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译 者 序 


C# 是 微软 公司 在 2000 年 6 月 发 布 的 一 种 面向 对 象 的 、 运 行 于 NET Framework 之 上 的 高 级 程序 设计 语言 ， 
由 Anders Hejlsberg 主持 开发 ， 它 是 第 一 个 面 癌 组 件 的 编程 语言 ， 其 源码 会 编译 成 MSIL 再 运行 。C# 是 微软 公 
司 .NET Framework 的 主角 。C# 是 一 种 安全 的 、 稳 定 的 、 简 单 的 、 优 雅 的 、 由 C 和 C++ 衍生 出 来 的 编程 语言 。 
它 在 继承 C 和 C+t+ 强 大 功能 的 同时 ， 去掉 了 它们 的 一 些 复 杂 特 性 , 使 程序 员 可 以 快速 地 编写 各 种 基于 微软 .NET 
平台 的 应 用 程序 。 

C# 是 兼顾 系统 开发 和 应 用 开发 的 最 佳 实用 语言 ， 很 有 可 能 成 为 编程 语言 历史 上 的 第 一 个 “全 能 ”型 语言 。 
它 提供 了 以 下 软件 工程 要 素 的 支持 ， 强 类 型 检查 、 数 组 维度 检查 、 未 初始 化 的 变量 引用 检测 、 自 动 垃圾 收集 。 
目前 ，C# 已 经 发 布 到 7.2 版 本 ， 其 中 : 

e C#1.0: 纯粹 的 面 回 对 象 。 

e C#2.0: 增加 了 泛 型 编程 新 概念 。 

se C#3.0: 率先 实现 了 LINQ 的 语言 。 

e (CC# 4.0: 文 持 动 态 编程 。 

8 C#5: 支持 异步 编程 。 

e C#6 和 NETCore 1.0 提供 了 代码 的 共享 ，NET Core 运行 在 Windows、Linux 和 Mac 操作 系统 上 。 因 此 

自从 NET Core 推出 以 来 ， 就 可 以 在 任何 操作 系统 上 构建 程序 。 

e (CH#7 和 NETCore 2.0 提供 了 函数 式 编程 。 

随 着 微软 加 快 了 发 布 速 度 ， 同 时 在 每 次 更 新 中 都 提供 了 更 重要 的 改进 ， 对 新 工具 和 新 特性 的 快速 处 理 就 变 
得 前 所 未 有 的 重要 。《C# 高 级 编程 (第 11 版 ) C#7&.NET Core 2.0》 就 是 为 了 达到 这 个 目的 而 设计 的 ， 关 于 C# 的 
一 切 都 在 这 里 。 

本 书 为 有 经 验 的 程序 员 提供 了 他 们 需要 与 世界 领先 的 编程 语言 有 效 合作 的 信息 。 最 新 的 C 语言 增加 了 许多 
新 的 特性 并 更 新 了 一 些 特性 ， 儿 助 你 在 更 短 的 时 间 内 完成 更 多 的 工作 ， 本 书 是 快速 入 门 的 理想 指南 。C#7 重点 
关注 代码 简化 和 性 能 ， 对 本 地 函数 、 元 组 类 型 、 记 录 类 型 、 模 式 匹 配 、 非 可 空 引 用 类 型 、 不 可 变 类 型 提供 了 新 
的 支持 。Visual Studio 的 改进 将 给 C 开发 人 员 与 空间 交互 的 方式 带 来 重大 改变 ,将 .NET 引入 非 微软 平台 ， 并 将 
Docker、GULP 和 NPM 等 工具 与 其 他 平台 结合 起 来 。 

本 书 分 四 个 部 分 ， 介 绍 C# 语 言及 其 在 各 个 领域 中 的 应 用 。 第 I 部 分 给 出 C# 语 言 的 展 好 背景 知识 。 第 荆 部 
分 介绍 独立 于 应 用 程序 类 型 的 .NET Core 和 Windows Runtime。 和 第 II 部 分 论述 Web 应 用 程序 和 服务 。 第 IV 部 
分 介绍 如 何 使 用 XAML 构建 应 用 程序 ， 包 括 Universal Windows 应 用 程序 和 Xamarin 应 用 程序 。 

无 论 你 是 C# 新 手 ， 还 是 刚刚 迁移 到 C# 7， 如 果 和 希望 对 最 新 特性 有 一 个 扎实 的 掌握 ， 能 够 利用 该 语言 的 全 
部 功能 来 创建 健壮 的 、 高 质量 的 应 用 程序 ， 本 书 都 是 你 需要 知道 的 所 有 内 容 的 一 站 式 指 南 。 
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在 软件 开发 领域 工作 多 年 以 后 ，Christian 仍然 热爱 学 习 和 使 用 新 技术 ， 并 通过 多 种 形式 教 别 人 如 何 使 用 新 
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为 微软 开发 技术 代言 人 (Microsoft Regional Director)。Istvan 与 他 人 合作 出 版 了 Visual 
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许多 年 过 去 了 ，.NET 有 了 新 的 发 展 势头 。 NET Framework 有 一 个 年 轻 的 兄弟 .NET Core! 
.NET Framework 是 封闭 的 源 代码 ， 只 能 在 Windows 系统 上 使 用 。 现 在 NET Core 是 开源 的 ， 可 以 在 Linux 
上 使 用 ， 并 且 使 用 现代 模式 。 在 NET 生态 系统 中 有 很 多 巨大 的 改进 。 


注意 : 
由 于 最 近 的 变化 ，C# 在 最 受 欢 迎 的 编程 语言 中 排名 前 十 ， 而 NET Core 在 最 受 欢 迎 的 框架 中 排名 第 三 。 在 Web 
和 桌面 开发 人 员 中 ，C# 在 最 流行 的 语言 中 排名 第 三 。 详 情 请 登录 https://insights.stackoverflow.conmy survey/ 2017。 


使 用 C# 和 ASP NET Core, 可 以 创建 运行 在 Windows、Linux 和 Mac 上 的 Web 应 用 程序 和 服务 .使 用 Windows 
Runtime(Windows 运行 库 )， 可 以 通过 C# 和 XAML 以 及 NET Core 创建 本 机 Windows 应 用 程序 (也 称 为 通用 
Windows 平台 ，UWP)。 通 过 Xamarin， 使 用 C# 和 XAML 可 以 创建 运行 在 Android 和 iOS 设备 上 的 应 用 程序 。 
在 NET Standard 的 帮助 下 ， 可 以 创建 能 在 ASPNET Core、Windows 应 用 、Xamarin 中 共享 的 库 ， 还 可 以 创建 传 
统 的 Windows Forms 和 WPF 应 用 程序 。 所 有 这 些 都 在 本 书 中 介绍 。 

本 书 大 部 分 示例 都 建立 在 带 有 Visual Studio 的 Windows 系统 上 。 许 多 示例 也 在 Linux 上 进行 了 测试 ， 并 在 
Linux 和 Mac 上 运行 。 除 了 Windows 应 用 程序 示例 之 外 , 还 可 以 使 用 Mac 的 Visual Studio Code 或 Visual Studio 
for the Mac 作为 开发 环境 。 


0.1 .NET Core 的 世界 


.NET 有 很 长 的 历史 , 但 是 .NET Core 很 年 轻 。.NET Core 2.0 从 NET Framework 中 获得 了 许多 新 的 API， 使 
其 更 容易 将 现 有 的 .NET Framework 应 用 程序 迁移 到 .NET Core 的 新 世界 。 

一 个 简单 的 步骤 是 ， 可 以 创建 使 用 NET Standard 2.0 的 库 ， 这 些 库 可 以 在 .NET Framework 4.6.1 及 以 上 版 本 
的 应 用 程序 、.NET Core 2.0 应 用 程序 和 Windows Build 16299 以 上 版 本 的 应 用 程序 中 使 用 。 

现在 , 没有 理由 不 在 后 端 使 用 ASPNET Core。 随 看 迁移 到 .NET Standard 的 简化 , 越 来 越 多 的 库 可 以 在 .NET 
Core 中 使 用 。 总 体 来 看 ，ASPNET Core MVC 与 ASPNET MVC 非常 相似 。 然 而 ASPNET Core MVC 要 灵活 得 
多 ， 使 用 NET Core 模式 时 更 容易 操作 ， 也 更 容易 扩展 。 

对 于 创建 新 的 Web 应 用 程序 ， 可 能 只 需要 使 用 新 技术 Razor Pages。 如 果 应 用 程序 增长 ，Razor Pages 可 以 
很 容易 地 扩展 到 使 用 ASP NET Core MVC 的 模型 -视图 -控制 器 模式 。 

在 撰写 本 文 时 ， 用 于 实时 通信 的 技术 SignalR 的 .NET Core 版 本 即将 发 布 。 

ASPNET Core 与 JavaScript 技术 (如 Angular 和 React/Redux) 的 结合 非常 有 效 ， 甚 至 还 有 模板 使 用 这 些 技 术 
以 及 用 于 后 端 服务 的 ASPNET Core 创建 项 目 。 


注意 : 

可 以 通过 https://github.com/dotnet/corefx 访问 .NET Core 的 源 代 码 。.NET Core 命令 行 可 以 在 
https://github.conmydotnet/cli 上 使 用 。 在 https://github.com/aspnet 上 有 许多 ASPNET Core 的 存储 库 。 其 中 包括 
ASPNET Core MVC、Razor、SiegnalR、EntityFrameworkCore 等 。 
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下 面 是 对 .NET Core 部 分 特性 的 总 结 : 

es .NET Core 是 开源 的 。 

es .NET Core 使 用 现代 模式 。 

e .NET Core 支持 在 多 个 平台 上 开发 。 

e ASPNET Core 可 以 在 Windows 和 Linux 上 运行 。 

使 用 .NET Core 时 ， 会 发 现 这 项 技术 是 NET 目 从 第 一 个 版 本 以 来 最 大 的 改变 。.NET Core 是 一 个 新 的 开始 ， 
从 这 里 可 以 继续 我 们 的 旅程 ， 快 速 进行 新 的 开发 。 


0.2 C# 的 重要 性 


C# 在 2002 年 发 布 时 ， 是 一 个 用 于 .NET Framework 的 开发 语言 。C# 的 设计 思想 来 自 C+H、Java 和 Pascal。 
Anders Hejlsberg 从 Borland 来 到 微软 公司 ， 带 来 了 开发 Delphi 语言 的 经 验 。Hejlsberg 在 微软 公司 开发 了 Java 
的 Microsoft 版 本 于 +， 之 后 创建 了 C#。 


注意 : 

Anders Hejlsberg 现在 已 经 转移 到 TypeScript( 而 他 仍 在 影响 C 要 ， Mads Torgersen 是 C# 的 项 目 负 责 人 。C# 
的 改进 可 以 在 https://github.conydotnet/csharplang 上 公开 讨论 。 在 这 里 ， 可 以 阅读 C# 语 言 建议 和 会 议 记录 ， 也 
可 以 提交 自己 的 C# 建 议 。 


C# 一 开始 不 仅 作为 一 种 面 癌 对象 的 通用 编程 语言 ， 而 且 是 一 种 基于 组 件 的 编程 语言 ， 文 持 属 性 、 事 件 、 特 
性 (注解 ) 和 构建 程序 集 ( 包 括 元 数据 的 二 进 制 文件 )。 

随 着 时 间 的 推移 ，C# 增 强 了 泛 型 、 语 言 集成 查询 (Laneuage Integrated Query，LINQ)、lambda 表达 式 、 动 态 
特性 和 更 简单 的 异步 编程 。C# 编 程 语言 并 不 简单 ， 它 提供 了 很 多 功能 ,而且 实际 使 用 的 功能 在 不 断 进 化 。 因 此 ， 
C# 不 仪 是 面 同 对 象 或 基于 组 件 的 语言 ， 它 还 包括 函数 式 编程 的 理念 ， 开 发 各 种 应 用 程序 的 通用 语言 会 实际 应 用 
这 些 理念 。 

在 C#6 中 ,编译 器 的 源 代码 完全 重 写 了 。 不 仅 新 的 编译 器 管道 可 以 在 目 定义 程序 中 使 用 ,微软 还 获得 了 一 
些 新 的 资源 ， 使 变更 不 会 破坏 程序 的 其 他 部 分 。 因 此 ， 增 强 编译 器 变 得 容易 了 。 

C# 7 再 次 添加 了 许多 具有 函数 编程 背景 的 新 特性 ， 如 本 地 函数 、 元 组 和 模式 匹配 。 


0.3 ”C# 7 的 新 特性 


C# 6 扩展 包 括 static using、 基于 表达 式 体 的 方法 和 属性 、 目 动 实现 的 属性 初始 化 器 、 只 读 上 自动 属性 、 nameof 
操作 符 、 空 条 件 运 算 符 、 字 符 串 插入 、 字 典 初 始 化 器 、 异 常 过 滤器 以 及 catch 中 等 待 。C# 7 的 新 特性 是 什么 ? 
0.3.1 数字 分 隔 符 

数字 分 隔 符 使 代码 更 具 可 读 性 。 在 声明 变量 时 可 以 给 单独 的 数字 添加 _。 编 译 器 只 是 删除 。 下 面 的 代码 卢 
段 在 C# 7 中 看 起 来 更 具 可 读 性 : 

C#6 

long nl = Oxl1l234567890ABCDEF; 


C# 7 
long n2 = 0x 1234 5353618 90AB CDEF'; 


在 C#7.2 中， 也 可 以 把 “” 放 在 开头 。 


下 
ll} 
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C# 1/.2 
long nz = 0X 1234 35618 S90AB CDEF' 


数字 分 隔 符 在 第 2 章 介 绍 。 

0.3.2 二进制 字 面值 
C#7 为 二 进 制 提供 了 一 个 新 的 字面 值 。 二 进 制 的 值 只 能 是 0 和 1。 现在 数字 分 隔 符 变 得 尤为 重要 : 
CE 了 


uint binaryl = 0bl111 0000 1010 0101 1111 0000 1010 0101; 


二 进 制 字面 值 在 第 2 章 介绍 。 


0.3.3 ”表达 式 体 的 成 员 


C# 6 允许 使 用 表达 式 体 的 方法 和 属性 。 在 C# 7 中 ， 表 达 式 体 可 以 与 构造 函数 、 析 构 函 数 、 本 地 函数 、 属 
性 访问 器 等 一 起 使 用 。 这 里 可 以 看 到 属性 访问 器 在 C# 6 和 C#7 之 间 的 区 别 : 


C#6 


private string firstName; 
Public string FirstName 
{ 
get { return firstName; } 
set 1{ Set (ref _ firstName, value); 1 
} 
private string firstName; 
Public string FirstName 
{ 
get => firstName; 


Set =»> set(ref firstName., value); 


} 


表达 式 体 的 成 员 在 第 3 章 介 绍 。 

0.3.4 ”out 变量 
在 C#7 之 前 , out 变量 必须 在 使 用 之 前 声明 。 而 在 C# 7 中 , 代码 减少 了 一 行 ,， 因为 变量 可 以 在 使 用 时 声明 : 
C#6 


string n = "A2"™; 
int result.: 


if (string.TryParse(n, cout result) 
{ 


Console.WriteLine($"Converting to a number Was successful: {result}"); } 


C# i/ 

string n = "42"; 

if (string.TryParse{n, cout var result) 
{ 


Console .WriteLine ($"Converting to a number was successful: {result}"),; 


} 


这 个 特性 在 第 3 章 介 绍 。 
0.3.5 不 拖 尾 的 命名 参数 
C# 文 持 可 选 参数 需要 的 命名 参数 ， 但 在 任何 情况 下 都 可 以 支持 可 读 性 。C# 7.2 支持 不 拖 尾 的 命名 参数 。 参 
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数 名 可 以 添加 到 C# 7.2 的 任何 参数 中 : 
C#7.0 


1if (Enum.TryParse (weekdayRecommendation.Entity, ignoreCase: true, 
result: out DavyOfWeek weekdav)) 


{ 

reservation.Weekday = weekday; 
} 
C#7.2 


1if (Enum.TryParse (weekdayRecomendation.Entity, ignoreCase: true, 
out DayoOfWeek weekday)})) 


{ 

reservation.Weekday = weekday; 
} 
命名 参数 在 第 3 章 介绍 。 


0.3.6 ”只 读 结 构 


结构 应 该 是 只 读 的 (有 一 些 例外 )。 在 C# 7.2 中 ， 可 以 使 用 readonly 修饰 符 声 明 结 构 体 ， 因 此 编译 器 可 以 验 
证 结构 体 没有 更 改 。 编 译 右 也 可 以 使 用 此 保证 ， 不 复制 作为 参数 传递 给 它 的 结构 ， 但 把 它 传递 为 引用 : 


C# 71.2 
Public readonly struct Dimensions 
{ 
Public double Length { get; } 
Public double Width { get; } 


Public Dimensions (double length, double width) 
{ 

Length = length; 

Width = width:; 
} 


public double Diagonal => Math.sart (Length * Length + Width * Width); 


mg 


只 读 结 构 在 第 3 草 介 绍 。 
0.3.7 in 参数 


C# 7.2 还 允许 给 参数 使 用 in 修饰 竺 。 这 就 保证 了 所 传递 的 值 头 型 不 会 更 改 ， 并 可 以 通过 引用 来 传递 ， 以 避 
免 复制 : 


static void CantcChange (In AStruct s) 


// 5 can't change 


} 
ref、in 和 out 修饰 符 在 第 3 章 介 绍 。 
0.3.8 Private Protected 


C# 7.2 添加 了 一 个 新 的 访问 修饰 符 private protected。 如 果 茶 成 员 用 于 同一 程序 集中 的 类 型 ， 或 派生 自 类 的 
另 一 个 程序 集 的 类 型 ， 那 么 访问 修饰 符 protected internal 允许 访问 它 。 使 用 private protected 时 ， 上 述 两 个 条 件 
使 用 AND 而 不 是 OR 一 一 只 有 妆 类 派生 目 基 类 ， 且 位 于 同一 程序 集中 时 ， 才 允许 访问 。 

访问 修饰 符 在 第 4 章 中 介绍 。 


可 
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0.3.9 目标 类 型 的 default 

在 C# 7.1 中， 定义 了 default 字面 值 ， 与 default 操作 符 相 比 ， 它 允许 使 用 更 短 的 语法 。default 操作 符 总 是 
需要 类 型 的 重复 ， 现 在 不 再 需要 了 。 这 适用 于 复杂 类 型 ， 

C# 7.0 


int x = default (int).; 
ImmutableArray<int> arr = default (ImmutableArray<int>).; 


C# 7.1 


int x = default.: 
ImutableArray<int> arr = default; 


default 字面 值 在 第 5 章 介 绍 。 


0.3.10 ”本 地 函数 
在 C#7 之 前 , 不 可 能 在 方法 中 声明 函数 。 而 可 以 创建 一 个 lambda 表达 式 并 调用 它 , 如 C#6 代码 片段 所 示 : 
C#6 


Ublic volid SomeFunstuff(} 


{ 
FUunNnc<int, int, int> add = (x, YY) => xX + Yi 
int result = add(38, 4); 
Console .WriteLine (result)}); 
} 
在 C#7 中 ， 可 以 在 方法 中 声明 一 个 本 地 函数 。 本 地 函数 只 能 在 方法 的 作用 域内 访问 : 
C# 1 


Ublic volid SomeFunstuff 1T) 
{ 
int add (int Xx, int Y) => XxX + y; 


int result = add(38, 4); 
Console .WriteLine (result).; 


} 


本 地 函数 在 第 13 章 和 解释。 本 书 的 几 个 章节 介绍 了 它 的 不 同 用 途 。 


0.3.11 元 组 


元 组 允许 组 合 不 同类 型 的 对 象 .在 C#7 之 前 ,元 组 是 NETFramework 中 的 Tuple 类 .可 以 使 用 Iteml Item2、 
Item3 等 访问 元 组 的 成 员 。 在 C#7 中 ， 元 组 是 该 语言 的 一 部 分 ， 可 以 定义 成 员 的 名 称 : 


C#6 


Var tl1 = Tuple.create (42, "astring"); 
int 1I1 = tl1.Iteml.; 
string sl1 = t].Item2; 


C#7/ 

Var tl1 = (n: 42, s: "magic"™).; 
int 11 = tli1.n; 

string sl1 = tl1.s; 


除 此 之 外 ， 新 的 元 组 是 值 类 型 (ValueTuple)， 而 Tuple 类 型 是 引用 类 型 。 元 组 的 所 有 更 改 都 包含 在 第 13 章 中 。 
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0.3.12 推断 的 元 组 名 


C#7.1 通过 上 自动 推断 元 组 名 称 来 扩展 元 组 ， 类 似 于 匿名 类 型 。 在 C# 7.0 中 ， 元 组 的 成 员 总 是 需要 命名 。 如 
果 元 组 成 员 的 名 称 应 该 与 分 配给 它 的 属性 或 字段 相同 ， 那 么 在 C# 7.1 中 ， 如 果 不 提 供 名 称 ， 它 就 与 分 配给 它 的 
成 员 的 名 称 相同 : 


Var tl1 = (FirstName: racer.FirstName, Wins: racer.Wins); 
int wins = tl1 .Wins.; 

Var 七 L = (racer.FirstName, racer.Wins); 

int wins = tl1 .Wins.; 


0.3.13” 拆 解 
不 ， 这 不 是 打印 错误 。 拆 解 不 是 析 构 函数 。 元 组 可 以 拆 解 成 独立 的 变量 ， 例 如 : 


CL# 了 

(int n, string s) = {42, "magic™)s 

如 果 定 义 了 Deconstruct 方法 ， 也 可 以 拆 解 Person 对 象 : 
L# 了 

Var pl = new Persont("Tom", "TUTDOD”) 7 

(string firstName, string lastName) = pil; 

拆 解 在 第 13 章 介 绍 。 


0.3.14 ”模式 匹配 


使 用 模式 匹配 ，is 操作 符 和 switch 语句 增强 为 三 种 模式 ，const 模式 、 类 型 模式 和 var 模式 。 下 面 的 代码 片 
段 显示 了 使 用 is 操作 符 的 模式 。 第 一 个 检查 匹配 常数 42， 第 二 个 检查 Person 对 象 , 第 三 个 用 var 模式 检查 每 个 
对 象 。 使 用 类 型 和 var 模式 ， 可 以 为 强 类 型 访问 声明 一 个 变量 : 


C# 1 


public void PatternMatchingWithIsOperator (object o) 
{ 
if lo is 42) 
{ 
} 
If (© Is Person p) 
{ 
} 
if (已 is var v1) 
{ 
} 
} 


通过 switch 语句 ， 可 以 对 case 子 句 使 用 相同 的 模式 。 如 果 模 式 匹 配 ， 则 可 以 将 变量 声明 为 强 类 型 。 也 可 以 
在 以 下 条 件 下 使 用 when 过 滤 模 式 : 

C#1/ 

public void PatternMatchingWithswitchstatement (object o) 

switch (o) 


总 己 呈 已 42: 
break; 


Case Person pp when p.FirstNMame == "Katharina": 
break: 
Case Person Bp: 
breaks; 
CAasSe Var V: 
break:; 
} 
} 


模式 匹配 在 第 13 章 中 介绍 。 


0.3.15 Throw 表达 式 


Dl 
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抛 出 异常 只 有 在 语句 中 才 可 行 ， 在 表达 式 中 是 不 可 行 的 。 因 此 ， 当 使 用 构造 函数 接收 参数 时 ， 需 要 对 null 
进行 额外 的 检查 ， 才 能 抛 出 AreumentNullException 异常 。 在 C# 7 中 ， 可 以 在 表达 式 中 抛 出 异常 ， 因 此 可 以 使 


用 合并 操作 符 在 左 侧 为 null 时 抛 出 ArgumentNullException 异常 。 
C#6 


private readonly IBooksService booksService; 
Public BookCcontroller (BooksService booksService) 
{ 
if (BooksService == null)} 
{ 
throw new ArgumentNullException (nameof (b})); 


booksService = booksService; 


} 


C# 1/ 


private readonly IBooksService booksService; 
Public BookController (BooksService booksService) 


{ 

booksService = booksService ?? throw new ArgumentNullException (nameof (P) ) : 
} 
Throw 表达 式 在 第 14 章 中 介绍 。 


0.3.16 ”异步 Main() 方 法 


在 C#7.1 之前，Main0 方 法 总 是 需要 声明 为 类 型 void。 在 C# 7.1 中 ，Main0 方 法 也 可 以 是 Task 类 型 ， 使 用 


async 和 await 关键 字 : 
C# 17.0 
static woid Main() 
{ 
SomeMethodAsync() .Wait(); 
} 
C# 7.1 
asyne static Task Mainl() 
{ 
await SomeMethodAsync(}); 
} 


异步 编程 在 第 15 章 介 绍 。 


0.3.17 引用 语义 


.NET Core 主要 关注 性 能 的 提高 。 为 引用 语义 添加 C# 特 性 有 助 于 提高 性 能 。 在 C# 7 之 前 ，ref 关键 字 可 以 


与 参数 一 起 使 用 ， 通 过 引用 传递 值 类 型 。 现 在 也 可 以 对 返回 类 型 和 本 地 变量 使 用 ref 关键 字 。 


下 面 的 代码 片段 声明 方法 GetNumber， 以 返回 对 int 的 引用 。 这 样 ， 调 用 者 可 以 直接 访问 数组 中 的 元 素 ， 


并 可 以 更 改 其 内 容 : 
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C#1.0 
int[] numbers = { 3, 7, 11, 15, 21 }; 
public ref int GetNumber(int index) 
{ 
return ref numbers[index]; 


} 
在 C# 7.2 中 ，readonly 修饰 符 可 以 添加 到 ref 返回 值 上 。 这 样 ， 调 用 者 不 能 更 改 返 回 值 的 内 容 , 但 仍然 使 用 
引用 语义 ， 并 可 以 避免 在 返回 结果 时 复制 值 类 型 。 调 用 方 收 到 引用 ， 但 不 允许 更 改 引 用 : 


C# 7.2 
int[] numbers = { 3, 1, ll1l, ls, 21 }; 
Public ref readonly int GetNumber (int index) 
{ 

return ref numbers[index]; 


} 

在 C# 7.2 之 前 ，C# 可 以 创建 引用 类 型 (类 ) 和 值 类 型 (结构 )。 然 而 ， 装 箱 时 ， 结 构 体 也 可 以 存储 在 堆 中 。 在 
C# 7.2 中 ， 可 以 声明 一 个 类 型 ref strmmct， 该 类 型 只 允许 放 在 堆栈 上 : 

C# 1.2 

ref struct OnlyonThestack 


{ 
} 


引用 的 新 特性 在 第 17 章 中 介绍 。 


0.4 ASP.NET Core 中 的 新 特性 


在 .NET Core 和 Visual Studio 2017 中 , 有 一 个 新 的 项 目 文件 .在 Visual Studio 2015 中 是 预览 版 本 的 .NET Core 
工具 ， 在 Visual Studio 2017 中 已 经 上 用 布 了 。 该 工具 使 用 csproj 文件 切换 到 MSBuild 环境 ， 所 以 现在 有 了 csproj 
文件 用 于 .NET Framework 和 .NET Core 应 用 程序 。 然 而 ， 这 并 不 是 前 几 代 的 csproj 文件 。 现 在 的 csproj 文件 要 
短 得 多 ， 简 化 了 许多 ， 也 可 以 使 用 简单 的 文本 编辑 器 来 修改 它们 。 

.NET Core 2.0 通过 .NET Standard 2.0 中 定义 的 类 和 方法 得 到 增强 ， 这 更 便于 将 现 有 的 .NET Framework 应 用 
程序 迁移 到 .NET Core。 

创建 ASPNET Core 项 目 , 不 仅 简 化 了 csproj 文件 , 而 且 简 化 了 C# 洒 代码。 使 用 默认 的 WebHostBuilder 时 ， 
会 预定 义 更 多 的 内 容 。 添 加 配置 和 日 志 提 供 程序 时 ， 不 需要 目 己 添加 它们 。 在 ASPNET Core MVC 中 ， 有 了 一 
些小 的 改进 一 一 例如 ， 视 图 组 件 现在 可 以 在 标记 辅助 程序 中 使 用 。 

还 有 一 种 新 的 技术 一 一 Razor 页 面 ， 比 ASPNET Core MVC 更 容易 学 习 。 有 些 应 用 程序 不 需要 来 自 模型 - 视 
图 -控制 器 模式 的 抽象 ， 此 时 就 可 以 使 用 Razor 页 面 。 


0.5 ”UWP 的 新 特性 


Windows 10 一 年 更 新 两 次 (如 果 在 Windows Insiders 程序 中 ， 就 会 更 频繁 地 得 到 更 新 ,但 这 对 大 多 数 用 户 来 
说 并 不 正常 )。 每 次 Windows 更 新 都 会 发 布 一 个 新 的 SDK。 最 新 的 两 项 更 新 是 Creators Update( 构 建 号 15063, 2017 
年 3 月 ) 和 Fall Creators Update (构建 号 16299. 2017 年 10 月 )。 

微软 继续 提供 集成 在 Windows 控件 中 的 新 设计 特性 。 新 的 设计 命名 为 Fluent Design, 它 集成 到 标准 控件 中 ， 
也 可 以 直接 访问 一 一 例如 ， 使 用 acrylic 和 reveal brushes。 在 应 用 程序 中 通过 ParallaxView 添加 了 视差 效果 。 

添加 特性 也 提高 了 生产 力 。 可 以 使 用 Windows Template Studio (Visual Studio 的 一 个 扩展 ) 中 的 模板 编辑 器 创 
建 多 个 页 面 ， 并 使 用 预先 生成 的 服务 。 

XAML 通过 有 条 件 的 XAML 进行 了 增强 ,使 其 更 容易 支持 多 个 Windows 10 版 本 , 但 使 用 旧版 本 Windows 
10 中 没有 的 新 功能 。 
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InkCanvas 控件 提供 了 新 的 标尺 ， 可 以 轻松 地 集成 到 应 用 程序 中 。NavigationView 可 以 很 容易 地 创建 带 有 汉 
堡 包 按钮 和 SplitView 的 自 适应 菜单 。 本 书 的 第 人 部 分 将 详细 介绍 所 有 这 些 新 特性 以 及 更 多 的 内 容 。 


0.6 编写 和 运行 C# 代 人 码 的 环境 


.NET Core 运行 在 Windows、Linux 和 Mac 操作 系统 上 。 使 用 Visual Studio Code(https://code. visualstudio.com)， 
可 以 在 任何 操作 系统 上 创建 和 构建 程序 。 

最 好 用 的 开发 工具 是 Visual Studio 2017， 也 是 本 书 使 用 的 工具 。 可 以 使 用 Visual Studio Community 2017 
版 (https://www.visualstudio.com), 但 本 书 介 绍 的 一 些 功 能 只 有 Visual Studio 的 企业 版 提供 。 需 要 企业 版 时 会 提 到 。 
Visual Studio 2017 需要 Windows 10 构建 号 1507 或 更 高 版 本 ， 要 求 使 用 Windows 8.1、Windows Server 2012 R2 
或 Windows 7 SP1。 要 构建 和 运行 本 书 中 的 Windows 应 用 程序 (UWP)， 需 要 Windows 10。 

要 为 iOS 创建 和 构建 Xamarin 应 用 程序 ， 还 需要 用 于 构建 系统 的 Mac。 没 有 Mac， 仍 然 可 以 为 Windows 
和 Android 开发 Xamarin 应 用 程序 。 

在 Mac 上 开发 应 用 程序 ， 可 以 使 用 Visual Studio for Mac: https://www.visualstudio.com/vs/Visual - Studio - Mac/。 
可 以 使 用 这 个 工具 创建 ASPNET Core 和 Xamarin 应 用 程序 ， 但 是 不 能 创建 和 测试 Windows 应 用 程序 。 


0.7 本 书 内 容 


本 书 首 先 在 第 1 间 介 绍 .NET 的 整体 体系 结构 , 给 出 编写 托管 代码 所 需要 的 背景 知识 。 此 后 概述 不 同 的 应 用 
程序 类 型 ， 学 习 如 何 用 新 的 开发 环境 CLI 编译 程序 ， 介 绍 在 Visual Studio 中 开始 学 习 的 最 重要 部 分 。 之 后 本 书 
分 几 部 分 介绍 C# 语 言及 其 在 各 个 领域 中 的 应 用 。 


第 | 部 分 一 一 C# 滞 言 

该 部 分 介绍 C# 语 言 的 良好 背景 知识 。 尽管 这 一 部 分 假定 读者 是 有 经 验 的 编程 人 员 , 但 它 没 有 假设 读者 拥有 
任何 特定 语言 的 知识 。 首 先 介绍 C# 的 基本 语法 和 数据 类 型 ， 再 介绍 C# 的 面 同 对 象 特 性 ， 之 后 介绍 C# 中 的 一 
些 高 级 编程 主题 ， 如 委托 、lambda 表达 式 和 语言 集成 查询 (Laneguage Integrated Query，LINQ)。 

由 于 C# 包 含 许多 函数 式 编 程 的 特性 ， 因 此 需要 了 解 元 组 和 模式 匹配 的 函数 式 编 程 基 础 ,讨论 异步 编程 和 引 
用 语义 的 新 语言 特性 .本 部 分 最 后 探讨 Visual Studio 2017 的 许多 特性 , 还 将 了 解 Docker 的 基础 知识 , 以 及 Visual 
Studio 2017 支持 Docker 的 方式 。 


第 中 部 分 一 一 .NET Core 与 Windows Runtime 

第 19 一 29 章 介绍 独立 于 应 用 程序 类 型 的 .NET Core 和 Windows Runtime( 运 行 库 )。 本 部 分 在 第 19 章 中 介绍 
如 何 创建 库 和 NuGet 包 ， 学 习 如 何以 最 好 的 方式 使 用 .NET 标准 。 

依赖 注入 (Dependency Injection，DD 与 NET Core 一 起 使 用 : 服务 注入 Entity Framework Core 和 ASPNET 
Core。ASPNET Core MVC 使 用 了 数 百 个 服务 。DI 便于 路 WPF、UWP 和 Xamarin 使 用 相同 的 代码 。 第 20 章 专 
门 介 绍 DI 的 基础 ， 还 可 以 在 DI 容器 Microsoft.Extensions .DependencyInjection 中 学 到 高 级 特性 ， 包 括 调 整 非 微 
软 容 器 。 其 他 许多 章节 也 使 用 DI。 

第 21 章 介 绍 使 用 任务 并 行 库 (Task Parallel Library，TPL) 进 行 并 行 编 程 ， 以 及 用 于 同步 的 各 种 对 象 。 

第 22 章 学 习 如 何 访问 文件 系统 ， 读 取 文 件 和 目录 ， 了 解 如 何 使 用 System.IO 名 称 空 间 中 的 流 和 ”Windows 
运行 库 中 的 流 来 编写 Windows 应 用 程序 。 

第 23 章 学 习 使 用 套 接 字 和 使 用 更 高 级 别 的 抽象 (如 HttpClient) 的 联网 的 核心 基础 。 

第 24 章 利用 流 来 了 解 安 全 性 ， 以 及 如 何 加 密 数 据 ， 人 允许 进行 安全 的 转换 。 本 章 还 讨论 了 创建 Web 应 用 程 
序 时 需要 了 解 的 一 些 主题 ， 如 SQL 注入 和 跨 站 点 请 求 伪 造 攻击 的 问题 。 

第 25 和 26 章 展示 了 如 何 访问 数据 库 。 第 25 章 使 用 ADO.NET 直接 解释 事务 ， 并 涵盖 了 使 用 NET 核心 的 
环境 事务 。 第 26 章 介 绍 了 Entity Framework Core 2.0 提供 的 所 有 新 特性 ,EF Core 2.0 有 旧 的 Entity Framework 6.x 
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无 法 提供 的 许多 特性 。 

第 27 章 介 绍 使 用 本 地 化 的 技术 本 地 化 应 用 程序 ， 该 技术 对 Windows 和 Web 应 用 程序 都 非常 重要 。 

用 C# 代 码 创建 功能 时 ， 不 要 跳 过 创建 单元 测试 的 步骤 。 一 开始 需要 更 多 的 时 间 ， 但 随 着 时 间 的 推移 ， 添 加 
功能 和 维护 代码 时 ， 就 会 看 到 其 优势 。 第 28 章 介 绍 如 何 创建 单元 测试 ， 包 括 Visual Studio 2017 中 的 实时 单元 
测试 、 网 络 测试 和 编码 的 UI 测试 。 

第 29 章 介 绍 了 .NET Core 的 日 志 功 能 ， 以 及 使 用 Visual Studio AppCenter 获取 分 析 信 息 。 


第 川 部 分 一 一 Web 应 用 程序 和 服务 

本 部 分 将 介绍 Web 应 用 程序 和 服务 。 本 部 分 从 第 30 章 开 始 ， 提 供 了 ASPNET Core 的 基础 。 使 用 MVC 模 
式 创 建 Web 应 用 程序 ， 包 括 新 技术 Razor 页 面 ， 在 第 31 章 中 介绍 。 第 32 章 涵 盖 了 ASPNET Core 的 REST 服 
务 特性 : Web API。 


第 IV 部 分 一 一 应 用 程序 

本 部 分 介绍 如 何 使 用 XAML 构建 应 用 程序 一 一 Universal Windows 应 用 程序 和 Xamarmn。 了 解 Windows 应 
用 程序 的 基础 ， 包 括 第 33 章 中 XAML 的 基础 ， 其 中 包含 XAML 语法 、 依 赖 属性 和 标记 扩展 ， 可 以 在 其 中 创建 
目 己 的 XAML 语法 。 本 章 介 绍 了 Windows 控件 的 不 同类 别 以 及 与 XAML 绑 定 数据 的 基础 。 

第 34 章 主 要 关注 MVVMI( 模 型 -视图 -视图 模型 ) 模 式 。 该 章 将 学 习 如 何 利 用 基于 XAML 的 应 用 程序 的 数据 
绑 定 特性 ， 这 些 特性 允许 在 Windows 应 用 程序 、WPF 和 Xamarin 之 间 共 享 大 量 代 码 。 也 可 以 分 享 许 多 为 iDS 
和 Android 平台 开发 的 代码 ,创建 WPF 应 用 程序 并 没有 在 本 书 中 介绍 一 一 这 一 技术 在 最 近 几 年 并 没有 得 到 多 少 
改进 ， 应 该 考虑 转向 通用 Windows 平台 ， 如 果 使 用 第 34 章 学 到 的 知识 ， 就 更 容易 实现 这 一 点 。WPF 应 用 程序 
仍然 需要 维护 。 要 想 更 深入 地 了 解 WPF， 应 该 阅读 本 书 的 上 一 版 。 

第 35 章 介 绍 基于 XAML 的 应 用 程序 的 样式 化 。 第 36 章 介绍 了 用 通用 Windows 平台 创建 Windows 应 用 程 
序 的 高 级 功能 。 展 示 了 应 用 程序 服务 、 上 墨 (inking、AutoSuggest 控件 、 高 级 编译 绑 定 特性 等 。 

第 37 章 帮 助 启动 Windows、Android 和 iPhone 的 Xamarin 开发 ， 并 展示 幕后 发 生 的 事情 。 学 习 
Xamarin.Android、Xamarin.iOS 和 Xamarn Formns 之 间 的 不 同 之 处 。 了 解 Xamarin.Forms 控件 与 Windows 控件 
的 不 同 之 处 ， 更 快 地 从 Windows 开发 转向 Xamarin。 本 章 的 较 大 示例 使 用 与 第 34 章 中 的 Windows 应 用 程序 相 
同 的 MVVM 库 。 


附加 的 章 书 

附加 的 第 1 章 讨 论 了 Microsoft Composition， 它 允许 创建 容器 和 部 件 之 间 的 独立 性 。 附 加 的 第 2 章 论 述 如 
何 将 对 象 序列 化 到 XML 和 JSON 中 ， 以 及 用 于 读 取 和 编写 XML 的 不 同 技术 。 

Web 应 用 程序 的 发 布 和 订阅 技术 使 用 ASPNET Core 技术 WebHooks 和 SignalR 的 形式 , 在 附加 的 第 3 章 中 
讨论 。 附 加 的 第 4 章 对 使 用 Bot 服务 和 Azure 认 知 服务 创建 应 用 程序 有 了 新 的 认识 。 

附加 的 第 5 章 涵 盖 了 一 些 与 Windows 应 用 程序 相关 的 额外 主题 : 使 用 相机 、 地 理 定位 来 访问 当前 的 位 置信 
恩 ， 以 各 种 格式 显示 地 图 的 MapControl， 以 及 几 个 传感器 (比如 提供 光线 信息 和 测量 重力 的 传感器 )。 

可 以 扫描 封 克 二 维 码 得 看 附加 的 $ 章 内 容 。 


0.8 ”如 何 下 载 本 书 的 示例 代码 


在 读者 学 习 本 书 中 的 示例 时 ， 可 以 手工 输入 所 有 的 代码 ， 也 可 以 使 用 本 书 附带 的 源 代码 文件 。 本 书 使 用 的 所 有 
源 代码 都 可 以 从 本 书 合作 站 点 http://wwwwrox.com/ 上 下 载 。 登录 到 站 点 http://www.wrox.com/, 使 用 Search 工具 或 书 
名 列表 就 可 以 找到 本 书 。 接 着 单 击 本 书 细 目 页 面 上 的 Download Code 链接 ， 就 可 以 获得 所 有 的 源 代 码 ， 也 可 以 扫描 
封底 的 二 维 码 获 取 本 书 的 源 代码 。 


wk 
ol 
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注意 : 
许多 图 书 的 书 名 都 很 相似 ,所 以 通过 ISBN 查找 本 书 是 最 简单 的 ,本 书 英文 版 的 ISBN 是 978-1-119-44927-0。 


在 下 载 代 码 后 ， 只 需要 用 上 自己 喜欢 的 解压 缩 软 件 对 它 进行 解压 缩 即 可 。 另 外 ， 也 可 以 进入 


http://www.wrox.com/dynamic/books/download.aspx 上 的 Wrox 代码 下 载 主页 ， 查 看 本 书 和 其 他 Wrox 图 书 的 所 有 
代码 。 


0.9 GitHub 


源 代码 也 可 以 在 GitHub 上 提供 , 网 址 是 https://www.github.com/ProfessionalCSharp/ ProfessionalCSharp7。 在 
GitHub 中 ， 还 可 以 使 用 Web 浏览 器 打开 每 个 源 代码 文件 。 使 用 这 个 网 站 时 ， 可 以 把 完整 的 源 代码 下 载 到 一 个 
zip 文件 。 还 可 以 将 源 代 码 复 制 到 系统 上 的 本 地 目录 。 只 需要 安装 git 工具 ， 为 此 可 以 使 用 Visual Studio 或 者 从 
https://git-scm.com/downloads 下 载 Windows、Linux 和 Mac 的 git 工具 。 要 将 源 代码 复制 到 本 地 目录 ， 请 使 用 git 


clone: 


> git clone https://www.github.com/ProfessionalCcSsharp/ProfessionalCcsharp7 


使 用 此 命令 ， 把 完整 的 源 代码 复制 到 子 目 录 ProfessionalCSharmp7。 之 后 就 可 以 开始 处 理 源 文件 了 。 

Visual Studio 的 更 新 可 用 ，SignalR 库 发 布 后 ， 源 代码 将 在 GitHub 上 更 新 。 如 果 在 复制 源 代码 之 后 源 代 码 
发 生 了 变化 ， 就 可 以 在 将 当前 目录 更 改 为 源 代码 目录 后 ， 提 取 最 新 的 更 改 : 

> git pull 

如 果 对 源 代码 做 了 一 些 更 改 ，git pull 可 能 会 导致 错误 。 如 果 发 生 这 种 情况 ， 可 以 把 更 改 隐藏 起 来 ， 然 后 再 
取出 来 : 


> git stash 
> git pull 


git 命令 的 完整 列表 可 以 在 https://git-scm.com/docs 上 找到 。 

如 果 源 代码 有 问题 ， 可 以 在 存储 库 中 报告 问题 。 在 浏览 器 中 打开 https://github.conyProfessionalCSharp/ 
ProfessionalCSharp7， 单 击 Issues 选项 卡 ， 单 击 New Issue 按钮 。 这 将 打开 一 个 编辑 器 ， 如 图 1 所 示 ， 尽 可 能 详 
细 地 描述 问题 。 
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为 了 报告 问题 ， 需 要 一 个 GitHub 账户 。 如 果 有 一 个 GitHub 账户 ， 也 可 以 将 源 代码 存储 库 分 叉 到 账户 上 。 
有 关 使 用 GitHub 的 更 多 信息 ， 请 查看 https://euides .github.comyactivities/hello-world 。 


注意 : 
可 以 读 取 源 代码 和 相关 问题 ， 并 在 不 加 入 GitHub 的 情况 下 在 本 地 复制 存储 库 。 要 在 GitHub 上 发 布 问 题 并 
创建 自己 的 存储 库 ， 需 要 自己 的 GitHub 账户 。 


0.10 ”勘误 表 


尽管 我 们 已 经 尽力 保证 不 出 现 错误 ， 但 错误 总 是 难免 的 ， 如 果 你 在 本 书 中 找到 了 错误 ， 如 拼写 错误 或 代码 
错误 ， 请 告诉 我 们 ， 我 们 将 非常 感激 。 通 过 勘误 表 ， 可 以 让 其 他 读者 避 倪 受挫 ， 当 然 ， 这 还 有 助 于 提供 更 高 质 
量 的 信息 。 

要 在 网 站 上 找到 本 书 的 勘误 表 ， 可 以 登录 http://www.wrox.com， 通 过 Search 工具 或 书 名 列表 查找 本 书 ， 然 
后 在 本 书 的 细 目 页 面 上 , 单 击 Book Errata 链接 。 在 这 个 页 面 上 可 以 查看 Wrox 编辑 已 提交 和 粘贴 的 所 有 勘误 项 。 
完整 的 图 书 列表 还 包括 每 本 书 的 勘误 表 ， 网 址 是 Www.wrox.com/misc-pages/ booklist.shtml。 

如 果 没 有 在 Book Errata 页 面 上 发 现 目 己 找 到 的 错误 ， 请 访问 Www.wrox.comycontact/techsupportt.shtml， 填 
好 表单 ， 将 你 找到 的 错误 发 送 给 我 们 。 我 们 将 检查 信息 ， 如 果 合 适 的 话 ， 将 消息 发 送 到 该 书 的 勘误 页 面 ， 并 在 
该 书 的 后 续 版 本 中 修复 问题 。 
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第 章 
.NET 应 用 程序 和 工具 


本 章 要 点 

回顾 .NET 的 历史 

理解 .NET Framework 和 .NET Core 之 间 的 差异 
NuGet 包 

公共 语言 运行 库 

Windows 运行 库 的 特性 

编写 “Hello World!” 程 序 
.NET Core 命令 行 界面 

Visual Studio 2017 

通用 Windows 平台 

创建 Windows 应 用 程序 的 技术 
创建 Web 应 用 程序 的 技术 


本 章 源 代码 下 载 : 

单 击 Www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 HelloWorld 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 

本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

® HelloWorld 

® WebApp 

es SelfContamned HelloWorld 


1.1 选择 技术 


.NET 是 在 Windows 平台 上 创建 应 用 程序 的 杰出 技术 。 但 现在 ，.NET 是 在 Windows、Linux 和 Mac 上 创建 
应 用 程序 的 杰出 技术 。 

.NET Core 是 .NET 目 其 发 明 以 来 最 大 的 变化 。 目 前 NET 代码 是 开源 的 代码 ， 还 可 以 为 其 他 平台 创建 应 用 
程序 。.NET 使 用 现代 模式 。.NET Core 和 NuGet 包 人 允许 微软 公司 以 更 短 的 更 新 周期 提供 新 特性 。 应 该 使 用 什么 
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技术 创建 应 用 程序 并 不 容易 决定 ， 本 章 将 提供 这 方面 的 帮助 。 其 中 包含 用 于 创建 Windows、Web 应 用 程序 和 服 
务 的 不 同 技术 的 信息 ， 指 导 选 择 什么 技术 进行 数据 库 访问 ， 凸 显 了 .NET Framework 和 .NET Core 之 间 的 差异 。 


1.2 ”回顾 .NET 历史 
要 更 好 地 理解 NET 和 cC# 的 可 用 功能 ， 最 好 先 了 解 它 的 历史 。 表 1-1 显示 了 .NET Framework 的 版 本 、 对 应 


的 公共 语言 运行 库 (Common Language Runtime，CLR) 的 版 本 、C# 的 版 本 以 及 Visual Studio 的 版 本 ， 并 指出 相应 
版 本 的 发 布 年 份 。 除 了 知道 使 用 什么 技术 之 外 ， 最 好 也 知道 不 推荐 使 用 什么 技术 ， 因 为 这 些 技术 会 被 蔡 代 。 


ET Ea CLR 出 Wasuwan 


当 使 用 .NET Core 创建 应 用 程序 时 ， 了 解 文 持 级 别 的 时 间 框 架 非 常 重 要 。LIS(Long Time Support， 长 时 间 
支持 ) 的 文 持 长 度 比 Current 长 ， 但 Curent 会 更 快 地 获得 新 特性 。LTS 在 发 行 后 或 下 一 个 LTS 版 本 发 布 的 12 个 
月 后 得 到 3 年 的 支持 ， 以 较 短 的 版 本 为 准 。 因 此 ， 如 果 下 一 个 LTS 版 本 在 2018 年 6 月 27 日 之 前 没有 发 布 ， 那 
么 .NET Core 1.0 将 支持 到 2019 年 6 月 27 日 。 如 果 下 一 个 LTS 版 本 在 更 早 的 时 候 发 布 , 那么 在 下 一 个 LTS 发 布 
后 的 一 年 ，.NET Core 1.0 将 得 到 支持 。 

.NET Core 1.1 最 初 是 一 个 Current 版 本 ， 但 它 变 成 了 LIS， 它 得 到 的 支持 长 度 与 .NET Core 1.0 相同 。 

.NET Core 2.0 是 一 个 Current 支持 级 别 的 版 本 。 这 意味 着 它 将 得 到 3 年 的 支持 ， 下 一 个 LTS 发 布 后 的 12 个 
月 ,或 发 布下 一 个 Current 版 本 后 的 3 个 月 以 较 短 的 时 间 为 准 。 可 以 假定 , 最 后 一 个 选项 是 视 情 况 而 定 , .NET 
Core 2.0 将 在 .NET Core 2.1 可 用 后 3 个 月 得 到 支持 。 

表 1-2 列 出 了 .NET Core 版 本 、 发 布 日 期 和 支持 级 别 。 


表 1-2 
NET Core 所 支持 级 区 
1.0 2016 年 6 月 27 日 LTS 
2.0 2017 年 8 月 14 日 Current 


1.2.1 C# 1.0 一 一 一 种 新 语言 


C# 1.0 是 一 种 全 新 的 编程 语言 , 用 于 .NET Framework。 开发 它 时 , .NET Framework 由 大 约 3000 个 类 和 CLR 
组 成 。 
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创建 Java 的 Sun 公司 申请 法 性 判决 不 允许 微软 公司 更 改 Java 代码 后 , Anders Hejlsberg 设计 了 C#。Hejlsberg 
为 微软 公司 工作 之 前 ， 在 Borland 公司 设计 了 Delphi 编程 语言 (一 种 Object Pascal 语言 )。Hejlsberg 在 微软 公司 
负责 J++(Java 编程 语言 的 微软 版 本 )。 鉴 于 Hejlsberg 的 背景 ，C# 编 程 语言 主要 受到 C++、Java 和 Pascal 的 影 啊 。 

因为 C# 的 创建 晚 于 Java 和 C++， 所 以 微软 公司 分 析 了 其 他 语言 中 典型 的 编程 错误 ， 完 成 了 一 些 不 同 的 工 
作 来 避免 这 些 错误 。 这 些 不 同 的 工作 包括 : 

e 在 让 语句 中 ， 布 尔 (Booleam 表 达 式 是 必需 的 (C++ 也 允许 在 这 里 使 用 整数 值 )。 

e 人 允许 使 用 struct 和 class 关键 字 创 建 值 类 型 和 引用 类 型 (Java 只 人 允许 创建 目 定 义 引 用 类 型 ;在 C++ 中 ,stract 

和 class 之 间 的 区 别 只 是 访问 修饰 符 的 默认 值 不 同 )。 

e 人 多 许 使 用 虚拟 方法 和 非 虚拟 方法 (这 类 似 于 C++; Java 总 是 创建 虚拟 方法 )。 

当然 ， 阅 读本 书 ， 会 看 到 更 多 的 变化 。 

现在 ，C# 是 一 种 纯粹 的 面向 对 象 编程 语言 ， 具 备 继承 、 封 装 和 多 态 性 等 特性 。C# 也 提供 了 基于 组 件 的 编程 
改进 ， 如 委托 和 事件 。 

在 NET 和 CLR 推出 之 前 ， 每 种 编程 语言 都 有 自己 的 运行 库 。 在 C++ 中 ，C++ 运 行 库 与 每 个 C++ 程序 链接 
起 来 。Visual Basic 6 有 上 自己 的 运行 库 VBRun。Java 的 运行 库 是 Java 虚拟 机 (Java Virtual Machine，JVC) 一 一 可 
以 与 CLR 相 媲美 。CLR 是 每 种 .NET 编程 语言 都 使 用 的 运行 库 。 推 出 CLR 时 ， 微 软 公司 提供 了 JScript NET、 
Visual Basic .NET、 Managed C++ 和 C#。JScript .NET 是 微软 公司 的 JavaScript 编译 器 ， 与 CLR 和 .NET 类 一 
起 使 用 。Visual Basic NET 是 提供 .NET 支持 的 Visual Basic,， 现在 再 次 简称 为 Visual Basic。Managed C++ 是 混合 
了 本 地 C++ 代码 与 Managed .NET 代码 的 语言 。 今 天 与 .NET 一 起 使 用 的 新 C++ 语言 是 CHH CLR。 

NET 编程 语言 的 编译 器 生成 中 间 语 言 (Intermediate Laneuage， 了 I) 代码 。 工 代码 看 起 来 像 面 向 对 象 的 机 器 
码 ， 使 用 工具 ildasm.exe 可 以 打开 包含 .NET 代码 的 DLL 或 EXE 文件 来 检查 工 代码 。CLR 包含 一 个 即时 
(Just-In-Time，JIT) 编 译 器 ， 当 程序 开始 运行 时 ，JIT 编译 器 会 从 开 代码 中 生成 本 地 代码 。 


注意 : 
工人 代码 也 称 为 托管 代码 。 


CLR 的 其 他 部 分 是 垃圾 收集 器 (GC)、 调 试 器 扩展 和 线程 实用 工具 。 垃 圾 收集 器 负责 清理 不 再 引用 的 托管 内 
存 ， 这 个 安全 机 制 使 用 代码 访问 安全 性 来 验证 允许 代码 做 什么 。 调 试 器 扩展 允许 在 不 同 的 编程 语言 之 间 启 动 调 
试 会 话 (例如 ， 在 Visual Basic 中 启动 调试 会 话 ， 在 C# 库 内 继续 调试 )。 线 程 实用 工具 人 负责 在 的 层 平 台 上 创建 
线程 。 

.NET Framework 的 第 1 版 已 经 很 大 了 。 类 在 名 称 空间 内 组 织 ， 以 便于 导航 可 用 的 3000 个 类 。 使 用 名 称 空 
间 组 织 类 , 允许 在 不 同 的 名 称 空间 中 有 相同 的 类 名 , 以 解决 冲突 。.NET Framework 的 第 1 版 允许 使 用 Windows 
Forms( 名 称 空 间 System.Windows.Forms) 创 建 Windows 曙 面 应 用 程序 ， 使 用 ASPNET Web Forms (System.Web) 
创建 Web 应 用 程序 ， 使 用 ASPNET Web Services 与 应 用 程序 和 Web 服务 通信 ， 使 用 .NET Remoting 在 NET 应 
用 程序 之 间 更 迅速 地 通信 ， 使 用 Enterprise Services 创建 运行 在 应 用 程序 服务 器 上 的 COM + 组 件 。 

ASPNET Web Forms 是 创建 Web 应 用 程序 的 技术 ， 其 目标 是 开发 人 员 不 需要 了 解 HTML 和 JavaScript。 服 
务 器 疹 控 件 会 创建 HIML 和 JavaScript， 这 些 控件 的 工作 方式 类 似 于 Windows Forms 本 身 。 

C# 1.2 和 .NET 1.1 主要 是 错误 修复 版 本 ， 改 进 较 小 。 


注意 : 
继承 在 第 4 章 中 讨论 ， 委 托 和 事件 在 第 8 章 中 讨论 。 


注意 : 
NET 的 每 个 新 版 本 都 有 Professional C# 图 书 的 新 版 本 。 对 于 .NET 1.0， 这 本 书 已 经 是 第 2 版 了 ， 因 为 第 1 
版 是 以 .NET 1.0 的 Beta 2 为 基础 出 版 的 。 目 前 ， 本 书 是 第 11 版 。 
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1.2.2 带 有 泛 型 的 C# 2 和 .NET 2 


C# 2 和 NET 2 是 一 个 巨大 的 更 新 。 在 这 个 版 本 中 ， 改 变 了 c# 编 程 语言 ， 建 立 了 II 代码 ， 所 以 需要 新 的 
CLR 来 支持 工 代码 的 增加 。 一 个 大 的 变化 是 泛 型 。 泛 型 允许 创建 类 型 ， 而 不 需要 知道 使 用 什么 内 部 类 型 。 所 
使 用 的 内 部 类 型 在 实例 化 ( 即 创建 实例 ) 时 定义 。 

CH 编程 语言 中 的 这 个 改进 也 导致 了 Framework 中 多 了 许多 新 类 型 ， 例 如 System.Collections Generic 名 称 空间 中 
新 的 泛 型 集合 类 。 有 了 这 个 类 ，1.0 版 本 定义 的 旧 集合 类 就 很 少 用 在 新 应 用 程序 中 了 。 当 然 ， 旧 类 现在 仍然 在 工 
作 ， 甚 至 在 新 的 NET Core 版 本 中 也 是 如 此 。 


注意 : 
本 书 一 直 在 使 用 泛 型 ， 详 见 第 5 章 。 第 10 章 介绍 了 泛 型 集合 类 。 


1.23 .NET 3.0 一 一 人 WIndows Presentation Foundation 


发 布 .NET 3.0 时 ， 不 需要 新 版 本 的 C#。3.0 版 本 只 提供 了 新 的 库 ， 但 它 发 布 了 大 量 新 的 类 型 和 名 称 空 间 。 
Windows Presentation Foundation(WPF) 可 能 是 新 框架 最 大 的 一 部 分 , 用 于 创建 Windows 时 面 应 用 程序 。 Windows 
Forms 包括 本 地 Windows 控件 ， 且 基于 像素 ; 而 WPF 基于 DirectX， 独 立 绘 制 每 个 控件 。WPF 中 的 矢量 图 形 允 
许 无 颖 地 调整 任何 窗 体 的 大 小 。WPF 中 的 模板 还 允许 完全 目 定义 外 观 。 例如， 用 于 苏 歼 世 机 场 的 应 用 程序 可 以 
包含 看 起 来 像 一 染 飞 机 的 按钮 。 因 此 ， 应 用 程序 的 外 观 可 以 与 之 前 开发 的 传统 Windows 应 用 程序 不 同 。 
System.Windows 名 称 空间 下 的 所 有 内 容 都 属于 WPF， 但 System.Windows.Forms 除外 。 有 了 WPF， 用户 界面 可 
以 使 用 XML 语法 XAML(XML for Applications Markup Language) 设 计 。 

NET 3.0 推出 之 前 ，ASPNET Web Services 和 NET Remoting 用 于 应 用 程序 之 间 的 通信 。Message Queuing 是 
用 于 通信 的 男 一 个 选择 。 各 种 技术 有 不 同 的 优点 和 缺点 ， 它 们 都 用 不 同 的 API 进行 编程 。 典 型 的 企业 应 用 程序 
必须 使 用 一 个 以 上 的 通信 API, 因此 必须 学 习 其 中 的 几 项 技术 。WCF(Windows Communication Foundation) 解决 
了 这 个 问题 。WCF 把 其 他 API 的 所 有 选项 结合 到 一 个 API 中 。 然 而 ， 为 了 文 持 WCF 提供 的 所 有 功能 ， 需 要 配 
置 WCF。 

NET 3.0 版 本 的 第 三 大 部 分 是 Windows WF(Workflow Foundation) 和 名 称 空 间 System.Workflow。 人 微软 公司 
不 是 为 几 个 不 同 的 应 用 程序 创建 自 定义 的 工作 流 引 擎 (微软 公司 本 和 喘 为 不 同 的 产品 创建 了 几 个 工作 流 引 擎 )， 而 
是 把 工作 流 引 擎 用 作 .NET 的 一 部 分 。 

有 了 NET3.0，Framework 的 类 从 NET 2.0 的 8 000 个 增加 到 约 12 000 个 。 


注意 : 
要 学 习 WPF 和 WCF， 需 要 阅读 本 书 的 前 一 版 本 《C# 高 级 编程 (第 10 版 ) C#6&.NET Core 1.0》。 


1.2.4 C#3 和 .NET 3.5 一 一 LINQ 


.NET 3.5 和 新 版 本 C# 3 一 起 上 发布。 主要 改进 是 使 用 C# 定 义 的 查询 语法 ， 它 允许 使 用 相同 的 语法 来 过 滤 和 
排序 对 象 列表 、XML 文件 和 数据 库 。 语言 增强 不 需要 对 芽 代码 进行 任何 改变 ， 因 为 这 里 使 用 的 C# 特 性 只 是 语 
法 糖 。 所 有 的 增强 也 可 以 用 旧 的 语法 实现 , 只 是 需要 编写 更 多 的 代码 。C# 语 言 很 容易 进行 这 些 查 询 。 有 了 LINQ 
和 lambda 表达 式 ， 就 可 以 使 用 相同 的 查询 语法 来 访问 对 象 集合 、 数 据 库 和 XML 文件 。 

为 了 访问 数据 库 并 创建 LINQ 碍 询 ，LINQto SQL 发 布 为 .NET 3.5 的 一 部 分 。 在 .NET 3.5 的 第 一 个 更 新 中 ， 
发 布 了 Entity Framework 的 第 一 个 版 本 ,LINQ to SQL 和 Entity Framework 都 提供 了 从 层次 结构 到 数据 库 关 系 的 
映射 和 LINQ 提供 程序 。Entity Framework 更 强大 ,但 LINQ to SQL 更 简单 。 随 着 时 间 的 推移 ，LINQto SQL 的 
特性 在 Entity Framework 中 实现 了 ， 并 且 Entity Framework 会 一 直 保 留 这 些 特性 。Entity Framework 的 新 版 本 
Entity Framework Core (EF Core) 看 起 来 与 第 一 版 非常 不 同 。 
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另 一 种 引入 为 NET3.5 一 部 分 的 技术 是 System.Addm 名 称 空间 ， 它 提供 了 插件 模型 。 这 个 模型 提供 了 甚至 
在 过 程 外 部 运行 插件 的 强大 功能 ， 但 它 使 用 起 来 也 很 复杂 。 


注意 : 
LINQ 详 见 第 12 章 ，Entity Framework 的 最 新 版 本 与 .NET 3.5 版 本 有 很 大 差别 ， 参 见 第 26 章 。 


1.2.5 C#4 和 .NET 4.0——dynamic 和 TPL 


C#4 的 主题 是 动态 集成 脚本 语言 ， 使 其 更 容易 使 用 COM 集成 。C# 语 法 扩展 为 使 用 dynamic 关键 字 、 命 名 
参数 和 可 选 参数 ， 以 及 用 泛 型 增强 的 协 变 和 逆 变 。 

其 他 改进 在 .NET Framework 中 进行 。 有 了 多 核 CPU, 并 行 编程 就 变 得 越 来 越 重要 。 任务 并 行 库 (Task Parallel 
Library，TPL) 使 用 Task 类 和 Parallel 类 抽象 出 线程 ， 更 容易 创建 并 行 运行 的 代码 。 

因为 用 .NET 3.0 创建 的 工作 流 引 擎 没有 履行 自己 的 族 言 ， 所 以 全 新 的 Windows Workflow Foundation 成 
为 .NET 4.0 的 一 部 分 。 为 了 避免 与 旧 工 作 流 引 擎 冲突 ,新 的 工作 流 引 擎 是 在 System.Activity 名 称 空 间 中 定义 的 。 

C# 4 的 增强 还 需要 一 个 新 版 本 的 运行 库 。 运 行 库 从 版 本 2 跳 到 版 本 4。 

发 布 Visual Studio 2010 时 ， 附 带 了 一 项 创建 Web 应 用 程序 的 新 技术 : ASPNET MVC 2.0。 与 ASPNET Web 
Forms 不 同 , 该 技术 关注 于 模型 -视图 -控制 器 (MVC) 模 式 ， 该 模式 由 项 目 结构 强制 执行 。 这 项 技术 也 关注 于 编程 
HTML 和 JavaScript。HTML 和 JavaScript 通过 HTML 5 的 发 布 在 开发 者 社区 中 获得 了 巨大 的 推动 。 由 于 这 一 技 
术 非 常 新 颖 ， 而 且 是 到 Visual Studio 的 带 外 (Out Of Band，OOB)， 因 此 ASPNET MVC 是 定期 更 新 的 。 


注意 : 
C#4 的 dynamic 关键 字 参 见 第 16 章 。 任 务 并 行 库 参见 第 21 章 。ASPNET 的 新 一 代 ASP.NET Core 参见 第 
30 章 ，ASP.NET Core MVC6 参见 第 31 章 。 


1.2.6 ”CC# 5 和 异步 编程 


C#5 只 有 两 个 新 的 关键 字 : async 和 await， 然 而 ， 它 大 大 简化 了 异步 方法 的 编程 。 在 Windows 8 中 ， 触 摸 变 
得 更 加 重要 ， 不 阻塞 UI 线程 也 变 得 更 加 重要 。 用 户 使 用 鼠标 ， 习 惯 于 花 些 时 间 深 动 屏幕 。 人 然而， 在 触摸 界 面 
上 使 用 手势 时 ， 反 应 不 及 时 很 不 好 。 

Windows 8 还 为 Windows Store 应 用 程序 (也 称 为 Modern 应 用 程序 、Metro 应 用 程序 、 通用 Windows 应 用 程 
序 ， 最 近 称 为 Windows 应 用 程序 ) 引 入 了 一 个 新 的 编程 接口 : Windows 运行 库 。 这 是 一 个 本 地 运行 库 ， 看 起 来 
像 是 使 用 语言 投射 的 NET。 许 多 WPF 控件 都 为 新 的 运行 库 重 写 了 ，.NET Framework 的 一 个 子 集 可 以 使 用 这 样 
的 应 用 程序 。 

System.Addm 框架 过 于 复杂 、 缓 慢 ， 所 以 用 NET 4.5 创建 了 一 个 新 的 合成 框架 : Managed Extensibility 
Framework 和 名 称 空 间 System.Composition 。 

独立 于 平台 的 通信 的 新 版 本 是 由 ASPNET Web API 提供 的 。WCF 提供 有 状态 和 无 状态 的 服务 ， 以 及 许多 
不 同 的 网 络 协 议 ， 而 ASPNET Web API 则 简单 得 多 ， 它 是 基于 Representational State Transfer(REST) 软 件 架 构 风 
格 的 。 


注意 : 

C# 5 的 async 和 await 关键 字 在 第 15 章 中 详细 讨论 ， 其 中 也 介绍 .NET 在 不 同时 期 使 用 的 不 同 异 步 模式 。 

MEF 参见 网 上 附加 第 1 章 。Windows 应 用 程序 参见 第 33~36 章 ，Web API 和 ASPNET Core MVC 参见 第 
32 章 。 
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1.2.7 C#6 和 .NET Core 1.0 


C# 6 没有 由 泛 型 、LINQ 和 异步 带 来 的 巨大 改进 ， 但 有 许多 小 而 实用 的 语言 增强 ， 可 以 在 几 个 地 方 减少 代 
码 的 长 度 。 很 多 改进 都 通过 新 的 编译 器 引擎 Roslyn 或 .NET Compiler Platform 实现 。 

完整 的 NET Framework 并 不 是 近年 来 使 用 的 唯一 NET Framework。 有 些 场景 需要 较 小 的 框架 。2007 年 ， 发 
布 了 Microsoft Silverlight 的 第 一 个 版 本 (代码 名 为 WPF/E， 即 WPF Everywhere)。Silverlight 是 一 个 Web 浏览 器 插 
件 ， 支 持 动 态 内 容 。Silverlight 的 第 一 个 版 本 只 支持 通过 JavaScript 编程 。 第 2 个 版 本 包含 ,NET Framework 的 子 
集 。 当 然 ， 不 需要 服务 器 器 库 ， 因 为 Silverlight 总 是 在 客户 端 运行 ， 但 附带 Silverlight 的 Framework 也 删除 了 核 
心 特性 中 的 类 和 方法 ， 使 其 更 简洁 ， 便 于 移植 到 其 他 平台 。 用 于 果 面 的 Silverlight 版 本 (第 $ 版 ) 在 2011 年 12 月 
发 布 。 Silverlight 也 用 于 Windows Phone 的 编程 。 Silverlight 8.1 进入 Windows Phone 8.1, 但 这 个 版 本 的 Silverlight 
不 同 于 时 面 版 本 。 

在 Windows 果 面 上 ， 有 如 此 巨大 的 .NET 框架 ， 需 要 更 快 的 开发 节 臭 ， 也 需要 较 大 的 改进 。 在 DevOps 中 ， 
开发 人 员 和 操作 员 一 起 工作 ， 甚 至 是 同一 个 人 不 断 地 给 用 户 提 供应 用 程序 和 新 特性 ， 需 要 使 新 特性 快速 可 用 。 
由 于 框架 巨大 ， 且 有 许多 依赖 关系 ， 创 建新 的 特性 或 修复 缺陷 是 一 项 不 容易 完成 的 任务 。 

有 了 几 个 较 小 的 NET 版 本 (如 Silverlight、 用 于 Windows Phone 的 Silverlieht)， 在 .NET 的 桌面 版 本 和 较 小 
版 本 之 间 共 享 代码 就 很 重要 。 在 不 同 NET 版 本 之 间 共 享 代码 的 一 项 技术 是 可 移植 库 。 随 独 时 间 的 推移 ， 有 了 许 
多 不 同 的 NET Framework 和 版 本 ， 可 移植 库 的 管理 已 成 为 一 场 垩 梦 。 

为 了 解决 所 有 这 些 问 题 ， 需 要 .NET 的 新 版 本 (是 的 ， 的 确 需 要 解决 这 些 问 题 )。Framework 的 新 版 本 命名 
为 .NET Core。.NET Core 较 小 ， 是 开源 的 ， 带 有 模块 化 的 NuGet 包 ， 以 及 分 布 给 每 个 应 用 程序 的 运行 库 ， 不 
仅 可 用 于 Windows 的 果 面 版 ， 也 可 用 于 许多 不 同 的 Windows 设备 ， 以 及 Linux 和 OS XX。 

为 了 创建 Web 应 用 程序 ， 完 全 重 写 了 ASPNET， 得 到 了 ASPNET Core 1.0。 这 个 版 本 不 完全 问 后 兼容 老 版 
本 ， 需 要 对 现 有 的 ASPNETMVC( 和 ASPNET Core MVC) 代 码 进 行 一 些 修改 。 然 而 ， 与 旧版 本 相 比 ， 它 也 有 很 
多 优点 ， 例 如 每 一 个 网 络 请 求 的 开销 较 低 ， 性 能 更 好 ， 也 可 以 在 Linux 上 运行 。ASPNET Web Forms 不 包含 在 
这 个 版 本 中 , 因为 ASPNET Web Forms 不 是 专 为 最 佳 性 能 而 设计 的 , 它 基 于 Windows Forms 应 用 程序 开发 人 员 
熟悉 的 模式 来 提高 对 开发 人 员 的 友好 性 。 

当然 ， 并 不 是 所 有 应 用 程序 都 很 容易 改 为 使 用 NET Core。 所 以 这 个 巨大 的 框架 也 会 进行 改进 一 一 即使 这 
些 改进 的 完成 速度 没有 .NET Core 那么 快 ， 也 是 要 改进 的 。.NET Framewolk 完整 的 新 版 本 是 46。ASPNET Web 
Forms 的 小 更 新 包 在 完整 的 .NET 上 可 用 。 


注意 : 
C# 语 言 的 变化 参见 第 I 部 分 中 所 有 的 语言 章节 ， 例如， 只 读 属 性 参见 第 3 章 ，nameof 运算 符 和 空 值 传播 参 
见 第 6 章 ， 字 符 串 播 值 参见 第 9 章 ， 异 常 过 滤器 参见 第 14 章 。 


1.28 C#7 和 .NET Core 2.0 


C# 更 新 具有 更 快 的 速度 。 主 要 版 本 7.0 在 2017 年 3 月 发 布 ， 次 级 版 本 7.1 和 7.2 分 别 在 2017 年 8 月 和 12 
月 后 不 久 发 布 。 通 过 项 目 设置 可 以 选择 要 使 用 的 编译 器 版 本 。 
C#7 引 入 了 许多 新 特性 。 这 些 特性 中 最 重要 的 部 分 来 自 函 数 式 编程 ， 模式 匹 配 和 元 组 。 


注意 : 
模式 匹配 和 元 组 参见 第 13 章 。 


.NET Core 2.0 的 重点 是 更 容易 将 使 用 NET Framework 编写 的 现 有 应 用 程序 引入 NET Core。 以 前 不 能 用 
于 .NET Core、 但 仍 在 许多 .NET Framework 应 用 程序 和 库 中 使 用 的 类 型 ， 现 在 可 以 用 于 .NET Core。 在 .NET Core 
2.0 中 添加 了 两 万 多 个 API。 人 例如， 二进制 序列 化 和 DataSet 又 回来 了 ， 还 可 以 在 Linux 上 使 用 这 些 特性 。 另 一 
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个 有 助 于 将 旧 应 用 程序 引入 .NET Core 的 特性 是 Windows Compatibility Pack (Microsoft.Windows. Compatibility)。 
这 个 NuGet 包 定 义 了 用 于 WCF、 注 册 表 访问 、 加 密 、 目 录 服 务 、 绘 图 等 的 API。 当 前 状态 参见 
https://eithub.com/dotnet/deslens/blob/master/accepted/compat-pack/compat-pack.md.。 

.NET Standard 是 一 个 规范 ， 它 定义 了 在 任何 支持 该 标准 的 平台 上 应 该 使 用 哪些 API。 标 准 版 本 越 高 ， 可 用 
的 API 就 越 多 。.NET Standard 2.0 将 标准 扩展 了 两 万 多 个 API， 并 得 到 了 .NET Framework 4.6.1、.NET Core 2.0 
和 通用 Windows 平台 (Windows 应 用 程序 ) 的 支持 ， 开 始 于 构建 版 16299 (Windows 10 的 Fall Creators Update)。 


注意 : 
第 19 章 详细 介绍 了 .NET Standard。 


要 检查 应 用 程序 是 否 可 以 轻松 地 移植 到 .NET Core 中 , 可 以 使 用 .NET Portability Analyzer (.NET 可 移植 性 分 
析 器 )。 此 工具 可 以 安装 为 Visual Studio 的 扩展 。 它 会 分 析 二 进 制 文件 。 还 可 以 为 希望 获得 的 版 本 和 框架 配置 可 
移植 性 信息 ， 为 .NET Core、.NET Framework、.NET Standard、Mono、Silverlight、Windows、Xamarin 等 提供 可 
移植 性 信息 。 结 果 可 以 是 JSON、HTML 和 Excel。 

图 1-1 显示 了 在 选择 NET Framework 二 进 制 文件 后 的 总 结 报 告 , 其 中 , 该 二 进 制 文件 与 .NET Framework 100% 
兼容 ， 与 NET Core 96.67%4 兼 容 ， 与 Windows 应 用 程序 69.7% 兼 容 。 图 1-2 显示 了 有 问题 的 API 的 详细 信息 。 
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BB API Catalog last updated an Monday, Mowember 127, 2017 
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Portability Summary Details 


图 1-2 


1.2.9 选择 技术 ， 继 续 前 进 


知道 框架 内 技术 相互 竞争 的 原因 后 , 就 更 容易 选择 用 于 编写 应 用 程序 的 技术 。 例如 , 如 果 创 建新 的 Windows 
应 用 程序 , 使 用 Windows Forms 就 不 是 好 的 解决 方案 , 而 应 该 使 用 基于 XAML 的 技术 , 例如 Universal Windows 
Platform (UWP)。 当 然 ， 使 用 其 他 技术 仍然 有 很 好 的 理由 。 需 要 支持 Windows 7 客户 端 吗 ? 在 这 种 情况 下 ，UWP 
不 合适 ， 但 WPF 合适 。 仍 然 可 以 以 一 种 易于 切换 到 其 他 技术 的 方式 创建 WPF 应 用 程序 ， 例 如 UWP 和 Xamarin。 
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注意 : 
请 阅读 第 34 章 ， 了 解 如 何 设 计 应 用 程序 ， 以 便 在 WPF、UWP 和 Xamarin 之 间 共 享 尽 可 能 多 的 代码 。 


如 果 创 建 Web 应 用 程序 , 肯定 应 使 用 ASPNET Core 与 ASPNET Core MVC。 做 这 个 选择 时 要 排除 ASPNET 
Web Forms。 如 果 访 问 数据 库 ， 就 应 该 使 用 Entity Framework Core， 应 该 选择 Managed Extensibility Framework 
而 不 是 System.AddIn。 

旧 应 用 程序 仍 在 使 用 Windows Forms、ASPNET Web Forms 和 其 他 一 些 旧 技术 。 只 为 改变 现 有 的 应 用 程序 
而 使 用 新 技术 是 没有 意义 的 。 进 行 修改 必须 有 巨大 的 优势 ， 例 如 ， 维 护 代码 已 经 是 一 个 疆 梦 ， 需 要 大 量 的 重 构 
以 缩短 客户 要 求 的 发 布 周 期 ， 或 者 使 用 一 项 新 技术 可 以 减少 更 新 包 的 编码 时 间 。 根 据 旧 有 应 用 程序 的 类 型 ， 使 
用 新 技术 可 能 不 值得 。 可 以 允许 应 用 程序 仍 使 用 旧 技 术 ， 因 为 在 未 来 的 许多 年 仍 将 支持 Windows Forms 和 
ASPNET Web Forms。 

本 书 的 内 容 以 新 技术 为 基础 ， 展 示 创 建新 应 用 程序 的 最 佳 技 术 。 如 果 仍 然 需要 维护 旧 应 用 程序 ， 可 以 参考 

《C# 高 级 编程 (第 10 版 ) C#6 & .ENT Core 1.0》， 其 中 介绍 了 ASPNET Web Forms、WCF、Windows Forms、 
System.AddIm、Waorkflow Foundation 和 其 他 仍然 在 NET Framework 中 可 用 的 旧 技 术 。 


1.3 .NET 术语 


什么 是 当前 的 NET 技术 ? 图 1-3 给 出 了 NET Framework、.NET Core 和 Mono 相互 关联 的 总 体 情况 。 所 有 
的 .NET Framework 应 用 程序 、NET Core 应 用 程序 和 Xamarin 应 用 程序 如 果 是 用 NET Standard 构建 的 ， 就 都 可 
以 使 用 相同 的 库 。 这 些 技术 共享 相同 的 编译 器 平台 、 编 程 语 言 和 运行 库 组 件 。 它 们 不 共享 相同 的 运行 库 ， 但 是 
它们 在 运行 时 共享 组 件 。 例 如 ，.NET Framework 和 .NET Core 使 用 即时 (JIT) 编 译 器 RyuJIT。 

使 用 NET Framework， 可 以 创建 Windows Forms、WPF 和 在 Windows 上 运行 的 旧 ASPNET 应 用 程序 。 

使 用 NET Core， 可 以 创建 在 不 同 平台 上 运行 的 ASPNET Core 和 控制 台 应 用 程序 。.NET Core 也 由 通用 
Windows 平台 (UWP) 使 用 ， 但 这 并 不 能 使 UWP 在 Linux 上 可 用 。UWP 还 利用 了 Windows 运行 库 ， 它 只 能 在 
Windows 上 使 用 。 

Xamarin 提供 了 Xamarin.IoSs 和 Xamarin.Android 库 ， 它 们 可 以 为 iPhone 和 Android 开发 C# 应 用 程序 。 有 
了 Xamarin.Forms， 就 可 以 在 两 个 移动 平台 之 间 共 享用 户 界 面 。Xamarin 目前 仍然 基于 Mono 框架 ，Mono 框架 
是 由 Xamarin 开发 的 .NET 变 体 。 在 某 种 程度 上 ， 这 可 能 会 变 为 NET Core。 然 而 ， 重 要 的 是 所 有 这 些 技术 都 可 
以 使 用 为 .NET 标准 创建 的 相同 的 库 。 


wamarin.Forms 


ASPNET 


i UWP 
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在 图 1-3 的 下 半 部 分 ， 可 以 看 到 NET Framewolk、.NET Core 和 Mono 之 间 也 有 一 些 共 享 。 运 行 库 组 件 的 代 
码 是 共享 的 ， 例 如 垃圾 收集 器 和 RyuJIT( 这 是 一 个 新 的 JIT 编译 器 ， 可 以 将 工 代码 编译 为 本 地 代码 )。 垃 圾 收集 
器 由 CLR、CoreCLR 和 .NET Native 使 用 。CLR 和 CoreCLR 使 用 RyuJIT 即时 编译 器 。 所 有 这 些 平台 都 使 用 .NET 
Compiler Platform( 也 称 为 Roslyn) 和 编程 语言 。 


1.3.1 .NET Framework 


.NET Framework 4.7 是 .NET Framework 在 过 去 15 年 不 断 增 强 的 结果 。1.2 节 讨 论 的 许多 技术 都 基于 这 个 框 
架 。 这 个 框架 用 于 创建 Windows Forms 和 WPF 应 用 程序 。.NET Framework 4.7 还 提供 了 Windows Forms 的 增 
强 功 能 ， 比 如 对 High DPI 的 支持 。 

如 果 希 望 继续 使 用 ASPNET Web Forms， 就 应 选择 ASPNET 4.7 和 .NET Framework 4.7。 否 则 ， 就 需要 重 
写 一 些 代 码 ， 以 移动 到 NET Core。 根 据 源 代码 的 质量 和 添加 新 特性 的 需要 ， 重 写 代 码 可 能 是 值得 的 。 


1.3.2 .NET Core 


NET Core 是 新 的 NET， 所 有 新 技术 都 使 用 它 ， 是 本 书 的 一 大 关注 点 。 这 个 框架 是 开源 的 ， 可 以 在 
http://www.github.comy/dotmet 上 找到 它 。 运 行 库 是 CoreCLR 库 ; 包含 集合 类 的 框架 、 文 件 系统 访问 、 控 制 台 和 
XML 等 都 在 CoreFX 库 中 。 

.NET Framework 要 求 必须 在 系统 上 安装 应 用 程序 需要 的 特定 版 本 ， 而 在 .NET Core 1.0 中 ， 框 架 (包括 运行 
库 ) 是 与 应 用 程序 一 起 交付 的 。 以 前 ， 把 ASPNET Web 应 用 程序 部 署 到 共享 服务 器 上 有 时 可 能 有 问题 ， 因 为 提 
供 程序 安装 了 旧版 本 的 .NET。 这 种 情况 已 经 一 去 不 复 返 了 。 现 在 可 以 同时 提交 应 用 程序 和 运行 库 ， 而 不 依赖 服 
务 器 上 安装 的 版 本 。 

.NET Core 以 模块 化 的 方式 设计 。 该 框架 分 成 数量 很 多 的 NuGet 包 。 这 样 就 不 必 处 理 所 有 的 包 了 ， 而 可 以 用 
元 包 来 引用 一 起 工作 的 小 包 。 使 用 NET Core 2.0 和 ASPNET Core 2.0, 甚至 可 以 改进 元 包 。 通 过 ASPNET Core 2.0， 
只 需要 引用 Microsoft.AspNetCore.All， 就 可 以 得 到 ASPNET Core web 应 用 程序 通常 需要 的 所 有 包 。 

.NET Core 可 以 很 快 更 新 。 即 使 更 新 运行 库 ， 也 不 影响 现 有 的 应 用 程序 ， 因 为 运行 库 与 应 用 程序 一 起 安装 。 
现在 ， 微 软 公 司 可 以 增强 NET Core， 包 括 运行 库 ， 发 布 周期 更 短 。 


注意 : 
为 了 使 用 .NET Core 开发 应 用 程序 ， 微 软 公司 创建 了 新 的 命令 行 实 用 程序 .NET Core Command Line (CLD。 
这 些 工 具 参 见 本 章 后 面 的 内 容 。 


1.3.3 .NET Standard 


.NET Standard 不 是 一 个 实现 , 而 是 一 个 协定 。 本 协定 规定 了 需要 实现 哪些 API。NET Framework、 .NET Core 
和 Xamarin 实现 了 这 个 标准 。 

标准 是 有 版 本 的 。 在 每 个 版 本 中 都 添加 了 额外 的 API。 根 据 需要 的 API， 可 以 选择 库 的 标准 版 本 。 需 要 检 
得 所 选 平台 是 否 符合 所 需 版 本 的 标准 。 

可 以 在 https:/docs.microsoft.comyen-us/dotnet/standardmet-standard 中 找到 .NET Standard 的 平台 支持 表 。 以 下 
是 需要 了 解 的 最 重要 的 部 分 : 

e .NET Core 1.1 支持 .NET Standard 1.6，.NET Core 2.0 支持 .NET Standard 2.0 

e .NET Framework 4.6.1 支持 NET Standard 2.0。 

s。 UWP 构建 了 16299， 后 来 支持 .NET Standard 2.0; 旧版 本 只 支持 .NET Standard 1.4。 

e 通过 Xamarin 使 用 NET Standard 2.0， 需 要 Xamarin.iOS 10.14 和 Xamarin.Android 8.0。 


注意 : 
请 阅读 第 19 章 中 关于 NET Standard 的 详细 信息 . 
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1.3.4 NuGet 包 


在 早期 ， 程 序 集 是 应 用 程序 的 可 重用 单元 。 添 加 对 程序 集 的 一 个 引用 ， 以 使 用 上 自己 代码 中 的 公共 类 型 和 方 
法 ， 此 时 ， 仍 可 以 这 样 使 用 (一 些 程序 集 必须 这 样 使 用 )。 然 而 ， 使 用 库 可 能 不 仪 意味 着 添加 一 个 引用 并 使 用 它 。 
使 用 库 也 意味 着 一 些 配 置 更 改 , 或 者 可 以 通过 脚本 来 利用 一 些 特性 . 这 是 在 NuGet 包 中 打包 程序 集 的 一 个 原因 。 

NuGet 包 是 一 个 zip 文件 ， 其 中 包含 程序 集 (或 多 个 程序 集 )、 配 置信 息 和 PowerShell 脚本 。 

使 用 NuGet 包 的 男 一 个 原因 是 ， 它 们 很 容易 找到 ， 它 们 不 仅 可 以 从 微软 公司 找到 ， 也 可 以 从 第 三 方 找到 。 
NuGet 包 很 容易 在 NuGet 服务 器 http://www.nuget.ore 上 获得 。 

在 Visual Studio 项 目的 引用 中 ,可 以 打开 NuGet 包 管 理 器 (NuGet Package Manager， 见 图 1-4)， 在 该 管理 器 
中 可 以 搜索 包 ， 并 将 其 添加 到 应 用 程序 中 。 这 个 工具 允许 搜索 还 没有 发 布 的 包 ( 包 括 预 发 布 选 项 )， 定 义 应 该 在 
哪个 NuGet 服务 器 中 搜索 包 。 搜 索 包 的 一 个 地 方 是 自己 的 共享 目录 ， 其 中 放置 了 内 部 使 用 的 包 。 


Updates NuGet Package Manager VSHelloWorld 
| | | includs Prerslease Package SO0UrCE: Mget.org 本 嫌 


he 


~ NewtonsoftJson ® 


Newtonsoft.Json © by James Newton-King, 103M downloads 


Json.NET rs a popular hgh-performance JSON framework for .NET 
Wervion: Latest stable 10.0.3 = Install 


NUnit 避 by Charies Poole, Rob Prouse, 15.9M downloads 
NUnit is a unit-testing framemerk Far all .MET langusges with a strong TOD fepeus By Optiens 


EntityFramework ® by Microsoft, 37.7M downloads G2 Descriptien 
Entity Framework is Microsolt's recommended data sccess technology for new applications, Json.NET is a popular high-perfermance JSON framewok for .MET 


Werslon: 10.0.3 
jQuery by jQuery Foundation, Ine, 42.7M downloads Author(s): james Newton-King 
Incompatible: Use Bower instead 

Liee 后 htes: Firavw ethub com/larresNR /Newtonsoft lson/ 
jQuery is a new kind of Jeveascript Library Ne wp pt 人 Un 2 
| Frasther/LiCENSE. rd 
HtmlAgilityPack by 2Z22 Projects,Simen Mourier Jeff Klaviter Stephan Grall, 5.BAM da Date published: Sunday June 19, 2017 (GMa/201n) 
This is an agils HIML parser that Duilds a read/writs DOM and suppearts plain MAPAIH or Preject URL: https /vey .newtonsoftl.com/son 


SLT [you actually don't HAVE te understand 其 PATH nor XSLT to use i don't yormy..). lt is., Neport Abuse https/Mwww.nugetong/packages/Newtonsoft json/10.0.3/ 
ReportAbuse 

Dapper by Sam saffron Marec Gravell Nick Craver, 5.25M downloads 
Taas: jan 
A nigh Gorterrmames Micro-ORM suppertina SL Server, hyoL, Salite, SalcE, Firebird ste, 9 I 
Esch package ts licensed to you by its owner. Miet is not responsible for, ror does it grant arvy licenses to, Dependencies 
third -Party packages 

,NETFramewark, Verstion=Vvd.5 


L_ Do not show this again No dependeneres 


图 1-4 


注意 : 

使 用 NuGet 服务 器 中 的 第 三 方 包 时 ， 如 果 一 个 包 以 后 才能 使 用 ， 就 总 是 有 风险 。 还 需要 检查 包 的 支持 可 用 
性 。 使 用 包 之 前 ， 总 要 检查 项 目的 链接 信息 。 对 于 包 的 来 源 ， 可 以 选择 Microsoft and .NET， 只 获得 微软 公司 支 
持 的 包 。 第 三 方 包 也 包括 在 Microsoft and .NET 部 分 中 ， 但 它们 是 微软 公司 支持 的 第 三 方 包 。 


注意 : 
NuGet 包 管 理 器 的 更 多 信息 参见 第 18 章 。 


1.3.5 ”名 称 空间 
可 用 于 .NET 的 类 组 织 在 名 称 以 System 开头 的 名 称 空间 中 。 表 1-3 描述 的 名 称 空间 提供 了 层次 结构 的 思路 。 
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表 1-3 
名 称 空间 说 明 
System.Collections 这 是 集合 的 根 名 称 空间 。 了 于 名 称 空间 也 包含 集合 ， 如 System.Collections.Concurrent 和 System.Collections. Generic 
System.Data 这 是 访问 数据 库 的 名 称 空间 。System.Data.SqlClient 包含 访问 SQL Server 的 类 


System.Diagnostics 这 是 诊断 信息 的 根 名 称 空间 ， 如 事件 记录 和 跟踪 (在 System.Diagnostics.Tracing 名 称 空间 中 ) 
System.Globalization | 该 名 称 空间 包含 的 类 用 于 全 球 化 和 本 地 化 应 用 程序 


System.IO 这 是 文件 IO 的 名 称 空间 ， 其 中 的 类 访问 文件 和 目录 ， 包 括 读 取 器 、 写 入 器 和 流 
System.Net 这 是 核心 网 络 的 名 称 空间 ， 比 如 访问 DNS 服务 器 ， 用 System.Net.Sockets 创建 套 接 字 


System.Threading 这 是 线程 和 任务 的 根 名 称 空间 。 任 务 在 System.Threading.Tasks 中 定义 


注意 : 
一 些 新 的 .NET 类 使 用 名 称 以 Microsoft 开头 而 不 是 以 System 开头 的 名 称 空间 ， 比 如 用 于 Entity Framework Core 
的 Microsoft EntityFrameworkCore， 用 于 新 的 依赖 关系 注入 框架 的 Microsoft.Extensions.DependencyInjection 。 


1.3.6 公共 语言 运行 库 


UWP 利用 Native .NET 通过 AOT Compiler 把 工 编译 成 本 地 代码 。 这 与 Xamarin.iOS 类 似 。 在 所 有 其 他 场 
景 中 ， 使 用 NET Framework 的 应 用 程序 和 使 用 NET Core 1.0 的 应 用 程序 都 需要 CLR(Common Language 
Runtime， 公 共 语 言 运 行 库 )。 然 而 ，.NET Core 使 用 CoreCLR， 而 NET Framework 使 用 CLR。 那 么 ，CLR 的 作 
用 是 什么 ? 

在 CLR 执行 应 用 程序 之 前 ， 编 写 好 的 源 代码 (使 用 C# 或 其 他 语言 编写 的 代码 ) 都 需要 编译 。 在 .NET 中 ， 编 
译 分 为 两 个 阶段 : 

(1) 将 源 代码 编译 为 Microsoft 中 间 语 言 (Intermediate Language，IL)。 

(2) CLR 把 十 编译 为 平台 专用 的 本 地 代码 。 

I 代码 在 .NET 程序 集中 可 用 。 在 运行 时 ，JIT 编译 器 编译 工 代码 ， 创 建 特定 于 平台 的 本 地 代码 。 

新 的 CLR 和 CoreCLR 包括 一 个 新 的 JIT 编译 器 RyuJIT。 新 的 JIT 编译 器 不 仅 比 以 前 的 版 本 快 ,还 在 用 Visual 
Studio 调试 时 更 好 地 支持 Edit & Continue 特性 。Edit & Continue 特性 允许 在 调试 时 编辑 代码 ， 可 以 继续 调试 会 
话 ， 而 不 需要 停止 并 重新 启动 过 程 。 

CLR 还 包括 一 个 珊 有 类 型 加 载 器 的 类 型 系统 ， 类 型 加 载 器 负责 从 程序 集中 加 载 类 型 。 类 型 系统 中 的 安全 基 
础 设施 验证 是 否 允 许 使 用 某 些 类 型 系统 结构 ， 如 继承 。 

创建 类 型 的 实例 后 ， 实 例 还 需要 销毁 ， 内 存 也 需要 回收 。CLR 的 另 一 个 功能 是 垃圾 收集 器 。 垃 圾 收集 器 从 
托管 堆 中 清除 不 再 引用 的 内 存 。 

CLR 还 负责 线程 的 处 理 。 在 C# 中 创建 托管 的 线程 不 一 定 来 目 底 层 操 作 系统 。 线 程 的 虚拟 化 和 管理 由 CLR 
负责 。 


注意 : 

如 何在 C# 中 创建 和 管理 线程 参见 第 21 章 和 22 章 。 第 17 章 介 绍 了 垃圾 收集 器 和 清理 内 存 的 方法 。 
1.3.7 ”Windows 运行 库 

从 Windows 8 开始 ，Windows 操作 系统 提供 了 男 一 种 框架 : Windows 运行 库 (Windows Runtime)。 这 个 运 
行 库 由 WUP(Windows Universal Platform，Windows 通用 平台 ) 使 用 ，Windows 8 使 用 第 1 版 ，Windows 8.1 使 用 


第 2 版 ，Windows 10 使 用 第 3 版 。 
与 NET Framework 不 同 ， 这 个 框架 是 使 用 本 地 代码 创建 的 。 当 它 用 于 NET 应 用 程序 时 ， 所 包含 的 类 型 
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和 .NET 类 似 。 在 语言 投射 的 帮助 下 ，Windows 运行 库 可 以 用 于 JavaScript、C++ 和 .NET 语言 ， 它 看 起 来 像 编程 

环境 的 本 地 代码 。 不 仅 方法 因 区 分 大 小 写 而 行为 不 同 ， 方 法 和 类 型 也 可 以 根据 所 处 的 位 置 有 不 同 的 名 称 。 
Windows 运行 库 提供 了 一 个 对 象 层次 结构 , 它 在 以 Windows 开头 的 名 称 空间 中 组 织 。 这 些 类 没有 复制 NET 

Framework 的 很 多 功能 ， 相 反 ， 提 供 了 额外 的 功能 ， 用 于 在 UWP 上 运行 的 应 用 程序 。 如 表 1-4 所 示 。 


表 1-4 
名 称 空 间 说 有 明 
Windows. 这 个 名 称 空间 及 其 子 名 称 空间 (如 Windows.ApplicationModel.Contracts) 定 义 了 类 , 用 于 管理 应 用 程序 的 生 
ApplicationModel 命 周 期 ， 与 其 他 应 用 程序 通信 
Windows.Data Windows.Data 定义 了 子 名 称 空间 ， 来 处 理 文 本 、JSON、PDF 和 XML 数据 


Windows.Devices 地 理 位 置 、 智 能 卡 、 服 务 设备 点 、 打 印 机 、 扫 描 仪 等 设备 可 以 用 Windows.Devices 子 名 称 空间 访问 
Windows.Foundation Windows.Foundation 定义 了 核心 功能 。 集 合 的 接口 用 名 称 空间 Windows.Foundation.Collections 定义 。 这 
里 没有 具体 的 集合 类 。 相 反 ，.NET 集合 类 型 的 接口 映射 到 Windows 运行 库 类 型 


Windows.Media Windows.Media 是 播放 、 捕 获 视频 和 音频 、 访 问 播放 列表 和 语音 输出 的 根 名 称 空 间 
Windows.Networking | 这 是 套 接 字 编 程 、 数 据 后 台 传 输 和 推送 通知 的 根 名 称 空间 
Windows.Security Windows.Security.Credentials 中 的 类 提供 了 密码 的 安全 存储 区 ，Windows.Security.Credentials.UI 提供 了 一 


个 选择 器 ， 用 于 从 用 户 处 获得 凭据 
Windows.Services. 这 个 名 称 空间 包含 用 于 定位 服务 和 路 由 的 类 


Maps 
Windows.Storage 有 了 Windows.Storage 及 其 子 名 称 空间 ， 就 可 以 访问 文件 和 目录 ， 使 用 流 和 压缩 
Windows.System Windows.System 名 称 空间 及 其 子 名 称 空间 提供 了 系统 和 用 户 的 信息 , 也 提供 了 一 个 启动 其 他 应 用 程序 的 


局 动 器 
Windows.UIXaml 在 这 个 名 称 空 间 中 ， 可 以 找到 很 多 用 于 用 户 界 面 的 类 型 


1.4 用 .NET Core CLI 编译 


在 本 书 的 许多 章节 中 并 不 需要 Visual Studio， 而 可 以 使 用 任何 编辑 器 和 命令 行 。 要 创建 和 编译 应 用 程序 ， 
可 以 使 用 .NET Core 命令 行 接口 (Command Line Interface，CLD。 下 面 看 看 如 何 设置 系统 ， 以 及 如 何 使 用 这 个 
工具 。 


1.4.1 设置 环境 


安装 了 Visual Studio 2017 和 最 新 的 更 新 包 后 ， 就 可 以 立即 启动 CLI 工具 。 可 以 在 没有 Visual Studio 2017 的 
情况 下 建立 一 个 系统 ， 还 可 以 在 Linux 和 OS X 上 使 用 大 部 分 示例 。 为 了 下 载 环 境 的 应 用 程序 ， 只 需要 访问 
https://dot.net 并 单 击 Get Started 按钮 。 从 这 里 ， 可 以 下 载 Windows、Linux 和 macOs 的 .NET SDK。 

对 于 Windows， 可 以 下 载 安装 SDK 的 可 执行 文件 。 使 用 Linux， 需 要 选择 Linux 发 行 版 来 获得 相应 的 命令 : 

e 通过 Red Hat 和 CentOS， 使 用 yum 安装 .NET SDK 

se 通过 Ubuntu 和 Debian， 使 用 apt-get 

e 通过 Fedora， 使 用 dnfinstall 

e 通过 SLES/openSUSE， 使 用 zipper install 
要 在 Mac 上 安装 NET SDK， 可 以 下 载 .pksg 文件 。 

在 Windows 上 ， 不 同 版 本 的 .NET Core 运行 库 以 及 NuGet 包 安 装 在 用 户 配置 文件 中 。 使 用 .NET 时 ， 这 个 
文件 夹 的 大 小 会 增加 。 随 着 时 间 的 推移 ， 会 创建 多 个 项 目 ，NuGet 包 不 再 存储 在 项 目 中 ， 而 是 存储 在 这 个 用 户 
专用 的 文件 夹 中 。 这 样 做 的 优势 在 于 ， 不 需要 为 每 个 不 同 的 项 目下 载 NuGet 包 。 这 个 NuGet 包 下 载 后 ， 它 就 在 
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系统 上 。 因 为 不 同 版 本 的 NuGet 包 和 运行 库 都 是 可 用 的 ， 所 有 的 不 同 版 本 都 存储 在 这 个 文件 夹 中 。 不 时 地 检查 
这 个 文件 夹 ， 删 除 不 再 需要 的 旧版 本 ， 可 能 很 有 趣 。 

安装 .NET Core CLI 工具 ， 要 把 domet 工具 作为 入 口 点 来 局 动 所 有 这 些 工 具 。 只 需要 启动 : 

> dotnet -help 

会 看 到 ，dotnet 工具 的 所 有 不 同 选项 都 可 用 。 许 多 选项 都 有 简化 符号 。 要 获得 帮助 ， 可 以 输入 : 


> dotnet —h 


1.4.2 创建 应 用 程序 
dotnet 工具 提供 了 一 种 简单 的 方法 创建 “Hello World!” 应 用 程序 。 输 入 如 下 命令 : 
> dotnet new console --output HelloWorld 
这 个 命令 创建 一 个 新 的 HelloWorld 目录 并 添加 源 代 码 文件 Program.cs 和 项 目 文件 HelloWorld.csproj。 
从 NET Core 2.0 开始 ， 这 个 命令 还 包括 dotmet restore， 所 有 的 NuGet 包 都 会 下 载 。 要 查看 应 用 程序 使 用 的 库 的 
依赖 项 和 版 本 列表 ， 可 以 检查 obj 子 目 录 中 的 文件 project.assets. json。 如 果 不 使 用 选项 --output (或 -o 速记 符号 )， 
文件 就 在 当前 目录 中 生成 。 
生成 的 源 代码 如 下 所 示 ( 代 码 文 件 HelloWorld/Program.cs): 
using System; 
namespace HelloWorld 
/ Class Program 
static void Main(string[] args) 
, Console .WriteLine ("Hello World!™).; 


} 
} 


} 
自从 20 世纪 70 年 代 Brian Kernighan 和 Dennis Ritchie 撰写 了 《C 编程 语言 》 一 书 ， 使 用 “Hello World” 
应 用 程序 开始 ， 学 习 编 程 语言 就 变 成 一 种 传统 。 使 用 NET Core CLI， 这 个 程序 会 自动 生成 。 
下 面 看 看 这 个 程序 的 语法 。Main0 方 法 是 .NET 应 用 程序 的 入 口 点 。CLR 在 局 动 时 调用 静态 Main0 方 法 。 
Main0 方 法 需要 放 到 一 个 类 中 。 这 里 ， 这 个 类 命名 为 Program， 但 是 可 以 给 它 指 定 任何 名 称 。 
Console.WriteLine 调用 Console 类 的 WriteLine0) 方 法 。Console 类 在 System 名 称 空 间 中 。 不 需要 编写 
System.Console.WriiteLine 调用 该 方法 ; System 名 称 空间 在 源 文件 的 顶部 使 用 using 声明 打开 。 
在 编写 源 代 码 之 后 ， 需 要 编译 代码 来 运行 它 。 
创建 的 项 目 配置 文件 名 为 HelloWorld.csproj。 与 较 老 版 本 的 csproj 文件 相 比 ， 新 项 目 文件 减少 为 几 行 ， 有 
几 个 默认 值 : 
<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup» 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 
</Project> 
对 于 项 目 文件 ，OutputType 定义 了 输出 的 类 型 。 对 于 控制 台 应 用 程序 ， 该 类 型 是 Exe。TargetFramework 指 
定 了 用 于 构建 应 用 程序 的 框架 和 版 本 。 在 样 例 项 目 中 ， 应 用 程序 是 使 用 .NET Core 2.0 构建 的 。 可 以 将 此 元 素 更 
改 为 TargetFramework， 并 指定 多 个 框架 ， 如 netcoreapp2.0。net47 用 于 为 .NET Framework 4.7 和 .NET Core 2.0 
构建 应 用 程序 (项 目 文件 HelloWorld/HelloWorld.csproj): 
<Project Sdk="Microsoft .NET.Sdk"> 
<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFrameworks>netcoreapp2.0;net471</TargetFrameworks> 


</PropertyGroup> 
</Project> 
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sdk 属性 指定 项 目 使 用 的 SDK。 微 软 有 两 个 主要 的 SDK: Microsoft.NET.Sdk 用 于 控制 台 应 用 程序 ， 
Microsoft.NET.Sdk.Web 用 于 ASPNET Core web 应 用 程序 。 

不 需要 同 项 目 添加 源 文件 。 在 编译 时 ， 会 目 动 添加 同一 目录 和 子 目 录 下 扩展 名 为 cs 的 文件 。 扩 展 名 为 resx 
的 资源 文件 是 自动 添加 的 ， 用 于 藤 入 资源 。 可 以 更 改 默认 行为 ， 并 显 式 排除 /包含 文件 。 

也 不 需要 添加 NET Core 包 。 通 过 指定 目标 框架 netcoreapp2.0, 引用 许多 其 他 包 的 元 包 MicrosoftNetCore .App 
会 自动 包含 在 内 。 


1.4.3 构建 应 用 程序 


要 构建 应 用 程序 ， 需 要 将 当前 目录 更 改 为 应 用 程序 的 目录 ， 并 局 动 dotnet build。 为 .NET Core 2.0 和 .NET 
Framework 4.7 编译 时 ， 输 出 如 下 : 


> dotnet build 
Microsoft (R) Build Engine version 15.5.179.9764 for .NET Core 
COopPyright (C) Microsoft Corporation. All rights reserved. 


Restore completed in 19.8 ms for 
C:\procsharp\Intro\HelloWorld\HelloWorld .cspro]j. 
HelloWorld -> C:\procsharp\Intro\HelloWorld\bin\Debug\net47\HelloWorld .exe 
HelloWorld -> 
C:\procsharp\Intro\HelloWorld\bin\Debug\netcoreapp2.0\HelloWorld.d1ll 
Build succeeded. 
0 Warning(s) 
0 Errort{(s) 


Time Elapsed 00:00:01.58 


注意 : 
命令 dotnet new 和 dotnet build 现在 包括 恢复 NuGet 包 。 使 用 dotnet restore 还 可 以 显 式 地 恢复 NuGet 包 。 


编译 过 程 的 结果 是 在 bin/debug/[netcoreapp2.0lnet47] 文 件 夹 中 的 程序 集 包含 Program 类 的 工 代码 。 如 果 比 
较 .NET Core 与 .NET 4.7 的 构建 结果 , 会 发 现 一 个 包含 了 芽 代码 和 .NET Core 的 DLL， 以 及 一 个 包含 了 十 代码 
和 .NET 4.7 的 EXE。 为 NET Core 生成 的 程序 集 有 一 个 对 System.Console 程序 集 的 依赖 项 ， 而 .NET 4.6 程序 集 
在 mscorlib 程序 集中 找到 Console 类 。 

要 构建 发 布 代码 ， 就 需要 指定 选项 --configuration Release (简写 为 -c Release): 

> dotnet build --configuration Release 

以 下 章节 中 的 一 些 代码 示例 使 用 了 C# 7.1 或 C#7.2 提供 的 功能 。 默 认 情 况 下 ， 使 用 编译 器 的 最 新 主 版 本 ， 
即 C# 7.0。 要 局 用 新 版 本 的 C#， 需 要 在 项 目 文件 中 指定 这 一 点 ， 如 下 面 的 项 目 文件 部 分 所 示 。 这 里 ， 配 置 了 
C# 编 译 器 的 最 新 版 本 。 

<PropertyGroup> 


<LangVersion>latest</LangVersion> 
</PropertyGroup> 


1.4.4 运行 应 用 程序 
要 运行 应 用 程序 ， 可 以 使 用 domet run 命令 。 


> dotnet run 
如 果 项 目 文 件 面 向 多 个 框架 ， 就 需要 通过 --framework 选项 告诉 dotnet run 命令 ， 使 用 哪个 框架 来 运行 应 用 
程序 。 这 个 框架 必须 通过 csproj 文件 来 配置 。 使 用 样 例 应 用 程序 ， 可 以 在 恢复 信息 之 后 得 到 如 下 输出 : 


> dotnet run -framework netcooreapp2.0 
Microsoft (R) Build Engine version 15.5.179.9764 for .NET Core 
Copyright (C) Microsoft Corporation. All rights reserved. 


Restore completed in 20.65 ms for 
C:\procsharp\Intro\HelloWorld\HelloWorld.cspro]. 


第 1 章 .NET 应 用 程序 和 工具 | 17 


Hello World! 
在 生产 系统 中 ， 不 使 用 domet run 运行 应 用 程序 ， 而 可 以 使 用 dotnet 和 库 的 名 称 : 
> dotnet bin/debug/netcoreapp2.0/HelloWorld.d1l1 


还 可 以 创建 可 执行 文件 ， 但 可 执行 文件 是 特定 于 平台 的 。 


注意 : 

前 面 是 在 Windows 上 构建 和 运行 “Hello World!” 应 用 程序 ， 而 dotnet 工具 在 Linux 和 OSX 上 的 工作 方式 
是 相同 的 。 可 以 在 这 两 个 平台 上 使 用 相同 的 dotnet 命令 。 

本 书 的 重点 是 Windows， 因 为 Visual Studio 2017 提供 了 一 个 比 其 他 平台 更 强大 的 开发 平台 , 但 本 书 的 许多 
代码 示例 是 基于 .NET Core 的 ， 所 以 也 能 够 在 其 他 平台 上 运行 。 还 可 以 使 用 Visual Studio Code( 一 个 免费 的 开发 
环境 )， 直 接 在 Linux 和 OS 义 上 开发 应 用 程序 ， 参 见 1.7 节 ， 了 解 Visual Studio 不 同 版 本 的 更 多 信息 。 


1.4.5 创建 Web 应 用 程序 
还 可 以 使 用 NET Core CLI 创建 Web 应 用 程序 。 启动 domet new 时 , 可 以 看 到 可 用 的 模板 列表 (参见 图 1-5)。 


Developer Command Prompt for VS 2017 


慰 趟 末 上 时 上 贡 旨 
dk jE Lk j jk 


1 | 1 
性 旨 
有 RE 


诗 此 


Omi 
扬 前 

| 国生 

by 

| 一 上 

下 Ys 

ED 

[各 jf 

NT 


和 
= 一] js 
十 


下 面 的 命令 

> dotnet new mvc -o WebApp 
会 使 用 ASPNET Core MVC 创建 新 的 ASPNET Core web 应 用 程序 。 切 换 到 WebApp 文件 夹 之 后 ， 使 用 下 述 命 
令 构建 和 运行 程序 : 


> dotnet build 
> dotnet run 


运行 上 述 代 码 会 局 动 ASP.NET Core 的 Kestrel 服务 器 ， 来 监听 端口 5000。 可 以 打开 浏览 器 访问 从 这 个 服务 
器 返回 的 页 面 ， 如 图 1-6 所 示 。 


1.4.6 ”发布 应 用 程序 


使 用 domet 工具 , 可 以 创建 一 个 NuGet 包 并 发 布 应 用 程序 来 进行 部 署 。 首先 创建 应 用 程序 的 框架 依赖 部 署 。 
这 减少 了 发 布 所 需 的 文件 。 
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而 与 Homepage -Webapp x [RS TDS 


二 一 人 OD localhost:5000/ 


ASP.NET Core | Windows Linux OSX 


Leam how to build ASP.NET apps that can run anywhere. 


Learn More 


蛋品 口 品 


Application How to Overview Run & Deploy 


LSeSsS = Add a Controller and View * Concepiual overview of a Run your app 
- Manage User Secrets what ls ASP.NET Core - Run tools such as EF 
using Secret Manager 二 Fundamentals of ASP.NET migrations and more 
-Use logging to log a Core such as 全 四 up and = Publish to Microsofl Azure 
message middleware Web Apps 
: Ard packages using - Working with Data 
NuGet. = SECUTity 
* Target development, " Client side development 
staging or production * Develop on diffenent 
enwironrment platiorms 


图 1-6 


* Sample pages Using 
ASP,NET Core MVC 
* Theming using Bootstrap 


> dotnet publish -f netcoreapp2.0 -cc Release 

发 布 所 需 的 文件 放 在 bin/Release/netcoreapp2.0/publish 目录 中 。 

在 目标 系统 上 使 用 这 些 文件 进行 发 布 ， 也 需要 运行 库 。 在 https://www.microsoft.com/net/download/ 上 可 以 找 
到 运行 库 的 下 载 和 安装 说 明 。 

在 .NET Framework 中 ， 相 同 的 安装 运行 库 可 以 由 不 同 的 .NET Framework 版 本 使 用 (例如 ，.NET Framework 
4.0 运行 库 和 更 新 包 可 以 在 .NET Framework 4.7、4.6、4.5、4.0 等 应 用 程序 中 使 用 )， 与 .NET Framework 相反 ， 
对 于 .NET Core， 要 运行 应 用 程序 ， 就 需要 相同 的 运行 库 版 本 。 


注意 : 
如 果 应 用 程序 使 用 了 额外 的 NuGet 包 , 这 些 就 需要 在 csproj 文件 中 引用 , 并 且 库 需要 与 应 用 程序 一 起 交付 。 
阅读 第 19 章 ， 了 解 更 多 信息 。 


自 包 含 部 署 

应 用 程序 不 需要 在 目标 系统 上 安装 运行 库 ， 而 是 可 以 用 它 交 付 运 行 库 。 这 就 是 所 谓 的 自 包 含 部 普 。 

平台 不 同 ， 运 行 库 就 不 同 。 因 此 ， 对 于 目 包 含 部 普 ， 需 要 通过 在 项 目 文件 中 指定 RuntimeIdentifiers， 来 指 
定 文 持 的 平台 , 如 下 面 的 项 目 文件 所 示 。 这 里 , 指定 了 Windows 10、macOSs 和 Ubuntu Linux 的 运行 库 标识 符 ( 项 
目 文 件 SelfContainedHelloWorld/SelfContainedHelloWorld.csproj): 


<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup> 
<oOutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 
<PropertycGroup> 
Runtimeldentifiers> 
Winl0-x6d4 :ubuntu-x64;o0sx.10.11-x64: 
</RuntimeIlIdentifiers> 
</PropertyGroup> 
</Project> 
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注意 : 
在 https://docs.microsoft.com/en-us/dotnet/core/rid-catalog 的 .NET Core Runtime Identifier(RID) 类 别 中 可 以 获取 
不 同 平台 和 版 本 的 所 有 运行 库 标识 符 。 


现在 可 以 为 所 有 不 同 的 平台 创建 发 布 文件 : 


> dotnet publish -cc Release -Ir winl0-x64 
> dotnet publish -cc Release -Ir OSX.10.1]1-—x64 
> dotnet publish -cc Release -rr ubuntu—-x64 


在 运行 这 些 命令 之 后 ， 可 以 在 Release/[win10- x64|osx.10.11-x64|ubuntu-x64]/publish 目录 中 找到 发 布 所 需要 
的 文件 。 随 着 .NET Core 2.0 的 规模 越 来 越 大 ， 发 布 的 规模 也 越 来 越 大 。 在 这 些 目录 中 ， 可 以 找到 特定 于 平台 的 
可 执行 文件 ， 可 以 在 不 使 用 dotmet 命令 的 情况 下 直接 启动 它 。 


1.5 使 用 Visual Studio 2017 


接 下 来 使 用 Visual Studio 2017 代 蔡 命令 行 。 本 节 将 介绍 Visual Studio 中 最 重要 的 部 分 来 开始 工作 。Visual 
Studio 的 更 多 特性 在 第 18 章 中 介绍 。 


1. 安装 Visual Studio 2017 
Visual Studio 2017 提供 了 一 个 新 的 安装 程序 ， 它 可 以 更 容易 安装 需要 的 产品 。 使 用 安装 程序 ， 可 以 选择 开 
发 应 用 程序 所 需 的 工作 负载 (参见 图 1-7)。 为 了 涵盖 本 书 的 所 有 章节 ， 安 装 这 些 工作 负载 : 
se UWP 开发 
.NET Desktop 开发 
ASPNET 和 Web 开发 
Azure 开发 
移动 开发 与 .NET 
.NET Core 跨 平台 开发 


Miodifying 一 Visual Studio Enterprise 2017 一 15.5.2 
Workloads Individual componenits Language packs 
Winadaws (3 SUM mary 


yy Visual Studio core editor 


Universal Windows Platfornm dewvealo | ,ET desktop deveal Ti 
面 国 Univer ie ee pr 可 | es » Universal Windows Platform development 二 


而 国 Create applications for tha Univarsal Windows Platiorm Buld WPF, Windews Formt, ar coneole applications Using 
with Ce, VE, Javadeript or spticnslly Ce+. Cs Visual Besic snd Fe. 》 :NET desktop development 
» ASPNET and web develaprment 
» Arure developrrent 
中 Deskiep develeprment with C= > Nodejs development 
ii Build elessie Wirndows based sppliestions using the power ¥ Mobile development with .NET 喜 
sf the Visual Ce= tealset AIL and sptrenal festures [ke,.. 3 .NET Core cross-platftorm development 
ww Indmvidual componmenits * 
NuGeat package manager 
Web 总 Cloud 17 bd MET FFSTTIEWGTK .G1 SD 
Typescript 2.5 SOK 


下 


wt and Typescnpt language support 


Build web apoplications US ASP.NIET. ASP.NET Core Arure SOE, tools, and projects for developing dowd apes 


HTML evaSenpt, and Contaners nehyding Docker SuPPGrt， | rd creating resources 
| 


CT Ioancosbes 


] 加 ASPNET snd welb developrrerit Azure development 


六 -i 
[| 
ba 而 EE 
加" 蜀 


ES Compilers 


请 python developmert S Node.js development 
Ediing, debugoing, intersctwe development and source Build scalable netvork applications using Mode,js, sn 
control for Pytheon asymchronous event-drven Javascript runtime. 


NET Portable Library targeting pack 
CLR data types ter SQL Seny 

ta smurces and service references 
Drewveloper Analyties tocols 
"lin charn 


辐 国 国 加 加 四 加 回国 四 四 加 国 


Lacatian 


Total install size: 0 ka 
By comtinuing, you sgres to the beense for the Visual Studio edition you selected We also ofter the ability to dovaload other sottware vith Visual Shucio, This softaare 
二 leernped hparatehy, as seat out in te drd Party Naotees or i Its gccomperiying leonee, By eontinuing, you alis dgree to to edrnset Modify 
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2. 创建 一 个 项 目 
你 可 能 会 被 大 量 的 菜单 项 和 Visual Studio 中 的 许多 选项 所 淹没 。 要 在 本 书 的 第 1 章 中 创建 简单 的 应 用 程序 ， 
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只 需要 使 用 Visual Studio 的 一 小 部 分 特性 。 同 样 ， 这 本 完整 的 参考 书 只 涵 兹 了 可 以 用 Visual Studio 完成 的 一 部 
分 操作 。Visual Studio 的 许多 特性 是 为 遗留 应 用 程序 以 及 其 他 编程 语言 提供 的 。 

在 启动 Visual Studio 之 后 ， 首 先 要 创建 一 个 新 项 目 。 选 择 菜单 File | New | Project。 打 开 如 图 1-8 所 示 的 对 
话 框 ， 其 中 列 出 了 可 以 用 来 创建 新 项 目的 项 目 项 的 列表 。 


New Project 
bk Recent NET Framework 47.1 | Sort by:| Delault 
a Installed eT Ec Fil 已 由 Type: Visual Ce 
直 Wisual 已 ## A project for creat 
Windows Universal 2 Class Library (NET Core) mt < 
Windows Classic Desktop ER 
kb Web 区 ] Unit Test Projpect (NET Core) 
.NET Cere 
NET Standard 
Android 
Chaud 
Cross-Platform 
bb OS 


[= 
风 J sinit Test Project (NET Core) 


DD ASP.NET Core Web Application Wimual Ct 


Test 
b tvs 
VECF 
Eb Azure Data Lake 
b Azure Stream Analytics 
b Other Languages 
b Other Project Types 
F Online 本 
Nat finding what you are looking for? 
Chpen Visual Studic Irstaller 
Narmes: VSHellowWworld 
Locatlon: cENprocshorp 
solution name- VSHelloWaorld [v] Create directory for solution 
|_| Create new Git repostory 


OK 
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本 书 主 要 讨论 的 是 Visual C# 项 目 项 的 一 个 子 集 。 在 本 章 中 ， 选 择 .NET Core 类 别 和 项 目 模板 Console App 
(NET Core)。 在 如 图 1-8 所 示 的 对 话 框 顶部 , 选择 了 .NET Framework 版 本 。 不 要 混 消 , 这 个 选择 并 不 适用 于 .NET 
Core 项 目 。 

在 此 对 话 框 的 下 半 部 分 ， 可 以 输入 应 用 程序 的 名 称 ， 选择 存 储 项 目的 文件 夹 ， 并 为 解决 方案 输入 一 个 名 称 。 
解决 方案 可 以 包含 多 个 项 目 。 

单 击 OK 按钮 ， 创 建 “Hello World!” 应 用 程序 。 


3. 使 用 Solution Explorer 
在 Solution Explorer 中 (参见 图 1-9)， 可 以 看 到 解决 方案、 属于 解决 方案 的 项 目 以 及 项 目 中 的 文件 。 可 以 选 
择 能 进入 类 和 类 成 员 的 源 代 码 文件 。 
SoutionEplorer ox 
全 部 -| @@- 句 轩 | | 一 | 
Search Solution Explorer (Ctrl+ 问 PP: 


向] solution WSHelloWorld' (1 project) 


4 贺 vsHelloewerld 
br Dependencies 
1 【HE program.es 
4 "% Program 
四。 Maintstringll) : veid 


图 1-9 


在 Solution Explorer 中 选择 一 项 ， 并 单 击 鼠标 右键 或 按 下 键盘 上 的 应 用 程序 键 时 ， 会 打开 该 项 的 上 下 文集 
单 ， 如 图 1-10 所 示 。 可 用 的 荣 单 取决 于 选择 的 项 ， 以 及 与 Visual Studio 一 起 安装 的 特性 。 
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Solution Explorer S| 
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Sarch Solution Exealar 
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a C3 Pr Rebuild 
4 Chean 
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”Publish.. 
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New Selution Explorer View 


由 吊 


Edit VSHellaiWerld.capral 
ss hdd | 
的 Manage NuGet Packages. 
春 Setas startlp Project 
Debug k 
上 月 Analyze Project Partability 
Portability Analyzer Settings 


dt ‘Cut Ctrl# 关 
Remove Bel 
区 ] Rename 


Unmjead Project 
3 Open Folder in File Explorer 
- Properties Alt+ Enter 


图 1-10 


打开 项 目的 上 下 文 沫 单 时 ， 其 中 有 一 个 呈 单 项 是 用 于 编辑 项 目 文 件 的 。 此 选项 会 打开 项 目 文 件 
VSHelloWorld.csproj， 其 内 容 与 使 用 .NET Core CLI 时 看 到 的 内 容 相 同 。 


4. 配置 项 目 属性 

为 了 配置 项 目 属性 ， 应 在 Solution Explorer 中 单 击 项 目的 上 下 文 灯 单 ， 再 单 击 Properties， 或 选择 Project | 
VSHelloWorld Properties。 打 开 如 图 1-11 所 示 的 视图 。 在 这 里 ,可 以 配置 项 目的 不 同 设置 ， 如 要 使 用 的 .NET Core 
版 本 (假定 已 经 安装 了 多 个 框架 )、 构 建设 置 、 在 构建 过 程 中 应 该 调用 的 命令 、 包 配置 以 及 在 调试 应 用 程序 时 使 
用 的 参数 和 环境 变量 。 如 前 所 述 ， 对 于 一 些 代 码 示 例 ，C# 7.0 是 不 够 的 。 可 以 使 用 Build 类 别 配置 C# 编 译 器 的 
不 同 版 本 。 单 击 Advanced 按钮 将 打开 Advanced Build Settings 对 话 框 (参见 图 1-12)。 在 这 里 ， 可 以 配置 C# 编 译 
器 的 版 本 。 这 个 选择 会 进入 csproj 项 目 配置 文件 。 


Build Events 
Package Assembly name: Default namespace: 
Bebug VSHelloWworld WSHalloWWortd 
Jigning Target frarmework. Output type: 
Mop NET Core 2.0 =” Console Application 
slartup bect: 
[Neat set 


Resources 
Specify how application resources will be managet+ 


I lcon and manifest 


A manilest determines specific settings for an application. To embed a custom manifest, first 
add it to your project and then select it from the list below. 


learr 
[Default leam) 


Manifest 
Embed manifest with default settings 


DO) Resource file: 


图 1-11 
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Advanced Build Settings 


General 


Language version: C# latest major version (default) 


Internal compiler error reporting: Cs latest major wersion (default) 


Cf latest miner version (latest) 


DL Check for arithmetic overflowulsD -1 
Output 

Debugging information: 

File alignment 


Library base address: 
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注意 : 

在 对 项 目 属性 进行 更 改 时 ， 需 要 确保 在 对 话 框 顶部 选择 正确 的 配置 。 如 果 只 使 用 Debug 配置 更 改 C# 编 译 
器 的 版 本 ， 那 么 当 使 用 新 的 C#i 语 言 特性 时 ， 构 建 版 本 代码 就 会 失败 。 对 于 想 要 的 所 有 配置 设置 ， 请 选择 配置 
AllConfigurations。 


5. 了 解 编辑 器 
Visual Studio 编辑 占 非 常 强大 。 它 提供 了 智能 感知 功能 ， 该 功能 可 以 在 按 下 Tab 键 时 ， 调 用 方法 和 属性 ， 
-完成 输入 。 在 键入 时 进行 编译 ， 可 以 立即 看 到 带 有 下 划 线 代码 的 语法 错误 。 将 鼠标 指针 悬 停 在 下 划 线 的 文本 
上 ， 会 弹出 一 个 包含 错误 描述 的 小 框 。 

代码 编辑 器 的 一 个 重要 的 高 效 特性 是 代码 片段 。 它 们 会 减少 需要 输入 的 内 容 。 只 要 在 编辑 器 中 输入 
cw， 再 按 Tab 键 ， 编 辑 器 就 会 创建 Console.WriteLineO;:。Visual Studio 附带 了 许多 代码 片段 ， 选 择 Tools | 
Code Snippets Manager， 打 开 Code Snippets Manager 对 话 框 (参见 图 1-13)， 可 以 看 到 这 些 代码 片段 。 在 这 
里 ， 可 以 在 Language 字段 中 给 用 C# 语 言 定义 的 代码 片段 选择 CSharp, 选择 组 Visual C# 可 以 查看 为 C# 预 
定义 的 所 有 代码 片段 。 


Code Snippets Manager 


Language: 
Cosharmp 


Locatmon: 
CProgram Files (BE Microsoft Visual Studio\201N\Enterpnse\W CSnippets\1033Visual C# 


NM My Code Snippeis - 
| NetFX30 
| Refactoring 
Ml Test 
- 和 U-saL 
5 Visual CN 
册 | gf 


[1 Freogion 
| |= 


[| attribute 


1-13 
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6. 构建 项 目 

从 表单 Build | Build Solution 中 编译 项 目 。 如 果 出 现 错误 ，Error List 窗口 会 显示 错误 和 警告 。 但 是 ，Output 
窗口 (参见 图 1-14) 比 Error List 窗口 更 可 靠 。 有 时 ，Error List 窗口 包含 了 较 老 的 缓存 信息 ， 或 者 当 列 表 较 大 时 ， 
查找 错误 并 不 容易 。Output 窗口 通常 为 许多 不 同 的 工具 提供 了 很 好 的 信息 。 选 择 View | Output， 就 可 以 打开 
Output 窗口 。 


Output 
shew output from: Build 


Build started: Project: VSHelloWorld, Configuration: Debug Any CPU 
1>VsHelloorld = 和 est oh i er he ee ented @\VSHelloWorld. dll 


图 1-14 


7. 运行 应 用 程序 

要 运行 应 用 程序 ， 选 择 Debug | Start Without Debugging。 这 将 启动 应 用 程序 ， 并 保持 控制 台 窗 口 打开 ， 直 
到 关闭 它 为 止 。 

请 记 住 ， 可 以 选择 Debug 类 别 ， 在 Project Properties 中 配置 应 用 程序 参数 。 

8. 调试 

要 调试 应 用 程序 ， 可 以 单 击 编辑 器 中 的 左 侧 灰 色 区 域 来 创建 断 点 (参见 图 1-15)。 有 断 点 之 后 ， 就 可 以 通过 
选择 Debug | Start Debugging 局 动 调试 器 。 到 达 一 个 断 点 时 ， 可 以 使 用 Debug 工具 栏 (参见 图 1-16)， 以 进入 、 结 


i 也 可 以 显示 下 一 条 语句 。 将 鼠标 悬 停 在 变量 上 ， 可 以 查看 当前 值 。 还 可 以 在 Locals 和 Watch 
要 口中 检查 变量 设置 ， 也 可 以 在 应 用 程序 运行 时 更 改 值 。 


| VSHelloWeaorld Program,.cs 
-| VSHelloWorld.Program 


anamespace VSHelloWorld 
{ 


class Program 


static void Main(string[] args) 


onsole.WriteLine("Hello World!"); 


前 面 介绍 的 Visual Studio 部 分 是 帮助 领悟 本 书 第 1 章 的 最 重要 因素 。 第 18 章 对 Visual Studio 2017 进行 了 深 
入 的 研究 。 
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1.6 ”应 用 程序 类 型 和 技术 


可 以 使 用 C# 创 建 控制 台 应 用 程序 ， 本 章 的 大 多 数 示例 都 是 控制 台 应 用 程序 。 对 于 实际 的 程序 ,控制 台 应 用 
程序 并 不 常用 。 使 用 C# 创 建 的 应 用 程序 可 以 使 用 与 .NET 相关 的 许多 技术 。 本 节 概 述 可 以 用 C# 编 写 的 不 同类 型 
的 应 用 程序 。 


1.6.1 数据 访问 


在 介绍 应 用 程序 类 型 之 前 ， 先 看 看 所 有 应 用 程序 类 型 都 使 用 的 技术 : 数据 访问 。 

文件 和 目录 可 以 使 用 简单 的 API 调用 来 访问 ， 但 简单 的 API 调用 对 于 有 些 场景 而 言 不 够 灵活 。 使 用 流 API 
有 很 大 的 灵活 性 ， 流 提供 了 更 多 的 特性 ， 例 如 加 密 或 压缩 。 阅 读 器 和 写 入 器 简化 了 流 的 使 用 。 所 有 可 用 的 不 同 
选项 都 包含 在 第 22 章 中 。 也 可 能 以 XML 或 JSON 格式 序列 化 完整 的 对 象 。 网 上 附加 第 2 章 讨 论 了 这 些 选 项 。 

为 了 读 取 和 写 入 数据 库 , 可 以 直接 使 用 ADOJNET( 参 见 第 25 章 ), 也 可 以 使 用 抽象 层 : Entity Framework Core 
(参见 第 26 章 )。Entity Framework Core 提供 了 从 对 象 层次 结构 到 数据 库 关 系 的 映射 。 

Entity Framework Core 1.0 是 Entity Framework 的 完全 重新 设计 ， 新 名 称 反 映 了 这 一 点 。 代 码 需 要 更 改 ， 把 
应 用 程序 从 Entity Framework 的 旧版 本 迁移 到 新 版 本 。 旧 的 映射 变 体 ， 如 Database First 和 Model First 已 被 删 
除 ， 因 为 Code First 是 更 好 的 选择 。 完 全 重新 设计 也 文 持 关 系数 据 库 和 NoSQL。Entity Framework Core 2.0 有 一 
长 串 的 新 特性 ， 本 书 将 介绍 这 些 内 容 。 


1.6.2 Windows 应 用 程序 


对 于 创建 Windows 应 用 程序 ， 选 择 的 技术 应 该 是 UWP( 通 用 Windows 平台 )。 当 然 ， 当 这 个 选项 无 法 使 用 
时 ， 会 有 一 些 限制 一 一 例如 ， 如 果 仍 然 需要 支持 Windows 7 这 样 的 旧 O/S 版 本 。 此 时 ， 可 以 使 用 Windows 
Presentation Foundation (WPF)。 本 书 不 介绍 WPF, 但 是 可 以 阅读 《C# 高 级 编程 (第 10 版 ) C# 6 & .NET Core 1.0》， 
它 有 5 个 章节 专门 介绍 WPF， 其 他 章节 也 介绍 了 WPF。 

本 书 的 一 个 重点 是 : 通过 UWP 开发 应 用 程序 。 与 WPF 相 比 ，UWP 提供 了 更 现代 的 XAML 来 创建 用 户 界 
面 。 例 如 ， 数 据 绑 定 提供 了 一 个 编译 后 的 绑 定 变 体 ， 在 编译 时 会 得 到 错误 ， 而 不 是 显示 绑 定 的 数据 。 应 用 程序 
在 运行 于 客户 端 系 统 之 前 被 编译 为 本 机 代码 。 它 提供 了 现代 的 设计 ， 现 在 称 为 微软 中 的 流畅 设计 。 


注意 : 

第 33 章 介 绍 了 UWP 应 用 程序 的 创建 ， 并 介绍 了 XAML、 不 同 的 XAML 控件 和 应 用 程序 的 生命 周期 。 通 
过 支持 MVVM 模式 ， 可 以 使 用 WPF、UWP 和 Xamarin， 利 用 尽 可 能 多 的 公共 代码 来 创建 应 用 程序 。 这 一 模式 
在 第 34 章 中 介绍 。 为 了 给 应 用 程序 创建 酷 炫 的 外 观 和 风格 ， 请 务必 阅读 第 35 章 。 第 36 章 深入 介绍 了 UWP 的 
一 些 高 级 特性 。 


1.6.3 Xamarin 


如 果 Windows 在 移动 电话 市 场 上 扮演 更 大 的 角色 ， 那 就 太 好 了 。 然 后 ，UWA( 通 用 Windows 应 用 程序 ) 也 
会 在 移动 电话 上 运行 。 但 事实 并 非 如 此 ,移动 电话 上 运行 Windows 已 经 是 过 去 的 事情 了 。 然而， 通 过 Xamarin， 
你 可 以 使 用 C# 和 XAML 在 iPhone 和 Android 上 创建 应 用 程序 。Xamarin 提供 了 可 以 在 Android 上 创建 应 用 程 
序 的 API， 以 及 使 用 熟悉 的 C# 代 码 在 iPhone 上 创建 应 用 程序 的 库 。 

对 于 Android， 使 用 Android Callable Wrappers (ACW) 和 Managed Callable Wirappers(MCW) 的 映射 层 可 以 用 
于 在 .NET 代码 和 Android 的 Java 运行 库 之 间 进 行 交互 操作 。 在 ios 中 ，Ahead of Time (AOT) 编 译 器 将 托管 代 
码 编译 为 本 地 代码 。 

Xamarin.Forms 提供 了 XAML 代码 来 创建 用 户 界 面 ， 并 在 Android、iOS、Windows 和 Linux 之 则 共享 尽 可 
能 多 的 用 户 界 面 。XAML 只 提供 可 以 映射 到 所 有 平台 的 UI 控件 。 为 了 使 用 平台 上 的 特定 控件 ， 可 以 创建 特定 
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于 平台 的 泻 染 器 。 


注意 : 
用 Xamarin 和 Xamarin.Forms 开发 的 内 容 和 参见 第 37 章 。 


1.64 Web 应 用 程序 


最 初 引 入 ASPNET ， 从 根本 上 改变 了 Web 编程 模型 。ASPNET Core 再 次 改变 了 它 ， 人 允许 使 用 NET Core 
提高 性 能 和 可 伸缩 性 。 这 个 新 版 本 也 可 以 在 Windows 和 Linux 系统 上 运行 。 

在 ASPNET Core 中 ， 不 再 包含 ASPNET Web Forms( 它 仍然 可 以 使 用 ， 在 NET 4.7 中 更 新 )。 

ASPNET Core MVC 基于 著名 的 MVC( 模 型 -视图 -控制 器 ) 模 式 ， 更 容易 进行 单元 测试 。 它 还 允许 把 编写 用 
户 界面 代码 与 HIML、CSS、JavaScript 清晰 地 分 离 ， 它 只 在 后 台 使 用 C#。 


第 30 章 介绍 了 ASPNET Core 的 基础 ， 第 31 章 继 续 使 用 ASP.NET Core MVC 框架 加 固 基 础 。 


1.65 Web API 

过 去 ，SOAP 和 WCF 完成 了 任务 ， 就 不 再 需要 它们 了 。 现 代 应 用 程序 利用 REST (Representational State 
Transfer) 和 Web API。 使 用 ASPNET Core 创建 Web API 是 一 种 更 容易 进行 通信 的 选项 ， 它 满足 了 分 布 式 应 用 程 
序 90% 以 上 的 需求 。 这 项 技术 是 基于 REST 的 ， 它 为 无 状态 、 可 伸缩 的 Web 服务 定义 了 指导 方针 和 最 佳 实践 。 

客户 端 可 以 接收 JSON 或 XML 数据 。JSON 和 XML 也 可 以 格式 化 来 使 用 Open Data(OData) 规 范 。 

这 个 API 的 新 特性 更 容易 在 Web 客户 并 上 使 用 JavaScript、UWP 和 Xamarin。 

创建 Web API 是 构建 微服 务 的 好 方法 。 构 建 微服 务 的 方法 定义 了 更 小 的 服务 ， 这 些 服务 可 以 独立 地 运行 和 
部 署 ， 可 以 自己 控制 数据 存储 。 

为 了 描述 服务 ， 定 义 了 一 个 新 的 标准 : OpenAPI (https://www.openapis.ore)。 这 个 标准 植 根 于 Swagger 
(https://swagger.10/)。 


ASP.NET Core Web API、Swagger 和 更 多 关于 微服 务 的 信息 参见 第 32 章 。 


1.6.6 WebHooks 和 SignalR 


对 于 实时 Web 功能 以 及 客户 端 和 服务 器 端 之 间 的 双 同 通信 ， 可 以 使 用 的 ASPNET Core 和 .NET Core 2.1 技 
术 是 WebHooks 和 SignalR 。 

只 要 信息 可 用 ，SignalR 就 允许 将 信息 尽快 推送 给 连接 的 客户 。SignalR 使 用 WebSocket 技术 推送 信息 。 

WebHooks 可 以 集成 公共 服务 ， 这 些 服务 可 以 调用 公共 ASPNET Core 创建 的 Web API 服务 。WebHooks 技 
术 从 GitHub、Dropbox 和 其 他 服务 中 接收 推送 通知 。 


注意 : 
SignalR 连接 管理 、 连 接 的 分 组 ， 以 及 WebHooks 的 授权 和 集成 的 基础 知识 参见 网 上 附加 第 3 章 。 


1.6.7 Microsoft Azure 

现在 ， 在 考虑 开发 图 景 时 不 能 忽视 云 。 虽 然 没 有 专门 的 章节 讨论 云 技术 ， 但 在 本 书 的 几 章 中 都 引用 了 
Microsoft Azure。 

Microsoft Azure 提供 了 软件 即 服务 (Software as a Service，SaaS)、 基 础 设施 即 服 务 (Infrastructure as a Service， 
IaaS)、 平 台 即 服务 (Platform as a Service，PaaS) 和 函数 即 服务 (Functions as a Service，FaaS)。 有 时 产品 介 于 这 些 
类 别 之 间 。 下 面 介绍 这 些 Microsoft Azure 产品 。 
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1. Saas 


Saas 提供 了 完整 的 软件 ， 不 需要 处 理 服 务 器 的 管理 和 更 新 等 。Office 365 是 一 个 Saas 产品 ， 它 通过 云 产 品 
使 用 电子 邮件 和 其 他 服务 。 与 开发 人 员 相 关 的 Saas 产品 是 Visual Studio Team Server。Visual Studio Team Server 
是 云 中 的 Foundation Server， 可 以 用 作 私 人 代码 库 ， 跟 踪 错 误 和 工作 项 ， 以 及 构建 和 测试 服务 。 第 18 章 介绍 了 
Visual Studio 中 可 用 的 DevOps 特征 。 


2. laas 


男 一 个 服务 产品 是 IaaS。 这 个 服务 产品 提供 了 虚拟 机 。 用 户 负 责 管理 操作 系统 ， 维 护 更 新 。 当 创建 虚拟 机 
时 ， 可 以 决定 不 同 的 硬件 产品 ， 从 共享 核心 开始 ， 到 最 多 128 核 (编写 本 书 时 的 数据 ， 但 这 个 数据 会 很 快 改变 )。 
128 核 、2TB 的 RAM 和 4TB 的 本 地 SSD 属于 计算 机 的 “M 系列 ”。 

对 于 预 装 的 操作 系统 ， 可 以 在 Windows、Windows Server、Linux 和 预 装 了 SQL Server、BizTalk Server、 
SharePoint 和 Oracle 等 的 操作 系统 之 间 选 择 。 

笔者 经 常 给 一 周 只 需要 几 个 小 时 的 环境 使 用 虚拟 机 ， 因 为 虚拟 机 按 小 时 文 付费 用 。 如 果 想 和 尝试 在 Linux 上 
编译 和 运行 NET Core 程序 ， 但 没有 Linux 计算 机 ， 在 Microsoft Azure 上 安装 这 样 一 个 环境 是 很 容易 的 。 


3. PaasS 


对 于 开发 人 员 来 说 ，Microsoft Azure 最 相关 的 部 分 是 PaaS。 可 以 为 存储 和 读 取 数据 而 访问 服务 ， 使 用 应 用 
程序 服务 的 计算 和 联网 功能 ， 在 应 用 程序 中 集成 开发 者 服务 。 

为 了 在 云 中 存储 数据 ， 可 以 使 用 关系 数据 存储 SQL Database。SQL Database 与 SQL Server 的 本 地 版 本 大 致 
相同 。 也 有 一 些 NoSQL 解决 方案 ， 例 如 ，Cosmos DB 有 不 同 的 存储 选项 ， 如 JSON 数据 、 关 系 或 表格 存储 ， 
Azure Storage 存储 blob( 如 图 像 或 视频 )。 

应 用 程序 服务 可 以 用 于 驻 留 通过 ASPNET Core 创建 的 Web 应 用 程序 和 API 应 用 程序 。 

Microsoft 还 在 Microsoft Azure 中 提供 了 Developer Services。Developer Services 的 一 部 分 是 Visual Studio 
Team Services。 Visual Studio Team Services 允许 管理 源 代 码 ， 上 自动 构建 、 测 试 和 部 署 CI (持续 集成 )。 

Developer Services 的 另 一 部 分 是 Application Insights。 它 的 发 布 周期 更 短 ， 对 于 获得 用 户 如 何 使 用 应 用 程 
序 的 信息 越 来 越 重 要 。 用 户 因为 可 能 找 不 到 哪些 染 单 ， 而 从 未 使 用 过 它们 ? 用户 在 应 用 程序 中 使 用 什么 路 径 来 
完成 任务 ? 在 Application Insights 中 ， 可 以 得 到 恨 好 的 匿名 用 户 信 息 ， 找 出 用 户 关 于 应 用 程序 的 问题 ， 使 用 
DevOps 可 以 快速 解决 这 些 问 题 。 

还 可 以 使 用 Cognitive Services 提供 的 功能 处 理 图 像 , 使 用 Bing Search APIs, 利用 语言 服务 理解 用 户 的 看 

4. Faas 

Faas 是 云 服 务 的 一 个 新 概念 ， 也 称 为 无 服务 器 计算 技术 。 当 然 ， 幕 后 总 是 有 一 个 服务 器 。 不 需要 为 保留 的 
CPU 和 内 存 付 费 ， 就 像 在 Web 应 用 程序 中 使 用 的 应 用 程序 服务 一 样 。 相 反 ， 文 付 的 金额 是 基于 消费 的 ， 即 对 
活动 所 需要 的 内 存 的 调用 次 数 和 时 间 付 费 ， 且 有 一 些 限 制 。Azure 函数 是 一 种 可 以 使 用 Faas 进行 部 署 的 技术 。 

注意 : 

第 29 章 介 绍 了 跟踪 特性 以 及 如 何 使 用 Microsoft Azure 的 Application Insights 产品 。 第 32 章 不 仅 说 明了 如 
何 使 用 ASP. NET Core MVC 创建 Web API， 也 展示 了 如 何在 Azure 函数 中 使 用 相同 的 服务 功能 。 网 上 附加 第 4 
章 介 绍 了 Microsoft Bot 服务 和 Cognitive Services。 


1.7 开发 工具 
第 2 章 会 讨论 很 多 C# 人 代码， 而 本 章 的 最 后 一 部 分 介绍 开发 工具 和 Visual Studio 2017 的 版 本 。 
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1.7.1 Visual Studio Community 


这 个 版 本 的 Visual Studio 是 免费 的 ， 具备 以 前 Professional 版 的 功能 。 使 用 时 间 有 许可 限制 。 它 对 开源 项 目 
和 培训 、 学术 和 小 型 专业 团队 是 免费 的 。Visual studio Express 版 本 以 前 是 免费 的 , 但 该 产品 允许 在 Visual Studio 
中 使 用 扩展 。 


1.72 Visual Studlo Professlonal 


这 个 版 本 比 Community 版 包括 更 多 功能 ， 例 如 CodeLens 和 Team Foundation Server， 来 进行 源 代码 管理 和 
团队 协作 。 有 了 这 个 版 本 ， 也 会 得 到 MSDN 订阅 ， 其 中 包括 微软 公司 的 几 个 服务 器 产品 ， 用 于 开发 和 测试 。 


1.7.3 Visual Studio Enterprise 


与 Professional 版 不 同 ， 这 个 版 本 包含 很 多 测试 工具 ， 如 Web 负载 和 性 能 测试 、 使 用 Microsoft Fakes 进行 
单元 测试 隔离 ， 以 及 编码 的 UI 测试 (单元 测试 是 所 有 Visual Studio 版 本 的 一 部 分 )。 通 过 Code Clone 可 以 找到 解 
决 方案 中 的 代码 克隆 。Visual Studio Enterprise 版 还 包含 架构 和 建 模 工具 ， 以 分 析 和 验证 解决 方案 体系 结构 。 


注意 : 
有 了 Visual Studio 订阅 ， 就 有 权 免 费 使 用 Microsoft Azure， 每 月 具体 的 数量 视 MSDN 订阅 的 类 型 而 定 。 


注意 : 
第 18 章 详细 介绍 了 Visual Studio 2017 几 个 特性 的 使 用 。 第 28 章 阅 述 单 元 测试 、Web 测试 和 创建 编码 的 
UI 测试 。 


注意 : 
本 书 中 的 一 些 功能 ， 如 编码 的 UI 测试， 需要 Visual Studio Enterprise 版 。 使 用 Visual Studio Community 版 
可 以 完成 本 书 的 大 部 分 内 容 。 


1.74 Visual Studiofor Mac 


Visual Studio for Mac 起 源 于 Xamarin Studio, 但 现在 它 提 供 的 比 之 前 的 产品 多 得 多 。 例如 ,编辑 器 与 Visual 
Studio 共享 代码 ， 因 此 用 户 很 快 就 会 熟悉 它 。 有 了 Visual Studio for Mac， 不 仅 可 以 创建 Xamarin 应 用 程序 ， 还 
可 以 创建 在 Windows、Linux 和 Mac 上 运行 的 ASPNET Core 应 用 程序 。 在 本 书 的 许多 章节 中 , 都 可 以 使 用 Visual 
Studio for Mac。 但 介绍 UWP 的 章节 例外 ， 它 要 求 用 Windows 运行 和 开发 应 用 程序 。 


1.1.5 Visual Studlo Code 


与 其 他 Visual Studio 版 本 相 比 ，Visual Studio Code 是 一 个 完全 不 同 的 开发 工具 。Visual Studio 2017 提供 了 
基于 项 目的 特性 以 及 一 组 丰富 的 模板 和 工具 ， 而 Visual Studio Code 是 一 个 代码 编 辑 器 ， 几 乎 不 支持 项 目 管 理 。 
然而 ，Visual Studio Code 不 仅 在 Windows 上 运行 ， 也 在 Linux 和 OS X 上 运行 。 

对 于 本 书 的 许多 章节 ， 可 以 使 用 Visual Studio Code 作为 开发 编辑 器 。 但 不 能 创建 UWP 或 Xamarin 应 用 程 
序 , 也 无 法 获得 第 18 章 介 绍 的 特性 .Visual Studio Code 代码 可 以 用 于 NET Core 控制 台 应 用 程序 , 以 及 使 用 NET 
Core 的 ASPNET Core 1.0 Web 应 用 程序 。 

可 以 从 http://code.visualstudio.com 下 载 Visual Studio Code。 


1.8 小结 
本 章 涵 盖 了 很 多 重要 的 技术 和 技术 的 变化 。 了 解 一 些 技术 的 历史 ， 有 助 于 确定 新 的 应 用 程序 应 该 使 用 哪些 
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技术 ， 现 有 的 应 用 程序 应 该 如 何 处 理 。 

.NET Framework 和 .NET Core 是 有 差异 的 。 本 章 讨 论 了 如 何在 这 两 种 环境 中 创建 并 运行 “Hello World!” 应 
用 程序 ， 但 没有 使 用 Visual Studio。 

本 章 阑 述 了 公共 语言 运行 库 (CLR) 的 功能 ， 介 绍 了 用 于 访问 数据 库 和 创建 Windows 应 用 程序 的 技术 。 论 述 
了 ASPNET Core 的 优点 。 

第 2 章 开 始 讨论 C# 语 法 ， 学 习 变 量 ， 实 现 程 序 流 ， 把 代码 组 织 到 名 称 空间 中 等 内 容 。 


第 


核 心 C# 


本 章 要 点 
声明 变量 
变量 的 初始 化 和 作用 域 
c# 的 预定 义 数据 类 型 
在 C# 程 序 中 指定 执行 流 
使 用 名 称 空间 组 织 类 和 类 型 
Main0 方 法 
使 用 内 部 注释 和 文档 编制 功能 
预 处 理 器 指令 
C# 编 程 的 推荐 规则 和 约定 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 CoreCSharp 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 


® HelloWorldApp 

® VarablesSampjle 

® WarliablescopeSample 
® Itstatement 

® ForLoop 

® NamespacesSample 

® AroeumentsSample 

® Strnesample 


2.1 C# 基 础 
理解 了 C# 的 用 途 后 ， 就 该 学 习 如 何 使 用 它 了 。 本 章 将 介绍 CH# 编 程 的 基础 知识 ， 这 也 是 后 续 章 节 的 基础 。 
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阅读 完 本 章 后 ， 读 者 束 有 足够 的 C# 知 识 来 编写 简单 的 程序 了 , 但 还 不 能 使 用 继承 或 其 他 面 同 对 象 的 特性 。 这 些 
内 容 将 在 后 面 的 几 章 中 讨论 。 


“Hello World!” 程 序 


第 1 章 解释 了 如 何 使 用 NET Core CLI 工具 、Visual Studio、Visual Studio for Mac 和 Visual Studio Code 编写 
“Hello World!'” 应 用 程序 。 下 面 解 释 C# 源 代码 。 首 先 对 C# 语 法 做 一 些 一 般 性 的 解释 。 在 C# 中 ， 与 其 他 C 风 
格 的 语言 一 样 ， 语 句 都 以 分 号 (:) 结 尾 ， 并 且 语 句 可 以 写 在 多 个 代码 行 上 ， 不 需要 使 用 续 行 字 符 。 用 花 括 号 ({}) 
把 语句 组 合 为 块 。 单 行 注释 以 两 个 斜 杠 字符 开头 UL/)， 多 行 注 释 以 一 个 斜 枉 和 一 个 星 号 (/ 久 开头 ， 以 一 个 星 号 和 
一 个 斜 杜 (*/) 结 尾 , 在 这 些 方面 , C# 与 C++ 和 Java 一 样 , 但 与 Visual Basic 不 同 。 分 号 和 花 括 号 使 C# 代 码 与 Visual 
Basic 代码 的 外 观 差 异 很 大 。 如 果 以 前 使 用 的 是 Visual Basic， 就 应 特别 注意 每 条 语句 结尾 的 分 号 。 对 于 新 接触 
C 风格 语言 的 用 户 ， 忽 略 分 号 常常 是 导致 编译 错误 的 最 主要 原因 。 男 一 个 方面 是 ，C# 区 分 大 小 写 ， 即 myVar 与 
MyVar 是 两 个 不 同 的 变量 。 

在 前 面 的 代码 示例 中 ， 前 几 行 代码 与 名 称 空间 有 关 ( 如 本 章 后 面 所 述 )， 名 称 空间 是 把 相关 类 组 合 在 一 起 的 
方式 。namespace 关键 字 声 明了 应 与 类 相关 的 名 称 空 间 。 其 后 花 括号 中 的 所 有 代码 都 被 认为 是 在 这 个 名 称 空间 
中 。 编 译 器 在 using 语句 指定 的 名 称 空 间 中 查找 没有 在 当前 名 称 空 间 中 定义 但 在 代码 中 引用 的 类 。 这 与 Java 中 
的 import 语句 和 C++ 中 的 using namespace 语句 非常 类 似 (代码 文件 HelloWorldApp/Proeram.cs): 

using System; 


namespace WIox.HelloWorldApp 
{ 


在 Program.cs 文件 中 使 用 “using System: 声 明 ” 的 原因 是 : 下 面 要 使 用 System: System.Console 名 称 空 
间 中 的 类 Console。 using System: 声 明 语 名 允许 引 用 这 个 类 , 而 忽略 名 称 空 间 。 可 以 使 用 下 面 的 类 调用 WriteLine 
方法 : 


using System; 
fi --- 


Console.WriteLine ("Hello World!™).: 


注意 : 

名 称 空间 参见 本 章 后 面 的 内 容 。 

使 用 using static 声明 ， 不 仅 可 以 打开 名 称 空间 ， 还 可 以 打开 类 的 所 有 静态 成 员 。 声 明 using static 
System.Console， 可 以 调用 Console 类 的 WriteLine 方法 ， 但 不 使 用 类 名 : 

usSsing static System.Console; 

Wi erinet Lie World!™); 

忽略 整个 using 声明 ， 调 用 WriteLine0 方 法 时 就 必须 添加 名 称 空间 的 名 称 : 

System.Console .WriteLine ("Hello World!'"); 

标准 的 System 名 称 空 间 包含 了 最 常用 的 .NET 类 型 。 在 C# 中 做 的 所 有 工作 都 依赖 于 .NET 基 类 ， 认 识 到 这 
一 点 非常 重要 。 在 本 例 中 ， 使 用 了 System 名 称 空间 中 的 Console 类 ， 以 写 入 控制 台 窗 口 。C# 没 有 用 于 输入 和 输 
出 的 内 置 关键 字 ， 而 是 完全 依赖 于 .NET 类 。 

在 源 代 码 中 ， 声 明 一 个 类 Program。 但 是 ， 因 为 该 类 位 于 Wrox.HelloWorldApp 名 称 空间 中 ， 所 以 其 完整 的 
名 称 是 Wrox.HelloWorldApp.Program( 代 码 文件 HelloWorldApp/Program.cs): 

namespace WIox.HelloWorldApp 

{ 


class Program 


{ 
所 有 的 C# 代 码 都 必须 包含 在 类 中 。 类 的 声明 包括 class 关键 字 ， 其 后 是 类 名 和 一 对 花 括 号 。 与 类 相关 的 所 
有 代码 都 应 放 在 这 对 人 花 括 号 中 。 
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Program 类 包含 一 个 方法 Main0。 每 个 C# 可 执行 文件 (如 控制 台 应 用 程序 、Windows 应 用 程序 、Windows 
服务 和 Web 应 用 程序 ) 都 必须 有 一 个 入 口 点 一 一 Main0 方 法 (注意 ，M 大 写 ): 


static volid Malnr) 


{ 
在 程序 启动 时 调用 该 方法 。 该 方法 要 么 没有 返回 值 (void)， 要 么 返回 一 个 整数 (int)。 注 意 ， 在 C# 中 ， 方 法 
定义 的 格式 如 下 : 

[modifiers] return type MethodName ([parameters]) 


/:/ Method body. NB. This code block is pseudo-code. 


第 一 个 方 插 号 中 的 内 容 表 示 一 些 可 选 关 键 字 。 修饰 从 (modifiers) 用 于 指定 用 户 所 定义 的 方法 的 茶 些 特性 , 例 
如 可 以 在 何 处 调用 该 方法 。 在 本 例 中 ，Main0 方 法 没有 使 用 public 访问 修饰 行 ， 如 果 需 要 对 Main0 方 法 进行 单 
元 测试 ， 可 以 给 它 使 用 public 访问 修饰 待 。 运 行 库 不 需要 使 用 public 访问 修饰 符 ， 仍 可 以 调用 方法 。 运 行 库 没 
有 创建 类 的 实例 ， 调 用 方法 时 ， 需 要 修饰 符 static。 把 返回 类 型 设置 为 void， 在 本 例 中 不 包含 任何 参数 。 

最 后 ， 看 看 代码 语句 : 

Console WriteLine ("Hello World!"); 

在 本 例 中 ， 只 调用 了 System.Console 类 的 WriteLine0 方 法 ， 把 一 行文 本 写 到 控制 台 窗 口上 。WriteLine0O 是 
一 个 静态 方法 ， 在 调用 之 前 不 需要 实例 化 Console 对 象 。 

对 C# 基 本 语法 有 了 大 致 的 认识 后 ， 下 面 就 详细 讨论 C# 的 各 个 方面 。 因 为 没有 变量 不 可 能 编写 出 重要 的 程 
序 ， 所 以 首先 介绍 C# 中 的 变量 。 


2.2 ”变量 
在 C# 中 使 用 下 述 语法 声明 变量 ; 


datatype ldentifier; 

例如 : 

该 语句 声明 int 变量 1。 实际 上 编译 器 不 允许 在 表达 式 中 使 用 这 个 变量 ， 除 非 用 一 个 值 初始 化 了 该 变量 。 

声明 i 之 后 ， 就 可 以 使 用 赋值 运算 符 (=) 给 它 赋 值 : 

i = 10- 

还 可 以 在 一 行 代码 中 (同时 ) 声 明 变 量 ， 并 初始 化 它 的 值 : 

int 1 = 10; 

如 果 在 一 条 语句 中 声明 和 初始 化 了 多 个 变量 ， 那 么 所 有 变量 都 具有 相同 的 数据 类 型 : 

int xX = 10, Yy =20; // x and YyY are both ints 

要 声明 不 同类 型 的 变量 ， 需 要 使 用 单独 的 语句 。 在 一 条 多 变量 的 声明 中 ， 不 能 指定 不 同 的 数据 类 型 : 

enh // Creates a variable that stores true or false 

int x = 10, bool y = true; // This won't compile! 

注意 上 面 例子 中 的 “//” 和 其 后 的 文本 ， 它 们 是 注释 。“//” 字 符 串 告诉 编译 器 ， 和 忽略 该 行 后 面 的 文本 ， 这 
些 文 本 仅 为 了 让 人 更 好 地 理解 程序 ， 它 们 并 不 是 程序 的 一 部 分 。 本 章 后 面 会 详细 讨论 代码 中 的 注释 。 


2.2.1 初始 化 变量 


变量 的 初始 化 是 C# 强 调 安全 性 的 另 一 个 例子 。 简 单 地 说 ，C# 编 译 器 需要 用 某 个 初始 值 对 变量 进行 初 
始 化 ， 之 后 才能 在 操作 中 引用 该 变量 。 大 多 数 现代 编译 器 把 没有 初始 化 标记 为 警告 , 但 C# 编 译 器 把 它 当 成 
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oll} 


C# 有 两 个 方法 可 确保 变量 在 使 用 前 进行 了 初始 化 : 

e 变量 是 类 或 结构 中 的 字段 ， 如 果 没 有 显 式 初始 化 ， 则 创建 这 些 变量 时 ， 其 默认 值 就 是 0( 类 和 结构 在 后 
面 讨论 )。 

e 方法 的 局 部 变量 必须 在 代码 中 显 式 初 始 化 ， 之 后 才能 在 语句 中 使 用 它们 的 值 。 此 时 ， 初 始 化 不 是 在 声明 
该 变量 时 进行 的 ， 但 编译 器 会 通过 方法 检查 所 有 可 能 的 路 径 ， 如 果 检 测 到 局 部 变量 在 初始 化 之 前 就 使 
用 了 其 值 ， 就 会 标记 为 错误 。 

例如 ， 在 C# 中 不 能 使 用 下 面 的 语句 : 

int Mainl() 

int ad; 
Console.WriteLine(d}; // can't do this! Need to initialize d before use 


return 0 

} 

注意 在 这 段 代 码 中 ， 演 示 了 如 何 定义 Main0 方 法 ， 使 之 返回 一 个 int 类 型 而 不 是 void 类 型 的 数据 。 

在 编译 这 些 代 码 时 ， 会 得 到 下 面 的 错误 消息 : 

Use of unassigned local variable ‘'d'" 

考虑 下 面 的 语句 : 

Something objSomething; 

在 C# 中 ， 这 行 代码 仅 会 为 Something 对 象 创建 一 个 引用 ， 但 这 个 引用 还 没有 指 癌 任何 对 象 。 对 该 变量 调用 
方法 或 属性 会 导致 错误 。 

在 C# 中 实例 化 一 个 引用 对 象 ， 需 要 使 用 new 关键 字 。 如 上 所 述 ， 创 建 一 个 引用 ， 使 用 new 关键 字 把 该 引 
用 指向 存储 在 堆 上 的 一 个 对 象 : 


objSomething = new Something(); // This creates a Something object on the heap 


2.2.2 类 型 推断 


类 型 推断 使 用 var 关键 字 。 声 明 变 量 的 语法 有 些 变化 : 使 用 var 关键 字 蔡 代 实 际 的 类 型 。 编 译 器 可 以 根据 
变量 的 初始 化 值 “ 推 新 ”变量 的 类 型 。 例 如 ， 


var SomeNumber = 0; 
Luly i 
就 变 成 : 

1int someNumber = 0; 


即使 someNumber 从 来 没有 声明 为 int， 编 译 器 也 可 以 确定 ， 只 要 someNumber 在 其 作用 域内 ， 就 是 int 类 
型 。 编 译 后 ， 上 面 两 个 语句 是 等 价 的 。 
下 面 是 另 一 个 小 例子 (代码 文件 VariablesSample/Program.cs ): 


usSsing System; 
namespace WIoOx 
{ 
Class Program 
{ 
static void Maint) 
{ 
Var name = "Bugs Bunny™s; 
VAaAI AgE = 之 避让 
var lisRabbit = true; 
Type nameTyYpe = name.GetType () 7 
Type ageTYybe = age.GetType (}); 
Type isRabbitType = lsRabbit.GetType (); 
Console.WriteLine ($"name is of type {nameType}"); 
Console.WriteLine ($"age 15 of type {ageType}"™); 
Console.WriteLine ($"isRabbit is of type {isRabbitType}™"); 
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这 个 程序 的 输出 如 下 : 

name is of type System.Sstring 

age is of type System.Int32 

isRabbit is of type System.Boolean 

需要 遵循 以 下 一 些 规则 : 

e 变量 必须 初 妈 化。 否则， 编译 器 就 没有 推断 变量 类 型 的 依据 。 

e 初始 化 器 不 能 为 空 。 

e 初始 化 器 必须 放 在 表达 式 中 。 

e 不 能 把 初始 化 器 设置 为 一 个 对 象 ， 除 非 在 初始 化 器 中 创建 了 一 个 新 对 象 。 

第 3 章 在 讨论 匿名 类 型 时 将 详细 探讨 这 些 规则 。 

声明 了 变量 且 推 断 出 类 型 后 ,就 不 能 再 改变 变量 的 类 型 了 。 变量 的 类 型 确定 后 ， 对 该 变量 进行 任何 赋值 时 ， 
其 强 类 型 化 规则 必须 以 推断 出 的 类 型 为 基础 。 


2.2.3 变量 的 作用 域 


变量 的 作用 域 是 可 以 访问 该 变量 的 代码 区 域 。 一 般 情况 下 ， 确 定 作 用 域 遵 循 以 下 规则 : 

e 只 要 类 的 局 部 变量 在 某 个 作用 域内 ， 其 字段 (也 称 为 成 员 变量 ) 也 在 该 作用 域内 。 

e 局 部 变量 存在 于 表示 声明 该 变量 的 块 语句 或 方法 结束 的 右 花 括号 之 前 的 作用 域内 。 

e 在 for、while 或 类 似 语句 中 声明 的 局 部 变量 存在 于 该 循环 体内 。 

1. 局 部 变量 的 作用 域 冲 突 

大 型 程序 常常 在 不 同 部 分 为 不 同 的 变量 使 用 相同 的 变量 名 。 只 要 变量 的 作用 域 是 程序 的 不 同 部 分 ， 束 不 会 
有 问题 ， 也 不 会 产生 多 义 性 。 但 要 注意 ， 同 名 的 局 部 变量 不 能 在 同一 作用 域内 声明 两 次 。 例 如 ， 不 能 使 用 下 面 
的 代码 ; 


int XxX = 20; 
// some more code 
int 交 = 30 


考虑 下 面 的 代码 示例 (代码 文件 VariableScopeSample/Program.cs ): 


USslng System; 
namespace VarlIableSscopeSarmp1le 


Class Program 
{ 
static int Mainl) 
1 
for (int i = 0; i < 10; i++}) 


Console.WriteLine (1}); 
} // i goes out of scope here 


/:/ We can declare a variable named 1 again, because 
/:/ there's no other variable with that name in scope 
for (In 1 = 9; 1 >= 0; 1 一 ) 
{ 

Console .WriteLine (1); 
} // i goes out of scope here. 


return 0; 
} 


} 
} 


这 段 代码 很 简单 ， 使 用 两 个 for 循环 打印 0-9 的 数字 ， 再 逆序 打印 0-9 的 数字 。 重 要 的 是 在 同一 个 方法 中 ， 
代码 中 的 变量 i 声明 了 两 次 。 可 以 这 么 做 的 原因 是 i 在 两 个 相互 独立 的 循环 内 部 声明 ， 所 以 每 个 变量 i 对 于 各 目 
的 循环 来 说 是 局 部 变量 。 

下 面 是 另 一 个 例子 (代码 文件 VariableScopeSample2/Program.cs ): 


static Imt MalInmnTr) 


oll} 
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{ 

int ] = 20; 

for {int 1 = 07 1 < 107 1++) 

{ 
int j = 30; // Can't do this - j is still in scope 
Console.WriteLine(]j] + 1); 

} 

return Or 


} 
如 果 试 图 编译 它 ， 就 会 产生 如 下 错误 : 


error CS0136: A Local variable named Jj" cannot be declared in 
this scope because that name is used in an enclosing local scope 
to define a local or parameter 


其 原因 是 : 变量 j 是 在 for 循 环 开始 之 前 定义 的 ， 在 执行 for 循 环 时 仍 处 于 其 作用 域内 ， 直 到 Main0 方 法 结束 
执行 后 ， 变 量 j 才 超 出 作用 域 。 第 2 个 j (不 合法 ) 虽 然 在 循环 的 作用 域内 ， 但 作用 域 艇 套 在 Main0 方 法 的 作用 
域内 。 因 为 编译 器 无 法 区 分 这 两 个 变量 ， 所 以 不 允许 声明 第 二 个 变量 。 

2. 字段 和 局 部 变量 的 作用 域 冲突 

茶 些 情况 下 ， 可 以 区 分 名 称 相同 (尽管 其 完全 限定 名 不 同 )、 作 用 域 相同 的 两 个 标识 待 。 此 时 编译 器 允许 声 
明 第 二 个 变量 。 原因 是 C# 在 变量 之 间 有 一 个 基本 的 区 分 , 它 把 在 类 型 级 别 声明 的 变量 看 成 字段 ， 而 把 在 方法 中 
声明 的 变量 看 成 局 部 变量 。 

考虑 下 面 的 代码 片段 (代码 文件 VariableScopeSample3/Program.cs): 

Using System; 

namespace WIOx 


{ 
Class Program 
{ 
static int ] = 20; 
static void Main'() 
{ 
int ] = 30; 
Console.WriteLine (] ) ; 
return; 
} 
} 
} 


虽然 在 Main0 方 法 的 作用 域内 声明 了 两 个 变量 j， 这 段 代码 也 会 编译 : 一 个 是 在 类 级 别 上 定义 的 j， 在 类 
Program 删除 前 (在 本 例 中 ， 是 Main0 方 法 终止 , 程序 结束 时 ) 是 不 会 超出 作用 域 的 ; 一 个 是 在 Main0 中 定义 的 j。 
这 里 ， 在 Main0 方 法 中 声明 的 新 变量 j 隐藏 了 同名 的 类 级 别 变量 ， 所 以 在 运行 这 段 代 码 时 ， 会 显示 数字 30。 

但 是 ， 如 果 要 引用 类 级 别 变量 ， 该 怎么 办 ? 可 以 使 用 语法 objectfieldname， 在 对 象 的 外 部 引用 类 或 结构 的 
字段 。 在 上 面 的 例子 中 ， 访 问 静 态 方法 中 的 一 个 静态 字段 ， 所 以 不 能 使 用 类 的 实例 ， 只 能 使 用 类 本 喘 的 名 称 : 

0 void Main () 

{ 

int ] = 30; 
Console.WriteLine (]) ; 
Console .WriteLine (Program.J)}); 


} 

Ps 

如 果 要 访问 实例 字段 (该 字段 属于 类 的 一 个 特定 实例 )， 就 需要 使 用 this 关键 字 。 
2.2.4 ”常量 

顾名思义 ， 常 量 是 其 值 在 使 用 过 程 (生命 周期 ) 中 不 会 发 生变 化 的 变量 。 在 声明 和 初始 化 变量 时 ， 在 变量 的 
前 面 加 上 关键 字 const， 就 可 以 把 该 变量 指定 为 一 个 常量 : 


const int a = 100; // This value cannot be changed. 
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常量 具有 如 下 特点 : 

e 常量 必须 在 声明 时 初始 化 。 指 定 了 其 值 后 ， 就 不 能 再 改写 了 。 

e 常量 的 值 必须 能 在 编译 时 用 于 计算 。 因 此 ， 不 能 用 从 变量 中 提取 的 值 来 初始 化 常量 。 如 果 需 要 这 么 做 ， 
应 使 用 只 读 字 段 ( 详 见 第 3 章 )。 

e 常量 总 是 隐 式 静态 的 。 但 注意 ， 不 必 ( 实 际 上 ， 是 不 允许 ) 在 常量 声明 中 包含 修饰 符 static。 

在 程序 中 使 用 常量 至 少 有 3 个 好 处 : 

e 由 于 使 用 易于 读 取 的 名 称 (名 称 的 值 易于 理解 ) 蔡 代 了 较 难 读 取 的 数字 和 字符 串 ， 常量 使 程序 变 得 更 易于 

e 常量 使 程序 更 易于 修改 。 例 如 ， 在 C# 程 序 中 有 一 个 SalesTax 常量 ， 该 常量 的 值 为 6%6。 如 果 以 后 销售 
税率 发 生变 化 ， 把 新 值 赋 给 这 个 常量 ， 就 可 以 修改 所 有 的 税 款 计算 结果 ， 而 不 必 查 找 整 个 程序 去 修改 
税率 为 0.06 的 每 个 项 。 

e 常量 更 容易 避免 程序 出 现 错误 。 如 果 在 声明 常量 的 位 置 以 外 的 某 个 地 方 将 男 一 个 值 赋 给 常量 ， 编 译 器 
就 会 标记 错误 。 


2.3 预定 义 数 据 类 型 


前 面 介绍 了 如 何 声 明 变 量 和 常量 ， 下 面 要 详细 讨论 C# 中 可 用 的 数据 类 型 。 与 其 他 语言 相 比 ，C# 对 其 可 用 
的 类 型 及 其 定义 有 更 严格 的 描述 。 


2.3.1 值 类 型 和 引用 类 型 


在 开始 介绍 C# 中 的 数据 类 型 之 前 ， 理 解 C# 把 数据 类 型 分 为 两 种 非常 重要 : 

。 值 类 型 

e 引用 类 型 

下 面 几 节 将 详细 介绍 值 类 型 和 引用 类 型 的 语法 。 从 概念 上 看 ， 其 区 别 是 值 类 型 直接 存储 其 值 ， 而 引用 类 型 
存储 对 值 的 引用 。 

这 两 种 类 型 存储 在 内 存 的 不 同 地 方 ， 值 类 型 存储 在 堆栈 (stack) 中 ， 而 引用 类 型 存储 在 托管 堆 (managed heap) 
上 .。 注意 区 分 某 个 类 型 是 值 类 型 还 是 引用 类 型 ， 因 为 这 会 有 不 同 的 影响 。 

例如 ，int 是 值 类 型 ， 这 表示 下 面 的 语句 会 在 内 存 的 两 个 地 方 存储 值 20: 

AAA i and j are both of type int 

和 = 20; 

了 全 

但 考虑 下 面 的 代码 。 这 段 代码 假定 已 经 定义 了 类 Vector，Vector 是 一 个 引用 类 型 ， 它 有 一 个 int 类 型 的 成 员 
变量 Value; 

Vector x, y; 

a er is a field defined in Vector class 

Pp 


YY-Value = 20; 
Console .WriteLine (x.Value).; 


要 理解 的 重要 一 点 是 : 在 执行 这 段 代码 后 ， 只 有 一 个 Vector 对 象 。x 和 y 都 指 同 包含 该 对 象 的 内 存 位 置 。 
因为 x 和 Yy 是 引用 类 型 的 变量 ， 声 明 这 两 个 变量 只 保留 了 一 个 引用 一 一 而 不 会 实例 化 给 定 类 型 的 对 象 。 两 种 情 
况 下 都 不 会 真正 创建 对 象 。 要 创建 对 象 ， 就 必须 使 用 new 关键 字 ， 如 上 所 示 。 因 为 x 和 y 引用 同一 个 对 象 ， 所 
以 对 x 的 修改 会 影响 Y， 反 之 亦 然 。 因 此 上 面 的 代码 会 显示 30 和 50。 

如 果 变 量 是 一 个 引用 ， 就 可 以 把 其 值 设 置 为 null， 表 示 它 不 引用 任何 对 象 : 


Y = null; 
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如 果 将 引用 设置 为 mol， 显然 就 不 可 能 对 它 调 用 任何 非 静 态 的 成 员 函 数 或 字段 ， 这 么 做 会 在 运行 期 间 抛 出 
一 个 异常 。 


注意 : 
C# 8 计划 支持 不 可 空 的 引用 类 型 。 这 些 类 型 的 变量 需要 使 用 非 空 值 进行 初始 化 。 允 许 使 用 空 值 的 引用 类 型 
显 式 地 要 求 声 明 为 可 空 的 引用 类 型 。 


在 C# 中 ， 基 本 数据 类 型 (如 bool 和 long) 都 是 值 类 型 。 如 果 声 明 一 个 bool 变量 ， 并 给 它 赋予 男 一 个 bool 变 
量 的 值 ， 在 内 存 中 就 会 有 两 个 bool 值 。 如 果 以 后 修改 第 一 个 bool 变量 的 值 ， 第 二 个 bool 变量 的 值 也 不 会 改变 。 
这 些 类 型 是 通过 值 来 复制 的 。 

相反 ， 大 多 数 更 复杂 的 C# 数 据 类 型 ， 包 括 我 们 自己 声明 的 类 ， 都 是 引用 类 型 。 它 们 分 配 在 堆 中 ， 其 生存 期 
可 以 跨 多 个 函数 调用 ， 可 以 通过 一 个 或 几 个 别名 来 访问 。CLR 实现 一 种 精细 的 算法 ， 来 跟踪 哪些 引用 变量 仍 是 
可 以 访问 的 ， 哪 些 引 用 变量 已 经 不 能 访问 了 。CLR 会 定期 删除 不 能 访问 的 对 象 ， 把 它们 占用 的 内 存 返回 给 操作 
系统 。 这 是 通过 垃圾 收集 器 实现 的 。 

把 基本 类 型 (如 int 和 booD 规 定 为 值 类 型 ， 而 把 包含 许多 字段 的 较 大 类 型 (通常 在 有 类 的 情况 下 ) 规 定 为 引用 
类 型 ，C# 设 计 这 种 方式 是 为 了 得 到 最 佳 性 能 。 如 果 要 把 自己 的 类 型 定义 为 值 类 型 ， 就 应 把 它 声明 为 一 个 结构 。 


注意 : 
原始 数据 类 型 的 布局 通常 与 本 机 布局 保持 一 致 。 因 此 可 能 在 托管 代码 和 本 机 代码 之 间 共 享 相同 的 内 存 。 


2.32 .NET 类 型 


数据 类 型 的 C# 关 键 字 ( 如 int、short 和 string) 从 编译 器 映射 到 NET 数据 类 型 。 例 如 ， 在 C# 中 声明 一 个 int 
类 型 的 数据 时 ， 声 明 的 实际 上 是 NET struct:System.Int32 的 一 个 实例 。 这 听 起 来 似乎 很 深奥 ， 但 其 意义 深远 : 这 
表示 在 语法 上 ， 可 以 把 所 有 的 基本 数据 类 型 看 成 支持 某 些 方法 的 类 。 例 如 ， 要 把 int i 转换 为 string 类 型 ， 可 以 
编写 下 面 的 代码 : 

string s = i.ToString({}); 

应 该 强调 的 是 , 在 这 种 便利 语法 的 背后 , 类 型 实际 上 仍 存储 为 基本 类 型 。 基 本 类 型 在 概念 上 用 C# 结 构 表 示 ， 

下 面 看 看 C# 中 定义 的 内 置 类 型 。 我 们 将 列 出 每 个 类 型 ， 以 及 它们 的 定义 和 对 应 .NET 类 型 的 名 称 。C# 有 15 
个 预定 义 类 型 ， 其 中 13 个 是 值 类 型 ， 两 个 是 引用 类 型 (string 和 objecb。 


2.3.3 ”预定 义 的 值 类 型 
内 置 的 .NET 值 类 型 表示 基本 类 型 ， 如 整 型 和 浮 点 类 型 、 字 符 类 型 以 及 布尔 类 型 。 
1. 整 型 
CH# 文 持 8 个 预定 义 的 整 型 类 型 ， 如 表 2-1 所 示 。 
表 2-1 
名 称 范围 (最 小 一 最 大 ) 
sbyte 8 位 有 符号 的 整数 2 


short System.Int16 16 位 有 符号 的 整数 -32 768~32 767 (20~215 1) 


int System.Int32 32 位 有 符号 的 整数 -2 147 483 648~2 147 483 647 (23 一 23L_1) 


long System.Int64 64 位 有 符号 的 整数 -9 223 372 036 854 775 808 一 
9 223 372 036 854 775 807 (一 264 一 26_1) 
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( 续 表 ) 
名 TT 


ushort System.UInt16 16 位 无 符号 的 整数 0 一 65 535 (0 一 210 1) 
Uint System.UJnt32 32 位 无 符号 的 整数 0 一 4 294 967 295 (0 一 232_1) 
ulong System .UInt64 64 位 无 符号 的 整数 0 一 18 446 744 073 709 551 615 (0 一 26_1) 


有 些 C# 类 型 的 名 称 与 CHH 和 Java 类 型 一 致 ， 但 定义 不 同 。 例 如 ， 在 C# 中 ，int 总 是 32 位 有 符号 的 整数 。 
而 在 C++ 中 ，int 是 有 符号 的 整数 ， 但 其 位 数 取 决 于 平台 (在 Windows 上 是 32 位 )。 在 C# 中 ， 所 有 的 数据 类 型 都 
以 与 平台 无 关 的 方式 定义 ， 以 备 将 来 从 C# 和 .NET 迁移 到 其 他 平台 上 。 

byte 是 0~255( 包 括 255) 的 标准 8 位 类 型 。 注 意 ， 在 强调 类 型 的 安全 性 时 ，C# 认 为 byte 类 型 和 char 类 型 完 
全 不 同 ， 它 们 之 间 的 编程 转换 必须 显 式 请 求 。 还 要 注意 ， 与 整数 中 的 其 他 类 型 不 同 ，byte 类 型 在 默认 状态 下 是 
无 符号 的 ， 其 有 符号 的 版 本 有 一 个 特殊 的 名 称 sbyte。 

在 NET 中 ，short 不 再 很 短 ， 现 在 它 有 16 位 长 。int 类 型 更 长 ， 有 32 位 。long 类 # 
整数 类 型 的 变量 都 能 被 赋予 十 进 制 或 十 六 进 制 的 值 ， 后 者 需要 0x 前 组 ; 

long x = Oxl2ab; 

如 果 对 一 个 int、uint、long 或 ulong 类 型 的 整数 没有 任何 显 式 的 声明 ， 则 该 变量 默认 为 int 类 型 。 

为 了 把 输入 的 值 指定 为 其 他 整数 类 型 ， 可 以 在 数字 后 面 加 上 如 下 字符 : 

0 


ulong ul = 1234UL; 


也 可 以 使 用 小 写字 母 u 和 1， 但 后 者 会 与 整数 1 混 消 。 


数字 分 隔 符 

C#7 提供 了 数字 分 隔 符 。 这 些 分 隔 符 有 助 于 提高 可 读 性 ， 且 不 添加 任何 功能 。 例 如 ， 可 以 同 数 字 添 加 下 划 
线 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文 件 UsingeNumbers/Program.cs); 

long 11 = 0X123 4267 89ab cedf; 

用 作 分 隔 符 的 下 划 线 被 编译 器 忽略 。 对 于 前 面 的 示例 ， 每 次 从 右边 读 取 16 位 (或 4 个 十 六 进 制 字符 )， 就 添 
加 一 个 数字 分 隔 符 。 结 果 比 另 一 种 更 容易 读 公 : 

long l12 = Oxl234567189abcedf; 

因为 编译 器 只 会 忽略 下 划 线 ， 所 以 用 户 要 负责 确保 可 读 性 。 可 以 在 任何 位 置 放置 下 划 线 ， 并 需要 确保 它 有 
助 于 提高 可 读 性 ， 而 不 是 如 本 例 所 示 : 

long 13 = 0X12345 6189 abc ed f; 

允许 把 数字 分 隔 符 放 在 任何 位 置 都 是 有 用 的 ， 因 为 这 允许 把 它 用 于 不 同 的 情况 一 一 例如 ， 使 用 十 六 进 制 或 
八进制 值 ， 或 者 分 离 协议 所 需 的 不 同位 (如 下 一 节 所 示 )。 


-JE 


最 长 ， 其 值 上 有 64 位。 所 有 


注意 : 

数字 分 隔 符 是 C#7 新 增 的 内 容 。C# 7.0 不 允许 前 置 数字 分 隔 符 ， 在 值 之 前 (和 前 组 之 后 ) 有 分 隔 符 。 前 导数 
字 分 隔 符 可 以 在 C#7.2 中 使 用 。 

二 进 制 值 

除了 提供 数字 分 隔 符 ，C# 7 还 便于 把 二 进 制 值 分 配给 整数 类 型 。 如 果 在 变量 值 前 面 加 上 0b 字面 值 作为 前 
， 只 允许 使 用 0 和 1。 只 有 二 进 制 值 可 以 分 配给 变量 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文件 
UsineNumbers/Proeram.cs): 


uint binaryl = 0bll11 1110 1101 1100 1011 1010 1001 1000; 
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前 面 的 代码 片段 使 用 一 个 32 位 的 无 符号 int。 数 字 分 阳 符 对 二 进 制 值 的 可 读 性 有 很 大 帮助 。 这 段 代码 把 二 
进 制 值 分 隔 为 4 位 一 组 。 记 住 ， 也 可 以 用 十 六 进 制 记 数 法 : 

uint hexl = Oxfedcbhagdg8:; 

使 用 八进制 记 数 法 时 ， 每 三 位 使 用 一 个 分 隔 符 会 有 所 帮助 ， 在 0( 二 进 制 为 000) 和 7( 二 进 制 为 111) 之 间 使 用 
字符 : 

uint binary2 = 0bl11 110 101 100 011 010 001 000; 

下 面 的 示例 展示 了 如 何 定义 可 以 在 二 进 制 协议 中 使 用 的 值 ， 其 中 两 个 位 定义 了 最 右边 的 部 分 ，6 位 在 下 一 
部 分 中 ， 最 后 两 个 部 分 有 4 位 来 完成 16 位 : 

ushort binary3 = Obllll 0000 101010 11; 


记 住 ， 为 需要 的 位 数 使 用 正确 的 整数 类 型 ，ushort 用 于 16 位 ，uint 用 于 32 位 ，ulong 用 于 64 位 。 


注意 : 
第 6 和 第 11 章 介 绍 了 二 进 制 数据 的 更 多 信息 。 


注意 : 

二 进 制 字 面值 是 C#7 的 新 增 功能 。 

2. 浮 点 类 型 

C# 提 供 了 许多 整 型 数据 类 型 ， 也 支持 浮 点 类 型 ， 如 表 2-2 所 示 。 


表 2-2 


和 名称 范围 (大 至) 


float System.Single 32 0 下 志 +1.5X10~—+3.4X10% 


float 数据 类 型 用 于 较 小 的 浮 点 值 ， 因 为 它 要 求 的 精度 较 低 。double 数据 类 型 比 float 数据 类 型 大 ， 提供 的 精 
度 也 大 一 倍 (15 位 )。 

如 果 在 代码 中 对 某 个 非 整数 值 (如 12.3) 硬 编码 ， 则 编译 器 一 般 假 定 该 变量 是 double。 如 果 想 指定 该 值 为 
float， 可 以 在 其 后 加 上 字符 F( 或 个 : 

float f£ = 12.3F: 

3. decimal 类 型 

decimal 类 型 表示 精度 更 高 的 浮 点 数 ， 如 表 2-3 所 示 。 


表 2-3 
和 名称 位 数 E 
decimal é | System.Decimal 128 位 高 精度 十 进 制 数 表示 法 +1.0X 1023~47.9X 10 


NET 和 C# 数 据 类 型 的 一 个 重要 优点 是 提供 了 一 种 专用 类 型 进行 财务 计算 ， 这 就 是 decimal 类 型 。 使 用 
decimal 类 型 提供 的 28 位 的 方式 取决 于 用 户 。 换 言 之 ， 可 以 用 较 大 的 精确 度 ( 带 有 美 分 ) 来 表示 较 小 的 美元 值 ， 
也 可 以 在 小 数 部 分 用 更 多 的 舍 入 来 表示 较 大 的 美元 值 。 但 应 注意 ，decimal 类 型 不 是 基本 类 型 ， 所 以 在 计算 时 使 
用 该 类 型 会 有 性 能 损失 。 

要 把 数字 指定 为 decimal 类 型 而 不 是 double、float 或 整数 类 型 ， 可 以 在 数字 的 后 面 加 上 字符 M( 或 9)， 如 
下 所 示 : 
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decimal d = 12.30M; 


4. bool 类 型 
C# 的 bool 类 型 用 于 包含 布尔 值 tue 或 false， 如 表 2-4 所 示 。 


表 2-4 
名 称 NET 类 型 EN .El 本 到 到 值 


bool 值 和 整数 值 不 能 相互 隐 式 转换 。 如 果 变 量 (或 冰 数 的 返回 类 型 ) 声 明 为 bool 类 型 ， 就 只 能 使 用 值 tue 或 
false。 如果 试图 使 用 0 表示 false， 非 0 值 表 示 tue， 就 会 出 错 。 
为 了 保存 单个 字符 的 值 ，C# 文 持 char 数据 类 型 ， 如 表 2-5 所 示 。 


表 2-5 
汪 


char 类 型 的 字面 量 是 用 单 引 号 括 起 来 的 ， 如 'A'。 如 果 把 字符 放 在 双 引 号 中 ， 编 译 器 会 把 它 看 成 字符 串 ， 从 
而 产生 错误 。 

除了 把 char 表示 为 字符 字面 量 之 外 ， 还 可 以 用 4 位 十 六 进 制 的 Unicode 值 ( 如 "\u0041”)、 带 有 强制 类 型 转换 
的 整数 值 (如 (char)65) 或 十 六 进 制 数 ( 如 "x0041") 表 示 它 们 。 它 们 还 可 以 用 转 义 序列 表示 ， 如 表 2-6 所 示 。 


表 2-6 
转 义 序列 字 符 
\ 单 引号 
\ 双 引 号 
\ 反 斜 杠 
‘0 于 
\a 警告 
\b 退 格 
让 换 页 
I 换行 
\r 回 车 
让 水 平 制 表 符 
Ww 垂直 制 表 符 
6. 数字 的 字面 值 
表 2-7 总 结 了 可 以 用 于 数字 的 字面 值 。 该 表 重 复 前 几 节 的 字面 值 ， 将 它们 集中 在 一 个 地 方 。 
表 2-7 
字面 值 位 置 说 明 
后缀 unsigned nt 
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( 续 表 ) 


M 十 进 制 (货币 ) 
Ox 
ob 


前 级 六 进 制 数 字 ， 允 许 使 用 0~F 


二 进 制 数字 ， 只 多 许 使 用 0 和 1 


2.3.4 预定 义 的 引用 类 型 
C# 文 持 两 种 预定 义 的 引用 类 型 ; object 和 string, 如 表 2-8 所 示 。 


表 2-8 
名 称 .NET 类 型 说 明 
object System.Object 根 类 型 ， 其 他 类 型 都 是 从 它 派 生 而 来 的 (包括 值 类 型 ) 
string Unicode 字符 串 
1. object 类 型 


许多 编程 语言 和 类 层次 结构 都 提供 了 根 类 型 ， 层 次 结构 中 的 其 他 对 象 都 从 它 派生 而 来 。C# 和 .NET 也 不 例 
外 。 在 C# 中 ，object 类 型 就 是 最 终 的 父 类 型 ， 所 有 内 置 类 型 和 用 户 定 义 的 类 型 都 从 它 派生 而 来 。 这 样 ，object 
类 型 就 可 以 用 于 两 个 目的 : 
e 可 以 使 用 object 引用 来 绑 定 任 何 特定 子 类 型 的 对 象 。 例 如 ,第 6 章 将 说 明 如 何 使 用 object 类 型 把 堆栈 中 
的 值 对 象 装 箱 ， 再 移动 到 堆 中 。object 引用 也 可 以 用 于 反射 ， 此 时 必须 有 代码 来 处 理 类 型 未 知 的 对 象 。 
se object 类 型 实现 了 许多 一 般 用 途 的 基本 方法 ， 包 括 Equals0、GetHashCode0、GetType0 和 ToString()。 
用 户 定义 的 类 需要 使 用 一 种 面向 对 象 技 术 一 一 重 写 ,来 提供 其 中 一 些 方法 的 替代 实现 代码 。 例 如 ， 重 写 
ToString0 时 ， 要 给 类 提供 一 个 方法 ， 给 出 类 本 和 里 的 字符 串 表示 。 如 果 类 中 没有 提供 这 些 方 法 的 实现 代 
码 ， 编 译 器 就 会 使 用 object 类 型 中 的 实现 代码 ， 它 们 在 类 上 下 文中 的 执行 不 一 定 正 确 。 
后 面 将 详细 讨论 object 类 型 。 
2. string 类 型 
C# 有 string 关键 字 ， 在 遮 嘲 下 转换 为 NET 类 System.String。 有 了 它 ， 像 字符 串 连 接 和 字符 串 复 制 这 样 的 操 
作 吏 很 简单 了 : 
string strl = "Hello "; 


string str2 = "World"™; 
string str3 = Strl + str2; // string concatenation 


尽管 这 是 一 个 值 类 型 的 赋值 ， 但 string 是 一 个 引用 类 型 。string 对 象 被 分 配 在 堆 上 ， 而 不 是 栈 上 。 因 此 ， 当 
把 一 个 字符 串 变 量 赋予 另 一 个 字符 串 时 ， 会 得 到 对 内 存 中 同一 个 字符 串 的 两 个 引用 。 但 是 ，string 与 引用 类 型 
的 和 常见 行为 有 一 些 区 别 。 例 如 ， 字 符 串 是 不 可 改变 的 。 修 改 其 中 一 个 字符 串 ， 就 会 创建 一 个 全 新 的 string 对 象 ， 
而 男 一 个 字符 串 不 发 生 任 何 变 化 。 考 虑 下 面 的 代码 (代码 文件 StingSample/Program_cs): 

using System; 


Class Program 

{ 
static void Main() 
{ 


string sl1 = "a string™s 
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string 5s2 = sil; 
Console.WriteLine("sl1 1S ™ + S1L); 
Console.WriteLine("s2 is ™ + s2).: 
sl1 = "another string™; 
Console.WriteLine{("sl1 is now ™ + sl1}:; 
Console.WrijteLine("s2 1S now nm + 号 2) ; 
} 
} 


其 输出 结果 为 : 

sl is a string 

s2 is a string 

sl is now another string 

s2 is now a string 

改变 sl 的 值 对 s2 没有 影响 ， 这 与 我 们 期 待 的 引用 类 型 正好 相反 。 当 用 值 a string 初始 化 s1 时 ， 就 在 堆 上 
分 配 了 一 个 新 的 string 对 象 。 在 初始 化 s2 时 ， 引 用 也 指 阿 这 个 对 象 ， 所 以 s2 的 值 也 是 a string。 但 是 当 现 在 要 
改变 sl 的 值 时 ， 并 不 会 蔡 换 原来 的 值 ， 而 是 在 堆 上 为 新 值 分 配 一 个 新 对 象 。s2 变量 仍 指 回 原来 的 对 象 ， 所 以 
它 的 值 没有 改变 。 这 实际 上 是 运算 符 重 载 的 结果 ， 运 算 和 从 重 载 详 见 第 6 章 。 基 本 上 ，string 类 已 实现 ， 其 语义 
遵循 一 般 的 、 直 观 的 字符 串 规则 。 

字符 串 字 面 量 放 在 双 引 号 中 ("..."); 如 果 试 图 把 字符 串 放 在 单 引 号 中 ,编译 器 就 会 把 它 当 成 char 类 型 ， 从 而 
抛 出 错误 。C# 字 符 串 和 char 一 样 ， 可 以 包含 Unicode 和 十 六 进 制 数 转 义 序列 。 因 为 这 些 转 义 序列 以 一 个 反 斜 杠 
开头 ， 所 以 不 能 在 字符 串 中 使 用 没有 经 过 转 义 的 反 冬 杠 字符 ， 而 需要 用 两 个 反 斜 杠 字 符 (W) 表 示人 它 : 


string filepath = "C:\\ProCSharp\\First.cs"™; 


警告 : 

注意 , 对 目录 使 用 反 斜 杠 人 并 使 用 C: 将 应 用 程序 限制 为 Windows 操作 系统 。Windows 和 Linux 都 可 以 使 用 
斜 杠 (/) 分 隔 目录 。 第 22 章 提供 了 关于 如 何 处 理 Windows 和 Linux 上 的 文件 和 目录 的 详细 信息 。 

输入 两 个 反 斜 杠 字符 会 令 人 迷惑 。 幸 好 ，C# 提 供 了 蔡 代 方式 。 可 以 在 字符 串 字 面 量 的 前 面 加 上 字符 @， 在 
这 个 字符 后 的 所 有 字符 都 看 成 其 原来 的 含义 一 一 它们 不 会 解释 为 转 义 字符 : 

string filepath = @"C:\Procsharp\First.cs"; 

甚至 允许 在 字符 串 字 面 量 中 包含 换行 符 : 


string jabberwocky = @""'Twas brillig and the slithy toves 
Did gyre and gimble in the wabe.™; 


那么 jabberwocky 的 值 就 是 : 


'Twas brillig and the slithy toves 
Did gyre and gimble in the wabe. 
C# 定 义 了 一 种 新 的 字符 串 插值 格式 ， 用 $ 前 缀 来 标记 。 可 以 使 用 字符 串 插值 格式 ， 改 变 前 面 演 示 字 符 串 连 
接 的 代码 片段 。 对 字符 串 加 上 $ 前 经， 就 允许 把 花 括号 放 在 包含 一 个 变量 或 代码 表达 式 的 字符 串 中 。 变 量 或 代 
码 表达 式 的 结果 放 在 字符 串 中 花 括号 所 在 的 位 置 : 
Public static void Main() 
< sl1 = "a string"™s 
string 5s2 = sil; 
Console .WriteLine($"sl1 is {sl1}"); 
Console .WriteLine($"s2 is {s2}"); 
sl1 = "another string"™; 
Console .WriteLine($"sl1 is now {s1}").; 
Console .WriteLine($"s2 is now {s2}"); 
} 


江汉 二 
字符 事 和 字符 囊 插值 功 能 参见 第 9 章 。 
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2.4 ”程序 流 控制 
本 节 将 介绍 C# 语 言 最 基本 的 重要 语句 : 控制 程序 流 的 语句 。 它们 不 是 按 代 码 在 程序 中 的 排列 位 置 顺序 执行 的 。 
2.4.1 条 件 语句 


条 件 语句 可 以 根据 条 件 是 否 满足 或 根据 表达 式 的 值 来 控制 代码 的 执行 分 文 。C# 有 两 个 控制 代码 的 分 文 的 续 
构 : 站 语句 ， 测 试 特定 条 件 是 否 满足 ; switch 语句， 比较 表达 式 和 多 个 不 同 的 值 。 


1. if 语句 
对 于 条 件 分 文 ，C# 继 承 了 C 和 C++ 的 正 .-else 结构 。 对 于 用 过 程 语言 编程 的 人 ， 其 语法 非常 直观 : 


if (condition) 
statement (s) 

= 村 = 二。 
statement (s) 


如 果 在 条 件 中 要 执行 多 个 语句 ， 吏 需要 用 人 花 插 号 ({ … }) 把 这 些 语句 组 合 为 一 个 块 (这 也 适用 于 其 他 可 以 把 语 
句 组 合 为 一 个 块 的 C# 结 构 ， 如 for 和 while 循环 )。 


bool 38ETOD， 
if {1i == 0) 
{ a 
1s2ero = true; 
Console.WriteLine("i is Zero™).; 
} 
全 ] Se 
{ 
isBero = false; 
Console.WriteLine("i is Non-zero™).; 


] 


还 可 以 单独 使 用 让 语句 ， 不 加 最 后 的 else 语句 。 也 可 以 合并 else 站 子 句 ， 测 试 多 个 条 件 (代码 文件 
IfSstatement/Program.cs)。 


using System; 
namespace WIox 
{ 
Class Program 
{ 
static void Maint{) 
{ 
Console.WriteLine ("Type in a string"); 
string input; 
input = Console.ReadLine () : 
if (input == ™") 
{ 
CoDnSoO]e .WriteLine{("You typed in an empty string."™); 
} 
else if (input.Length < 5) 
{ 


CoDnSO]Ee .WriteLine("The string had less than 5 characters."™); 
} 
else if (input.Length < 10) 


Console .WriteLinetl 
"The string had at least 5 but less than 10 Characters.™); 
Console.WriteLine ("The string was "十 input).; 
} 


} 
} 


添加 到 让 子 句 中 的 else 让 语句 的 个 数 不 受 限制 。 

注意 ， 在 上 面 的 例子 中 ， 声 明了 一 个 字符 串 变量 input， 让 用 户 在 命令 行 中 输入 文本 ， 把 文本 填充 到 input 
中 ， 然 后 测试 该 字符 串 变 量 的 长 度 。 代 码 还 显示 了 在 C# 中 如 何 进行 字符 串 处 理 。 例 如 ， 要 确定 input 的 长 度 ， 
可 以 使 用 input.Length。 
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对 于 让 语句 ， 要 注意 的 一 点 是 如 果 条 件 分 支 中 只 有 一 条 语句 ， 束 不 需要 使 用 花 括号 : 
if (i == 0) 
Console.WriteLine("i is Zero"); // This will only execute if i == 0 
Console.WriteLine("i can be anvything"™); // Will execute whatever the 
/i/ value of i 


但 是 ， 为 了 保持 一 致 ， 许 多 程序 员 只 要 使 用 让 语句 ， 束 加 上 人 花 括 号 。 


提示 : 

在 这 语句 中 不 使 用 花 括 号 , 可 能 在 维护 代码 时 导致 错误 . 无 论 寺 语句 返回 true 还 是 flse， 都 常常 给 诺 语句 
添加 第 二 条 语句 。 每 次 都 使 用 花 括 号 ， 就 可 以 避免 这 个 编码 错误 . 

使 用 让 语句 的 一 个 指导 原则 是 只 有 语句 和 证 语 自 写 在 同一 行 上 ， 才 不 允许 程序 员 使 用 花 括 号 。 遵 守 这 条 指 
导 原 则 ， 程 序 员 就 不 太 可 能 在 添加 第 二 条 语句 时 不 添加 花 括号 。 


前 面 介绍 的 站 语句 还 演示 了 用 于 比较 数值 的 一 些 C# 运 算 答 。 特 别 注意 ，C# 使 用 “==” 对 变量 进行 等 于 比 
较 。 此 时 不 要 使 用 “=”， 一 个 “=” 用 于 赋值 。 

在 C# 中 ， 计 子 句 中 的 表达 式 必 须 等 于 布尔 值 (Boolean)。 不 能 直接 测试 整数 (如 从 函数 中 返回 的 值 )， 而 必须 
显 式 地 把 返回 的 整数 转换 为 布尔 值 tue 或 false， 例 如， 将 值 与 0 或 null 进行 比较 : 
if (DoSomething() != 0) 
// Non-zero Value returned 


} 


已 了 号 已 


/:/ Returned zero 


} 

2. switch 语句 

switch...case 语句 适合 于 从 一 组 互 斥 的 可 执行 分 文中 选择 一 个 执行 分 支 。 其 形式 是 switch 参数 的 后 面 跟 一 
组 case 子 句 。 如 果 switch 参数 中 表达 式 的 等 于 某 个 case 子 句 劳 边 的 某 个 值 ， 就 执行 该 case 子 句 中 的 代码 。 此 
时 不 需要 使 用 花 括号 把 语句 组 合 到 块 中 , 只 需要 使 用 break 语句 标记 每 段 case 代码 的 结尾 即 可 。 也 可 以 在 switch 
语句 中 包含 一 条 default 子 句 ， 如 果 表 达 式 不 等 于 任何 case 子 句 的 值 ， 就 执行 default 子 句 的 代码 。 下 面 的 switch 
语句 测试 integerA 变量 的 值 : 


switch (integerA) 
{ 
Case 1: 
Console.WriteLine ("integerA = 1"); 
break:; 
CaSEeE 2: 
Console.WriteLine ("integeraA = 2");}; 
break; 
CasSe 3: 
Console.WriteLine ("integeraA = 3").，; 
break; 
default: 
Console.WriteLine ("integerA is not 1, 2, or 3"); 
break; 


} 

注意 case 值 必 须 是 常量 表达 式 ， 不 允许 使 用 变量 。 

C 和 C++ 程序 员 应 该 很 熟悉 switch...case 语句 ， 而 C# 的 switch...case 语句 更 安全 。 特 别 是 它 禁 止 几乎 所 有 
case 中 的 失败 条 件 。 如 果 激 活 了 块 中 靠 前 的 一 条 case 子 句 ， 后 面 的 case 子 句 就 不 会 被 激活 ， 除 非 使 用 goto 语 
句 特别 标记 也 要 激活 后 面 的 case 子 句 。 编 译 器 会 把 没有 break 语句 的 case 子 句 标记 为 错误 ， 从 而 强制 实现 这 一 

Control cannot fall through from one case label ('case 2:') to another 

在 有 限 的 几 种 情况 下 ， 这 种 失败 是 允许 的 ， 但 大 多 数 情况 下 ， 我 们 不 希望 出 现 这 种 失败 ， 而 且 这 会 导致 出 
现 很 难 察觉 的 逻辑 错误 。 让 代码 正常 工作 ， 而 不 是 出 现 异 前 ， 这 样 不 是 更 好 吗 ? 
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ol} 


但 在 使 用 goto 语句 时 , 会 在 switch...cases 中 重复 出 现 失败 。 如果 确实 想 这 么 做 , 就 应 重新 考虑 设计 方案 了 。 
下 面 的 代码 说 明了 如 何 使 用 goto 模拟 失败 ， 得 到 的 代码 会 非常 混乱 : 


// assume country and language are of type String 
switch (country) 
{ 
Case "America™: 
CallAmericanonlyMethod():; 
goto case "Britain™; 
CaSe "FIAaNcCe™: 
landgquage = "French"; 
break; 
case "Britain™: 
language = "EnNnglish"™; 
break; 
} 
但 有 一 种 例外 情况 。 如 果 一 条 case 子 句 为 空 ， 就 可 以 从 这 条 case 子 句 跳 到 下 一 条 case 子 句 ， 这 样 就 可 以 
用 相同 的 方式 处 理 两 条 或 多 条 case 子 句 (不 需要 goto 语句 )。 
switch (country) 


CaSe "AaAU™: 
Case "uk™: 
CAaASeE "US™: 
language = "English"™; 
break; 
Case "at™: 
CAase "de™: 
landguage = "German™; 
break; 
} 
在 C# 中 ，switch 语句 的 一 个 有 趣 的 地 方 是 case 子 句 的 顺序 是 无 关 紧 要 的 ， 甚 至 可 以 把 default 子 句 放 在 最 
前 面 ! 因此 ， 任 何 两 条 case 都 不 能 相同 。 这 包括 值 相 同 的 不 同音 量 ， 所 以 不 能 这 样 编写 ; 
// assume country is of type string 
const string england = wuk™; 
Const string britain = uk™; 
switch (country) 
{ 
CasSe england.: 
case britain: // This will cause a compilation error. 
language = "English"™; 
break; 


} 
上 面 的 代码 还 说 明了 C# 中 的 switch 语句 与 C++ 中 的 switch 语句 的 另 一 个 不 同 之 处 : 在 C# 中 ， 可 以 把 字符 
串 用 作 测 试 的 变量 。 


注意 ; 
在 C#7 中 ， switch 语句 通过 模式 匹配 得 到 了 增强 。 使 用 模式 匹配 ，case 的 排序 变 得 很 重要 。 第 13 章 和 包含 
使 用 模式 匹配 的 switch 语句 的 更 多 信息 ， 


2.4.2 循环 


C# 提 供 了 4 种 不 同 的 循环 机 制 (for、while、do...while 和 foreach)， 在 满足 某 个 条 件 之 前 ， 可 以 重复 执行 代 
但 块 。 


1. for 循环 
C# 的 for 循环 提供 的 迭代 循环 机 制 是 在 执行 下 一 次 迭代 前 ， 测 试 是 否 满足 某 个 条 件 ， 其 语法 如 下 : 
其 中 : 


e initializer 是 指 在 执行 第 一 次 循环 前 要 计算 的 表达 式 ( 通 常 把 一 个 局 部 变量 初始 化 为 循环 计数 器 )。 
e condition 是 在 每 次 循环 的 新 运 代 之 前 要 测试 的 表达 式 ( 它 必须 等 于 true， 才 能 执行 下 一 次 友 代 )。 
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se iterator 是 每 次 进 代 完 要 计算 的 表达 式 ( 通 背 是 递增 循环 计数 器 )。 
当 condition 等 于 false 时 ， 和 迭代 停止 。 
for 循环 是 所 谓 的 预测 试 循 环 ， 因 为 循环 条 件 是 在 执行 循环 语句 前 计算 的 ， 如 果 循 环 条 件 为 假 ， 循 环 语句 就 


根本 不 会 执行 。 
for 循环 非常 适合 用 于 一 条 语句 或 语句 块 重复 执行 预定 的 次 数 。 下 面 的 例子 就 是 for 循环 的 典型 用 法 ， 这 段 
代码 输出 0-99 的 整数 : 


for (Int 1 = 0; LI 过 100; 工 = 工 十 1) 


Console.WriteLine (1i). 


这 里 声明 了 一 个 int 类 型 的 变量 i， 并 把 它 初始 化 为 0， 用 作 循 环 计 数 器 。 接 着 测试 它 是 否 小 于 100。 因 为 
这 个 条 件 等 于 tue， 所 以 执行 循环 中 的 代码 ， 显 示 值 0。 然 后 给 该 计数 器 加 1， 再 次 执行 该 过 程 。 当 i 等 于 100 
时 ， 循 环 停止 

实际 上 ， 上 述 编写 循环 的 方式 并 不 常用 。C# 在 给 变量 加 1 时 有 一 种 简化 方式 ， 即 不 使 用 i= 计 1， 而 简写 为 
itt: 

for (int 1 = 0; 1 < 100; 1++) 

dt a 

} 

也 可 以 在 上 面 的 例子 中 给 循环 变量 i 使 用 类 型 推断 。 使 用 类 型 推断 时 ， 循 环 结构 变 成 : 


for (Var i = 0; 1 < 100; 1i++) 
{ 

YA --- 
} 


岁 套 的 for 循环 非常 音 见 ， 在 每 次 碗 代 外 部 循环 时 ， 内 部 循环 都 要 彻底 执行 完毕 。 这 种 模式 通常 用 于 在 算 
形 多 维 数组 中 这 历 每 个 元 素 。 最 外 部 的 循环 志 历 每 一 行 ， 内 部 的 循环 遇 历 茶 行 上 的 每 个 列 。 下 面 的 代码 显示 数 
字 行 ， 它 还 使 用 另 一 个 Console 方法 Console.Wiite0， 该 方法 的 作用 与 Console.WiriteLine() 相 同 ， 但 不 在 输出 中 
添加 回 车 换行 符 ( 代 码 文件 ForLoop/Program.cs ): 

using System; 


namespace WIOXx 
{ 
Class Program 
{ 


static void Maint{) 


// This loop iterates through rows 

for {int 1 = 0; 1 < 100; 1+=10) 

{ 
// This loop iterates through columns 
for {int J = i; jj] < i+ 10; j++) 
{ 


Console .Write (s$™ {Ij}"); 
Ce 
本 
} 
} 
尽管 j 是 一 个 整数 ， 但 它 会 目 动 转 换 为 字符 串 ， 以 便 进行 连接 。 
上 述 例 子 的 结果 是 : 


O01l2z234406789 

10 11 12 13 14 15 16 17 18 19 
20 21 22 23 24 2 26 21 28 29 
30 31 32 33 34 3 36 31 38 39 
40 41 42 43 44 45 46 417 48 49 
30 51 52 5353 54 53 56 57 538 59 
60 61 62 63 64 65 66 67 68 69 
0 7L 2 13 74 1 76 778 79 
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0 路 


80 81 82 83 84 85 86 87 88 89 
90 91 92 93 94 95 9396 97 98 99 


尽管 在 技术 上 ， 可 以 在 for 循环 的 测试 条 件 中 计算 其 他 变量 ， 而 不 计算 计数 器 变量 ， 但 这 不 太 常 见 。 也 可 
以 在 for 循环 中 忽略 一 个 表达 式 (甚至 所 有 表达 式 )。 但 此 时 ， 要 考虑 使 用 while 循环 。 

2. while 循环 

与 for 循环 一 样 ，while 循环 也 是 一 个 预测 试 循环 。 其 语法 是 类 似 的 ， 但 while 循环 只 有 一 个 表达 式 : 


while (condition) 
statement (s).; 


与 for 循环 不 同 的 是 ，while 循环 最 常用 于 以 下 情况 : 在 循环 开始 前 ， 不 知道 重复 执行 一 条 语句 或 语句 块 的 
次 数 。 通 币 ， 在 茶 次 途 代 中 ，while 循环 体 中 的 语句 把 布尔 标志 设置 为 false， 结 束 循环 ， 如 下 面 的 例子 所 示 : 


bool condition = false; 
while (condition) 
{ 


// This loop spins until the condition is true. 
DoSsomeWork().; 
condition = CheckCcondition(}; // assume CheckCondition() returns a bool 


} 
3. do...while 循环 


do..while 循环 是 while 循环 的 后 测试 版 本 。 这 意味 着 该 循环 的 测试 条 件 要 在 执行 完 循环 体 之 后 评估 。 因 此 
do...while 循环 适用 于 循环 体 至 少 执行 一 次 的 情况 : 


bool condition; 

do 

{ 
// This loop will at least execute once, even if Condition is false. 
MustBeCcalledatLeastOnce().; 
condition = CheckCconditiont(}); 

} while (condition)}); 


4. foreach 循环 


foreach 循环 可 以 和 友 代 集合 中 的 每 一 项 。 现 在 不 必 考 虑 集合 的 准确 概念 (第 10 草 将 详细 介绍 集合 )， 只 需要 知 
道 集合 是 一 种 包含 一 系列 对 象 的 对 象 即 可 。 从 技术 上 看 ， 要 使 用 集合 对 象 ， 就 必须 文 持 IEnumerable 接口 。 集 
合 的 例子 有 C# 数 组 、System.Collection 名 称 空间 中 的 集合 类 ， 以 及 用 户 定义 的 集合 类 。 从 下 面 的 代码 中 可 以 了 
解 foreach 循环 的 语法 ， 其 中 假定 arrayOfInts 是 一 个 int 类 型 的 数组 : 

foreach (int temp in arraVyOfInts) 


Console -WIItLeLIne (temp); 
} 
其 中 ，foreach 循环 每 次 迭代 数组 中 的 一 个 元 际 。 它 把 每 个 元 素 的 值 放 在 int 类 型 的 变量 temp 中 ， 然 后 执行 
循环 迭代 。 
这 里 也 可 以 使 用 类 型 推断 。 此 时 ，foreach 循环 变 成 : 


foreach (var temp in arrayofIints) 
{ 


| 
Sx 


i 
} 


temp 的 类 型 推断 为 int， 因 为 这 是 集合 项 的 类 型 。 

注意 ，foreach 循环 不 能 改变 集合 中 各 项 (上 面 的 temp) 的 值 ， 所 以 下 面 的 代码 不 会 编译 : 
foreach (int temp in arrayOfIints) 

: tempt++; 

Console.WriteLine (temp); 


如 宁 需 要 友 代 集合 中 的 各 项 ， 并 改变 它们 的 值 ， 应 使 用 for 循环 。 
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2.4.3” 跳 转 语句 
C# 提 供 了 许多 可 以 立即 跳 转 到 程序 中 男 一 行 代码 的 语句 ， 在 此 ， 先 介绍 goto 语句 。 
1. goto 语句 
goto 语句 可 以 直接 跳 转 到 程序 中 用 标签 指定 的 男 一 行 (标签 是 一 个 标识 符 ， 后 跟 一 个 冒号 ): 


goto Labell; 

Console.WriteLine ("This won't pe executed"™}); 

Labell: 

Console.WriteLine("Continuyuing execution from here"™),;} 

goto 语句 有 两 个 限制 。 不 能 跳 转 到 像 for 循环 这 样 的 代码 块 中 ， 也 不 能 跳出 类 的 范围 ， 不 能 退出 try...catch 
块 后 面 的 finally 块 (第 14 章 将 介绍 如 何 用 try...catch...finally 块 处 理 异 闻 )。 

在 大 多 数 情况 下 不 允许 使 用 goto 语句 。 一 般 情况 下 ， 使 用 它 肯 定 不 是 面 品 对 象 编程 的 好 方式 。 

2. break 语句 

前 面 简要 提 到 过 break 语句 一 在 switch 语句 中 使 用 它 退出 某 个 case 语句 。 实际 上 , break 语句 也 可 以 用 于 
退出 for、foreach、while 或 do...while 循环 ， 该 语句 会 使 控制 流 执 行 循 环 后 面 的 语句 。 

如 果 该 语句 放 在 区 套 的 循环 中 ， 就 执行 最 内 部 循环 后 面 的 语句 。 如 果 break 放 在 switch 语句 或 循环 外 部 ， 
就 会 产生 编译 错误 。 

3. continue 语句 

continue 语句 类 似 于 break 语句 ， 也 必须 在 for、foreach、while 或 do...while 循环 中 使 用 。 但 它 只 退出 循环 
的 当前 和 途 代 ， 开 始 执行 循环 的 下 一 次 欠 代 ， 而 不 是 退出 循环 。 

4. return 语句 


retum 语句 用 于 退出 类 的 方法 ， 把 控制 权 返 回 给 方法 的 调用 者 。 如 果 方 法 有 返回 类 型 ，retum 语句 必须 返回 
这 个 类 型 的 值 ， 如 果 方 法 返回 void， 应 使 用 没有 表达 式 的 Tetum 语句 。 


2.5 ”名 称 空间 


如 前 所 述 ， 名 称 空间 提供 了 一 种 组 织 相 关 类 和 其 他 类 型 的 方式 。 与 文件 或 组 件 不 同 ， 名 称 空间 是 一 种 逻辑 
组 合 ， 而 不 是 物理 组 合 。 在 C# 文 件 中 定义 类 时 ， 可 以 把 它 包括 在 名 称 空间 定义 中 。 以 后 ， 在 定义 男 一 个 类 (在 
另 一 个 文件 中 执行 相关 操作 ) 时 ， 融 可 以 在 同一 个 名 称 空间 中 包含 它 ， 创 建 一 个 逻辑 组 合 ， 该 组 合 告诉 使 用 类 
的 其 他 开发 人 员 : 这 两 个 类 是 如 何 相关 的 以 及 如 何 使 用 它们 : 

usS1ing SYStem; 


namespace CustomerPhoneBookApp 


{ 


Public struct Subscriber 


// Code for struct here.. 
} 

} 
把 一 个 类 型 放 在 名 称 空间 中 ， 可 以 有 效 地 给 这 个 类 型 指定 一 个 较 长 的 名 称 ， 该 名 称 包括 类 型 的 名 称 空间 ， 名 
称 之 间 用 句点 ()] 隔 开 , 最 后 是 类 名 。 在 上 面 的 例子 中 , Subscriber 结构 的 全 名 是 CustomerPhoneBookApp.Subscriber。 
这 样 ， 有 相同 短 名 的 不 同类 就 可 以 在 同一 个 程序 中 使 用 了 。 全 名 篆 弟 称 为 完全 限定 的 名 称 。 

也 可 以 在 名 称 空间 中 磐 僚 其 他 名 称 空 间 ， 为 类 型 创建 层次 结构 ; 

namespace WIOK 

{ 


namespace ProCcsharp 


{ 


48 | 第 1 部 分 C# 语言 


namespace Basics 

{ 
class NamespaceExample 
{ 

// code for the class here.. 

} 

} 

} 
} 


每 个 名 称 空间 名 都 由 它 所 在 名 称 空间 的 名 称 组 成 ， 这 些 名 称 用 句点 分 隔 开 ,开头 是 最 外 层 的 名 称 空 间 ， 最 后 
是 它 目 己 的 短 名 。 所 以 ProCsharp 名 称 空间 的 全 名 是 Wrox.ProCSharp，NamespaceExample 类 的 全 名 是 
Wrox.ProCSsharp.Basics.NamespaceExample。 

使 用 这 个 语法 也 可 以 在 上 自己 的 名 称 空 间 定义 中 组 织 名 称 空间 ， 所 以 上 面 的 代码 也 可 以 写 为 : 

namespace Wrox.ProCcsharp.Basics 
, class NamespaceExample 

: // Code for the class here.. 
} 

注意 不 允许 声明 嵌 套 在 男 一 个 名 称 空间 中 的 多 部 分 名 称 空间 。 

名 称 空间 与 程序 集 无 关 。 同 一 个 程序 集中 可 以 有 不 同 的 名 称 空间 ， 也 可 以 在 不 同 的 程序 集中 定义 同一 个 名 
称 空 间 中 的 类 型 。 

应 在 开始 一 个 项 目 之 前 就 计划 定义 名 称 空间 的 层次 结构 。 一般 可 接受 的 格式 是 CompanyName.ProjectName. 
SystemsSection。 所 以 在 上 面 的 例子 中 ，Wrox 是 公司 名 ，ProCSharp 是 项 目 ， 对 于 本 章 ，Basics 是 部 分 名 。 


2.5.1 using 语句 


显然 ， 名 称 空间 相当 长 ， 输 入 起 来 很 麻烦 ， 用 这 种 方式 指定 菏 个 类 也 不 总 是 必要 的 。 如 本 章 开 头 所 述 ，C# 
允许 简写 类 的 全 名 。 为 此 ， 要 在 文件 的 顶部 列 出 类 的 名 称 空间 ， 前 面 加 上 using 关键 字 。 在 文件 的 其 他 地 方 ， 
就 可 以 使 用 其 类 型 名 称 来 引用 名 称 空间 中 的 类 型 了 : 


UslIng System; 
usSing Wrox.ProCsharp; 


如 前 所 述 ， 很 多 C# 文 件 都 以 语句 using System: 开 头 ， 这 仅 是 因为 微软 公司 提供 的 许多 有 用 的 类 都 包含 在 
System 名 称 空 间 中 。 

如 果 using 语句 引用 的 两 个 名 称 空间 包含 同名 的 类 型 ， 就 必须 使 用 完整 的 名 称 ( 或 者 至 少 较 长 的 名 称 )， 
确保 编译 器 知道 访问 哪个 类 型 。 例 如 ， 假 如 类 NamespaceExample 同时 存在 于 Wrox.ProCSharp.Basics 和 
Wrox.ProCSharp.OOP 名 称 空间 中 。 如 果 要 在 名 称 空间 Wrox.ProCSharp 中 创建 一 个 类 Test， 并 在 该 类 中 实例 化 
一 个 NamespaceExample 类 ， 就 需要 指定 使 用 哪个 类 : 

using Wrox.Procsharp.OOP; 

using Wrox.ProCcsharp.Basics; 


namespace Wrox.ProCcsharp 


Class Test 


{ 
static void Main'() 
{ 
Basics.NamespaceExample nS3Ex = new Basics.NamespaceExample(); 
// do something with the nsEx variable. 
} 
} 


} 
公司 应 花 一 些 时 间 开 发 一 种 名 称 空间 模式 ， 这 样 开 发 人 员 才 能 快速 定位 他 们 需要 的 功能 ， 而 且 公司 内 部 使 
用 的 类 名 也 不 会 与 现 有 的 类 库 相 冲突 。 本 章 后 面 将 介绍 建立 名 称 空间 模式 的 规则 和 其 他 命名 约定 。 
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2.5.2 ”名 称 空间 的 别名 


using 关键 字 的 男 一 个 用 途 是 给 类 和 名 称 空间 指定 别名 。 如 果 名 称 空间 的 名 称 非常 长 ,又 要 在 代码 中 多 次 引 
用 , 但 不 希望 该 名 称 空间 的 名 称 包含 在 using 语句 中 (例如 , 避免 类 名 冲突 ), 就 可 以 给 该 名 称 空 间 指 定 一 个 别名 ， 
其 语法 如 下 : 
using alias = NamespaceName:; 
下 面 的 例子 (前 面 例子 的 修订 版 本 ) 给 Wrox.ProCSharp.Basics 名 称 空间 指定 别名 Introduction， 并 使 用 这 个 别 
名 实例 化 了 在 该 名 称 空间 中 定义 的 NamespaceExample 对 象 。 注 意 名 称 空间 别名 的 修饰 符 是 “::”。 因 此 将 强制 
先 从 Introduction 名 称 空间 别名 开始 搜索 。 如 果 在 相同 的 作用 域 中 引入 了 Introduction 类 ,就 会 发 生 冲 突 。 即 使 出 
现 了 冲突 ,“:: ”运算 符 也 允许 引用 别名 。NamespaceExample 类 有 一 个 方法 GetNamespace0， 该 方法 调用 每 个 类 
都 有 的 GetType0 方 法 ， 以 访问 表示 类 的 类 型 的 Type 对 象 。 下 面 使 用 这 个 对 象 返回 类 的 名 称 空间 名 (代码 文件 
NamespaceSample/Program.cs ): 
using System; 
using Introduction = Wrox.ProCcsharp.Basics; 
class Program 
{ 
static void Main () 
Introduction: :NamespaceExample NSEx = new Introduction::NamespaceExample (); 
| Console -WriteLine (NSEX-GetNamespace()); 
} 


namespace Wrox.ProCcSharp.Basics 
{ 
class NamespaceExample 
{ 
PUublic string GetNamespace () 
{ 


return this.GetType() .Namespacer 
} 
} 
} 


2.6 ”Main() 方 法 


本 章 的 开头 提 到 过 ，C# 程 序 是 从 方法 Main0 开 始 执 行 的 。 根 据 执行 环境 ， 有 不 同 的 要 求 : 

e 使 用 了 static 修饰 符 

e 在 有 任何 名 称 的 类 中 

se 返回 int 或 void 类 型 

虽然 显 式 指定 public 修饰 从 是 很 闸 见 的 ， 因 为 按照 定义 ， 必 须 在 程序 外 部 调用 该 方法 ， 但 给 该 入 口 点 方法 
指定 什么 访问 级 别 并 不 重要 ， 即 使 把 该 方法 标记 为 private， 它 也 可 以 运行 。 

前 面 的 例子 只 介绍 了 不 带 参数 的 Main0 方 法 。 但 在 调用 程序 时 ， 可 以 让 CLR 包含 一 个 参数 ,将 命令 行 参数 
传递 给 程序 。 这 个 参数 是 一 个 字符 串 数组 ， 传 统 上 称 为 args( 但 C# 可 以 接受 任何 名 称 )。 在 启动 程序 时 ， 程 序 可 
以 使 用 这 个 数组 ， 访 问 通过 命令 行 传送 的 选项 。 

下 面 的 例子 在 传送 给 Main0 方 法 的 字符 串 数组 中 循环 ， 并 把 每 个 选项 的 值 写 入 控制 台 窗 口 (代码 文件 
AreumentsSample/Proeram.cs ): 

using System; 

namespace WIox 

{ 

Class Program 
{ 
static void Main(string[] args) 


{ 
for (int 1 = 0; 1 < args.Length; 1++) 


50 | 第 1 部 分 C# 语 


0 路 


{ 
Console -WTILeLIne(argds [ 工 ] ) ; 
} 
} 
} 
} 


在 Visual Studio 2017 中 运行 应 用 程序 时 ， 要 给 程序 传递 参数 ， 可 以 在 项 目 属 性 的 Debug 部 分 定义 参数 ， 如 
图 2-1 所 示 。 运 行 应 用 程序 ， 会 在 控制 台 上 显示 所 有 参数 值 。 

使 用 .NET Core CLI 工具 从 命令 行 上 运行 应 用 程序 时 ， 只 需要 在 dotmet run 命令 后 面 提供 参数 : 

dotnet run argl] arg2 arg3 

如 果 想 提供 与 dotnet run 命令 的 参数 相 神 突 的 参数 ， 可 以 在 提供 程序 的 参数 之 前 添加 两 个 短 横 号 (-): 


dotnet run 一 一 argl aaIgoz arg3 
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ArgumentsSample  X 
Application NA 
Build 
Build Events 
Package 


[Devs 


Signing 


Argurmentssample 


Raesources 


2.7 ”使 用 注释 


本 节 的 内 容 是 给 代码 添加 注释 ， 该 主题 表面 看 来 十 分 简单 ， 但 实际 可 能 很 复杂 。 注 释 有 助 于 阅读 代码 的 其 
他 开发 人 员 理 解 代码 ， 而 且 可 以 用 来 为 其 他 开发 人 员 生 成 代码 的 文档 。 


2.7.1 源 文件 中 的 内 部 注释 
本 章 开 头 提 到 过 ，Ct# 使 用 传统 的 C 风格 注释 方式 : 单行 注释 使 用 (/ ...)， 多 行 注释 使 用 (/* ... */): 


// This is a single-line comment 
/* This comment 
spans multiple lines. */ 


单行 注释 中 的 任何 内 容 ， 即 从 // 开 始 一 直到 行 尾 的 内 容 都 会 被 编译 器 忽略 。 多 行 注释 中 “*” 和 “*/” 之 间 
的 所 有 内 容 也 会 被 忽略 。 显 然 不 能 在 多 行 注释 中 包含 “%% ”组 合 ， 因 为 这 会 被 当成 注释 的 结尾 。 

实际 上 ， 可 以 把 多 行 注释 放 在 一 行 代码 中 : 

Console.WriteLine(/* Here's a comment! */ "This will compile."™); 

像 这 样 的 内 联 注释 在 使 用 时 应 小 心 ， 因 为 它们 会 使 代码 难以 理解 。 但 这 样 的 注释 在 调试 时 是 非常 有 用 的 ， 
例如 ， 在 运行 代码 时 要 临时 使 用 男 一 个 值 : 


DoSomething (Width, /*Height*/ 100); 
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当然 ， 字 符 串 字面 值 中 的 注释 字符 会 按照 一 般 的 字符 来 处 理 : 


string s = "/* This is just a normal string .*/"; 


27.2 XML 文档 


如 前 所 述 ， 除 了 C 风格 的 注释 外 ，C# 还 有 一 个 非常 出 色 的 功能 (本 章 将 讨论 这 一 功能 ): 根据 特定 的 注释 目 动 
创建 XML 格式 的 文档 说 明 。 这 些 注释 都 是 单行 注释 ， 但 都 以 3 条 斜 杠 /开头 ， 而 不 是 通常 的 两 条 斜 杜 。 在 这 些 
注释 中 ， 可 以 把 包含 类 型 和 类 型 成 员 的 文档 说 明 的 XML 标记 放 在 代码 中 。 

编译 器 可 以 识别 表 2-9 所 示 的 标记 。 


表 2-9 

标 记 说 明 
<c> 把 行 中 的 文本 标记 为 代码 ， 例 如 <c>int i= 10:</c> 
<code> 把 多 行 标记 为 代码 
<example> 标记 为 一 个 代码 示例 
<exception> 说 明 一 个 异常 类 (编译 器 要 验证 其 语法 ) 
<include> 包含 其 他 文档 说 明文 件 的 注释 (编译 器 要 验证 其 语法 ) 
<list> 把 列表 插入 文档 中 
<para> 建立 文本 的 结构 
<param> 标记 方法 的 参数 (编译 器 要 验证 其 语法 ) 
<paramref> 表明 一 个 单词 是 方法 的 参数 (编译 器 要 验证 其 语法 ) 
<permission> 说 明 对 成 员 的 访问 (编译 器 要 验证 其 语法 ) 
<remarks> 给 成 员 添 加 描述 
<returns> 说 明 方法 的 返回 值 
<see> 提供 对 男 一 个 参数 的 交叉 引用 (编译 器 要 验证 其 语法 ) 
<seealso> 提供 描述 中 的 “参见 ”部 分 (编译 器 要 验证 其 语法 ) 
<summary> 提供 类 型 或 成 员 的 简短 小 结 
<typeparam> 用 在 泛 型 类 型 的 注释 中 ， 以 说 明 一 个 类 型 参数 
<Value> 描述 属性 


要 了 解 它 们 的 工作 方式 ， 可 以 在 Calculator.cs 文件 中 添加 一 些 XML 注释 。 我 们 给 类 及 其 Add0 方 法 添加 一 
个 <summary> 元 素 ， 也 给 Add0) 方 法 添加 一 个 <retums> 元 素 和 两 个 <param> 元 素 : 


// MathLib.cs 
namespace Wrox.MathLib 
{ 
/i/<summary> 
/i Wrox.MathLib.calculator class. 
/i/ Provides a method to add two doublies. 
/</summary> 
public class Calculator 
{ 
/i/<summary> 
/i The Add method allows us to add two doubles. 
/</ summary> 
1 /<returns>Result of the addition (double) </returns> 
/7 /<param name="x">First number to add</param> 
/i/<param name="y">Second number to add</param> 
PUublic static double Add {double x, double vy) => xX + Yi 
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2.8”C# 预 处 理 器 指令 


除了 前 面 介绍 的 常用 关键 字 外 ，C# 还 有 许多 名 为 “ 预 处 理 器 指令 ”的 命令 。 这 些 命令 从 来 不 会 转换 为 可 执 
行 代 码 中 的 命令 ， 但 会 影响 编译 过 程 的 各 个 方面 。 例 如 ， 使 用 预 处 理 器 指令 可 以 茶 止 编译 器 编译 代码 的 茶 一 部 
分 。 如 果 计 划 发 布 两 个 版 本 的 代码 ， 即 基本 版 本 和 拥有 更 多 功能 的 企业 版 本 ， 就 可 以 使 用 这 些 预 处 理 器 指令 。 
在 编译 软件 的 基本 版 本 时 ， 使 用 预 处 理 器 指令 可 以 傈 止 编译 器 编译 与 附加 功能 相关 的 代码 。 另 外 ， 在 编写 提供 调 
试 信 息 的 代码 时 ， 也 可 以 使 用 预 处 理 器 指令 。 实 际 上 ， 在 销售 软件 时 ， 一 般 不 希望 编译 这 部 分 代码 。 

预 处 理 器 指令 的 开头 都 有 符号 #。 


注意 : 

C++ 开发 人 员 应 该 知道 ， 在 C 和 C++ 中 预 处 理 器 指令 非常 重要 。 但 是 ， 在 C# 中 ， 并 没有 那么 多 的 预 处 理 器 
指令 ， 它 们 的 使 用 也 不 太 频 繁 。C# 提 供 了 其 他 机 制 来 实现 许多 C++ 指令 的 功能 ， 如 定制 特性 。 还 要 注意 ，C# 
并 没有 一 个 像 C++ 那样 的 独立 预 处 理 器 ， 所 谓 的 预 处 理 器 指令 实际 上 是 由 编译 器 处 理 的 。 尽 管 如 此 ，C# 仍 保留 
了 一 些 预 处 理 器 指令 名 称 ， 因 为 这 些 命令 会 让 人 觉得 就 是 预 处 理 器 。 


下 面 简要 介绍 预 处 理 器 指令 的 功能 。 
2.8.1 #define 和 #undef 
#define 的 用 法 如 下 所 示 : 


#define DEBUG 

它 告诉 编译 器 存在 给 定名 称 的 符号 ， 在 本 例 中 是 DEBUG。 这 有 点 类 似 于 声明 一 个 变量 ,但 这 个 变量 并 没 
有 真正 的 值 ， 只 是 存在 而 已 。 这 个 符号 不 是 实际 代码 的 一 部 分 ， 而 只 在 编译 器 编译 代码 时 存在 。 在 C# 代 码 中 它 
没有 任何 意义 。 

#ndef 正好 相反 一 一 它 删除 符号 的 定义 : 

#undef DEBUG 

如 果 符 号 不 存在 ，#mdef 就 没有 任何 作用 。 同 样 ， 如 果 符 号 已 经 存在 ， 则 #define 也 不 起 作用 。 

必须 把 #define 和 要 mdef 命令 放 在 C 术 原文 件 的 开头 位 置 ， 在 声明 要 编译 的 任何 对 象 的 代码 之 前 。 

#define 本 刁 并 没有 什么 用 ， 但 与 其 他 预 处 理 器 指令 (特别 是 胡 人 结合 使 用 时 ， 它 的 功能 就 非 第 强大 了 。 


注意 : 

这 里 应 注意 一 般 C# 语 法 的 一 些 变 化 。 预 处 理 器 指令 不 用 分 号 结束 ， 一 般 一 行 上 只 有 一 条 命令 。 这 是 因为 对 
于 预 处 理 器 指令 ，C# 不 再 要 求 命令 使 用 分 号 进行 分 隔 。 如 果 编 译 器 遇 到 一 条 预 处 理 器 指令 ， 就 会 假定 下 一 条 命 
令 在 下 一 行 。 


2.8.2 #if、#elif、#else 和 #endif 
这 些 指令 告诉 编译 器 是 否 要 编译 代码 块 。 考 虑 下 面 的 方法 : 


int DoSomeWork (double xX) 
{ 
// do something 
#1if DEBUG 
Console .WriteLine($"x 15s5 {x}")-; 
#endif 
} 


这 段 代码 会 像 往常 那样 编译 ， 但 Console WiiteLine 方法 调用 包含 在 #if 子 句 内 。 这 行 代 码 只 有 在 前 面 的 
#define 指令 定义 了 符号 DEBUG 后 才 执行 。 当 编译 器 遇 到 #if 指令 后 ， 将 先 检查 相关 的 符号 是 否 存在 ， 如 果 符 
号 存在 ， 就 编译 #f 子 名 中 的 代码 。 否 则 ， 编 译 器 会 忽略 所 有 的 代码 ， 直 到 遇 到 匹配 的 #endif 指令 为 止 。 一 般 是 
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在 调试 时 定义 符号 DEBUG， 把 与 调试 相关 的 代码 放 在 共 f 子 句 中 。 完 成 调试 后 ， 就 把 #define 指令 注释 掉 ， 所 有 
的 调试 代码 会 奇迹 般 地 消失 ， 可 执行 文件 也 会 变 小 ， 最 终 用 户 不 会 被 这 些 调试 信息 弄 糊涂 (显然 ， 要 做 更 多 的 测 
试 ， 确 保 代码 在 没有 定义 DEBUG 的 情况 下 也 能 工作 )。 这 项 技术 在 C 和 C++ 编程 中 十 分 常见 ， 称 为 条 件 编译 
(conditional compllation )。 

#elif (=else if 和 #else 指令 可 以 用 在 #f 块 中 ， 其 合 义 非常 直观 。 也 可 以 舱 套 #f 块 : 

#define ENTERPRISE 

#define Wi10 

/i further on in the file 

#if ENTERPRISE 

// do something 

#if 而 10 

// some code that is only relevant to enterprise 

/i edition running on W10 

#endif 

#elif PROFESSIONAL 

// do something else 

#else 

// code for the leaner version 

#endif 


##f 和 #elif 还 支持 一 组 逻辑 运算 得“!1”、“==”“!=” 和 “||”。 如 果 符 号 存在 ,就 被 认为 是 tue， 否 则 为 false， 
例如 ; 


#if 而 10 && (ENTERPRISE==false) // it Wi0 is defined but ENTERPRISE isn't 


2.8.3 #Wwarning 和 #error 


另 两 个 非常 有 用 的 预 处 理 器 指令 是 #warning 和 #eror。 当 编译 器 遇 到 它们 时 ， 会 分 别 产生 警告 或 错误 。 如 果 
编译 器 遇 到 #waming 指令 , 会 回 用户 显示 #warning 指令 后 面 的 文本 ， 之 后 编译 继续 进行 。 如 果 编 译 器 遇 到 #error 
指令 ， 就 会 问 用 户 显 示 后 面 的 文本 ， 作 为 一 条 编译 错误 消息 ， 然 后 会 立即 退出 编译 ， 不 会 生成 开 代码 。 

使 用 这 些 指令 可 以 检查 #define 语句 是 不 是 做 错 了 什么 事 ， 使 用 #warning 语句 可 以 提醒 自己 执行 某 个 操作 : 

#if DEBUG && RELEASE 

#error "You've defined DEBUG and RELEASE simultaneously!" 

#endif 

#warning "Don't forget to remove this line before the boss tests the code!™" 

Console.WriteLine("*I love this job.*");} 


2.8.4 #region 和 #endregion 
要 egion 和 #endregion 指令 用 于 把 一 段 代码 视 为 有 给 定名 称 的 一 个 块 ， 如 下 所 示 : 


#region Member Field Declarations 
int zx; 

double ds; 

Currency balance; 

#endregion 


这 看 起 来 似乎 没有 什么 用 ， 它 根本 不 影响 编译 过 程 。 这 些 指令 真正 的 优点 是 它们 可 以 被 某 些 编辑 器 识别 ， 
包括 Visual Studio 编辑 器 。 这 些 编辑 器 可 以 使 用 这 些 指令 使 代码 在 屏幕 上 更 好 地 布局 。 第 18 章 会 详细 介绍 。 


2.8.5 坤 Ine 


#ine 指令 可 以 用 于 改变 编译 器 在 警告 和 错误 信息 中 显示 的 文件 名 和 行 号 信息 。 这 条 指令 用 得 并 不 
多 。 如 果 编 写 代 码 时 ， 在 把 代码 发 送 给 编译 器 前 ， 要 使 用 茶 些 软 件 包 改变 输入 的 代码 ， 该 指令 最 有 用 ， 
因为 这 意味 看 编译 器 报告 的 行 写 或 文件 名 与 文件 中 的 行 号 或 编辑 的 文件 名 不 匹配 。 要 ine 指令 可 以 用 于 还 
原 这 种 匹配 。 也 可 以 使 用 语法 机 ine default 把 行 号 还 原 为 默认 的 行 号 ; 


#1line 164 "Core.cs™" // We happen to Know this is line 164 in the file 
/i/ Core.cs, before the intermediate 

// package mangles it. 

// later on 

#1line default // restores default line numbering 
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2.8.6 #pragma 


#pragma 指令 可 以 抑制 或 还 原 指定 的 编译 警告 .与 命令 行 选项 不 同 ,可 ragma 指令 可 以 在 类 或 方法 级 别 实现 ， 
对 抑制 警告 的 内 容 和 抑制 的 时 间 进 行 更 精细 的 控制 。 下面 的 例子 禁止 “字段 未 使 用 ”警告 , 然后 在 编译 MyClass 
#pragma warning disable 169 


public class MyClass 
{ 


int neverUsedField.; 
} 


#pragma warning restore 169 


2.9 ”C# 编 程 准则 


本 章 的 最 后 一 节 介 绍 编写 C# 程 序 时 应 该 牢记 和 遵循 的 准则 。 大 多 数 C# 开 发 人 员 都 遵守 这 些 规则 ， 所 以 在 
这 些 规则 的 指导 下 编写 程序 ， 可 以 方便 其 他 开发 人 员 使 用 程序 的 代码 。 


2.9.1 关于 标识 符 的 规则 


本 小 节 将 讨论 可 用 的 变量 、 类 和 方法 等 的 命名 规则 。 注意 本 节 所 介绍 的 规则 不 仅 是 准则 ， 也 是 C# 编 译 器 强 
制 使 用 的 。 

标识 符 是 给 变量 、 用 户 定 义 的 类 型 (如 类 和 结构 ) 和 这 些 类 型 的 成 员 指定 的 名 称 。 标 识 符 区 分 大 小 写 ， 所 以 
interestRate 和 InterestRate 是 不 同 的 变量 。 确 定 在 C# 中 可 以 使 用 什么 标识 符 有 两 条 规则 : 

e 尽管 可 以 包含 数字 字符 ， 但 它们 必须 以 字母 或 下 划 线 开头 。 

e 不 能 把 C# 关 键 字 用 作 标 识 符 。 

C# 包 含 如 表 2-10 所 示 的 保留 关键 字 。 


表 2-10 

mich 
or or 
pet me 
char protected ulong 
eeked ET 
oa EEC vi 
default interface void 
a ET 
aa 

am 
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如 果 需 要 把 菜 一 保留 字 用 作 标 识 符 (例如 ， 访 问 一 个 用 男 一 种 语言 编写 的 类 )， 那 么 可 以 在 标识 符 的 前 面 加 
上 前 缀 符号 @， 告 知 编译 器 其 后 的 内 容 是 一 个 标识 从 ， 而 不 是 C# 关 键 字 (所 以 abstract 不 是 有 效 的 标识 符 ， 
(@abstract 才 是 )。 

最 后 ， 标 识 符 也 可 以 包含 Unicode 字符 ， 用 语法 \uXXXX 指定 ， 其 中 XXXX 是 Unicode 字符 的 4 位 十 六 进 
制 编码 。 下 面 是 有 效 标识 符 的 一 些 例子 : 

® Name 

® iiberflu? 

® Identiier 

® ‘u00sfIdentifier 

最 后 两 个 标识 符 完 全 相同 ， 可 以 互 换 (因为 005f 是 下 划 线 字符 的 Unicode 代码 )， 所 以 这 些 标识 符 在 同一 个 
作用 域内 不 要 声明 两 次 。 注 意 ， 虽 然 从 语法 上 看 ， 在 标识 符 中 可 以 使 用 下 划 线 字符 ， 但 大 多 数 情况 下 最 好 不 要 
这 人 么 做 ， 因 为 它 不 符合 微软 公司 的 变量 命名 规则 。 这 种 命名 规则 可 以 确保 开发 人 员 使 用 相同 的 命名 约定 ， 易 于 
阅读 他 人 编写 的 代码 。 


注意 : 

为 什么 “CH 最 新 版 本 添加 的 一 些 新 关键 字 没 有 列 在 保留 字 列 表 中 ? 原因 是 ， 如 果 将 它们 添加 到 保留 字 列 表 
中 ， 就 会 破坏 利用 新 C# 关 键 字 的 现 有 代码 。 解 决 方案 是 把 这 些 关键 字 定 义 为 上 下 文 关 键 字 ， 以 改进 语法 ; 它们 
只 能 用 在 某 些 具体 的 代码 中 。 例 如 ，async 关键 字 只 能 用 于 方法 声明 ， 也 可 以 用 作 变 量 名 。 编 译 器 不 会 因此 出 
现 冲 突 。 


2.9.2 用 法 约定 


在 任何 开发 语言 中 ， 通 常 有 一 些 传 统 的 编程 风格 。 这 些 风 格 不 是 语言 自 届 的 一 部 分 ， 而 是 约定 ， 例 如 ， 变 
量 如 何 命 名 ， 类 、 方 法 或 函数 如 何 使 用 等 。 如 果 使 用 茶 语言 的 大 多 数 开 发 人 员 都 遵循 相同 的 约定 ， 不 同 的 开发 
人 员 就 很 容易 理解 彼此 的 代码 ， 这 一 般 有 助 于 程序 的 维护 。 约 定 主要 取决 于 语言 和 环境 。 例 如 ， 在 Windows 平 
台 上 编程 的 C++ 开发 人 员 一 般 使 用 前 缀 psz 或 lpsz 表示 字符 串 : char *pszResult: char *lpszMessage:, 但 在 UNIX 
系统 上 ， 则 不 使 用 任何 前 缀 : char*Result: char *Message:。 

从 本 书 中 的 示例 代码 中 可 以 总 结 出 ，C# 中 的 约定 是 命名 变量 时 不 使 用 任何 前 缀 : string Result string 


Messape;. 


注意 : 

变量 名 用 带 有 前 组 字母 的 方法 来 表示 某 种 数据 类 型 ， 这 种 约定 称 为 Hungarian 表示 法 。 这样， 其 他 阅读 
该 代码 的 开发 人 员 就 可 以 立即 从 变量 名 中 了 解 它 代表 什么 数据 类 型 。 有 了 智能 编辑 器 和 IntelliSense 之 后 ， 人 们 
普遍 认为 Hungarian 表示 法 是 多 余 的 。 


在 许多 语言 中 ， 用 法 约定 是 随 着 语言 的 使 用 逐渐 演变 而 来 的 , 但 是 对 于 C# 和 整个 NET Framework， 微 软 公 
司 编写 了 非常 多 的 用 法 准则 , 详 见 .NET/C# MSDN 文档 。 这 说 明 , 从 一 开始 ，NET 程序 就 有 非常 高 的 互 操作 性 ， 
开发 人 员 可 以 以 此 来 理解 代码 。 用 法 准则 还 得 益 于 20 年 来 面 同 对 和 象 编程 的 发 展 ， 因此 相关 的 新 闻 组 已 经 仔细 考 
虑 了 这 些 用 法 规则 ， 而 且 已 经 为 开发 团体 所 接受 。 所 以 我 们 应 遵守 这 些 准则 。 

但 要 注意 ， 这 些 准 则 与 语言 规范 不 同 。 用 户 应 尽 可 能 遵循 这 些 准则 。 但 如 果 有 很 好 的 理由 不 遵循 它们 ， 也 
不 会 有 什么 问题 。 例 如 ， 不 遵循 这 些 准则 ， 也 不 会 出 现 编译 错误 。 一 般 情 况 下 ， 如 果 不 刹 循 用 法 准则 ， 就 必须 
有 充分 的 理由 。 准 则 应 是 正确 的 决策 ， 而 不 是 一 各 束缚。 如果 比较 本 书 的 后 续 示 例 ， 应 注意 到 许多 示例 都 没有 
遵循 该 约定 。 这 通常 是 因为 某 些 准则 适用 于 大 型 程序 ， 而 不 适合 用 于 小 示例 。 如 果 编 写 一 个 完整 的 软件 包 ， 
就 应 章 循 这 些 准 则 ， 但 它们 并 不 适合 于 只 有 20 行 代码 的 独立 程序 。 在 许多 情况 下 ， 遭 循 约定 会 使 这 些 示例 
难以 理解 。 
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编程 风格 的 准则 非常 多 。 这 里 只 介绍 一 些 比 较 重 要 的 ， 以 及 最 适合 于 用 户 的 准则 。 如 果 用 户 要 让 代码 完全 
遵循 用 法 准则 ， 就 需要 参考 MSDN 文档 。 

1. 命名 约定 

使 程序 易于 理解 的 一 个 重要 方面 是 给 对 象 选 择 命 名 的 方式 ， 包 括 变量 、 方 法 、 类 、 枚 举 和 名 称 空间 的 命名 
hs 

显然 ， 这些 名 称 应 反映 对 象 的 目的 ， 且 不 与 其 他 名 称 冲 突 。 在 .NET Framework 中 ， 一般 规则 也 是 变量 名 要 
反映 变量 实例 的 目的 ， 而 不 反映 数据 类 型 。 例 如 ，height 就 是 一 个 比较 好 的 变量 名 ， 而 integerValue 就 不 太 好 。 
但 是 ， 这 种 规则 是 一 种 理想 状态 ， 很 难 达 到 。 在 处 理 控 件 时 ， 大 多 数 情 况 下 使 用 confirmationDialog 和 
chooseEmployeeListBox 等 变量 名 比较 好 ， 这 些 变 量 名 说 明了 变量 的 数据 类 型 。 

名 称 的 约定 包括 以 下 几 个 方面 。 

(1) 名 称 的 大 小 写 

在 许多 情况 下 ， 名 称 都 应 使 用 Pascal 大 小 写 形式 。 Pascal 大 小 写 形式 指名 称 中 单词 的 首 字母 大 写 ， 如 
EmployeeSalary、ConfirmationDialog、PlainTextEncoding。 注 意 ， 名 称 空 间 和 类 ， 以 及 基 类 中 的 成 员 等 名 称 都 应 
遵循 Pascal 大 小 写 规则 ， 最 好 不 要 使 用 带 有 下 划 线 字符 的 单词 ， 即 名 称 不 应 是 employee_salary。 其 他 语言 中 常 
量 的 名 称 常 常 全 部 大 写 ， 但 在 C# 中 最 好 不 要 这 样 ， 因 为 这 种 名 称 很 难 阅读 ， 而 应 全 部 使 用 Pascal 大 小 写 形式 
的 命名 约定 : 

const int MaximumLength; 

还 推荐 使 用 另 一 种 大 小 写 模 式 : camel 大 小 写 形式 。 这 种 形式 类 似 于 Pascal 大 小 写 形式 ， 但 名 称 中 第 一 个 
单词 的 首 字 母 不 大 写 ， 如 employeeSalary、confirmationDialog、plainTextEncoding。 有 3 种 情况 可 以 使 用 camel 
大 小 写 形式 : 

e 类 型 中 所 有 私有 成 员 字 段 的 名 称 : 

但 要 注意 ， 成 员 字 段 的 前 缀 名 第 音 用 一 条 下 划 线 开头 
e ”传递 给 方法 的 所 有 参数 的 名 称 
e 用 于 区 分 同名 的 两 个 对 象 一 一 比较 常见 的 是 属性 封装 字段 : 
private string employeeName; 
public string EmployeeName 
: get 
{ 
return emploveeName; 


} 
} 


如 果 这 人 么 做 ， 则 私有 成 员 总 是 使 用 camel 大 小 写 形式 ， 而 公有 的 或 受 保护 的 成 员 总 是 使 用 Pascal 大 小 写 形 
式 ， 这 样 使 用 这 段 代码 的 其 他 类 就 只 能 使 用 Pascal 大 小 写 形式 的 名 称 了 (除了 参数 名 以 外 )。 

还 要 注意 大 小 写 问题 。C# 区 分 大 小 写 ， 所 以 在 C# 中 ， 仅 大 小 写 不 同 的 名 称 在 语法 上 是 正确 的 ， 如 上 面 的 
例子 所 示 。 但 是 ， 有 时 可 能 从 Visual Basic 应 用 程序 中 调用 程序 集 ， 而 Visual Basic 不 区 分 大 小 写 ， 如 果 使 用 仅 
大 小 写 不 同 的 名 称 , 就 必须 使 这 两 个 名 称 不 能 在 程序 集 的 外 部 访问 (上 例 是 可 行 的 , 因为 仅 私 有 变量 使 用 了 camel 
大 小 写 形式 的 名 称 )。 否 则 ，Visual Basic 中 的 其 他 代码 就 不 能 正确 使 用 这 个 程序 集 。 

(2) 名 称 的 风格 

名 称 的 风格 应 保持 一 致 。 例如， 如 果 类 中 的 一 个 方法 名 为 ShowConfirmmationDialog0， 另 一 个 方法 就 不 能 被 命 
名 为 ShowDialogWaming0) 或 WarmingDialogShow0O， 而 应 是 ShowWarningDialog()。 

(3) 名 称 空间 的 名 称 

名 称 空 间 的 名 称 非常 重要 ， 一 定 要 仔细 考虑 ， 以 避免 一 个 名 称 空 间 的 名 称 与 其 他 名 称 空间 同名 。 记 住 ， 名 
称 空 间 的 名 称 是 NET 区 分 共享 程序 集中 对 象 名 的 唯一 方式 。 如果 一 个 软件 包 的 名 称 空间 使 用 的 名 称 与 男 一 个 软 
件 包 相同 ， 而 这 两 个 软件 包 都 由 同一 个 程序 使 用 ， 就 会 出 问题 。 因 此 ， 最 好 用 目 己 的 公司 名 创建 顶级 的 名 称 空 
间 ， 再 能 套 技术 范围 较 罕 、 用 户 所 在 小 组 或 部 门 或 者 类 所 在 软件 包 的 名 称 空 间 。Microsof 建议 使 用 名 称 空间 : 


第 2 章 核心 C# | 57 


<CompanyName>.=TechnologyName>， 例 如 ， 
WeaponsOfDestructionCorp.RayGunControllers 
WeaponsOfDestructionCorp. Viruses 
(4) 名 称 和 关键 字 
名 称 不 应 与 任何 关键 字 冲 突 ， 这 非常 重要 。 实 际 上 ， 如 果 在 代码 中 ， 试 图 给 菜 一 项 指定 与 C# 关 键 字 同名 的 
名 称 ， 就 会 出 现 语法 错误 ， 因 为 编译 器 会 假定 该 名 称 表示 一 条 语句 。 但 是 ， 由 于 类 可 能 由 其 他 语言 编写 的 代码 访 
问 ， 因 此 不 能 使 用 其 他 .NET 语言 中 的 关键 字 作 为 对 应 的 名 称 。 一 般 来 说 ，C++ 关 键 字 类 似 于 C# 关 键 字 , 不 太 
可 能 与 C++ 混 消 ， 只 有 Visual C++ 常用 的 关键 字 以 两 个 下 划 线 字符 开头 。 与 C# 一样，C++ 关 键 字 都 是 小 写字 母 ， 
如 果 要 遵循 公有 类 和 成 员 使 用 Pascal 风格 名 称 的 约定 , 则 在 它们 的 名 称 中 至 少 有 一 个 字母 大 写 , 因此 不 会 与 C++ 
关键 字 冲 突 。 另 一 方面 ，Visual Basic 的 问题 会 多 一 些 ， 因 为 Visual Basic 的 关键 字 要 比 C# 的 多 ， 而 且 它 不 区 分 
大 小 写 ， 不 能 依赖 于 Pascal 风格 的 名 称 来 区 分 类 和 成 员 。 

查看 MSDN 文档 : https://docs.microsoft.com/dotnet/csharp/laneuagereference/keywords。 在 这 里 ， 有 一 个 很 长 
的 C# 关 键 字 列表 ， 不 应 该 用 于 类 和 成 员 。 

2. 属性 和 方法 的 使 用 

类 中 出 现 混乱 的 一 个 方面 是 某 个 特定 数量 是 用 属性 还 是 方法 来 表示 。 这 没有 硬性 规定 ， 但 一 般 情况 下 ， 如 
果 该 对 和 象 的 外 观 像 变 量 ， 就 应 使 用 属性 来 表示 它 ， 即 : 
e 客户 问 代 码 应 能 读 取 它 的 值 ,最 好 不 要 使 用 只 写 属性 , 例如 , 应 使 用 SetPassword0 方 法 , 而 不 是 Password 
只 写 属性 。 
e 读 取 该 值 不 应 化 太 长 的 时 间 。 实 际 上 ， 如 果 是 属性 ， 通 沼 表 明 读 取 过 程 花 的 时 间 相 对 较 短 。 
e 读 取 该 值 不 应 有 任何 明显 的 和 不 希望 的 负面 效应 。 进 一 步 说 ， 设 置 属性 的 值 ， 不 应 有 与 该 属性 不 直接 
相关 的 负面 效应 。 设 置 对 话 框 的 宽度 会 改变 该 对 话 框 在 屏幕 上 的 外 观 ， 这 是 可 以 的 ， 因 为 它 与 该 属性 
相关 。 
e 可 以 按照 任何 顺序 设置 属性 。 尤 其 在 设置 属性 时 ， 最 好 不 要 因为 还 没有 设置 另 一 个 相关 的 属性 而 抛 出 
异 弟 。 例如， 如 果 为 了 使 用 访问 数据 库 的 类 ， 则 需要 设置 ConnectionString、UserName 和 Password， 应 
确保 已 经 实现 了 该 类 ， 这 样 用 户 才能 按照 任何 顺序 设置 它们 。 
e 顺序 读 取 属性 应 有 相同 的 结果 。 如果 属 性 的 值 可 能 会 出 现 预料 不 到 的 改变 , 就 应 把 它 编 写 为 一 个 方法 。 
在 监控 汽车 运动 的 类 中 ， 把 speed 设置 为 属性 就 不 合适 ， 而 应 使 用 GetSpeed0 方 法 ; 男 一 方面 ， 应 把 
Weight 和 EngineSize 设置 为 属性 ， 因 为 对 于 给 定 的 对 象 ， 它 们 是 不 变 的 。 
如 果 要 编码 的 相关 项 满足 上 述 所 有 条 件 ， 就 把 它 设置 为 属性 ， 否 则 就 应 使 用 方法 。 
3. 字段 的 使 用 
字段 的 用 法 非常 简单 。 字 段 应 总 是 私有 的 ， 但 在 某 些 情况 下 也 可 以 把 常量 或 只 读 字段 设置 为 公有 。 原 因 是 
如 果 把 字段 设置 为 公有 ， 就 不 利于 在 以 后 扩展 或 修改 类 。 

遵循 上 面 的 准则 就 可 以 培养 良好 的 编程 习惯 ， 而 且 这 些 准 则 应 与 面 器 对 象 的 编程 风格 一 起 使 用 。 

最 后 要 记 住 以 下 有 用 的 备注 : 微软 公司 在 保持 一 致 性 方面 相当 谨慎 , 在 编写 .NET 基 类 时 遵循 了 它 目 己 的 准 
则 。 在 编写 .NET 代码 时 应 很 好 地 遵循 这 些 规则 ,对 于 基 类 来 说 , 就 是 要 弄 清楚 类 、 成 员 、 名 称 空 间 的 命名 方式 ， 
以 及 类 层次 结构 的 工作 方式 等 。 类 与 基 类 之 间 的 一 致 性 有 助 于 提高 可 读 性 和 可 维护 性 。 


注意 : 

新 的 ValueTuple 类 型 包含 公共 字段 ， 而 旧 的 Tuple 类 型 则 使 用 属性 。 微 软 打破 了 自己 为 字段 定义 的 准则 。 
由 于 元 组 的 变量 可 以 像 int 变量 一 样 简单 ， 性 能 非常 重要 ， 因 此 决定 为 值 元 组 设置 公共 字段 。 它 只 是 表明 没有 
无 例外 的 规则 。 有 关 元 组 的 更 多 信息 ， 请 阅读 第 13 章 。 
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2.10 “小 结 


本 章 介绍 了 一 些 c# 的 基本 语法 ， 包 括 编写 简单 的 C# 程 序 需要 掌握 的 内 容 。 我 们 讲述 了 许多 基础 知识 ， 但 
其 中 有 许多 是 熟悉 C 风格 语言 (甚至 Javascripb 的 开发 人 员 能 立即 领悟 的 。 

C# 语 法 与 CHHJava 语法 非常 类 似 ， 但 仍 存在 一 些 细微 区 别 。 在 许多 领域 ， 将 这 些 语法 与 功能 结合 起 来 会 
提高 编码 速度 ， 如 高 质量 的 字符 串 处 理 功能 。C# 还 有 一 个 已 定义 的 强 类 型 系统 ， 该 系统 基于 值 类 型 和 引用 类 型 
的 区 别 。 第 3 章 和 第 4 章 将 介绍 C# 的 面向 对 象 编程 特性 。 


+ 
对 象 和 类 型 


本 草 要 扣 

类 和 结构 的 区 别 
表达 式 体 成 员 
按 值 和 按 引 用 传递 参数 
方法 重 载 


部 分 类 
静态 类 
Object 类 ， 其 他 类 型 都 从 该 类 派生 而 来 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 WWWw.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 ObjectAndType 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 


® MathSsample 

® MethodSample 

® StaticConstructorSample 

® StructsSample 

® PassneByValueAndByReterence 
® OutkeywordSample 

® EnunSample 

® ExtensionMethods 
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3.1 创建 及 使 用 类 


到 目前 为 止 , 我 们 介绍 了 组 成 C#i 语 言 的 主要 模块 ,包括 变 量 、 数 据 类 型 和 程序 流 语句 ， 并 简要 介绍 一 个 只 
包含 Main0 方 法 的 完整 小 例子 。 但 还 没有 介绍 如 何 把 这 些 内 容 组 合 在 一 起 ， 构 成 一 个 完整 程序 ， 其 关键 就 在 于 
对 类 的 处 理 。 这 就 是 本 章 的 主题 。 第 4 章 将 介绍 继承 以 及 与 继承 相关 的 特性 。 


注意 : 
本 章 将 讨论 与 类 相关 的 基本 语法 ， 但 假定 你 已 经 熟悉 了 使 用 类 的 基本 原则 ， 例 如 ， 知 道 构造 函数 或 属性 的 
含义 ， 因 此 本 章 主 要 阐述 如 何 把 这 些 原则 应 用 于 C# 代 码 。 


3.2 ”类 和 结构 


类 和 结构 实际 上 都 是 创建 对 象 的 模板 ， 每 个 对 象 都 包含 数据 ， 并 提供 了 处 理 和 访问 数据 的 方法 。 类 定义 了 
类 的 每 个 对 象 ( 称 为 实例 ) 可 以 包含 什么 数据 和 功能 。 人 例如， 如果 一 个 类 表示 一 个 顾客 ， 就 可 以 定义 字段 
CustomerID、FirstName、LastName 和 Address， 以 包含 该 顾客 的 信息 。 还 可 以 定义 处 理 在 这 些 字 段 中 存储 的 
数据 的 功能 。 接 着 ， 就 可 以 实例 化 类 的 一 个 对 象 ， 来 表示 某 个 顾客 ， 为 这 个 实例 设置 相关 字段 的 值 ， 并 使 用 其 
功能 : 


Class PhoneCcustomer 
{ 
public const string DayofsendingBill = "Monday"; 
public int CustomerID; 
public string FirstName; 
public string LastName; 
} 


结构 不 同 于 类 , 因为 它们 不 需要 在 堆 上 分 配 空间 (类 是 引用 类 型 , 总 是 存储 在 堆 (heap) 上 ), 而 结构 是 值 类 型 ， 
通常 存储 在 栈 (stac 加 上 ， 另 外 ， 结 构 不 支持 继承 。 

较 小 的 数据 类 型 使 用 结构 可 提高 性 能 。 在 堆栈 上 存储 值 类 型 可 以 避免 垃圾 收集 。 结 构 的 允 一 个 用 例 与 本 机 
代码 互 操 作 ; 结构 体 的 布局 可 以 与 本 机 数据 类 型 相同 。 

但 在 语法 上 ， 结 构 与 类 非常 相似 ， 主 要 区 别 是 使 用 关键 字 struct 代替 class 来 声明 结构 。 例 如 ， 如 果 和 希望 所 
有 的 PhoneCustomer 实例 都 分 布 在 栈 上 ， 而 不 是 分 布 在 托管 堆 上 ， 就 可 以 编写 下 面 的 语句 : 

struct PhoneCcustomerstruct 

public const string DayofsendingBill = "Monday"; 

public int CustomerID; 


public string FirstName; 
public string LastName; 


} 

对 于 类 和 结构 ,都 使 用 关键 字 new 来 声明 实例 : 这 个 关键 字 创 建 对 象 并 对 其 进行 初始 化 。 在 下面 的 例子 中 ， 
类 和 结构 的 字段 值 都 默认 为 0: 

var myCustomer = new PhoneCustomer (); // works for a class 

var myCustomer2 = new PhoneCustomerstruct(};// works for a struct 


在 大 多 数 情况 下 ， 类 要 比 结构 稍 用 得 多 。 因 此 ， 我 们 先 讨 论 类 ， 然 后 指出 类 和 结构 的 区 别 ， 以 及 选择 使 用 
结构 而 不 使 用 类 的 特殊 原因 。 但 除非 特别 说 明 ， 否 则 就 可 以 假定 用 于 类 的 代码 也 适用 于 结构 。 


注意 : 
类 和 结构 的 一 个 重要 区 别 是 ， 类 类 型 的 对 象 通过 引用 传递 ， 结 构 类 型 的 对 象 按 值 传递 。 详 见 本 章 后 面 的 
内 容 。 
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3.3 类 


类 包含 成 员 ， 成 员 可 以 是 静态 成 员 或 实例 成 员 。 静 态 成 员 属 于 类 ， 实 例 成 员 属 于 对 象 。 静 态 字 段 的 值 对 每 
个 对 象 都 是 相同 的 。 而 每 个 对 象 的 实例 字段 都 可 以 有 不 同 的 值 。 静 态 成 员 关 联 了 static 修饰 待 。 成 员 的 种 类 见 
表 3-1。 


表 3-1 
成 ” 员 说 明 
字段 字段 是 类 的 数据 成 员 ， 它 是 类 型 的 一 个 变量 ， 该 类 型 是 类 的 一 个 成 员 
常量 常量 与 类 相关 (尽管 它们 没有 static 修饰 符 )。 编 译 器 使 用 真实 值 代 蔡 常量 
方法 方法 是 与 特定 类 相关 联 的 函数 
属性 属性 是 可 以 从 客户 端 访问 的 函数 组 ， 其 访问 方式 与 访问 类 的 公共 字段 类 似 。C# 为 读 写 类 中 的 属性 提供 了 专用 语 


法 ， 所 以 不 必 使 用 那些 名 称 中 髓 有 Get 或 Set 的 方法 。 因 为 属性 的 这 种 语法 不 同 于 一 般 函 数 的 语法 ， 所 以 在 客户 
端 代码 中 ， 虚 拟 的 对 象 被 当 作 实 际 的 东西 
构造 函数 构造 函数 是 在 实例 化 对 象 时 目 动 调用 的 特殊 函数 。 它 们 必须 与 所 属 的 类 同名 ， 且 不 能 有 返回 类 型 。 构 造 函 数 用 


于 初始 化 字段 的 值 

索引 器 索引 器 允许 对 象 用 访问 数组 的 方式 访问 。 索 引 器 参见 第 6 章 

运算 符 运算 符 执 行 的 最 简单 的 操作 就 是 加 法 和 减法 。 在 两 个 整数 相 加 时 ， 严 格 地 说 ， 就 是 对 整数 使 用 “+” 运算 符 。C# 
还 允许 指定 把 已 有 的 运算 符 应 用 于 自己 的 类 (运算 符 重 载 )。 第 6 章 将 详细 论述 运算 符 

事件 事件 是 类 的 成 员 ， 在 发 生 某 些 行为 (如 修改 类 的 字段 或 属性 ， 或 者 进行 了 某 种 形式 的 用 户 交互 操作 ) 时 ， 它 可 以 让 对 


象 通知 调用 方 。 客 户 可 以 包含 所 谓 “ 事 件 处 理 程序 ”的 代码 来 啊 应 该 事件 。 第 8 章 将 详细 介绍 事件 
析 构 函数 析 构 函数 或 终结 器 的 语法 类 似 于 构造 函数 的 语法 ， 但 是 在 CLR 检测 到 不 再 需要 茶 个 对 象 时 调用 它 。 它 们 的 名 称 
与 类 相同 ， 但 前 面 有 一 个 “~” 符 号 。 不 可 能 预测 什么 时 候 调用 终结 器 。 终 结 器 详 见 第 17 章 


类 型 类 可 以 包含 内 部 类 。 如 果 内 部 类 型 只 和 外 部 类 型 结合 使 用 ， 就 很 有 趣 
下 面 详细 介绍 类 成 员 。 
3.3.1 字段 


字段 是 与 类 相关 的 变量 。 前 面 的 例子 已 经 使 用 了 PhoneCustomer 类 中 的 字段 。 
一 旦 实例 化 PhoneCustomer 对 象 ， 就 可 以 使 用 语法 Object.FieldName 来 访问 这 些 字段 ， 如 下 例 所 示 : 


Var CuStomerl] = new PhoneCustomer().; 
customerl .FirstName = "Simon"™; 


常量 与 类 的 关联 方式 和 变量 与 类 的 关联 方式 相同 。 使 用 const 关键 字 声 明 常 量 。 如 果 把 它 声明 为 public， 就 
可 以 在 类 的 外 部 访问 它 。 
class PhoneCustomer 
{ 
Public const string DayOfsendingBill = "Monday™; 
Public int CustomerID; 
Public string FirstName; 


public string LastName; 


} 
3.3.2 ”只 读 字 段 


为 了 保证 对 象 的 字段 不 能 改变 ， 字 段 可 以 用 readonly 修饰 符 声 明 。 带 有 readonly 修饰 符 的 字段 只 能 在 构造 
函数 中 分 配 值 。 它 与 const 修饰 符 不 同 。 编 译 器 通过 const 修饰 符 ， 用 其 值 取 代 了 使 用 它 的 变量 。 编 译 器 知道 常 
量 的 值 。 只 读 字 段 在 运行 期 间 通 过 构造 函数 指定 。 与 常量 字段 相反 ， 只 读 字 段 可 以 是 实例 成 员 。 使 用 只 读 字段 
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作为 类 成 员 时 ， 需 要 把 static 修饰 符 分 配给 该 字段 。 

如 果 有 一 个 用 于 编辑 文档 的 程序 ， 因 为 要 注册 ， 所 以 需要 限制 可 以 同时 打开 的 文档 数 。 现 在 假定 要 销售 该 
软件 的 不 同 版 本 ， 而 且 顾 客 可 以 升级 他 们 的 版 本 ， 以 便 同 时 打开 更 多 的 文档 。 显 然 ， 不 能 在 源 代码 中 对 最 大 文 
档 数 进 行 硬 编码 ， 而 是 需要 一 个 字段 来 表示 这 个 最 大 文档 数 。 这 个 字段 必须 是 只 读 的 一 一 每 次 月 动 程序 时 ， 从 
某 个 文件 存储 中 读 取 。 代 码 如 下 所 示 : 


public class DocumentEditor 
{ 
private static readonly uint s maxDocuments; 
static DocumentEditor'() 
{ 
s maxDocuments = DoSomethingToFindOutMaxNumber (); 
} 
} 


在 本 例 中 ， 字 段 是 静态 的 ， 因 为 每 次 运行 程序 的 实例 时 ， 只 需要 存储 最 大 文档 数 一 次 。 这 就 是 在 静态 构造 
函数 中 初始 化 它 的 原因 。 如 果 只 读 字 段 是 一 个 实例 字段 ， 就 要 在 实例 构造 函数 中 初始 化 它 。 例 如 ， 假 定编 辑 的 
每 个 文档 都 有 一 个 创建 日 期 ， 但 不 允许 用 户 修 改 它 ( 因 为 这 会 覆盖 过 去 的 日 期 )。 

如 前 所 述 ， 日 期 用 基 类 System.DateTime 表示 。 下 面 的 代码 在 构造 函数 中 使 用 DateTime 结构 初始 化 
_creationTime 字段 。 初 始 化 Document 类 后 ， 创 建 时 间 就 不 能 改变 了 : 


Public class Document 
{ 
private readonly DateTime creationTime; 
public Document () 
| 
creationTime = DateTime .Now; 


} 
在 上 面 的 代码 段 中 ，_creationTime 和 s_ maxDocuments 的 处 理 方式 与 任何 其 他 字段 相同 ， 但 因为 它们 是 只 
读 的 ， 所 以 不 能 在 构造 函数 外 部 赋值 : 


Voldlad SomeMethod () 
{ 
s maxDocuments = 10; :/ compilation error here. MaxDocuments is readonly 


} 

还 要 注意 ， 在 构造 函数 中 不 必 给 只 读 字段 赋值 。 如 果 没 有 赋值 ， 它 的 值 就 是 其 特定 数据 类 型 的 默认 值 ， 或 
者 在 声明 时 给 它 初始 化 的 值 。 这 适用 于 只 读 的 静态 字段 和 实例 字段 。 

最 好 不 把 字段 声明 为 public。 如 果 修 改 类 的 公共 成 员 ， 使 用 这 个 公共 成 员 的 每 个 调用 程序 也 需要 更 改 。 例 
如 ， 如 果 和 希望 在 下 一 个 版 本 中 检查 最 大 的 字符 串 长 度 ， 公 共 字 上 段 就 需要 更 改 为 一 个 属性 。 使 用 公共 字段 的 现 有 
代码 ， 必 须 重 新 编译 ， 才 能 使 用 这 个 属性 (尽管 在 调用 程序 看 来 ， 语 法 与 属性 相同 )。 如 果 只 在 现 有 的 属性 中 改 
变 检查 ， 那 么 调用 程序 不 需要 重新 编译 就 能 使 用 新 版 本 。 

最 好 把 字段 声明 为 private， 使 用 属性 来 访问 字段 ， 如 下 一 节 所 述 。 


3.3.3 属性 


属性 (property) 的 概念 是 ， 它 是 一 个 方法 或 一 对 方法 ， 在 客户 端 代码 看 来 ， 它 ( 们 ) 是 一 个 字段 。 
下 面 把 前 面 示例 中 变量 名 为 firstName 的 名 字 字 段 改 为 私有 。FirstName 属性 包含 get 和 set 访问 器 ， 来 检 
索 和 设置 支持 字段 的 值 : 
class PhoneCcustomer 
| 上 
private string _firstName; 
public string Fl1lrstName 
get 
{ 
return firstName; 
} 


Set 


{ 
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firstName = value; 
} 
} 
a 
} 


get 访问 器 不 带 任何 参数 ， 且 必须 返回 属性 声明 的 类 型 。 也 不 应 为 set 访问 器 指定 任何 显 式 参数 ， 但 编译 器 假 
定 它 带 一 个 参数 ， 其 类 型 也 与 属性 相同 ， 并 表示 为 value。 

下 面 的 示例 使 用 另 一 个 命名 约定 。 下面 的 代码 包含 一 个 属性 Age, 它 设置 了 一 个 字段 age。 在 这 个 例子 中 , age 
表示 属性 Age 的 后 备 变量 。 


private int age; 
Public int Age 
{ 
de 七 
{ 
return age; 
} 
Se 七 
{ 
age = Valuer 
} 
} 


注意 这 里 所 用 的 命名 约定 。 我 们 采用 C# 的 区 分 大 小 写 模 式 , 使 用 相同 的 名 称 , 但 公有 属性 采用 Pascal 大 小 
写 形式 命名 ， 如 果 存 在 一 个 等 价 的 私有 字段 ， 则 它 采 用 camel 大 小 写 形式 命名 。 在 早期 .NET 版 本 中 ， 此 命名 约 
定 由 微软 的 C# 团 队 优 先 使 用 。 最 近 他 们 使 用 的 命名 约定 是 给 字段 名 加 上 下 划 线 作为 前 级。 这 会 为 识别 字段 而 不 
是 局 部 变量 提供 极 大 的 便利 。 


注意 : 

微软 团队 针对 不 同情 况 使 用 不 同 的 命名 约定 。 在 使 用 类 型 的 私有 成 员 时 , .NET 没有 严格 的 命名 约定 。 然而 ， 
在 团队 里 应 该 使 用 相同 的 约定 。.NET Core 团队 转向 使 用 下 划 线 作为 字段 的 前 组 , 这 是 本 书 大 多 数 地 方 使 用 的 约 
定 (参见 https://github.com/dotnet/ corefx/blob/master/Documentation/coding-guidelines/coding-style.md), 


1. 具有 表达 式 体 的 属性 访问 器 


使 用 C# 7， 还 可 以 将 属性 访问 器 编写 为 具有 表达 式 体 的 成 员 。 例 如 ， 前 面 显 示 的 属性 FirstName 可 以 使 用 
一 编写 。 这 个 新 特性 减少 了 编写 大 括号 的 需求 ， 并 且 使 用 get 访问 器 省 略 了 returm 关键 字 。 
private string firstName; 
public string FirstName 
— => firstName; 
set => firstName = value; 
} 
使 用 具有 表达 式 体 的 成 员 时 ， 属 性 访问 器 的 实现 只 能 由 一 条 语句 组 成 。 
2. 自动 实现 的 属性 


如 果 属 性 的 set 和 get 访问 器 中 没有 任何 逻辑 ， 就 可 以 使 用 自动 实现 的 属性 。 这 种 属性 会 自动 实现 后 备 成 员 
变量 。 前 面 Age 示例 的 代码 如 下 : 

public int Age { get; set; } 

不 需要 声明 私有 字段 。 编 译 器 会 自动 创建 它 。 使 用 自动 实现 的 属性 ， 就 不 能 直接 访问 字段 ， 因 为 不 知道 编 
译 器 生成 的 名 称 。 如 果 对 属性 所 需要 做 的 就 是 读 取 和 编写 一 个 字段 ， 那 么 使 用 自动 实现 属性 时 的 属性 语法 比 使 
用 具有 表达 式 体 的 属性 访问 器 时 的 语法 要 短 。 

使 用 自动 实现 的 属性 ， 就 不 能 在 属性 设置 中 验证 属性 的 有 效 性 。 所 以 在 上 面 的 例子 中 ， 不 能 检查 是 否 设 置 
了 无 效 的 年 龄 。 

自动 实现 的 属性 可 以 使 用 属性 初始 化 器 来 初始 化 : 


Public int Age { get set; } = 42; 
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oll} 


3. 属性 的 访问 修饰 符 

C# 人 允许 给 属性 的 get 和 set 访问 器 设置 不 同 的 访问 修饰 符 , 所 以 属性 可 以 有 公有 的 get 访问 器 和 私有 或 受 保 
护 的 set 访问 器 。 这 有 助 于 控制 属性 的 设置 方式 或 时 间 。 在 下 面 的 代码 示例 中 ， 注 意 set 访问 器 有 一 个 私有 访问 
修饰 符 ， 而 get 访问 器 没有 任何 访问 修饰 符 。 这 表示 get 访问 器 具有 属性 的 访问 级 别 。 在 get 和 set 访问 器 中 ， 
必须 有 一 个 具备 属性 的 访问 级 别 。 如 果 get 访问 器 的 访问 级 别 是 protected， 就 会 产生 一 个 编译 错误 ， 因 为 这 会 
使 两 个 访问 器 的 访问 级 别 都 不 是 属性 。 

Public string Name 

{ 

get => name; 


private set => name = value; 


} 
通过 自动 实现 的 属性 ， 也 可 以 设置 不 同 的 访问 级 别 : 


public :int age { get; private set; } 


注意 : 

一 些 开 发 人 员 可 能 会 担心 ， 前 面 列举 了 许多 情况 ， 其 中 标准 C# 编 码 方式 导致 了 大 材 小 用 。 例如， 通过 属性 
访问 字段 ， 而 不 是 直接 访问 字段 。 这 些 额 外 的 函数 调用 是 否 会 增加 系统 开销 ， 寻 致 性 能 下 降 ? 其 实 ， 不 需要 担 
心 这 种 编程 方式 会 在 C# 中 带 来 性 能 损失 。C# 代 码 会 编译 为 全， 然后 在 运行 时 JIT 编译 为 本 地 可 执行 代码 。JIT 
编译 器 可 生成 高 度 优化 的 代码 ， 并 在 适当 的 时 候 随意 地 内 联 代 码 ( 即 ， 用 内 联 代码 来 替代 函数 调用 )。 如 果实 现 
某 个 方法 或 属性 仅 是 调用 男 一 个 方法 ， 或 返回 一 个 字段 ， 则 该 方法 或 属性 肯定 是 内 联 的 。 

通常 不 需要 改变 内 联 的 行为 ， 但 在 通知 编译 器 有 关内 联 的 情况 时 有 一 些 控制 。 使 用 属性 MethodImpl 
可 以 定义 不 应 用 内 联 的 方法 (MethodImplOptions.NolInlining), 或 内 联 应 该 由 编译 器 主动 完成 (MethodImplOptions. 
AggressiveInlining)。 对 于 属性 ， 需 要 直接 将 这 个 属性 应 用 于 get 和 set 访问 器 。 属 性 详 见 第 16 章 。 


4. 只 读 属 性 
在 属性 定义 中 省 略 set 访问 器 ， 就 可 以 创建 只 读 属性 。 因 此 ， 如 下 代码 把 Name 变 成 只 读 属 性 : 


private readonly string name; 
Public string Name 
{ 

get => name; 


} 


用 readonly 修饰 符 声 明 字段 ， 只 允许 在 构造 函数 中 初始 化 属性 的 值 。 


注意 : 

可 以 创建 只 读 属性 ， 就 可 以 创建 只 写 属 性 。 只 要 在 属性 定义 中 省 略 get 访问 器 ， 就 可 以 创建 只 写 属性 。 但 
是 ， 这 是 不 好 的 编程 方式 ， 因 为 这 可 能 会 使 客户 端 代 码 的 作者 感到 迷惑 。 一 般 情 况 下 ， 如 果 要 这 么 做 ， 最 好 使 
用 一 个 方法 替代 。 

5. 自动 实现 的 只 读 属 性 

C# 提供 了 一 个 简单 的 语法 ， 使 用 自动 实现 的 属性 创建 只 读 属 性 ， 访 问 只 读 字 段 。 这 些 属性 可 以 使 用 属性 
初始 化 器 来 初始 化 。 

public string Id { get; } = Guid.NewGuid{) .ToString() ; 

在 后 台 ， 编 译 器 会 创建 一 个 只 读 字 段 和 一 个 属性 ， 其 get 访问 器 可 以 访问 这 个 字段 。 初 始 化 器 的 代码 进入 
构造 函数 的 实现 代码 ， 并 在 调用 构造 函数 体 之 前 调用 。 

当然 ， 只 读 属 性 也 可 以 显 式 地 在 构造 函数 中 初始 化 ， 如 下 面 的 代码 片段 所 示 ; 

public class Person 


{ 


Public Personl(string name) => Name = name; 
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Public string Name { get; } 
} 


6. 表达 式 体 属性 
从 C#6 开始， 只 有 get 访问 器 的 属性 可 以 使 用 表达 式 体 属性 实现 。 类 似 于 表达 式 体 方法 ， 表 达 式 体 属性 不 
需要 花 括 号 和 返回 语句 。 表 达 式 体 属 性 是 带 有 get 访问 器 的 属性 ， 但 不 需要 编写 get 关键 字 。 只 是 get 访问 器 的 
实现 后 跟 lambda 操作 符 。 对 于 Person 类 ，FulIName 属性 使 用 表达 式 体 属性 实现 ， 通 过 该 属性 返回 FirstName 
和 LastName 属性 值 的 组 合 ( 代 码 文件 ClassesSample/Program.cs): 
public class Person 
Public Person(string firstName, string lastName) 
FirstName = firstName; 
z LastName = lastNames; 
> string FirstName { get; } 
Public string LastName { get; } 
public string FullName => S$"{FirstName} {LastName}".; 
} 


7. 不 可 变 的 类 型 

如 果 类 型 包含 可 以 改变 的 成 员 ， 它 就 是 一 个 可 变 的 类 型 。 使 用 readonly 修饰 符 ， 编 译 器 会 在 状态 改变 时 报 
错 。 状 态 只 能 在 构造 函数 中 初始 化 。 如 果 对 象 没 有 任何 可 以 改变 的 成 员 ， 只 有 只 读 成 员 ， 它 就 是 一 个 不 可 变 类 
型 。 其 内 容 只 能 在 初始 化 时 设置 。 这 对 于 多 线程 是 非常 有 用 的 ， 因 为 多 个 线程 可 以 访问 信息 永远 不 会 改变 的 同 
一 个 对 象 。 因 为 内 容 不 能 改变 ， 所 以 不 需要 同步 。 

不 可 变 类 型 的 一 个 例子 是 String 类 。 这 个 类 没有 定义 任何 允许 改变 其 内 容 的 成 员 。 诸 如 ToUpper( 把 字符 串 
更 改 为 大 写 ) 的 方法 总 是 返回 一 个 新 的 字符 串 ， 但 传递 到 构造 函数 的 原始 字符 串 保持 不 变 。 


注意 : 
.NET 也 提供 了 不 可 变 的 集合 ， 这 些 集合 类 参见 第 11 章 。 
3.3.4 ”匿名 类 型 


第 2 章 讨 论 了 var 关键 字 ， 它 用 于 表示 隐 式 类 型 化 的 变量 。var 与 new 关键 字 一 起 使 用 时 ， 可 以 创建 匿名 
类 型 。 匿 名 类 型 只 是 一 个 继承 自 Object 且 没 有 名 称 的 类 。 该 类 的 定义 从 初始 化 器 中 推 新 ， 类 似 于 隐 式 类 型 化 的 


者 ， 
如 果 需 要 一 个 对 象 包 含 某 个 人 的 姓氏 、 中 间 名 和 名 字 ， 则 声明 如 下 : 
var Captain = new 


MiddleName = "T", 
LastName = "Elirk™ 


} ; 
这 会 生成 一 个 包含 FirstName、MiddleName 和 LastName 属性 的 对 象 。 如 果 创 建 男 一 个 对 象 ， 如 下 所 示 : 
var doctor = new 
{ 
FirstName = "Leonard"™, 


MiddleName = string.Empty, 
LastName = "McCoy™" 
} 7 


那么 captain 和 doctor 的 类 型 就 相同 。 例 如 ,可 以 设置 captain = doctor。 只 有 所 有 属性 都 匹配 ,才能 设置 captain 


= doctor。 
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如 果 所 设置 的 值 来 自 于 男 一 个 对 象 ， 则 可 以 推断 匿名 类 型 成 员 的 名 称 。 这 样 ， 就 可 以 简化 初始 化 器 。 如 果 
已 经 有 一 个 包含 FirstName、MiddleName 和 LastName 属性 的 类 ， 且 有 该 类 的 一 个 实例 person，captain 对 象 就 
可 以 初始 化 为 : 
var captain = new 
person.FirstName, 


person.MiddleName, 
person.LastName 


person 对 象 的 属性 名 应 投射 到 新 对 象 名 captain, 所 以 captain 对 象 应 有 FirstName、MiddleName 和 LastName 
属性 。 

这 些 新 对 象 的 类 型 名 未 知 。 编 译 器 为 类 型 “伪造 ”了 一 个 名 称 ， 但 只 有 编译 器 才能 使 用 它 。 我 们 不 能 也 不 
应 使 用 新 对 象 上 的 任何 类 型 反射 ， 因 为 这 不 会 得 到 一 致 的 结果 。 


3.3.5 方法 


注意 ， 正 式 的 C# 术 语 区 分 函数 和 方法 。 在 C# 术 语 中 ,“ 函 数 成 员 ” 不 仅 包 含 方法 ， 也 包含 类 或 结构 的 一 些 
非 数 据 成 员 ， 如 索引 器 、 运 算 符 、 构 造 函 数 和 析 构 函数 等 ， 甚 至 还 有 属性 。 这 些 都 不 是 数据 成 员 ， 字 段 、 常 量 
和 事件 才 是 数据 成 员 。 

1. 方法 的 声明 

在 C# 中 ， 方 法 的 定义 包括 任意 方法 修饰 符 ( 如 方法 的 可 访问 性 )、 返 回 值 的 类 型 ， 然 后 依次 是 方法 名 、 输 入 
参数 的 列表 (用 圆 括号 括 起 来 ) 和 方法 体 (用 花 括号 括 起 来 )。 

[modifiers] return type MethodName ([parameters]) 


// Method body 


每 个 参数 都 包括 参数 的 类 型 名 和 在 方法 体 中 的 引用 名 称 。 但 如 果 方 法 有 返回 值 ， 则 retum 语句 就 必须 与 返 
回 值 一 起 使 用 ， 以 指定 出 口 点 ， 例 如 

Public bool IsSquare (Rectangle rect) 

{ 


return (rect.Height == rect.Width); 
} 


如 果 方 法 没有 返回 值 ， 就 把 返回 类 型 指定 为 void， 因 为 不 能 省 略 返回 类 型 。 如 果 方 法 不 带 参 数 ， 仍 需要 在 
方法 名 的 后 面包 含 一 对 空 的 圆 括号 0。 此 时 return 语句 就 是 可 选 的 一 一 当 到 达 闭 花 括 号 时 ， 方 法 会 自动 返回 。 

2. 表达 式 体 方法 

如 果 方 法 的 实现 只 有 一 条 语句 ，C# 为 方法 定义 提供 了 一 个 简化 的 语法 : 表达 式 体 方 法 。 使 用 新 的 语法 ， 不 
需要 编写 花 插 号 和 retum 关键 字 ， 而 使 用 运算 得 => 区 分 操作 符 左边 的 声明 和 操作 符 右边 的 实现 代码 。 

下 面 的 例子 与 前 面 的 方法 IsSquare 相同 ,但 使 用 表达 式 体 方法 语法 实现 。lambda 操作 符 的 右 侧 定义 了 方法 
的 实现 代码 。 不 需要 花 括号 和 返回 语句 。 返回 的 是 语句 的 结果 , 该 结果 的 类 型 必须 与 左边 方法 声明 的 类 型 相同 ， 
在 下 面 的 代码 片段 中 ， 该 类 型 是 bool: 

Public bool IsSquare (Rectangle rect) => rect.Height == rect.Width; 

3. 调用 方法 

在 下 面 的 例子 中 ， 说 明了 类 的 定义 和 实例 化 、 方 法 的 定义 和 调用 的 语法 。 类 Math 定义 了 静态 成 员 和 实例 
成 员 (代码 文件 MathSample/Math.cs ): 

Public class Math 

{ 


public int Value { get; set; } 
public int GetSduare () => Value * Value; 
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Public static Int GetSdquareoOt (int x) => XxX * xX; 
Public static double GetPi() => 3.14159; 
} 


Program 类 利用 Math 类 调用 静态 方法 并 实例 化 一 个 对 象 ,来 调用 实例 成 员 ( 代 码 文件 MathSample/Program.cs): 


USI1ing System; 
namespace MathSample 


{ 
Class Program 
{ 
static void Main() 
{ 
:i Try calling some static functions. 
Console .WriteLine ($"P1i is {Math.GetP1i()}"). 
int XxX = Math.GetSquareoOf (51) ; 
Console .WriteLine ($"Square of 5 is {x}"); 
/i Instantiate a Math object 
Var math = new Math(); // instantiate a reference type 
// Call instance members 
math.Vvalue = 30，; 
Console .WriteLine (S$"Value field of math wvariable contains {math.Value}™).; 
Console .WriteLine ($"Square of 30 is {math.GetSquare()}"); 
} 
} 
} 


运行 MathSample 示例 ， 会 得 到 如 下 结果 : 


Pi 1s 3.14159 

Square of 5 is 25 

Value field of math variable contains 30 
Square of 30 is 900 


从 代码 中 可 以 看 出 ，Math 类 包含 一 个 属性 和 一 个 方法 ， 该 属性 包含 一 个 数字 ， 该 方法 计算 该 数字 的 平方 。 
这 个 类 还 包含 两 个 静态 方法 ， 一 个 返回 pi 的 值 ， 另 一 个 计算 作为 参数 传 入 的 数字 的 平方 。 

这 个 类 有 一 些 功能 并 不 是 设计 C# 程 序 的 好 例子 。 例 如 ，GetPi0 通 常 作 为 const 字段 来 执行 ， 而 好 的 设计 应 
使 用 目前 还 没有 介绍 的 概念 。 


4. 方法 的 重 载 
C# 支 持 方法 的 重 载 一 方法 的 几 个 版 本 有 不 同 的 签名 ( 即 ,， 方法 名 相同 , 但 参数 的 个 数 和 /或 数据 类 型 不 同 )。 
为 了 重 载 方 法 ， 只 需要 声明 同名 但 参数 个 数 或 类 型 不 同 的 方法 即 可 : 


class ResultDisplayer 
{ 
Public void DisplayResult (string result) 


/i implementation 
} 
Public VolIa DisplayResult (int result) 
| 1/A implementation 
ee 
不 仅 参 数 类 型 可 以 不 同 ， 参 数 的 数量 也 可 以 不 同 ， 如 下 一 个 示例 所 示 。 一 个 重 载 的 方法 可 以 调用 另 一 个 重 
载 的 方法 : 
class MyClass 
public int DoSomething (int x) 
| return DoSsomething (x, 10); // invoke DoSomething with two parameters 


} 


public int DoSomething (int x, int Y) 
{ 
//: implementation 
} 
} 
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Dl} 


注意 : 

对 于 方法 重 载 ， 仅 通过 返回 类 型 不 足以 区 分 重 载 的 版 本 。 仅 通过 参数 名 称 也 不 足以 区 分 它们 。 需 要 区 分 参 
数 的 数量 和 /或 类 型 。 

5. 命名 的 参数 

调用 方法 时 ， 变 量 名 不 需要 添加 到 调用 中 。 然 而 ， 如 果 有 如 下 的 方法 答 名 ， 用 于 移动 矩形 : 

Public Vvoid MoveAndResize (int x, int y, int width, int height) 

用 下 面 的 代码 片段 调用 它 ， 就 不 能 从 调用 中 看 出 使 用 了 什么 数字 ， 这 些 数字 用 于 哪里 : 

r.MoveAndReslize (30, 40, 20, 40); 

可 以 改变 调用 ， 明 确 数字 的 含义 : 

r.MovenAndResize (x: 30，Y: 40, width: 20, height: 40) ; 

任何 方法 都 可 以 使 用 命名 的 参数 调用 。 只 需要 编写 变量 名 ， 后 跟 一 个 冒号 和 所 传递 的 值 。 编 译 器 会 去 掉 变 
量 名 , 创建 一 个 方法 调用 ,就 像 没有 变量 名 一 样 一 这 在 编译 后 的 代码 中 没有 差别 。C# 7.2 允许 使 用 不 拖 尾 的 命 
名 参数 。 使 用 早期 的 C# 版 本 时 ， 需 要 在 使 用 第 一 个 命名 参数 之 后 为 所 有 参数 提供 名 称 。 

还 可 以 用 这 种 方式 更 改变 量 的 顺序 ， 编 译 器 会 重新 安排 ， 获 得 正确 的 顺序 。 其 真正 的 优势 是 下 一 节 所 示 的 
可 选 参数 。 


6. 可 选 参 数 
参数 也 可 以 是 可 选 的 。 必 须 为 可 选 参数 提供 默认 值 。 可 选 参数 还 必须 是 方法 定义 的 最 后 的 参数 ; 


public void TestMethod (Int notoptionalNumber, int optionalNumber = 42) 


Console.WriteLine (optionalNumber + notoptionalNumber).; 


这 个 方法 可 以 使 用 一 个 或 两 个 参数 调用 。 传 递 一 个 参数 ， 编 译 器 就 修改 方法 调用 ， 给 第 二 个 参数 传递 42。 


工人 StMEthOO1T LT 7 
TestMethodt(ll, 之 之 ) 


注意 : 

因为 编译 器 用 可 选 参数 改变 方法 ， 传 递 默认 值 ， 所 以 在 程序 集 的 新 版 本 中 ， 软 认 值 不 应 该 改变 。 在 新 版 本 
中 修改 默认 值 ， 如 果 调 用 程序 在 没有 重新 编译 的 另 一 个 程序 集中 ， 就 会 使 用 旧 的 默认 值 。 这 就 是 为 什么 应 该 只 
给 可 选 参数 提供 永远 不 会 改变 的 值 。 如 果 默 认 值 更 改 时 ， 总 是 重新 编译 调用 的 方法 ， 这 就 不 是 一 个 问题 。 


可 以 定义 多 个 可 选 参数 ， 如 下 所 示 : 
PUublic void TestMethod (int n, int optl = 11，1nt opt2 = 22, int opt3 = 33) 
{ 


Console.WriteLine{(n + optl + opt2 + opt3).; 
} 


这 样 ， 该 方法 就 可 以 使 用 1、2、3 或 4 个 参数 调用 。 下 面 代码 中 的 第 一 行 给 可 选 参数 指定 值 11、22 和 33。 
第 二 行 传递 了 前 三 个 参数 ， 最 后 一 个 参数 的 值 是 33; 


TestMethod (1}).:; 
TestMethod (1, 2, 3); 


通过 多 个 可 选 参数 ， 命 名 参数 的 特性 就 会 发 挥 作用 。 使 用 命名 参数 ， 可 以 传递 任何 可 选 参数 ， 例 如 ， 下 面 
的 例子 仅 传递 最 后 一 个 参数 : 


TestMethod(1, opt3: 4) ; 
opt3: 4 
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注意 : 
注意 使 用 可 选 参 数 时 的 版 本 控制 问题 。 一 个 问题 是 在 新 版 本 中 改变 默认 值 ; 另 一 个 问题 是 改变 参数 的 数量 。 
添加 另 一 个 可 选 参数 看 起 来 很 容易 ， 因 为 它 是 可 选 的 。 然 而 ， 编 译 器 更 改 调用 代码 ， 填 充 所 有 的 参数 ， 如 果 以 
后 添加 另 一 个 参数 ， 早 期 编译 的 调用 程序 就 会 失败 。 
7. 个 数 可 变 的 参数 
使 用 可 选 参数 ， 可 以 定义 数量 可 变 的 参数 。 然 而 ， 还 有 另 一 种 语法 允许 传递 数量 可 变 的 参数 一 这 个 
语法 没有 版 本 控制 问题 。 
声明 数组 类 型 的 参数 (示例 代码 使 用 一 个 int 数组 )， 添 加 params 关键 字 ， 就 可 以 使 用 任意 数量 的 int 参数 调 
用 该 方法 。 
public void AnyNumberofArguments (params int[] data) 
foreach (var x in data) 
z Console.WriteLine (x); 
} 
} 
十 本: 
数组 参见 第 7 章 。 


AnyNumberOfAreuments 方法 的 参数 类 型 是 int[]， 可 以 传递 一 个 int 数组 ， 或 因为 params 关键 字 ， 可 以 传 
递 一 个 或 任何 数量 的 int 值 : 


amyNumceroftarguments (1) 7 
AnyNumberofArgumentst{(1l, 3, 5, 17, 1 1， 工 3 7 


如 果 应 该 把 不 同类 型 的 参数 传递 给 方法 ， 可 以 使 用 object 数组 : 

Public void AnyNumberofArguments (params object[] data) 

f 

现在 可 以 使 用 任何 类 型 调用 这 个 方法 : 

AnyNumberofArguments ("text", 42).; 

如 果 params 关键 字 与 方法 签名 定义 的 多 个 参数 一 起 使 用 ， 则 params 只 能 使 用 一 次 ， 而 且 它 必须 是 最 后 一 
个 参数 : 

ConsolLe .WriteLine (string format, params object[] arg); 


前 面 介绍 了 方法 的 许多 方面 ， 下 面 看 看 构造 函数 ， 这 是 一 种 特殊 的 方法 。 


3.3.6 构造 函数 
声明 基本 构造 函数 的 语法 就 是 声明 一 个 与 包含 的 类 同名 的 方法 ， 但 该 方法 没有 返回 类 型 ; 


public class MyClass 
{ 


public MyClass() 
{ 
} 


/i rest of class definition 


| 
没有 必要 给 类 提供 构造 函数 ， 到 目前 为 止 本 书 的 例子 中 没有 提供 这 样 的 构造 函数 。 一 般 情况 下 ， 如 果 没 有 
提供 任何 构造 函数 ， 编 译 器 会 在 后 台 生 成 一 个 默认 的 构造 函数 。 这 是 一 个 非常 基本 的 构造 函数 ， 它 只 能 把 所 有 
的 成 员 字 段 初 始 化 为 标准 的 默认 值 (例如 ， 引 用 类 型 为 空 引用 ， 数 值 数 据 类 型 为 0，bool 为 false)。 这 通常 就 足 
够 了 ， 人 否则 就 需要 编写 上 自己 的 构造 函数 。 
构造 函数 的 重 载 遭 循 与 其 他 方法 相同 的 规则 。 换 言 之 ， 可 以 为 构造 函数 提供 任意 多 的 重 载 ， 只 要 它们 的 签 
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0 路 


名 有 明显 的 区 别 即 可 : 
public MyClass() // zeroparameter constructor 


/:/: construction code 


} 
public MyClass (int number) // another overload 
{ 


:i/: construction code 


} 

但 是 ， 如 果 提 供 了 市 参数 的 构造 函数 ， 编 译 器 就 不 会 目 动 提供 默认 的 构造 函数 。 只 有 在 没有 定义 任何 构 
造 函 数 时 ， 编 译 器 才 会 目 动 提供 默认 的 构造 函数 。 在 下 面 的 例子 中 , 因为 定义 了 一 个 带 单个 参数 的 构造 函数 ， 
编译 器 会 假定 这 是 可 用 的 唯一 构造 函数 ， 所 以 它 不 会 隐 式 地 提供 其 他 构造 函数 : 

Public class MyNumber 

{ 


private int number; 


public MyNumber (int number) 
{ 
_ number = number; 
} 
} 


如 果 试 图 使 用 无 参数 的 构造 函数 实例 化 MyNumber 对 象 ， 就 会 得 到 一 个 编译 错误 : 
Var numb = new MyNumber(); // causes compilation error 

注意 ， 可 以 把 构造 函数 定义 为 private 或 protected， 这 样 不 相关 的 类 就 不 能 访问 它们 : 
Public class MyNumber 

{ 


private int number; 
private MyNumber (int number) // another overload 


number = number; 
| 
这 个 例子 没有 为 MyNumber 定义 任何 公有 的 或 受 保护 的 构造 函数 。 这 就 使 MyNumber 不 能 使 用 new 运算 
符 在 外 部 代码 中 实例 化 (但 可 以 在 MyNumber 中 编写 一 个 公有 静态 属性 或 方法 ， 以 实例 化 该 类 )。 这 在 下 面 两 种 
情况 下 是 有 用 的 : 
se 关 仅 用 作 茶 些 静态 成 员 或 属性 的 容器 ， 因 此 永远 不 会 实例 化 它 。 在 这 种 情况 下 ， 可 以 用 static 修饰 符 声 
明 类 。 使 用 这 个 修饰 待 ， 类 只 能 包含 静态 成 员 ， 不 能 实例 化 。 
e 希望 类 仅 通 过 调用 某 个 静态 成 员 函 数 来 实例 化 (这 就 是 所 谓 对 象 实例 化 的 类 工厂 方法 )。 单 例 模式 的 实现 
如 下 面 的 代码 片段 所 示 : 


public class Singleton 


private static Singleton s instance; 
private int state; 
private Singletonl(int state) 


{ 
state = state; 
} 
public static Singleton Instance 
get => 5 instance ?2? (s instance = new Singleton (42); 
} 
} 


Singleton 关 包 合 一 个 私有 构造 函数 ， 所 以 只 能 在 类 中 实例 化 它 本 身 。 为 了 实例 化 它 ， 静 态 属 性 Instance 返 
回 字段 s instance。 如 果 这 个 字段 尚未 初始 化 mulD)， 就 调用 实例 构造 函数 ， 创 建 一 个 新 的 实例 。 为 了 检查 null， 
使 用 合并 运算 符 。 如 果 这 个 操作 符 的 左边 是 null， 就 处 理 操作 符 的 右边 ， 调 用 实例 构造 函数 。 


注意 : 
合并 运算 符 参 见 第 6 章 。 
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1. 表达 式 体 和 构造 浮 数 
如 果 构 造 函 数 的 实现 由 一 个 表达 式 组 成 ， 那 么 构造 函数 可 以 通过 一 个 表达 式 体 来 实现 : 


public class Singleton 
{ 
private static Singleton s instance; 
private int state; 
Private Singletonl(int state) 一 > state = state,; 


Public static Singleton Instance 三 > 


s instance 22 {s instance = new Singleton (42); 


| 

2. 从 构造 函数 中 调用 其 他 构造 舟 数 

有 时 ， 在 一 个 类 中 有 几 个 构造 函数 ， 以 容纳 茶 些 可 选 参 数 ， 这 些 构造 函数 包含 一 些 共同 的 代码 。 例 如 ， 下 
面 的 情况 : 


class Car 

{ 
private string description; 
private uint nWheels; 


Public Car(string description, uint nwWwheels) 
description = description;s 
nnWheels = nWheels; 

} 


Public Car{(string description) 


description = description;s 
_nWheels = 4: 
} 
AAA --- 
} 


这 两 个 构造 函数 初始 化 相同 的 字段 ， 显 然 ， 最 好 把 所 有 代码 放 在 一 个 地 方 。C# 有 一 个 特殊 的 语法 ， 称 为 构 
造 函 数 初始 化 器 ， 可 以 实现 此 目的 : 
class Car 
{ 
private string description; 
private uint nWheels; 
Public Car(string description, uint nwWwheels) 
{ 
description = description;s 
nnWheels = nWheels; 
} 
public Car(string description): this (description, 4) 


{ 
} 
ff --- 
这 里 ，this 关键 字 仅 调 用 参数 最 匹配 的 那个 构造 函数 。 注 意 ， 构 造 函 数 初始 化 器 在 构造 函数 的 函数 体 之 前 
执行 。 现 在 假定 运行 下 面 的 代码 : 
var myCar = new Car{("Proton Personan) ; 
在 本 例 中 ， 在 带 一 个 参数 的 构造 函数 的 函数 体 执行 之 前 ， 先 执行 带 两 个 参数 的 构造 图 数 (但 在 本 例 中 ， 因 为 
在 带 一 个 参数 的 构造 函数 的 函数 体 中 没有 代码 ， 所 以 没有 区 别 )。 
C# 构 造 函 数 初 始 化 器 可 以 包含 对 同一 个 类 的 男 一 个 构造 函数 的 调用 (使 用 前 面 介绍 的 语法 )， 也 可 以 包含 对 
直接 基 类 的 构造 函数 的 调用 (使 用 相同 的 语法 ， 但 应 使 用 base 关键 字 代 替 this)。 初 始 化 器 中 不 能 有 多 个 调用 。 
3. 静态 构造 阔 数 


C# 的 一 个 特征 是 也 可 以 给 类 编写 无 参数 的 静态 构造 函数 。 这 种 构造 函数 只 执行 一 次 ， 而 前 面 的 构造 函数 是 
实例 构造 函数 ， 只 要 创建 类 的 对 象 ， 就 会 执行 它 。 
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Class MyClass 
static MyClass() 
// initialization code 


:i rest of class definition 


编写 静态 构造 国 数 的 一 个 原因 是 ， 类 有 一 些 静 态 字段 或 属性 ， 需 要 在 第 一 次 使 用 类 之 前 ， 从 外 部 源 中 初始 
化 这 些 静 态 字段 和 属性 。 

NET 运 行 库 没 有 确保 什么 时 候 执行 静态 构造 函数 ， 所 以 不 应 把 要 求 在 某 个 特定 时 刻 (例如 ， 加 载 程序 集 时 ) 
执行 的 代码 放 在 静态 构造 函数 中 。 也 不 能 预计 不 同类 的 静态 构造 函数 按照 什么 顺序 执行 。 但 是 ， 可 以 确保 静态 
构造 函数 至 多 运行 一 次 ， 即 在 代码 引用 类 之 前 调用 它 。 在 C# 中 ,通常 在 第 一 次 调用 类 的 任何 成 员 之 前 执行 静态 

注意 ， 静 态 构 造 函 数 没 有 访问 修饰 待 ， 其 他 C# 代 码 从 来 不 显 式 调用 它 ， 但 在 加 载 类 时 ， 总 是 由 NET 运行 
库 调用 它 ， 所 以 像 public 或 private 这 样 的 访问 修饰 符 就 没有 任何 意义 。 出 于 同样 的 原因 ， 静 态 构造 冰 数 不 能 带 
任何 参数 ， 一 个 类 也 只 能 有 一 个 静态 构造 函数 。 很 显然 ， 静 态 构 造 函数 只 能 访问 类 的 静态 成 员 ， 不 能 访问 类 的 

无 参数 的 实例 构造 函数 与 神态 构造 尔 数 可 以 在 同一 个 类 中 定义 。 尽 管 参数 列表 相同 ， 但 这 并 不 牙 盾 ， 因 为 
在 加 载 类 时 执行 琅 态 构造 函数 ， 而 在 创建 实例 时 执行 实例 构造 沙 数 ， 所 以 何 时 执行 哪个 构造 函数 不 会 有 冲突 。 

如 果 多 个 类 都 有 静态 构造 函数 ， 先 执行 哪个 静态 构造 图 数 就 不 确定 。 此 时 静态 构造 函数 中 的 代码 不 应 依 
赖 于 其 他 静态 构造 函数 的 执行 情况 。 另 一 方面 ， 如 果 任 何 静 态 字 段 有 默认 值 ， 吏 在 调用 静态 构造 函数 之 前 分 
配 它 们 。 

下 面 用 一 个 例子 来 说 明 静 态 构造 函数 的 用 法 。 该 例子 的 思想 基于 包含 用 户 痢 选项 的 程序 (假定 用 户 首 选项 
存储 在 茶 个 配置 文件 中 )。 为 了 简单 起 见 ,假定 只 有 一 个 用 户 首 选项 一 一 BackColor， 它 表示 要 在 应 用 程序 中 使 
用 的 背景 色 。 因 为 这 里 不 想 编写 从 外 部 数据 源 中 读 取 数据 的 代码 ， 所 以 假定 该 首选 项 在 工作 日 的 背景 色 是 红 
色 , 在 周末 的 背景 色 是 绿色 。 程 序 仅 在 控制 台 窗 口中 显示 首选 项 一 一 但 这 足以 说 明 静 态 构造 函数 是 如 何 工 作 的 。 

类 UserPreferences 用 static 修饰 符 声 明 ， 因 此 它 不 能 实例 化 ， 只 能 包含 静态 成 员 。 静 态 构造 函数 根据 星期 
几 初 始 化 BackColor 属性 (代码 文件 StaticConstructorSample /UserPreferences.cs): 


public static class UserPreferences 


public static Color BackColor { get; } 
static UserPreferences() 
{ 
DateTime now = DateTime .Now:; 
if (now.DayofWeek == DayOfWeek.Saturday 
[| now.DayofWeek == DaYyoOfWeek.Sunday) 


BackColor = Color.Green; 
} 
1] Se 
{ 

BackColor = Color.Red:; 


} 
} 
这 段 代码 使 用 了 .NET Framework 类 库 提供 的 System.DateTime 结构 。DateTime 结构 实现 了 返回 当前 时 间 的 
静态 属性 Now，DayOfWeek 属性 是 DateTime 的 实例 属性 ， 返 回 一 个 类 型 DayOfWeek 的 枚 举 值 。 
Color 定义 为 enum 类 型 ， 包含 几 种 颜色 。enum 类 型 详 见 “ 枚 举 ” 一 节 ( 代 码 文 件 StaticConstructor- 
Sample/Enum.cs): 


PUublic enum Color 
{ 

White, 

Red, 

GIeSen, 

Blue,. 
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Black 
} 


Main0 方 法 调用 Console. WriteLine 方法 ,把 用 户 首 选 的 背景 色 写 到 控制 台 ( 代 码 文件 StaticConstructorSample 
/Program.cs): 
class Program 


static woid Maint() 
{ 
COmSD1E .WriteLinet 
$s"User-preferences: BackColor is: {UserPreferences.BackColor}"™"); 
} 
} 


编译 并 运行 这 段 代码 ， 会 得 到 如 下 结果 : 
User-preferences: BackColor is: Color Red 


当然 ， 如 果 在 周末 执行 上 述 代码 ， 颜 色 首 选项 就 是 Green。 


3.4 结构 


前 面 介绍 了 类 如 何 封 沪 程序 中 的 对 象 ， 也 介绍 了 如 何 将 它们 存储 在 堆 中 ， 通 过 这 种 方式 可 以 在 数据 的 生存 
期 上 获得 很 大 的 灵活 性 ， 但 性 能 会 有 一 定 损 失 。 因 为 托管 堆 的 优化 ， 这 种 性 能 损失 较 小 。 但 是 ， 有 时 仅 需 要 一 
个 小 的 数据 结构 。 此 时 ， 类 提供 的 功能 多 于 我 们 需要 的 功能 ， 由 于 性 能 原因 ， 最 好 使 用 结构 。 看 看 下 面 的 例子 : 


Public class Dimensions 

{ 
Public Dimensions (double length, double width) 
{ 


Length = length; 
Width = width; 
} 
public double Length { get; } 
public double Width { get; } 
} 


上 面 的 代码 定义 了 类 Dimensions， 它 只 存储 了 某 一 项 的 长 度 和 宽度 。 假 定编 写 一 个 布置 家 具 的 程序 ， 让 人 
们 试 着 在 计算 机 上 重新 布置 家 具 ， 并 存储 每 件 家 具 的 尺寸 。 表 面 看 来 使 字段 变 为 公共 字段 会 违背 编程 规则 ， 但 
这 里 的 关键 是 我 们 实际 上 并 不 需要 类 的 全 部 功能 。 现 在 只 有 两 个 数字 ， 把 它们 当成 一 对 来 处 理 ， 要 比 单 个 处 理 
方便 一 些 。 既 不 需要 很 多 方法 ， 也 不 需要 从 类 中 继承 ， 也 不 希望 NET 运行 库 在 堆 中 遇 到 麻烦 和 性 能 问题 ， 只 需 
要 存储 两 个 double 类 型 的 数据 即 可 。 

为 此 ， 只 需要 修改 代码 ， 用 关键 字 struct 代替 class， 定 义 一 个 结构 而 不 是 类 ， 如 本 章 前 面 所 述 : 


Public struct Dimensions 

{ 
Public Dimensions (double length, double width) 
{ 


Length = length; 
Width = width; 
} 


public double Length { get; } 
Public double Width { get; } 
} 


为 结构 定义 函数 与 为 类 定义 函数 完全 相同 。 前 面 介绍 了 Dimensions 结构 的 构造 函数 。 下 面 的 代码 添加 
Diagonal 属性 ， 以 调用 Math 类 的 Sqrt 方法 (代码 文件 StructsSample/Dimension.cs): 


Public struct Dimensions 
{ 
Public double Length { get; } 
public double Width { get; } 
Public Dimensions (double length, double width) 
{ 
Length = length; 
Width = width:; 
} 
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public double Diagonal => Math.SsSqgqrt (Length * Length + Width * Width); 


结构 是 值 类 型 , 不 是 引用 类 型 。 它 们 存储 在 栈 中 或 存储 为 内 联 (如 果 它 们 是 存储 在 堆 中 的 另 一 个 对 象 的 一 部 
分 )， 其 生存 期 的 限制 与 简单 的 数据 类 型 一 样 。 

。 结构 不 支持 继承 。 

。 对 于 结构 ， 构 造 函数 的 工作 方式 有 一 些 区 别 。 如 果 没 有 提供 默认 的 构造 函数 ， 编 译 器 会 自动 提供 一 个 ， 

把 成 员 初始 化 为 其 默认 值 。 

。 使 用 结构 ， 可 以 指定 字段 如 何在 内 存 中 布局 (第 16 章 在 介绍 特性 时 将 详细 论述 这 个 问题 )。 

因为 结构 实际 上 是 把 数据 项 组 合 在 一 起 ， 所 以 有 时 大 多 数 或 者 全 部 字段 都 声明 为 public。 严 格 来 说 ， 这 与 编 
写 NET 代 码 的 规则 相反 一 根据 Microsoft， 字 段 ( 除 了 const 字 段 之 外 ) 应 总 是 私有 的 ， 并 由 公有 属性 封装 。 但 是 ， 
对 于 简单 的 结构 ， 许 多 开发 人 员 都 认为 公有 字段 是 可 接受 的 编程 方式 。 


注意 : 
在 后 台 上 ，int 类 型 (System.Int32) 是 一 个 具有 公共 字段 的 结构 。 新 类 型 System.ValueType 是 一 个 包含 一 个 
或 多 个 公共 字段 的 结构 。ValueTuple 在 第 13 章 中 详细 讨论 。 


下 面 几 节 将 详细 说 明 类 和 结构 之 间 的 区 别 。 


3.4.1 结构 是 值 类 型 


虽然 结构 是 值 类 型 ， 但 在 语法 上 切 常 可 以 把 它们 当 作 类 来 处 理 。 例 如 ， 在 上 面 的 Dimensions 类 的 定义 中 ， 
可 以 编写 下 面 的 代码 : 

Var point = new Dimensions (); 

point.Length = 3; 

point .Width = 6; 

注意 ， 因 为 结构 是 值 类 型 ， 所 以 new 运算 符 与 类 和 其 他 引用 类 型 的 工作 方式 不 同 。new 运算 符 并 不 分 配 堆 
中 的 内 存 ， 而 是 只 调用 相应 的 构造 函数 ， 根 据 传送 给 它 的 参数 ， 初 始 化 所 有 字段 。 对 于 结构 ， 可 以 编写 下 述 完 
全 合法 的 代码 : 

Dimensions point; 

point.Length = 3; 

point.Width = 6; 

如 果 Dimensions 是 一 个 类 ， 就 会 产生 一 个 编译 错误 ， 因 为 point 包含 一 个 未 初始 化 的 引用 一 一 不 指向 任何 
地 方 的 一 个 地 址 ， 所 以 不 能 给 其 字段 设置 值 。 但 对 于 结构 ， 变 量 声 明 实 际 上 是 为 整个 结构 在 栈 中 分 配 空间 ， 所 
以 就 可 以 为 它 赋 值 了 。 但 要 注意 下 面 的 代码 会 产生 一 个 编译 错误 ， 编 译 器 会 抱怨 用 户 使 用 了 未 初始 化 的 变量 : 


Dimensions point; 
double d = point.Length; 


结构 遵循 其 他 数据 类 型 都 遵循 的 规则 ;在 使 用 前 所 有 元 素 都 必须 进行 初始 化 。 在 结构 上 调用 new 运算 符 ， 
或 者 给 所 有 的 字段 分 别 赋 值 ， 结 构 就 完全 初始 化 了 。 当 然 ， 如 果 结 构 定义 为 类 的 成 员 字 段 ， 在 初始 化 包含 的 对 
象 时 ， 该 结构 会 自动 初 始 化 为 0。 

结构 会 影响 性 能 的 值 类 型 ， 但 根据 使 用 结构 的 方式 ， 这 种 影响 可 能 是 正面 的 ， 也 可 能 是 负面 的 。 正 面 的 影 
啊 是 为 结构 分 配 内 存 时 ， 速 度 非常 快 ， 因 为 它们 将 内 联 或 者 保存 在 栈 中 。 在 结构 超出 了 作用 域 被 删除 时 ， 速 度 
也 很 快 ， 不 需要 等 待 垃圾 收集 。 负 面 影响 是 ， 只 要 把 结构 作为 参数 来 传递 或 者 把 一 个 结构 赋予 另 一 个 结构 (如 
A=B， 其 中 A 和 B 是 结构 )， 结 构 的 所 有 内 容 就 被 复制 ， 而 对 于 类 ， 则 只 复制 引用 。 这 样 就 会 有 性 能 损失 ， 根 
据 结 构 的 大 小 ， 性 能 损失 也 不 同 。 注 意 ， 结 构 主 要 用 于 小 的 数据 结构 。 

但 当 把 结构 作为 参数 传递 给 方法 时 , 应 把 它 作 为 ref 参数 传递 ， 以 避免 性 能 损失 一 一 此 时 只 传递 了 结构 在 内 
存 中 的 地 址 ， 这 样 传递 速度 就 与 在 类 中 的 传递 速度 一 样 快 了 。 但 如 果 这 样 做 ， 就 必须 注意 被 调用 的 方法 可 以 改 
变 结 构 的 值 。 详 见 本 章 后 面 的 内 容 。 
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3.4.2 ”品读 结构 


从 属性 中 返回 一 个 值 类 型 时 ， 调 用 方 会 收 到 一 个 副本 。 设 置 此 值 类 型 的 属性 只 更 改 副 本 ， 原 始 值 不 变 。 这 
可 能 会 让 访问 属性 的 开发 人 员 感 到 困惑 。 这 就 是 为 什么 结构 的 指导 原则 定义 了 值 类 型 应 该 是 不 可 变 的。 当然 ， 
这 个 准则 对 于 所 有 值 类 型 都 无 效 ， 因 为 int、short、double…… 不 是 不 可 变 的 ,而且 ValueTuple 也 不 是 不 可 变 的 。 
然而 ， 大 多 数 结构 类 型 都 是 不 可 变 的 。 

使 用 C# 7.2 时 ，readonly 修饰 符 可 以 应 用 于 结构 ， 因 此 编译 器 保证 结构 体 的 不 变性 。 使 用 C# 7.2 时， 可 以 
声明 前 面 定 义 的 类 型 Dimensions 为 readonly， 因 为 它 只 包含 一 个 修改 其 成 员 的 构造 函数 。 属 性 只 包含 一 个 get 
访问 器 ， 因 此 不 可 能 进行 更 改 (代码 文件 ReadOnlyStructSample/Dimensions.cs): 

public readonly struct Dimensions 

Public double Length { get; } 

Public double Width { get; } 

public Dimensions (double length, double width) 

"i = length; 
Width = width; 
} 


Public double Diagonal => Math.sqrt (Length * Length + Width * Width); 


对 于 readonly 修饰 符 ， 如 果 在 创建 对 象 后 类 型 更 改 了 字段 或 属性 ， 编 译 占 就 会 报错 。 使 用 这 个 修饰 符 ， 编 
译 器 可 以 生成 优化 的 代码 ， 使 其 在 传递 结构 体 时 不 会 复制 结构 的 内 容 ， 相 有 反 ， 编 译 器 使 用 引用 ， 因 为 它 永 远 不 
会 改变 。 


3.4.3 ”结构 和 继承 


结构 不 是 为 继承 设计 的 。 这 意味 看 : 它 不 能 从 一 个 结构 中 继承 。 唯 一 的 例外 是 对 应 的 结构 (和 C# 中 的 其 他 
类 型 一 样 ) 最 终 派生 于 类 System.Object。 因 此 ， 结 构 也 可 以 访问 System.Object 的 方法 。 在 结构 中 ， 甚 至 可 以 重 
写 System.Object 中 的 方法 一 一 如 重 写 ToString0 方 法 。 结 构 的 继承 链 是 ， 每 个 结构 派生 上 自 System.ValueType 类 ， 
System.ValueType 类 又 派生 自 System.Object。ValueType 并 没有 给 Object 添加 任何 新 成 员 , 但 提供 了 一 些 更 适合 
结构 的 实现 方式 。 注 意 ， 不 能 为 结构 提供 其 他 基 类 : 每 个 结构 都 派生 目 ValueType。 


注意 : 
只 有 结构 作为 对 象 时 , 才 从 System.ValueType 中 继承 ,不 能 用 作对 和 象 的 结构 是 引用 结构 ,这些 类 型 自 C#7.2 
以 来 一 直 可 用 。 这 个 特性 参见 稍 后 的 “ref 结构 ” 。 


注意 : 
要 比较 结构 值 ， 最 好 实现 接口 IEquatable<T>。 该 接口 将 在 第 6 章 中 讨论 。 


3.4.4 结构 的 构造 函数 


为 结构 定义 构造 函数 的 方式 与 为 类 定义 构造 函数 的 方式 相同 。 
前 面 说 过 ， 默 认 构 造 函 数 把 数值 字段 都 初始 化 为 0， 且 总 是 隐 式 地 给 出 ， 即 使 提供 了 其 他 带 参数 的 构造 函 
数 ， 也 是 如 此 。 不 能 为 结构 创建 定制 的 默认 构造 函数 。 
public Dimensions (double length, double width) 
Length = length; 
Width = width; 
} 


另外 ， 可 以 像 类 那样 为 结构 提供 Close0 或 Dispose0 方 法 。 第 17 章 将 讨论 Dispose0 方 法 。 
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3.4.5 ref 结构 


结构 并 不 总 是 放 在 堆栈 上 。 它们 也 可 以 放 在 堆 上 。 可 以 为 对 象 分 配 一 个 结构 体 , 这 会 在 堆 中 创建 一 个 对 象 。 
这 种 行为 在 某 些 类 型 中 可 能 是 一 个 问题 。 在 NET Core 2.1 中 ，Span 类 型 允许 访问 堆栈 上 的 内 存 。Span 类 型 的 
副本 需要 是 原子 的 。 只 有 当 类 型 放 在 堆栈 上 时 ， 才 能 保证 这 一 点 。 此 外 ，Span 类 型 可 以 在 其 字段 中 使 用 托管 指 
针 。 在 堆 上 有 这 样 的 指针 ， 可 以 在 垃圾 收集 器 运行 时 使 应 用 程序 月 溃 。 因 此 ， 需 要 保证 类 型 放 在 堆栈 上 。 

使 用 新 的 C# 7.2 语言 结构 ， 引 用 类 型 存储 在 堆 上 ， 值 类 型 通常 存储 在 栈 上 ， 但 也 可 以 存储 在 堆 上 。 还 有 第 
三 种 可 用 类 型 ， 即 只 能 在 栈 上 存储 的 值 类 型 。 

此 类 型 是 将 ref 修饰 符 应 用 于 结构 而 创建 的 ， 如 下 面 的 代码 片段 所 示 。 可 以 添加 属性 、 值 字段 、 引 用 类 型 
和 方法 一 就 像 其 他 结构 一 样 (代码 文件 RefStructSample/ValueTypeOnly.cs): 


ref struct ValueTypeOnly 
{ 

ER 
} 


这 种 类 型 不 能 执行 的 操作 是 将 它 分 配给 对 象 一 一 例如 ， 调 用 Object 基 类 的 方法 (如 ToString)。 这 将 导致 装 
箱 ， 并 创建 一 个 引用 类 型 ， 这 种 类 型 是 不 允许 这 种 操作 的 。 

注意 : 

对 于 大 多 数 应 用 程序 ， 不 需要 创建 自 定 义 ref struct 类 型 。 但 是 ,对 于 需要 减少 垃圾 收集 的 高 性 能 应 用 程序 ， 
需要 使 用 这 种 类 型 。 要 获得 ref struct 的 更 多 信息 ， 使 用 这 种 类 型 的 原因 ， 以 及 使 用 ref return 和 ref local， 应 该 
阅读 第 17 章 ， 其 中 详细 介绍 了 Span 类 型 ， 以 及 关于 ref 的 更 多 信息 。 


3.5 “ 按 值 和 按 引 用 传递 参数 


假设 有 一 个 类 型 A， 它 有 一 个 int 类 型 的 属性 义 。ChangeA 方法 接收 类 型 A 的 参数 ， 把 X 的 值 改 为 2( 代 码 
文件 PassingByValueAndReference/Program.cs): 


Public static void Changea (A a) 


Main0) 方 法 创建 类 型 A 的 实例 ， 把 X 初始 化 为 1， 调 用 ChangeA 方法 : 
static woid Malinr) 
{ 
五 下 = newAaAl{X= 1 1}; 
ChangeaA (al).:; 
Console .WriteLine ($s$"al .Xx: {al .Xx}™).; 
} 


输出 是 什么 ?1 还 是 2? 

答案 视 情 况 而 定 。 需 要 知道 A 是 一 个 类 还 是 结构 。 下 面 先 假定 A 是 结构 : 
Public struct A 

{ 


public int X { get set; ]} 
} 


结构 按 值 传递 ， 通 过 按 值 传 递 ，ChangeA 方法 中 的 变量 a 得 到 堆栈 中 变量 al 的 一 个 副本 。 在 方法 ChangeA 
的 最 后 修改 并 销毁 副本 。al 的 内 容 从 不 改变 ， 一 直 是 1。 

A 作为 一 个 类 时 ， 是 完全 不 同 的 : 

- class A 


public int X { get; set; } 
} 


类 按 引 用 传递 。 这 样 ，a 变量 把 堆 上 的 同一 个 对 象 引用 为 变量 a1。 当 ChangeA 修改 a 的 X 属性 值 时 ， 把 
它 改 为 al1.X， 因 为 它 是 同一 个 对 象 。 这 里 ， 结 果 是 2。 
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注意 : 

为 了 避免 在 更 改 成 员 时 类 和 结构 之 间 的 不 同行 为 上 出 现 这 种 混 消 ， 最 好 将 结构 设置 为 不 可 变 的 。 如 果 一 个 
结构 体 只 有 不 允许 改变 状态 的 成 员 ， 就 不 会 陷入 如 此 混乱 的 境地 。 当然 ， 使 struct 类 型 不 可 变 的 规则 总 是 有 例 
外 的 。C#7 中 新 增 的 ValueTuple 实现 为 一 个 可 变 结构 体 。 然 而 ， 使 用 ValueTuple， 人 公共 成 员 就 是 字段 ， 而 不 是 
属性 (这 是 提供 公共 字段 的 准则 的 另 一 个 例外 )。 由 于 元 组 很 重要 ， 且 以 int 和 float 的 方式 使 用 它们 ， 这 是 违反 
一 些 指 导 原 则 的 好 理由 。 


3.5.1 ref 参数 


也 可 以 通过 引用 传递 结构 。 如 果 A 是 结构 类 型 ， 就 添加 ref 修饰 待 ， 修 改 ChangeA 方法 的 声明 ， 通 过 引用 
传递 变量 : 


Public static vold ChangeRaI(ITefE A a) 


从 调用 端 也 可 以 看 出 这 一 点 ， 所 以 给 方法 参数 应 用 了 ref 修饰 符 后 ， 在 调用 方法 时 需要 添加 和 它 : 


static wolid Maint{) 
{ 
Aal = new BA{KX=1 1}; 
Changea (ref al); 
Console.WriteLine(s"al .Xx: {al .XxX}™): 
} 


现在 ， 与 类 类 型 一 样 ， 结 构 也 按 引 用 传递 ， 所 以 结果 是 2。 

类 类 型 如 何 使 用 ref 修饰 符 ? 下 面 修改 ChangeA 方法 的 实现 ; 

Public static void ChangeaA (五 a) 

| da. 一 之; 

忆 一 了 EW ET 一 了 卫 }; 

} 

使 用 A 类 型 的 类 ， 可 以 预期 什么 结果 ? 当然 ，Main0 方 法 的 结果 不 是 1， 因 为 按 引 用 传递 是 通过 类 类 型 实 
现 的 。aX 设置 为 2， 就 改变 了 原始 对 象 a1。 然 而 ， 下 一 行 a= new A { 义 =3 } 现 在 在 堆 上 创建 一 个 新 对 象 ， 和 
一 个 对 新 对 象 的 引用 。Main0 方 法 中 使 用 的 变量 al 仍然 引用 值 为 2 的 旧 对 象 。ChangeA 方法 结束 后 ， 没 有 引用 
堆 上 的 新 对 象 ， 可 以 回收 它 。 所 以 这 里 的 结果 是 2。 

把 A 作为 类 类 型 ， 使 用 ref 修饰 待 ， 传 递 对 引用 的 引用 (在 C+ 术语 中 ， 是 一 个 指向 指针 的 指针 )， 它 允许 
分 配 一 个 新 对 象 ，Main0 方 法 显示 了 结果 3: 

Public static void ChangeA (ref A a) 

| 已 -其 一 27 


二 PEW {X= 3 }: 
} 


最 后 ， 一 定 要 理解 ，C# 对 传递 给 方法 的 参数 继续 应 用 初始 化 要 求 。 在 任何 变量 传递 给 方法 之 前 ， 必 须 初 始 
化 ， 无 论 是 按 值 还 是 按 引用 传递 。 


注意 : 
在 C#7 中， 还 可 以 对 局 部 变量 和 方法 的 返回 类 型 使 用 ref 关键 字 。 这 个 新 特性 在 第 17 章 中 讨论 。 


3.5.2 ”out 参数 


如 果 方 法 返回 一 个 值 ， 该 方法 通常 声明 返回 类 型 ， 并 返回 结果 。 如 果 方 法 返回 多 个 值 ， 可 能 类 型 还 不 同 ， 
该 怎么 办 ? 这 有 不 同 的 选项 。 一 个 选项 是 声明 类 和 结构 ， 把 应 该 返回 的 所 有 信息 都 定义 为 该 类 型 的 成 员 。 另 一 
个 选项 是 使 用 元 组 类 型 。 元 组 参见 第 13 章 。 第 三 个 选项 是 使 用 out 关键 字 。 

下 面 的 例子 使 用 通过 Int32 类 型 定义 的 Parse 方法 。ReadLine 方法 获取 用 户 输入 的 字符 串 。 假设 用 户 输入 一 
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个 数字 ，int.Parse 方法 把 它 转 换 为 字符 串 ， 并 返回 该 数字 (代码 文件 OutKeywordSample/Program .cs): 

string inputl = Console.ReadLine(); 

int resultl = int.Parse (input1); 

Console.WriteLine ($"result: {result1}"); 

然而 ， 用 户 并 不 总 是 输入 希望 他 们 输入 的 数据 。 如 果 用 户 没有 输入 数字 ， 就 会 抛 出 一 个 异常 。 当 然 ， 可 以 
捕获 异常 ， 并 相应 地 处 理 用 户 , 但 “正常 ”情况 不 这 么 做 。 也 许可 以 认为 ,“ 正 常 ” 情 况 就 是 用 户 输 入 了 错误 的 
数据 。 处 理 异 遂 参 见 第 14 章 。 

要 处 理 类 型 错误 的 数据 ， 更 好 的 方法 是 使 用 Int32 类 型 的 另 一 个 方法 : TryParse。TryParse 声明 为 无 论 解析 
成 功 与 否 ， 都 返回 一 个 bool 类 型 。 解 析 的 结果 (如 果 成 功 ) 是 使 用 out 修饰 竺 返回 一 个 参数 : 

public static bool TryParse{(string s, out int result); 

调用 此 方法 后 ，result 变量 不 需要 预先 初始 化 ， 而 是 在 方法 中 初始 化 变量 。 在 C# 7 中 ， 也 可 以 在 方法 调用 
时 声明 变量 。 与 ref 关键 字 类 似 ， 在 调用 方法 时 需要 提供 out 关键 字 ， 而 不 仅仅 在 声明 方法 时 提供 : 


string input2 = ReadLine (}); 

if (int.TryParse (input2, out int result2)) 
Console .WriteLine ($s$"result: {result2}"™"):; 

} 

已 二 号 已 


{ 


Console .WriteLine{("not a number™). 


注意 : 

out var 是 C#7 的 一 个 新 特性 。 在 C#7 之 前 ， 需 要 在 调用 该 方法 之 前 声明 一 个 out 变量 。 在 C#7 中 ， 可 以 
调用 方法 来 实现 声明 。 如 果 类 型 是 由 方法 签名 明确 定义 的 , 则 可 以 使 用 var 关键 字 ( 这 就 是 为 什么 out var 知道 这 
个 特性 的 原因 ) 来 声明 变量 。 还 可 以 定义 具体 的 类 型 ， 如 前 面 的 代码 片段 所 示 。 该 变量 的 作用 域 在 方法 调用 之 后 
是 有 效 的 。 


3.5.3 in 参数 


C# 7.2 同 参 数 添加 了 in 修饰 符 。out 修饰 符 人 允许 返回 参数 指定 的 值 。in 修饰 符 保 证 发 送 到 方法 中 的 数据 不 
会 更 改 (在 传递 值 类 型 时 )。 

下 面 定 义 一 个 简单 的 可 变 结 构 体 ， 名 称 为 AvalueType ， 再 定义 一 个 公共 可 变 字 段 (代码 文件 
InParameterSample/AValueType.cs): 

struct AvalueType 


public int Data; 
} 


现在 ,使 用 in 修饰 符 定 义 一 个 方法 时 ， 变 量 就 不 能 更 改 了 。 试 图 更 改 可 变 字 段 Data， 编 译 器 会 抱怨 不 能 为 
只 读 变 量 的 成 员 分 配 值 ， 因 为 该 变量 是 只 读 的 。in 修饰 符 使 参数 设置 为 只 读 变 量 ( 代 码 文件 
InParameterSample/Proeram.cs): 

static void CantChange (in AValueType a) 

, // a.Data = 43; // does not compile —- readonly variable 


Console .WriteLine (a.Data).; 


} 
当 调 用 方法 CantChange 时 ， 可 以 通过 传递 或 不 传递 in 修饰 符 来 调用 该 方法 。 这 对 生成 的 代码 没有 影 啊 。 
使 用 值 类 型 和 in 修饰 符 ， 不仅 有 助 于 确保 不 更 改 内 存 ， 编 译 器 还 可 以 创建 更 好 的 优化 代码 。 与 使 用 方法 调 

用 来 复制 值 类 型 不 同 ， 编 译 器 可 以 使 用 引用 ， 从 而 减少 所 需 的 内 存 并 提高 性 能 。 
注意 : 
in 修饰 符 主要 用 于 值 类 型 。 也 可 以 对 引用 类 型 使 用 它 。 雇 修饰 符 用 于 引用 类 型 时 ， 可 以 更 改变 量 的 内 容 ， 

但 不 能 更 改变 量 本 身 。 
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3.6 ”可 空 类 型 


引用 类 型 (类 ) 的 变量 可 以 为 空 ， 而 值 类 型 (结构 ) 的 变量 不 能 。 在 一 些 情况 下 ， 这 可 能 是 一 个 问题 ， 如 把 C# 
类 型 映射 到 数据 库 或 XML 类 型 。 数 据 库 或 XML 数量 可 以 为 空 ， 而 int 或 double 不 能 为 空 。 

处 理 这 个 冲突 的 一 个 方法 是 使 用 映射 到 数据 库 数字 类 型 的 类 (这 由 Java 实现 )。 使 用 引用 类 型 ， 映 射 到 允许 
空 值 的 数据 库 数 字 ， 有 一 个 重要 的 缺点 : 它 融 来 了 额外 的 开销 。 对 于 引用 类 型 ， 需 要 垃圾 收集 器 进行 清理 。 
类 型 不 需要 用 垃圾 收集 器 清理 ;变量 超出 作用 域 时 ， 从 内 存 中 删除 。 

C# 有 一 个 解决 方案 : 可 空 类 型 。 可 空 类 型 是 可 以 为 空 的 值 类 型 。 可 空 类 型 只 需要 在 类 型 的 后 面 添加 “?”( 它 
必须 是 结构 )。 与 基本 结构 相 比 ， 值 类 型 唯一 的 开销 是 一 个 可 以 确定 它 是 否 为 空 的 布尔 成 员 。 

在 下 面 的 代码 片段 中 ，xl1 是 一 个 普通 的 int，x2 是 一 个 可 以 为 空 的 int。 因 为 x2 是 可 以 为 空 的 int， 所 以 可 
以 把 null 分 配给 x2: 


int xl1 = 1- 
int3? 2 = null: 


因为 int 值 可 以 分 配给 int?， 所 以 给 int? 传 递 一 个 int 变量 总 是 会 成 功 ， 编 译 器 会 接受 它 : 

int? x3 = xl; 

反 过 来 是 不 正确 的 。int? 不 能 直接 分 配给 int。 这 可 能 失败 ， 因 此 需要 一 个 类 型 转换 : 

int x4 = (int} x3; 

当然 ， 如 果 x3 是 null， 类 型 转换 操作 就 会 生成 一 个 异常 。 更 好 的 方法 是 使 用 可 空 类 型 的 HasValue 和 Value 
属性 。HasValue 返回 true 或 false, 这 取决 于 可 空 类 型 是 否 有 值 ，Value 返回 底层 的 值 。 使 用 条 件 操作 符 填 充 x5， 
不 会 抛 出 异常 。 如 果 x3 是 null，HasValue 就 返回 false， 这 里 给 变量 xs 提供 -1: 


int X5 = KX3.HasValue 2 x3.Value : -1; 

使 用 合并 操作 符 ??， 可 空 类 型 可 以 使 用 较 短 的 语法 。 如 果 x3 是 null， 则 用 变量 x6 给 它 设置 -1， 否 则 提取 
x3 的 值 : 

int x6 = xX3 33 一 1; 

注意 : 


对 于 可 空 类 型 ， 可 以 使 用 能 用 于 基本 类 型 的 所 有 可 用 操作 符 ， 例 如 ， 可 用 于 int? 的 +、-、*、/ 等 。 每 个 结 
构 类 型 都 可 以 使 用 可 空 类 型 ， 而 不 仅 是 预定 义 的 C# 类 型 。 可 空 类 型 及 其 后 台 的 内 容 参 见 第 5 章 。 


3.7” 枚 举 类 型 


枚 举 是 一 个 值 类 型 ， 包 含 一 组 命名 的 常量 ， 如 这 里 的 Color 类 型 。 枚 举 类 型 用 enum 关键 字 定 义 ( 代 码 文件 
EnumSample/Color. cs): 

public enum Color 

Red, 

} 


可 以 声明 枚 举 类 型 的 变量 ， 如 变量 c1， 用 枚 举 类 型 的 名 称 作为 前 级 设置 一 个 命名 常量 ， 来 赋予 枚 举 中 的 一 
个 值 (代码 文件 EnumSample/Program.cs): 
private static void ColorSamples() 


CoOlor cl 三 CDOT -Re 
Console.WriteLine (cl1); 
/i/... 

} 


运行 程序 ， 控 制 台 输出 显示 Red， 这 是 枚 举 的 向 量 值 。 
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默认 情况 下 ，enum 的 类 型 是 mnt。 这 个 基本 类 型 可 以 改 为 其 他 整数 类 型 (byte、short、int、 市 符号 的 long 和 
无 符号 变量 )。 命 名 常量 的 值 从 0 开始 递增 ， 但 它们 可 以 改 为 其 他 值 : 


public enum Color : Short 


{ 
Red = 1, 
GIreen = 之 ， 
Blue = 3 

} 


使 用 强制 类 型 转换 可 以 把 数字 改 为 枚 举 值 ， 把 枚 举 值 改 为 数字 。 


Color c2 = {Color}2; 
short number = (short})c2.; 


还 可 以 使 用 enum 类 型 把 多 个 选项 分 配给 一 个 变量 ， 而 不 仅仅 是 一 个 枚 举 常 量 。 为 此 ， 分 配给 常量 的 值 必 
须 是 不 同 的 位 ，Flags 属性 需要 用 枚 举 设置 。 

枚 举 类 型 DaysOfWeek 为 每 天 定义 了 不 同 的 值 。 要 设置 不 同 的 位 , 可 以 使 用 用 0x 前 级 指定 的 十 六 进 制 值 轻 
松 地 完成 ，Flags 属性 是 编译 器 创建 值 的 另 一 个 字符 串 表 示 的 信息 ， 例 如 给 DaysOfWeek 的 一 个 变量 设置 值 3， 
结果 是 Monday， 如 果 使 用 Flags 属性 ， 结 果 就 是 Tuesday( 代 人 码 文 件 EnumSample/DaysOfWeek.cs): 


[Flags] 

Public enum DaysOfWeek 

{ 
Monday = Oxl, 
Tuesday = 0x2, 
Wednesday = Ox4, 
Thursday = 0x8, 
Friday = 0Qx10, 
Saturday = 0x20., 
Sunday = VxX40 


} 
有 了 这 个 枚 举 声 明 ， 就 可 以 使 用 “逻辑 或 ”运算 符 为 一 个 变量 指定 多 个 值 (代码 文件 EnumSample/ 
Proesram.cs): 


DaysoOfWeek mondayhndWednesday = DaysoOfWeek.Monday | DaysofWeek.Wednesday; 
Console .WriteLine (mondayhindWednesday); 


运行 程序 ， 输 出 是 日 期 的 字符 串 表 示 : 

Monday, Tuesday 

设置 不 同 的 位 ,也 可 以 结合 单个 位 来 包括 多 个 值 , 如 Weekend 的 值 0x60 是 用 “逻辑 或 ”运算 符 结合 了 Saturday 
和 Sunday。Workday 则 结合 了 从 Monday 到 Friday 的 所 有 日 子 ，AllWeek 用 “你 辑 或 ”运算 符 结 合 了 Workday 
和 Weekend (代码 文件 EnumSample/DaysOfWeek.cs): 


[Flagsl 
Public enum DaysOfWeek 
{ 
Monday = Oxl, 
Tuesday = 0x2, 
Wednesday = Ox4, 
Thursday = 0x8, 
Friday = 0x10, 
Saturday = 0x20, 
Sunday = Ux40, 
Weekend = Saturday | Sunday 
Workday = Oxzl1f, 
AllWeek = Workday | Weekend 
} 


有 了 这 些 人 代码， 就 可 以 把 DaysOfWeek.Weekend 直接 分 配给 变量 ， 指 定 用 “逻辑 或 ”运算 符 结 合 
DaysOfWeek.Saturday 和 DaysOfWeek.Sunday 的 单个 值 , 也 可 以 得 到 相同 的 结果 。 输出 会 显示 Weekend 的 字符 
串 表 示 。 


DaysoOftWeek weekend = DaysOfWeek.Saturday | DavysofWeek.Sunday; 
Console .WriteLine (weekend)}).; 


使 用 枚 举 ， 类 Enum 有 时 非常 有 助 于 动态 获得 枚 举 类 型 的 信息 。 枚 举 提 供 了 方法 来 解析 字符 串 ， 获 得 相应 
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的 枚 举 和 常数 ， 获 得 枚 举 类 型 的 所 有 名 称 和 值 。 
下 面 的 代码 片段 使 用 字符 串 和 Enum.TryParse 来 获得 相应 的 Color 值 (代码 文件 EnumSample/Program .cs): 


Color red; 
if {Enum.TryParse<Color> ("Red", out red)) 


Console.WriteLine ($"successfully parsed {red}").; 


} 


注意 : 
Enum.TryParse <T>0 是 一 个 泛 型 方法 ， 其 中 工 是 泛 型 参数 类 型 。 这 个 参数 类 型 需要 用 方法 调用 定义 。 泛 型 
方法 参见 第 5 章 。 


Enum.GetNames 方法 返回 一 个 包 舍 所 有 枚 举 名 的 字符 串 数 组 : 
foreach (var day in Enum.GetNames (typeof (ColLor) ) ) 


Console.WriteLine (day); 


运行 应 用 程序 ， 输 出 如 下 : 
Red 

GIeEen 

Blue 


为 了 获得 枚 举 的 所 有 值 ， 可 以 使 用 方法 Enum.GetValues。Enum.GetValues 返回 枚 举 值 的 一 个 数组 。 为 了 获 
得 整数 值 ， 需 要 把 它 转 换 为 枚 举 的 底层 类 型 ， 为 此 应 使 用 foreach 语句 : 

foreach (short val in Enum.GetValues (typeof (Color))) 

{ 


Console.WriteLine (val).; 


} 


3.8 ”部 分 类 


partial 关键 字 允 许 把 类 、 结 构 、 方 法 或 接口 放 在 多 个 文件 中 。 一 般 情况 下 ， 某 种 类 型 的 代码 生成 器 生成 了 
一 个 类 的 某 部 分 ， 所 以 把 类 放 在 多 个 文件 中 是 有 益 的 。 假 定 要 给 类 添加 一 些 从 工具 中 目 动 生成 的 内 容 。 如 果 重 
新 运行 该 工具 ， 前 面 所 做 的 修改 就 会 丢失 。partial 关键 字 有 助 于 把 类 分 开放 在 两 个 文件 中 ， 而 对 不 由 代码 生成 
器 定义 的 文件 进行 修改 。 

partial 关键 字 的 用 法 是 : 把 partial 放 在 class struct 或 interface 关键 字 的 前 面 。 在 下 面 的 例子 中 , SampleClass 
类 驻 留 在 两 个 不 同 的 源 文件 SampleClassAutogenerated.cs 和 SampleClass.cs 中 : 


SamplecClass.cs: 
//SampleClassAutogenerated.cs 
partial class SampleClass 
{ 

Public void Methodone() { } 


//SampleClass.cs 
partial class SampleClass 
{ 
Public void MethoadTwol() { } 


当 编 译 包 含 这 两 个 源 文件 的 项 目 时 ， 会 创建 一 个 SampleClass 类 ， 它 有 两 个 方法 MethodOneO 和 
MethodTwo()。 

如 果 声 明 类 时 使 用 了 下 面 的 关键 字 ， 则 这 些 关 键 字 就 必须 应 用 于 同一 个 类 的 所 有 部 分 : 

® public 

® private 


® protected 


82 | 第 1 部 分 C# 语言 


Intemal 
abstract 
sealed 
DeW 
e 一 般 约 束 
在 绒 套 的 类 型 中 ， 只 要 partial 关键 字 位 于 class 关键 字 的 前 面 ， 就 可 以 嵌 套 部 分 类 。 在 把 部 分 类 编译 到 
类 型 中 时 ， 属 性 、XML 注释 、 接 口 、 泛 型 类 型 的 参数 属性 和 成 员 会 合并 。 有 如 下 两 个 源 文 件 : 
4 0 i -CS 


partial class SampleClass: SampleBaseClass, ISampleClass 


{ 
public void Methodone() !{ } 


//: SampleClass.cs 
[AnotherAttributel] 
partial class SampleClass: IOtherSsampleClass 
{ 
public void MethodTwo() { } 
} 


编译 后 ， 等 价 的 源 文件 变 成 : 


[customAttributel] 
[AnotherBAttributel] 
partial class SampleClass: SampleBaseClass, ISampleClass, IOtherSampleClass 
{ 
Public void Methodone()} { } 
Public void MethoadTwo() { } 
} 


注意 : 
尽管 partial 关键 字 很 容易 创建 路 多 个 文件 的 庞大 的 类 ， 且 不 同 的 开发 人 员 处 理 同一 个 类 的 不 同文 件 ， 但 该 
关键 字 并 不 用 于 这 个 目的 。 在 这 种 情况 下 ， 最 好 把 大 类 拆 分 成 几 个 小 类 ， 一 个 类 只 用 于 一 个 目的 . 


部 分 类 可 以 包含 部 分 方法 。 如 果 生 成 的 代码 应 该 调用 可 能 不 存在 的 方法 ， 这 就 是 非常 有 用 的 。 扩 展 部 分 类 
的 程序 员 可 以 决定 创建 部 分 方法 的 目 定义 实现 代码 ， 或 者 什么 也 不 做 。 下 面 的 代码 片段 包含 一 个 部 分 类 ， 其 方 
法 MethodOne 调用 APartialMethod 方法 。 APartialMethod 方法 用 partial 关键 字 声 明 , 因此 不 需要 任何 实现 代码 。 
如 果 没 有 实现 代码 ， 编 译 器 将 删除 这 个 方法 调用 : 


//SampleClassAutogenerated.cs 
partial class SampleClass 
public void Methodone () 
APartialMethod ().; 
J partial woid APartialMethod'(}); 
} 


部 分 方法 的 实现 可 以 放 在 部 分 类 的 任何 其 他 地 方 ， 如 下 面 的 代码 片段 所 示 。 有 了 这 个 方法 ， 编 译 器 就 在 
MethodOne 内 创建 代码 ， 调 用 这 里 声明 的 APartialMethod: 


/i SampleClass.cs 
partial class SampleClass: IOtherSsampleClass 
{ 

Public void APartialMethod () 

{ 

// implementation of APartialMethod 

} 

} 


部 分 方法 必须 是 void 类 型 ， 否 则 编译 器 在 没有 实现 代码 的 情况 下 无 法 删除 调用 。 
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3.9 扩展 方法 


有 许多 扩展 类 的 方式 。 继 承 (参见 第 4 章 ) 就 是 给 对 象 添加 功能 的 好 方法 。 扩 展 方法 是 给 对 象 添加 功能 的 男 
一 个 选项 ， 在 不 能 使 用 继承 时 ， 也 可 以 使 用 这 个 选项 (例如 类 是 密封 的 )。 


注意 : 
扩展 方法 也 可 以 用 于 扩展 接口 。 这 样 ， 实 现 该 接口 的 所 有 类 就 有 了 公共 功能 。 接 口 参 见 第 4 章 。 


扩展 方法 是 静态 方法 ， 它 是 类 的 一 部 分 ， 但 实际 上 没有 放 在 类 的 源 代 码 中 。 

假设 希望 用 一 个 方法 扩展 string 类 型 ， 该 方法 计算 字符 串 中 的 单词 数 。GetWordCount 方法 利用 String.Split 
方法 把 字符 串 分 割 到 字符 串 数 组 中 ， 使 用 Length 属性 计算 数组 中 元 素 的 个 数 (代码 文件 ExtensionMethods/ 
Program.cs): 

ExtensionMethods/Program.cs): 

Public static class StringExtension 


{ 
public static Int GetWordCount (this string s) => 5s.Split() .Length:; 


使 用 this 关键 字 和 第 一 个 参数 来 扩展 字符 串 。 这 个 关键 字 定 义 了 要 扩展 的 类 型 。 

即使 扩展 方法 是 静态 的 ， 也 要 使 用 标准 的 实例 方法 语法 。 注 意 ， 这 里 使 用 fox 变量 而 没有 使 用 类 型 名 来 调 
用 GetWordCount 0。 

string fox = "the Guick brown fox jumped over the lazy dogs down ™ 十 

"9876543210 times"; 


int wordCount = fox.GetWordCount'(): 
Console .WriteLine ($"{wordcount} words"™); 


在 后 台 ， 编 译 器 把 它 改 为 调用 静态 方法 : 

int wordCount = StringExtension.GetWordCount (fox); 

使 用 实例 方法 的 语法 ， 而 不 是 从 代码 中 直接 调用 静态 方法 ， 会 得 到 一 个 好 得 多 的 语法 。 这 个 语法 还 有 一 个 
好 处 :该 方法 的 实现 可 以 用 男 一 个 类 取代 ， 而 不 需要 更 改 代 码 一 一 只 需要 运行 新 的 编译 器 。 

编译 器 如 何 找到 某 个 类 型 的 扩展 方法 ?this 关键 字 必 须 匹 配 类 型 的 扩展 方法 ， 而 且 需 要 打开 定义 扩展 方法 
的 静态 类 所 在 的 名 称 空间 。 如 果 把 StringExtensions 类 放 在 名 称 空间 Wrox.Extensions 中 ， 则 只 有 用 using 指令 打 
开 Wrox.Extensions， 编 译 器 才能 找到 GetWordCount 方法 。 如 果 类 型 还 定义 了 同名 的 实例 方法 ， 扩 展 方法 就 永 
远 不 会 使 用 。 类 中 已 有 的 任何 实例 方法 都 优先 。 当 多 个 同名 的 扩展 方法 扩展 相同 的 类 型 ， 打 开 所 有 这 些 类 型 的 
名 称 空间 时 ， 编 译 器 会 产生 一 个 错误 ， 指 出 调用 是 模棱两可 的 ， 它 不 能 决定 在 多 个 实现 代码 中 选择 哪个 。 然 而 ， 
如 果 调 用 代码 在 一 个 名 称 空 间 中 ， 这 个 名 称 空 间 就 优先 。 


注意 : 
语言 集成 查询 (Language Integrated Query，LINQ) 利 用 了 许多 扩展 方法 。LINQ 参见 第 12 章 。 


3.10 Object 类 


前 面 提 到 ， 所 有 的 .NET 类 最 终 都 派生 自 System.Object。 实 际 上 ， 如 果 在 定义 类 时 没有 指定 基 类 ， 编 译 器 就 
会 自动 假定 这 个 类 派生 自 Object。 本 章 没 有 使 用 继承 , 所 以 前 面 介绍 的 每 个 类 都 派生 自 System.Object( 如 前 所 述 ， 
对 于 结构 ， 这 个 派生 是 间接 的 :结构 总 是 派生 自 System.ValueType，System .ValueType 又 派生 自 System.Objecb。 

其 实际 意义 在 于 ， 除 了 目 己 定义 的 方法 和 属性 等 外 ， 还 可 以 访问 为 Object 类 定义 的 许多 公有 的 和 受 保护 的 
成 员 方法 。 这 些 方法 可 用 于 上 自己 定义 的 所 有 其 他 类 中 。 
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下 面 将 简要 总 结 每 个 方法 的 作用 : 


3.11 


ToString() 方 法 : 是 获取 对 象 的 字符 串 表 示 的 一 种 便捷 方式 。 当 只 需要 快速 获取 对 象 的 内 容 ， 以 进行 调 
试 时 ， 就 可 以 使 用 这 个 方法 。 在 数据 的 格式 化 方面 ， 它 几乎 没有 提供 选择 : 例如 ， 在 原则 上 日 期 可 以 
表示 为 许多 不 同 的 格式 , 但 DateTime.ToString0 没 有 在 这 方面 提供 任何 选择 。 如 果 需 要 更 复杂 的 字符 串 
表示 ， 例 如 ， 考 虑 用 户 的 格式 化 首选 项 或 区 域 性 ， 就 应 实现 下 ormattable 接口 (参见 第 9 章 )。 
GetHashCode() 方 法 : 如 果 对 象 放 在 名 为 映射 (也 称 为 散 列 表 或 字典 ) 的 数据 结构 中 ， 就 可 以 使 用 这 个 方 
法 。 处 理 这 些 结构 的 类 使 用 该 方法 确定 把 对 象 放 在 结构 的 什么 地 方 。 如 果 和 希望 把 类 用 作 字 典 的 一 个 键 ， 
就 需要 重 写 GetHashCode0 方 法 。 实 现 该 方法 重 载 的 方式 有 一 些 相当 严格 的 限制 ， 这 些 将 在 第 10 章 介 
绍 字典 时 讨论 。 

Equals()( 两 个 版 本 ) 和 ReferenceEquals() 方 法 : 注意 有 3 个 用 于 比较 对 象 相 等 性 的 不 同方 法 ， 这 说 
明 NET Framework 在 比较 相等 性 方面 有 相当 复杂 的 模式 。 这 3 个 方法 和 比较 运算 和 从 “一 ”在 使 用 方式 
上 有 微妙 的 区 别 。 而 且 ， 在 重 写 带 一 个 参数 的 虚 Equals0 方 法 时 也 有 一 些 限制 ， 因 为 System.Collections 
名 称 空间 中 的 一 些 基 类 要 调用 该 方法 ， 并 希望 它 以 特定 的 方式 执行 。 第 6 章 在 介绍 运算 符 时 将 探讨 这 
些 方法 的 使 用 。 

Finalize() 方 法 : 第 17 章 将 介绍 这 个 方法 ， 它 最 接近 C++ 风格 的 析 构 函数 ， 在 引用 对 象 作 为 垃圾 被 收集 
以 清理 资源 时 调用 它 。Object 中 实现 的 Finalize0 方 法 实际 上 什么 也 没有 做 ， 因 而 被 垃圾 收集 器 忽略 。 
如 果 对 象 拥有 对 非 托管 资源 的 引用 ， 则 在 该 对 象 被 删除 时 ， 就 需要 删除 这 些 引 用 ， 此 时 一 般 要 重 写 
Finalize0。 垃 圾 收集 器 不 能 直接 删除 这 些 对 非 托 管 资源 的 引用 ， 因 为 它 只 负责 托管 的 资源 ， 于 是 它 只 能 
依赖 用 户 提供 的 Finalize0。 


GetType() 方 法 : 这 个 方法 返回 从 System.Type 派生 的 类 的 一 个 实例 , 因此 可 以 提供 对 象 成 员 所 属 类 的 更 


多 信息 ， 包 括 基 本 类 型 、 方 法 、 属 性 等 。System.Type 还 提供 了 .NET 的 反射 技术 的 入 口 点 。 这 个 主题 详 
见 第 16 章 。 

MemberwiseClone() 方 法 : 这 是 System.Object 中 唯一 没有 在 本 书 的 其 他 地 方 详细 论述 的 方法 。 不 需要 
讨论 这 个 方法 ， 因 为 它 在 概念 上 相当 简单 ， 它 只 复制 对 象 ， 并 返回 对 副本 的 一 个 引用 (对 于 值 类 型 ， 就 
是 一 个 装 箱 的 引用 )。 注 意 ， 得 到 的 副本 是 一 个 浅 表 复 制 ， 即 它 复制 了 类 中 的 所 有 值 类 型 。 如 果 类 包含 
内 嵌 的 引用 ， 就 只 复制 引用 ， 而 不 复制 引用 的 对 象 。 这 个 方法 是 受 保护 的 ， 所 以 不 能 用 于 复制 外 部 的 
对 象 。 该 方法 不 是 虚 方 法 ， 所 以 不 能 重 写 它 的 实现 代码 。 


小 结 


本 章 介 绍 了 Cc# 中 声明 和 处 理 对 象 的 语法 ， 论 述 了 如 何 声明 静态 和 实例 字段 、 属 性 、 方 法 和 构造 函数 。 还 讨 
论 了 C#7 中 新 增 的 特性 。 例 如 ， 表 达 式 体 的 成 员 和 构造 函数 、 属 性 访问 器 和 out 变量 。 

我 们 还 阐述 了 C# 中 的 所 有 类 型 最 终 都 派生 自 类 System.Object， 这 说 明 所 有 的 类 型 都 开始 于 一 组 基本 的 实 
用 方法 ， 包 括 ToString0。 

本 章 多 次 提 到 了 继承 ， 第 4 章 将 介绍 C# 中 的 实现 (implementation) 继 承 、 接 口 继承 和 面向 对 象 的 其 他 方面 。 


入 
继 承 


本 章 要 点 
实现 继承 
访问 修饰 符 
接口 
is 和 as 运算 符 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 ObjectOrientation 目录 
的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® VirtualMethods 
® InheritanceWithConstructors 
® Usinelnterfaces 


4.1 面向 对 象 


C# 不 是 一 种 纯粹 的 面 癌 对 象 编程 语言 。C 刘 是 供 了 多 种 编程 范例 。 然 而 ， 面 癌 对 象 是 C# 的 一 个 重要 概念 ， 
也 是 .NET 提供 的 所 有 库 的 核心 原则 。 

面 问 对 象 的 三 个 最 重要 的 概念 是 继承 、 封 装 和 多 态 性 。 第 3 章 谈 到 如 何 创 建 单独 的 类 ， 来 安排 属性 、 方 法 
和 字段 。 当 某 类 型 的 成 员 声 明 为 private 时 ， 它 们 就 不 能 从 外 部 访问 。 它 们 封装 在 类 型 中 。 本 章 的 重点 是 继承 和 
多 态 性 。 

第 3 章 提 到 ， 所 有 类 最 终 都 派生 于 System.Object。 本 章 介绍 如 何 创 建 类 的 层次 结构 ， 多 态 性 如 何 应 用 于 
C#， 还 描述 与 继承 相关 的 所 有 C# 关 键 字 。 


4.2 ”继承 的 类 型 


首先 介绍 一 些 面 问 对 象 (Object-Oriented，OO) 术 语 ， 看 看 C# 企 继承 方面 支持 和 不 支持 的 功能 。 
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e。 单 重 继承 : 表示 一 个 类 可 以 派生 自 一 个 基 类 。C# 就 采用 这 种 继承 。 

e 多 重 继 承 : 多 重 继承 允许 一 个 类 派生 自 多 个 类 。C# 不 支持 类 的 多 重 继承 ， 但 允许 接口 的 多 重 继 承 。 

e 多 层 继承 : 多 层 继 承 允 许 继承 有 更 大 的 层次 结构 。 类 B 派生 自 类 A， 类 C 又 派生 自 类 B。 其 中 , 类 B 
也 称 为 中 间 基 类 ，C# 支 持 它 ， 也 很 常用 。 

e 接口 继承 : 定义 了 接口 的 继承 。 这 里 允许 多 重 继承 。 接 口 和 接口 继承 参见 本 章 后 面 的 “接口 ”一 节 。 

下 面 讨论 继承 和 C# 的 某 些 特定 问题 。 


4.2.1 多 重 继承 


一 些 语言 (如 C++) 文 持 所 谓 的 “多 重 继承 ”， 即 一 个 类 派生 目 多 个 类 。 对 于 实现 继承 ， 多 重 继承 会 给 生成 的 
代码 增加 复杂 性 ， 还 会 带 来 一 些 开 销 。 因 此 ，C# 的 设计 人 员 决 定 不 支持 类 的 多 重 继 承 ， 因 为 支持 多 重 继 承 会 增 
加 复杂 性 ， 还 会 带 来 一 些 开销 。 

而 C# 又 允许 类 型 派生 自 多 个 接口 。 一 个 类 型 可 以 实现 多 个 接口 。 这 说 明 ，C# 类 可 以 派生 自 另 一 个 类 和 任 
意 多 个 接口 。 更 准确 地 说 ， 因 为 System.Object 是 一 个 公共 的 基 类 ， 所 以 每 个 C# 类 (除了 Object 类 之 外 ) 都 有 一 
个 基 类 ， 还 可 以 有 任意 多 个 基 接 口 。 


4.2.2 ”结构 和 类 


第 3 章 区 分 了 结构 ( 值 类 型 ) 和 类 (引用 类 型 )。 使 用 结构 的 一 个 限制 是 结构 不 支持 继承 ,但 每 个 结构 都 目 动 派 
生 目 System.ValueType。 不 能 编码 实现 结构 的 类 型 层次 ， 但 结构 可 以 实现 接口 。 换 言 之 ， 结 构 并 不 文 持 实现 继 
承 ， 但 文 持 接口 继承 。 定 义 的 结构 和 类 可 以 总 结 为 : 

e 结构 总 是 派生 自 System.ValueType， 它 们 还 可 以 派生 自任 意 多 个 接口 。 

e 类 总 是 派生 目 System.Object 或 用 户 选择 的 另 一 个 类 ， 它 们 还 可 以 派生 目 任 意 多 个 接口 。 


4.3 ”实现 继承 


如 果 要 声明 派生 目 男 一 个 类 的 一 个 类 ， 就 可 以 使 用 下 面 的 语法 : 
class MyDerivedClass: MyBaseClass 


/i members 
} 


如 果 类 (或 结构 ) 也 派生 目 接 口 ， 则 用 逗号 分 隔 列 表 中 的 基 类 和 接口 : 


Public class MyDerivedClass: MyBaseClass, IInterfacel, IInterface? 
{ 

// members 
} 


注意 : 
如 果 类 和 接口 都 用 于 派生 ， 则 类 总 是 必须 放 在 接口 的 前 面 。 


对 于 结构 ， 语 法 如 下 (只 能 用 于 接口 继承 ): 
Public struct MyDerivedstruct: lIInterfacel, IInterface2 
{ 
// members 
} 


如 果 在 类 定义 中 没有 指定 基 类 , C# 编 译 器 就 假定 System.Object 是 基 类 ,因此 ,派生 自 Object 类 (或 使 用 object 
关键 字 )， 与 不 定义 基 类 的 效果 是 相同 的 。 
class MyClass // implicitly derives from System.Object 


/:/ members 
} 
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下 面 的 例子 定义 了 基 类 Shape。 无 论 是 矩形 还 是 椭圆 ， 形 状 都 有 一 些 共 同 点 : 形状 都 有 位 置 和 大 小 。 定 义 
相应 的 类 时 ， 位 置 和 大 小 应 包含 在 Shape 类 中 。Shape 类 定义 了 只 读 属 性 Position 和 Shape， 它 们 使 用 自动 属 
性 初始 化 器 来 初始 化 (代码 文件 VirtualMethods /Shape.cs): 


public class Position 
{ 
public int X { get; set; } 
Public int Y { get; set; } 
} 


public class Size 


PUublic int Width { get; set; } 
Public int Height 1{ get; set; } 


} 

Public class Shape 

{ 
PUublic Position Position { get; } = new Position(); 
Public Size Size { get; } = new Size(); 

} 


4.3.1 虚 方 法 
把 一 个 基 类 方法 声明 为 virtual， 就 可 以 在 任何 派生 类 中 重 写 该 方法 : 


public class Shape 
{ 


public virtual void Draw() => 
Console.WriteLine($"Shape with {Position} and {Size}"); 


} 
如 果实 现代 码 只 有 一 行 ， 也 可 以 把 virtual 关键 字 和 表达 式 体 的 方法 (使 用 lambda 运算 符 ) 一 起 使 用 。 这 个 语 
法 可 以 独立 于 修饰 待 ， 单 独 使 用 : 
public class Shape 
PUublic virtual void Draw() => 


Console.WriteLine($"Shape with {Position} and {Size}"™); 


} 

也 可 以 把 属性 声明 为 virtual。 对 于 虚 属性 或 重 写 属性 ， 语 法 与 非 虚 属性 相同 ， 但 要 在 定义 中 添加 关键 字 
public virtual Size Size { get; set; |} 

当然 ， 也 可 以 给 虚 属 性 使 用 完整 的 属性 语法 。 下 面 的 代码 片段 使 用 了 C#7 表达 式 体 的 属性 访问 器 : 
0 

| get => size; 


set => size = values 


} 

为 简单 起 见 ， 下 面 的 讨论 将 主要 集中 于 方法 ， 但 其 规则 也 适用 于 属性 。 

C# 中 虚 函 数 的 概念 与 标准 OOP 的 概念 相同 : 可 以 在 派生 类 中 重 写 虚 函 数 。 在 调用 方法 时 ， 会 调用 该 类 对 
象 的 合适 方法 。 在 C# 中 ， 函 数 在 默认 情况 下 不 是 虚拟 的 ， 但 (除了 构造 函数 以 外 ) 可 以 显 式 地 声明 为 virtual。 这 
遵循 C++ 的 方式 ， 即 从 性 能 的 角度 来 看 ， 除 非 显 式 指定 ， 否 则 函数 就 不 是 虚拟 的 。 而 在 Java 中 ， 所 有 的 函数 都 
是 虚拟 的 。 但 C# 的 语法 与 C++ 的 语法 不 同 ， 因 为 C# 要 求 在 派生 类 的 函数 重 写 男 一 个 函数 时 ， 要 使 用 override 
关键 字 显 式 声明 (代码 文件 VirtualMethods/ConcreteShapes.cs): 


Public class Rectangle : Shape 
public everride void Draw() => 


Console.WriteLine($"Rectangle with {Position} and {Size}"™"); 


} 


重 写 方法 的 语法 避免 了 C++ 中 很 容易 发 生 的 潜在 运行 错误 : 当 派 生 类 的 方法 签名 无 意 中 与 基 类 版 本 上 略 有 到 
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oll} 


别 时 ， 该 方法 就 不 能 重 写 基 类 的 方法 。 在 C# 中 ， 这 会 出 现 一 个 编译 错误 ， 因 为 编译 器 会 认为 函数 已 标记 为 
override， 但 没有 重 写 其 基 类 的 方法 。 
Size 和 Position 类 型 重 写 了 ToString(0 方 法 。 这 个 方法 在 基 类 Object 中 声明 为 virtual: 
Public class Position 
public int X { get; set; } 
public int Y { get; set; } 
public override string ToString() => S$"X: {X}, Y: {Y}"; 
} 


Public class Size 
{ 

public int Width { get; set; } 

public int Height { get; set; } 

public override string ToString() => $"Width: {Width}, Height: {Height}"; 
} 


注意 : 
基 类 Object 的 成 员 参 见 第 3 章 。 


注意 : 
重 写 基 类 的 方法 时 ， 签 名 (所 有 参数 类 型 和 方法 名 ) 和 返回 类 型 必须 完全 匹配 。 和 否则， 以 后 创建 的 新 成 员 就 
覆盖 基 类 成 员 。 


在 Main(0 方 法 中 ,实例 化 矩形 rt, 初始 化 其 属性 ,调用 其 方法 Draw0 (代码 文件 VirtualMethods/Program.cs): 


var I 一 new Rectangle(}; 
r.PoOSition.X = 33; 
r.Position.Y = 22- 


r.Size.Width = 200; 
r.Size.Helight = 100; 
rr.Drawt{}; 


运行 程序 ， 查 看 Draw0 方 法 的 输出 : 
Rectangle with X: 33, Y: 22 and Width: 200, Height: 100 


成 员 字 段 和 静态 函数 都 不 能 声明 为 virtual， 因 为 这 个 概念 只 对 类 中 的 实例 函数 成 员 有 意义 。 
4.3.2 多 态 性 


使 用 多 态 性 ， 可 以 动态 地 定义 调用 的 方法 ， 而 不 是 在 编译 期 间 定 义 。 编 译 器 创建 一 个 虚拟 方法 表 (vtable)， 
其 中 列 出 了 可 以 在 运行 期 间 调用 的 方法 ， 它 根据 运行 期 间 的 类 型 调用 方法 。 

在 下 面 的 例子 中 ，DrawShape0 方 法 接收 一 个 Shape 参数 ， 并 调用 Shape 类 的 Draw0 方 法 (代码 文件 
VirtualMethods/Program.cs): 

public static void DrawShape(Shape shape) => shape.Draw!(); 

使 用 之 前 刨 建 的 窍 形 调用 方法 。 尽 管 方法 声明 为 接收 一 个 Shape 对 象 ， 但 任何 派生 Shape 的 类 型 (包括 
Rectangle) 都 可 以 传递 给 这 个 方法 : 

DrawShape (r); 

运行 这 个 程序 ， 查 看 Rectanegle.Draw 方法 0 而 不 是 Shape.Draw0 方 法 的 输出 。 输 出 行 从 Rectangle 开始 。 如 
果 基 类 的 方法 不 是 虚拟 方法 或 没有 重 写 派生 类 的 方法 ， 束 使 用 所 声明 对 象 (Shape) 的 类 型 的 Draw0 方 法 ， 因 此 输 
出 从 Shape 开始 : 


Rectangle with X: 33, Y: 22 and Width: 200, Helight: 100 
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4.3.3 隐藏 方法 


如 果 签 名 相同 的 方法 在 基 类 和 派生 类 中 都 进行 了 声明 ,但 该 方法 没有 分 别 声明 为 virtual 和 override， 派 生 
类 方法 就 会 隐藏 基 类 方法 。 

在 大 多 数 情况 下 ， 是 要 重 写 方法 ， 而 不 是 隐藏 方法 ， 因 为 隐藏 方法 会 造成 对 于 给 定 类 的 实例 调用 错误 方法 的 
危险。 但 是 ， 如 下 面 的 例子 所 示 ，C# 语 法 可 以 确保 开发 人 员 在 编译 时 收 到 这 个 潜在 错误 的 警告 ， 从 而 使 隐 忠 方法 
(如 果 这 确实 是 用 户 的 本 意 ) 更 加 安全 。 这 也 是 类 库 开 发 人 员 得 到 的 版 本 方面 的 好 处 。 

假定 类 库 中 有 一 个 类 Shape: 

public class Shape 


/:/ various members 


} 
在 将 来 的 某 一 刻 ， 要 编写 一 个 派生 类 Ellipse， 用 它 给 Shape 基 类 添加 某 个 功能 ， 特 别 是 要 添加 该 基 类 中 目 
前 没有 的 方法 一 一 MoveBy0: 
Public class Ellipse: Shape 
{ 
Public void MoveBy(int x, int Y) 
{ 
Position.K ++= XX; 
POS1ition.Y += Ys; 
} 
} 


过 了 一 段 时 间 , 基 类 的 编写 者 决定 扩展 基 类 的 功能 。 为 了 保持 一 致 , 他 也 添加 了 一 个 名 为 MoveBy0 的 方法 ， 
该 方法 的 名 称 和 签名 与 前 面 添加 的 方法 相同 ， 但 并 不 完成 相同 的 工作 。 这 个 新 方法 可 能 声明 为 virtual， 也 可 能 
不 声明 为 virtual。 

如 果 重 新 编译 派生 的 类 ， 会 得 到 一 个 编译 器 警告 ， 因 为 出 现 了 一 个 潜在 的 方法 冲突 。 然 而 ， 也 可 能 使 用 了 
新 的 基 类 ， 但 没有 编译 派生 类 ; 只 是 蔡 换 了 基 类 程序 集 。 基 类 程序 集 可 以 安装 在 全 局 程序 集 缓存 中 (许多 
Framework 程序 集 都 安装 在 此 )。 

现在 假设 基 类 的 MoveBy0 方 法 声明 为 虚 方 法 ， 基 类 本 身 调 用 MoveBy0 方 法 。 会 调用 哪个 方法 ? 基 类 的 方 
法 还 是 前 面 定义 的 派生 类 的 MoveBy0 方 法 吗 ? 因为 派生 类 的 MoveBy0 方 法 没有 用 override 关键 字 定 义 (这 是 不 
可 能 的 ， 因 为 基 类 MoveBy0 方 法 以 前 不 存在 )， 编 译 器 假定 派生 类 的 MoveBy0 方 法 是 一 个 完全 不 同 的 方法 ， 与 
基 类 的 方法 没有 任何 关系 ， 只 是 名 字 相 同 。 这 种 方法 的 处 理 方 式 就 好 像 它 有 另 一 个 名 称 一 样 。 

编译 Ellipse 类 会 生成 一 个 编译 警告 ， 提 醒 使 用 new 关键 字 隐 藏 方法 。 在 实践 中 ， 不 使 用 new 关键 字 会 得 
到 相同 的 编译 结果 ， 但 避免 出 现 编译 器 警告 : 


public class Ellipse: Shape 
{ 


new Public void Move (Position newPosition) 
{ 

PoOSsition.X = newPosition.X; 

Position.Y = newPosition.Y; 


/i/... other members 
} 


不 使 用 new 关键 字 ， 也 可 以 重 命名 方法 ， 或 者 ， 如 果 基 类 的 方法 声明 为 virtual， 且 用 作 相同 的 目的 ， 束 重 
写 它 。 然 而 ， 如 果 其 他 方法 已 经 调用 了 此 方法 ， 简 单 的 重 命名 会 破坏 其 他 代码 。 


注意 : 
new 方法 修饰 符 不 应 该 故意 用 于 隐藏 基 类 的 成 员 。 这 个 修饰 符 的 主要 目的 是 处 理 版 本 冲突 ， 在 修改 派生 类 
后 ， 响 应 基 类 的 变化 。 
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4.3.4 调用 方法 的 基 类 版 本 

C# 有 一 种 特殊 的 语法 用 于 从 派生 类 中 调用 方法 的 基 类 版 本 : base.<MethodName>=()。 例 如 ， 派 生 类 Shape 
声明 了 Move0 方 法 ， 想 要 在 派生 类 Rectangle 中 调用 它 ， 以 使 用 基 类 的 实现 代码 。 为 了 添加 派生 类 中 的 功能 ， 
可 以 使 用 base 调用 它 ( 代 码 文件 VirtualMethods/Shape.cs): 


public class Shape 


{ 
Public virtual void Move (Position newPosition) 
{ 
Position.X = newPosition.X; 
PoSsitijon.Y = newPosition.Y.; 


Console.WriteLine(s$"moves to {Position}™):; 


} 
/i/...other members 
} 


Move0 方 法 在 Rectangle 类 中 重 写 ， 把 Rectangle 一 词 添 加 到 控制 台 。 写 出 文本 之 后 ， 使 用 base 关键 字 调 用 
基 类 的 方法 (代码 文件 VirtualMethods/ConcreteShapes.cs): 


Public class Rectangle: Shape 
{ 
Public override void Move (Position newPosition) 
{ 
Console.Write ("Rectangle "™); 
base .Move (newPosition).; 


} 
上/ .other members 
} 


现在 ， 和 矩形 移动 到 一 个 新 位 置 (代码 文件 VirtualMethods/Program_.cs): 
r.Movel(lnew Position { KX = 120, YY = 40 }); 
运行 应 用 程序 ， 输 出 是 Rectangle 和 Shape 类 中 Move0 方 法 的 结果 : 


Rectangle moves to X: 120, Y: 40 


注意 : 
使 用 base 关键 字 ， 可 以 调用 基 类 的 任何 方法 一 一 而 不 仅仅 是 已 重 写 的 方法 。 


4.3.5 ”抽象 类 和 抽象 方法 


C# 人 允许 把 类 和 方法 声明 为 abstract。 抽 象 类 不 能 实例 化 ， 而 抽象 方法 不 能 直接 实现 ， 必 须 在 非 抽象 的 派生 
类 中 重 写 。 显 然 ， 抽 象 方法 本 身 也 是 虚拟 的 (尽管 也 不 需要 提供 virtual 关键 字 ， 实 际 上 ， 如 果 提 供 了 该 关键 字 ， 
就 会 产生 一 个 语法 错误 )。 如 果 类 包含 抽象 方法 ， 则 该 类 也 是 抽象 的 ， 也 必须 声明 为 抽象 的 。 

下 面 把 Shape 关 改 为 抽象 类 。 因 为 其 他 类 需要 派生 和 目 这 个 类 。 新 方法 Resize 声明 为 抽象 ， 因 此 它 不 能 有 在 
Shape 类 中 的 任何 实现 代码 (代码 文件 VirtualMethods/Shape.cs): 

publ ic abstract class Shape 


public abstract void Resize(int width, int height); // abstract method 
} 


从 抽象 基 类 中 派生 类 型 时 ， 需 要 实现 所 有 抽象 成 员 。 梧 则 ， 编 译 器 会 报错 : 


public class Ellipse : Shape 
{ 
public override void Resize(int width, int height) 
{ 
Size.Width = width.; 
Size.Height = height; 
} 
} 


当然 , 实现 代码 也 可 以 如 下 面 的 例子 所 示 。 抛 出 类 型 NotImplementationException 的 异常 也 是 一 种 实现 方式 ， 
在 开发 过 程 中 ， 它 通 闸 只 是 一 个 临时 的 实现 : 
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Public override void Resize(int width, int height) 
{ 
throw new NotImplementedException (}; 


} 


注意 : 
异常 详 见 第 14 章 。 


使 用 抽象 的 Shape 类 和 派生 的 Ellipse 类 ， 可 以 声明 Shape 的 一 个 变量 。 不 能 实例 化 它 ， 但 是 可 以 实例 化 
Ellipse， 并 将 其 分 配给 Shape 变量 (代码 文件 VirtualMethods/Program.cs): 


Shape sl1 = new Ellipse(); 
Drawshape (sl1); 


4.3.6 ”密封 类 和 密封 方法 


如 果 不 应 创建 派生 目 茶 个 目 定义 类 的 类 ， 该 目 定 义 类 就 应 密封 。 给 类 添加 sealed 修饰 待 ， 就 不 允许 创建 该 
类 的 子 类 。 密 封 一 个 方法 ， 表 示 不 能 重 写 该 方法 。 
sealed class FinalClass 


FE 
} 


Class Derivedclass: FinalClass // wrong. Cannot derive from sealed class. 
{ 

Fo 
} 


在 把 类 或 方法 标记 为 sealed 时 ， 最 可 能 的 情形 是 : 如 果 在 库 、 类 或 目 己 编写 的 其 他 类 的 操作 中 ， 类 或 方法 
是 内 部 的 ， 则 任何 尝试 重 写 它 的 一 些 功 能 ， 都 可 能 导致 代码 的 不 稳定 。 例 如 ， 也 许 没 有 测试 继承 ， 就 对 继承 的 
设计 决策 投资 。 如 果 是 这 样 ， 最 好 把 类 标记 为 sealed。 

密封 类 有 男 一 个 原因 。 对 于 密封 类 , 编译 器 知道 不 能 派生 类 ， 因 此 用 于 虚拟 方法 的 虚拟 表 可 以 缩短 或 消除 ， 
以 提高 性 能 。string 类 是 密封 的 。 没 有 哪个 应 用 程序 不 使 用 字符 串 ， 最 好 使 这 种 类 型 保持 最 佳 性 能 。 把 类 标记 
为 sealed 对 编译 器 来 说 是 一 个 很 好 的 提示 。 

将 一 个 方法 声明 为 sealed 的 目的 类 似 于 一 个 类 。 方 法 可 以 是 基 类 的 重 写 方 法 ， 但 是 在 接 下 来 的 例子 中 ， 编 
译 器 知道 ， 男 一 个 类 不 能 扩展 这 个 方法 的 虚拟 表 ， 它 在 这 里 终止 继承 。 

class MyClass: MyBaseClass 

public sealed override void FinalMethod() 

// implementation 

. 

class Derivedclass: MyClass 

-i override void FinalMethod() // wrong. Will give compilation error 


} 
} 


要 在 方法 或 属性 上 使 用 sealed 关键 字 ， 必 须 先 从 基 类 上 把 它 声 明 为 要 重 写 的 方法 或 属性 。 如 果 基 类 上 不 希 
望 有 重 写 的 方法 或 属性 ， 就 不 要 把 它 声 明 为 virtual。 


4.3.7 派生 类 的 构造 函数 

第 3 章 介 绍 了 单个 类 的 构造 函数 是 如 何 工 作 的 。 这 样 ， 就 产生 了 一 个 有 趣 的 问题 ， 在 开始 为 层次 结构 中 的 
类 (这 个 类 继承 了 其 他 也 可 能 有 目 定 义 构造 函数 的 类 ) 定 义 目 己 的 构造 函数 时 ， 会 发 生 什 么 情况 ? 

假定 没有 为 任何 类 定义 任何 显 式 的 构造 函数 ， 编 译 器 就 会 为 所 有 的 类 提供 默认 的 初始 化 构造 函数 ， 在 后 台 
会 进行 许多 操作 ， 但 编译 器 可 以 很 好 地 解决 类 的 层次 结构 中 的 所 有 问题 ， 每 个 类 中 的 每 个 字段 都 会 初始 化 为 对 


me 
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应 的 默认 值 。 但 在 添加 了 一 个 我 们 目 己 的 构造 函数 后 ， 就 要 通过 派生 类 的 层 次 结构 高 效 地 控制 构造 过 程 ， 因 此 
必须 确保 构造 过 程 顺利 进行 ， 不 要 出 现 不 能 按照 层次 结构 进行 构造 的 问题 。 

为 什么 派生 类 会 有 某 些 特殊 的 问题 ? 原因 是 在 创建 派生 类 的 实例 时 ， 实 际 上 会 有 多 个 构造 函数 起 作用 。 要 
实例 化 的 类 的 构造 国 数 本 身 不 能 初始 化 类 ， 还 必须 调用 基 类 中 的 构造 函数 。 这 就 是 为 什么 要 通过 层 次 结构 进行 
构造 的 原因 。 

在 之 前 的 Shape 类 型 示例 中 ， 使 用 自动 属性 初始 化 器 初始 化 属性 : 

public class Shape 

Se Position Position { get; } = new Position(); 


public Size Size { get; } = new Size(); 


} 


在 幕后 ， 编 译 器 会 给 类 创建 一 个 默认 的 构造 函数 ， 把 属性 初始 化 器 放 在 这 个 构造 函数 中 : 
public class Shape 
Shape() 
: Position = new Position().; 
Size = new Sizel); 


} 


public Position Position { get; }; 

， public Size Size { get; }; 

当然 ， 实 例 化 派生 自 Shape 类 的 Rectangle 类 型 ，Rectangle 需要 Position 和 Size， 因 此 在 构造 派生 对 象 时 ， 
调用 基 类 的 构造 函数 。 

如 果 没 有 在 默认 构造 函数 中 初始 化 成 员 ， 编 译 器 会 自动 把 引用 类 型 初始 化 为 null， 值 类 型 初始 化 为 0， 布 
尔 类 型 初始 化 为 f@lse。 布 尔 类 型 是 值 类 型 ，false 与 0 是 一 样 的 ， 所 以 这 个 规则 也 适用 于 布尔 类 型 。 

对 于 Ellipse 类 ， 如 果 基 类 定义 了 默认 构造 函数 ， 只 把 所 有 成 员 初 始 化 为 其 默认 值 ， 就 没有 必要 创建 默认 的 
构造 函数 。 当 然 ， 仍 可 以 提供 一 个 构造 函数 ， 使 用 构造 函数 初始 化 器 ， 调 用 基 构 造 函 数 : 

public class Ellipse : Shape 

public Ellipse{() 

: basel() 


} 
} 


构造 函数 总 是 按照 层次 结构 的 顺序 调用 : 先 调用 System.Object 类 的 构造 函数 ， 再 按照 层次 结构 由 上 向 下 
进行 ， 直 到 到 达 编 译 器 要 实例 化 的 类 为 止 。 为 了 实例 化 Ellipse 类 型 ， 先 调用 Object 构造 函数 ， 再 调用 Shape 
构造 函数 ， 最 后 调用 Ellipse 构造 函数 。 这 些 构造 函数 都 处 理 它 自己 类 中 字段 的 初始 化 。 

现在 ， 改 变 Shape 类 的 构造 函数 。 不 是 对 Size 和 Position 属性 进行 默认 的 初始 化 ， 而 是 在 构造 函数 内 赋 
值 (代码 文件 InheritanceWithConstructors/Shape.cs ): 


Public abstract class Shape 
{ 
Public Shape (int width, int height, int x, int vy) 
{ 
Size = new Size { Width = width, Height = height }; 
Position = new Position { 站 = xXx, Y= YY 1}; 


} 


public Position Position { get; } 
public Size Size { get; } 
} 


当 删 除 默 认 构造 函数 ， 重 新 编译 程序 时 ， 不 能 编译 Ellipse 和 Rectangle 类 ， 因 为 编译 器 不 知道 应 该 把 什么 
值 传递 给 基 类 唯一 的 非 默 认 值 构造 函数 。 这 里 需要 在 派生 类 中 创建 一 个 构造 函数 ， 用 构造 函数 初始 化 器 初始 化 
基 类 构造 函数 (代码 文件 InheritanceWithConstructorsMConcreteShapes.cs ): 


public Rectangle(Int width, int height, int x, Int Y) 
: base (width, height, XxX, Y) 
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把 初始 化 代码 放 在 构造 函数 块 内 太 人 迟 了 ， 因 为 基 类 的 构造 函数 在 派生 类 的 构造 函数 之 前 调用 。 这 就 是 为 什 
么 在 构造 函数 块 之 前 声明 了 一 个 构造 函数 初始 化 器 。 

如 果 锅 望 允许 使 用 默认 的 构造 函数 创建 Rectangle 对 和 象 , 仍然 可 以 这 样 做 。 如 果 基 类 的 构造 函数 没有 默认 的 
构造 函数 ， 也 可 以 这 样 做 ， 只 需要 在 构造 函数 初始 化 器 中 为 基 类 构造 函数 指定 值 ， 如 下 所 示 。 在 接 下 来 的 代码 
片段 中 ， 使 用 了 命名 参数 ， 否 则 很 难 区 分 传递 的 width、height、x 和 y 值 。 

Public Rectangle{() 

: base (width: 0, height: 0, xX: 0，Y: 0) 

注意 : 

命名 参数 参见 第 3 章 。 

这 个 过 程 非常 简洁 ， 设 计 也 很 合理 。 每 个 构造 函数 都 负责 处 理 相应 变量 的 初始 化 。 在 这 个 过 程 中 ， 正 确 地 
实例 化 了 类 ， 以 备 使 用 。 如 果 在 为 类 编写 目 己 的 构造 函数 时 遵循 同样 的 规则 ， 就 会 帮 现 ， 即 便 是 最 复杂 的 类 也 
可 以 顺利 地 初始 化 ， 并 且 不 会 出 现任 何 问题 。 


4.4 修饰 符 

前 面 已 经 遇 到 许多 所 谓 的 修饰 竺 , 即 应 用 于 类 型 或 成 员 的 关键 字 。 修饰 符 可 以 指定 方法 的 可 见 性 , 如 public 
或 private; 还 可 以 指定 一 个 项 的 本 质 ， 如 方法 是 virtual 或 abstract。C# 有 许多 访问 修饰 符 ， 下 面 讨 论 完 整 的 修 
饰 符 列 表 。 
4.4.1 访问 修饰 符 

表 4-1 中 的 修饰 符 确 定 了 是 否 允许 其 他 代码 访问 某 一 项 。 


表 4-1 
修 饰 符 说 明 
public 任何 代码 均 可 以 访问 该 项 
protected 只 有 派生 的 类 型 能 访问 该 项 
internal 只 能 在 包含 它 的 程序 集中 访问 该 项 
private 类 型 和 内 肉 类 型 的 所 有 成 员 只 能 在 它 所 属 的 类 型 中 访问 该 项 
protected internal 类 型 和 内 峰 类 型 的 所 有 成 员 只 能 在 包含 它 的 程序 集 和 派生 类 型 的 任何 代码 中 访问 该 项 。 实际 上 , 这 意 
味 着 protected 或 internal 


private protected 类 型 和 内 峰 类 型 的 所 有 成 员 访问 修饰 罕 protected intemal 表示 protected 或 intemal， 与 此 相反 ，private 
protected 将 private 与 protected 组 合 在 一 起 ， 表 示 private 和 protected。 只 
允许 访问 同一 程序 集中 的 派生 类 型 , 而 不 允许 访问 其 他 程序 集中 的 派生 类 
型 。 这 个 访问 修饰 符 在 C# 7.2 中 是 新 增 的 


注意 : 

public、protected 和 private 是 逻辑 访问 修饰 符 。internal 是 一 个 物理 访问 修饰 符 ， 其 边界 是 一 个 程序 集 。 
注意 ， 类 型 定义 可 以 是 内 部 或 公有 的 ， 这 取决 于 是 否 希 望 在 包含 类 型 的 程序 集 外 部 访问 它 : 

Public class MyClass 


{ 
了 
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不 能 把 类 型 定义 为 protected、private 或 protected internal， 因 为 这 些 修饰 符 对 于 包含 在 名 称 空 间 中 的 类 型 没有 
意义 。 因 此 这 些 修饰 符 只 能 应 用 于 成 员 。 但 是 ， 可 以 用 这 些 修饰 人 符 定义 散 套 的 类 型 ( 即 ， 包 含 在 其 他 类 型 中 的 
类 型 )， 因 为 在 这 种 情况 下 ， 类 型 也 具有 成 员 的 状态 。 于 是 ， 下 面 的 代码 是 合法 的 : 

Public class QuterClass 


{ 


protected class InnerCclass 


Ef a 


如 果 有 退 套 的 类 型 ， 则 内 部 的 类 型 总 是 可 以 访问 外 部 类 型 的 所 有 成 员 。 所 以 ， 在 上 面 的 代码 中 ，InnerClass 
中 的 代码 可 以 访问 OuterClass 的 所 有 成 员 ， 甚 至 可 以 访问 OuterClass 的 私有 成 员 。 
4.4.2 ”其 他 修饰 符 
表 4-2 中 的 修饰 符 可 以 应 用 于 类 型 的 成 员 ， 而 且 有 不 同 的 用 途 。 在 应 用 于 类 型 时 ， 其 中 的 几 个 修饰 符 也 是 
有 意义 的 。 
表 4-2 
修 饰 符 说 明 
new 成 员 用 相同 的 签名 隐藏 继承 的 成 员 


static 成 员 不 作用 于 类 的 具体 实例 ， 也 称 为 类 成 员 ， 而 不 是 实例 成 员 

virtual 成 员 可 以 由 派生 类 重 写 

abstract 虚拟 成 员 定义 了 成 员 的 签名 ， 但 没有 提供 实现 代码 

override 。 ”| 仅 函数 成 员 成 员 重 写 了 继承 的 虚拟 或 抽象 成 员 

sealed 类 、 方 法 和 属性 对 于 类 ， 不 能 继承 自 密封 类 。 对 于 属性 和 方法 ， 成 员 重 写 已 继承 的 虚拟 成 员 ， 但 任 
何 派 生 类 中 的 任何 成 员 都 不 能 重 写 该 成 员 。 该 修饰 符 必须 与 override 一 起 使 用 

extem 仅 静 态 [Dllimport] 方 法 | 成 员 在 外 部 用 另 一 种 语言 实现 。 这 个 关键 字 的 用 法 参见 第 17 章 


4.5 ”接口 


如 前 所 述 ， 如 果 一 个 类 派生 目 一 个 接口 ， 声 明 这 个 类 就 会 实现 茶 些 函数 。 并 不 是 所 有 的 面 回 对 象 语言 都 文 
持 接 口 ， 所 以 本 节 将 详细 介绍 C# 接 口 的 实现 。 下 面 列 出 Microsof 预定 义 的 一 个 接口 System.IDisposable 的 完 
整定 义 。IDisposable 包含 一 个 方法 Dispose0， 该 方法 由 类 实现 ， 用 于 清理 代码 : 

public interface IDisposable 

Dispose() ; 


} 

上 面 的 代码 说 明 ， 声 明 接 口 在 语法 上 与 声明 抽象 类 完全 相同 ， 但 不 允许 提供 接口 中 任何 成 员 的 实现 方式 。 
一 般 情 况 下 ， 接 口 只 能 包含 方法 、 属 性 、 索 引 器 和 事件 的 声明 。 

比较 接口 和 抽象 类 : 抽象 类 可 以 有 实现 代码 或 没有 实现 代码 的 抽象 成 员 。 然而, 接口 不 能 有 任何 实现 代码 ; 
它 是 纯粹 抽象 的 。 因 为 接口 的 成 员 总 是 抽象 的 ， 所 以 接口 不 需要 abstract 关键 字 。 

类 似 于 抽象 类 ， 水 远 不 能 实例 化 接口 ， 它 只 能 包含 其 成 员 的 签名 。 此 外 ， 可 以 声明 接口 类 型 的 变量 。 

接口 既 不 能 有 构造 函数 (如 何 构 建 不 能 实例 化 的 对 象 ? ) 也 不 能 有 字段 (因为 这 隐 含 了 某 些 内 部 的 实现 方式 )。 
接口 定义 也 不 允许 包含 运算 和 从重 载 ， 但 设计 语言 时 总 是 会 讨论 这 个 可 能 性 ， 未 来 可 能 会 改变 。 

在 接口 定义 中 还 不 允许 声明 成 员 的 修饰 行 。 接 口 成 员 总 是 隐 式 为 public， 不 能 声明 为 virtual。 如 果 需 要 ， 
束 应 由 实现 的 类 来 声明 ， 因 此 最 好 实现 类 来 声明 访问 修饰 从 ， 就 像 本 节 的 代码 那样 。 
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例如 ，IDisposable。 如 果 类 和 希望 声明 为 公有 类 型 ， 以 便 它 实现 方法 Dispose0， 该 类 就 必须 实现 IDisposable。 
在 C# 中 ， 这 表示 该 类 派生 目 IDisposable 类 。 
class SomeClass: IDisposable 
{ 
/i This class MUST contain an implementation of the 
/:/: IDisposable.Dispose() method, otherwise 
/i/ You get a compilation error. 
Public void Dispose() 
{ 
//: implementation of Dispose{() method 


/1 rest of class 


} 

在 这 个 例子 中 ， 如 果 SomeClass 派生 上 自 IDisposable 类 ， 但 不 包含 与 IDisposable 类 中 签名 相同 的 Dispose0 
实现 代码 ， 就 会 得 到 一 个 编译 错误 ， 因 为 该 类 破坏 了 实现 IDisposable 的 一 致 协定 。 当 然 ， 编 译 器 允许 类 有 一 个 
不 派生 目 IDisposable 类 的 Dispose0 方 法 。 问 题 是 其 他 代码 无 法 识别 出 SomeClass 类 ， 来 文 持 IDisposable 特性 。 


注意 : 
IDisposable 是 一 个 相当 简单 的 接口 ， 它 只 定义 了 一 个 方法 。 大 多 数 接口 都 包含 许多 成 员 。IDisposable 的 正 
确实 现代 码 没有 这 么 简单 ， 参 见 第 17 章 。 


4.5.1 定义 和 实现 接口 


下 面 开 上 有 一 个 遵循 接口 继承 规范 的 小 例子 来 说 明 如 何 定 义 和 使 用 接口 .这 个 例子 建立 在 银行 账户 的 基础 上 。 
假定 编写 代码 ， 最终 允许 在 银行 账户 之 间 进 行 计算 机 转账 业务 。 许 多 公司 可 以 实现 银行 账户 , 但 它们 一 致 认为 ， 
表示 银行 账户 的 所 有 类 都 实现 接口 [BankAccount。 该 接口 包含 一 个 用 于 存 取 蒜 的 方法 和 一 个 返回 余额 的 属性 。 
这 个 接口 还 允许 外 部 代码 识别 由 不 同 银行 账户 实现 的 各 种 银行 账户 类 。 我 们 的 目的 是 允许 银行 账户 彼此 通信 ， 
以 便 在 账户 之 间 进 行 转账 业务 ， 但 还 没有 介绍 这 个 功能 。 

为 了 使 例子 简单 一 些 ， 我 们 把 本 例 的 所 有 代码 都 放 在 同一 个 源 文件 中 ， 但 实际 上 不 同 的 银行 账户 类 不 仅 会 
编译 到 不 同 的 程序 集中 , 而 且 这 些 程序 集 位 于 不 同 银行 的 不 同 机 器 上 。 但 这 些 内 容 对 于 我 们 的 目的 过 于 复杂 了 。 
为 了 保留 一 定 的 真实 性 ， 我 们 为 不 同 的 公司 定义 不 同 的 名 称 空间 。 

首先 ， 需 要 定义 IBankAccount 接口 (代码 文件 UsingInterfaces/IBankAccount.cs): 

namespace Wrox.ProCcsharp 

| public interface IBankAccount 

PayIn (decimal amount); 
bool Withdraw (decimal amount); 
decimal Balance { get; ]} 


} 
} 


注意 ， 接 口 的 名 称 为 BankAccount。 接 口 名 称 通常 以 字母 I 开头 ， 以 便 知 道 这 是 一 个 接口 。 


注意 : 

如 第 2 章 所 述 ， 在 大 多 数 情况 下 ，NET 的 用 法 规则 不 鼓励 采用 所 谓 的 Hungarian 表示 法 ， 在 名 称 的 前 面 加 
一 个 字母 ， 表 示 所 定义 对 象 的 类 型 。 接 口 是 少 数 几 个 推荐 使 用 Hungarian 表示 法 的 例外 之 一 。 

现在 可 以 编写 表示 银行 账户 的 类 了 。 这 些 类 不 必 彼 此 相关 ， 它 们 可 以 是 完全 不 同 的 类 。 但 它们 都 表示 银行 
账户 ， 因 为 它们 都 实现 了 IBankAccount 接口 。 

下 面 是 第 一 个 类 ， 一 个 由 了 Royal Bank of Venus 运行 的 存款 账户 (代码 文件 UsingInterfaces/VenusBank cs): 

namespace Wrox.ProCsharp.VenusBank 

public class SaverAccount: IBankAccount 


private decimal balance; 
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Public void PaylIn(decimal amount) => balance += amount; 
public bool Withdraw (decimal amount) 


{ 
if ( balance >= amount)} 
{ 
balance -= amount; 
return true; 
} 


Console .WriteLine ("Withdrawal attempt failed.™); 
return false; 

} 

Public decimal Balance => balance; 

public override string ToString() => 
SnmVWenus Bank Saver: Balance = { balance, 6:cC}"s 

} 
} 


实现 这 个 类 的 代码 的 作用 一 目 了 然 。 其 中 包含 一 个 私有 字段 balance， 当 存 款 或 取款 时 就 调整 这 个 字段 。 如 
果 因 为 账户 中 的 金额 不 足 而 取款 失败 ， 就 会 显示 一 条 错误 消息 。 还 要 注意 ， 因 为 我 们 要 使 代码 尽 可 能 简单 ， 所 
以 不 实现 额外 的 属性 ， 如 账户 持 有 人 的 姓名 。 在 现实 生活 中 ， 这 是 最 基本 的 信息 ， 但 对 于 本 例 不 必要 这 人 么 复杂 。 

在 这 段 代 码 中 ， 唯 一 有 趣 的 一 行 是 类 的 声明 : 

public class SaverAccount: IBankAccount 

SaverAccount 派生 目 一 个 接口 [BankAccount, 我 们 没有 显 式 指出 任何 其 他 基 类 (当然 这 表示 SaverAccount 直接 
派生 目 System.Object)。 男 外 ， 从 接口 中 派生 完全 独立 于 从 类 中 派生 。 

SaverAccount 派生 目 BankAccount， 表示 它 获得 了 IBankAccount 的 所 有 成 员 , 但 接口 实际 上 并 不 实现 其 方 
法 ， 所 以 SaverAccount 必须 提供 这 些 方法 的 所 有 实现 代码 。 如 果 缺 少 实现 代码 ， 编 译 器 就 会 产生 错误 。 接 口 仅 
表示 其 成 员 的 存在 性 ， 类 人 负责 确定 这 些 成 员 是 虚拟 还 是 抽象 的 (但 只 有 在 类 本 和 号 是 抽象 的 ， 这些 函数 才能 是 抽象 
的 )。 在 本 例 中 ， 接 口 的 任何 函数 不 必 是 虚拟 的 。 

为 了 说 明 不 同 的 类 如 何 实 现 相 同 的 接口 ， 下 面 假定 Planetary Bank of Jupiter 还 实现 一 个 类 GoldAccount 来 
表示 其 银行 账户 中 的 一 个 (代码 文件 UsingInterfaces/JupiterBank.cs ): 


namespace 出 TOX-PEIOCSharp .JupIterBanmK 
{ 
Public class GoldAccount: IBankAccount 
{ 
i de 
} 
} 


这 里 没有 列 出 GoldAccount 类 的 细节 ,因为 在 本 例 中 它 基 本 上 与 SaverAccount 的 实现 代码 相同 .GoldAccount 
与 SaverAccount 没有 关系 ， 它 们 只 是 页 巧 实现 相 同 的 接口 而 已 。 
有 了 自己 的 类 后 ， 就 可 以 测试 它们 了 。 首 先 需 要 一 些 using 语句 : 


USing Wrox.ProCcsharp; 
USing Wrox.ProCcsharp.VenusBank; 
USing Wrox.ProCcsharp.JupiterBank; 


然后 需要 一 个 Main0 方 法 (代码 文件 UsingInterfaces/Proeram.cs): 


namespace Wrox.ProCcSsharp 
{ 
class Program 
{ 
static void Main{) 
{ 
IBankAccount venusAccount = new SaverAccount () ， 
IBankAccount jupiterAccount = new GoldAccount (); 
venusAccount .PayIn (200).; 
VenusacCount .Withdraw(100):; 
Console .WriteLine (venusAccount .ToString(})); 
JupiterAccount.PayIn (S500); 
JupiterAccount .Withdraw (600); 
JupiterAccount .Withdraw (100); 
Console .WriteLine (jupiterAccount.ToString()}); 
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这 段 代码 的 执行 结果 如 下 : 

> BankAccounts 

Venus Bank Saver: Balance = $100.00 

Withdrawal attempt failed. 

Jupiter Bank Saver: Balance = $400.00 

在 这 段 代码 中 , 要 点 是 把 两 个 引用 变量 声明 为 IJBankAccount 引用 的 方式 。 这 表示 它们 可 以 指向 实现 这 个 接 
口 的 任何 类 的 任何 实例 。 但 我 们 只 能 通过 这 些 引 用 调用 接口 的 一 部 分 方法 一 一 如 果 要 调用 由 类 实现 的 但 不 在 接 
口中 的 方法 ， 就 需要 把 引用 强制 转换 为 合适 的 类 型 。 在 这 段 代码 中 ， 我 们 调用 了 ToString0( 不 是 IBankAccount 
实现 的 )， 但 没有 进行 任何 显 式 的 强制 转换 ， 这 只 是 因为 ToString0 是 一 个 System.Object0 方 法 ， 因 此 C# 编 译 器 
知道 任何 类 都 支持 这 个 方法 (换言之 ， 从 任何 接口 到 System.Object 的 数据 类 型 强制 转换 是 隐 式 的 )。 第 6 章 将 介 
绍 强制 转换 的 语法 。 

接口 引用 完全 可 以 看 成 类 引用 一 一 但 接口 引用 的 强大 之 处 在 于 ， 它 可 以 引用 任何 实现 该 接口 的 类 。 例 如 ， 
我 们 可 以 构造 接口 数组 ， 其 中 数组 的 每 个 元 素 都 是 不 同 的 类 ; 


IBankAccount[] accounts = new IBankAccount [之 ] ; 
accounts[0] = new SaverAccount (}.; 
accounts[1] = new GoOldAccount (); 


但 注意 ， 如 果 编 写 了 如 下 人 代码， 就 会 生成 一 个 编译 器 错误 : 


accounts[1] = new SomeCtherClass(); // SomeotherClass does NOT implement 
// IBankAccount: WRONG!! 


这 会 导致 如 下 所 示 的 编译 错误 : 


Cannot implicitly convert type ‘Wrox.ProCcSsharp. SomeOtherCclass'" to 
'WIoOXK.PIOCSharp.IBankAccount" 


4.5.2 派生 的 接口 


接口 可 以 彼此 继承 ， 其 方式 与 类 的 继承 方式 相同 。 下 面 通过 定义 一 个 新 的 ITransferBankAccount 接口 来 说 
明 这 个 概念 ， 该 接口 的 功能 与 IJBankAccount 相同 ， 只 是 又 定义 了 一 个 方法 ， 把 资金 直接 转 到 另 一 个 账户 上 ( 代 
码 文 件 UsingInterfaces/TIransferBankAccount ): 

namespace Wrox.ProCcsharp 


| 


public interface ITransferBankAccount: IBankAccount 


bool TransferTo (IBankAccount destination, decimal amount); 

因为 TTransferBankAccount 派生 自 IBankAccount， 所 以 它 拥有 IBankAccount 的 所 有 成 员 和 它 自己 的 成 员 。 
这 表示 实现 (派生 上 自 )ITransferBankAccount 的 任何 类 都 必须 实现 IBankAccount 的 所 有 方法 和 在 
ITransferBankAccount 中 定义 的 新 方法 TransferTo0。 没 有 实现 所 有 这 些 方法 就 会 产生 一 个 编译 错误 。 

注意 ，TransferTo0 方 法 对 于 目标 账户 使 用 了 IBankAccount 接口 引用 。 这 说 明了 接口 的 用 途 : 在 实现 并 调用 
这 个 方法 时 ， 不 必 知 道 转账 的 对 象 类 型 ， 只 需要 知道 该 对 象 实 现 IBankAccount 即 可 。 

下 面 说 明 ITransferBankAccount: 假定 Planetary Bank of Jupiter 还 提供 了 一 个 当前 账户 。CurentAccount 类 
的 大 多 数 实现 代码 与 SaverAccount 和 GoldAccount 的 实现 代码 相同 (这 仅 是 为 了 使 例子 更 简单 , 一 般 是 不 会 这 样 
的 )， 所 以 在 下 面 的 代码 中 ， 我 们 仅 突出 显示 了 不 同 的 地 方 (代码 文件 UsingInterfaces/JupiterBank.cs ): 

public class CurrentAccount: ITransferBankaccount 

private decimal balance; 


public void PavyIn (decimal amount) 一 > balance += amount.; 
public bool Withdraw (decimal amount) 


if ( balance >= amount) 
{ 
balance -二 amount.; 
return true; 


} 
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Console.WriteLine ("Withdrawal attempt failed.™); 
return false; 


} 


public decimal Balance => balance; 


Public bool TransferIo (IBankAccount destinaticon, decimal amount) 
{ 
bool result = Withdraw (amount) ; 
i (result) 
{ 
destinatiocon.PavyIn (amount) ; 
} 
return result,; 
} 
public override string ToString{() => 
$"Jupiter Bank Current Account: Balance = { balance,6:C}"; 
} 
可 以 用 下 面 的 代码 验证 该 类 : 
static void Mainl() 
{ 
IBankAccount venusAccount = new SaverAccount(}):; 
ITransferBankAccount jupiterAccount = new CurrentAccount () ; 
VENnUSACCOoOunt .PayIn (200); 
jupiterAccount.PaylIn (500); 
JupiterAccount.TransferTo (venusAccount, 100); 
Console .WriteLine (venusAccount.ToSsString(})); 
Console .WriteLine (jupiterAccount.ToString())}); 


} 
这 段 代码 的 结果 如 下 所 示 ， 可 以 验证 ， 其 中 说 明了 正确 的 转账 金额 : 


Venus Bank Saver: Balance = $300.00 
Jupiter Bank Current Account: Balance = $400.00 


4.6 is 和 as 运算 符 


在 结束 接口 和 类 的 继承 之 前 ， 需 要 介绍 两 个 与 继承 有 关 的 重要 运算 从: is 和 as。 

如 前 所 述 ， 可 以 把 具体 类 型 的 对 象 直接 分 配给 基 类 或 接口 一 一 如 果 这 些 类 型 在 层次 结构 中 有 直接 关系 。 例 
加， 前 面 创建 的 SaverAccount 可 以 直接 分 配给 [BankAccount， 因 为 SaverAccount 类 型 实现 了 IBankAccount 
接口 : 

IBankAccount venusAccount = new SaverBaccount(}).; 

如 果 一 个 方法 接受 一 个 对 象 类 型 ， 现 在 希望 访问 IBankAccount 成 员 ， 该 怎么 办 ? 该 对 象 类 型 没有 
IBankAccount 接口 的 成 员 。 此 时 可 以 进行 类 型 转换 。 把 对 象 (也 可 以 使 用 任何 接口 中 任意 类 型 的 参数 ， 把 它 转 换 
为 需要 的 类 型 ) 转 换 为 IJBankAccount， 再 处 理 它 : 

public void WorkWithManyDifferentobjects (object o) 

| IBankAccount account = (IBankAccount)o; 


/i work with the account 


} 

只 要 总 是 给 这 个 方法 提供 一 个 BankAccount 类 型 的 对 象 ， 这 就 是 有 效 的 。 当 然 ， 如 果 接 受 一 个 object 类 型 
的 对 象 ， 有 了 时 就 会 传递 无 效 的 对 象 。 此 时 会 得 到 InvalidCastException 异常 。 在 正常 情况 下 接受 异常 从 来 都 不 好 ， 
详 见 第 14 章 。 此 时 应 使 用 is 和 as 运算 符 。 

不 是 直接 进行 类 型 转换 ， 而 应 检查 参数 是 否 实现 了 接口 [BankAccount。as 运算 和 从 的 工作 原理 类 似 于 类 层次 
结构 中 的 cast 运算 符 一 一 它 返 回 对 象 的 引用 。 然 而 ， 它 从 不 抛 出 mvalidCastException 异常 。 相 反 ， 如 果 对 象 不 
是 所 要 求 的 类 型 ， 这 个 运算 符 就 返回 null。 这 里 ， 最 好 在 使 用 引用 前 验证 它 是 否 为 衬 ， 否 则 以 后 使 用 以 下 引用 ， 
就 会 抛 出 NullReferenceException 异常 : 

public void WorkWithManyDifferentobjects (object o) 


{ 


IBankAccount account = 6 as IBankAccount.: 
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if (account != null) 
YA work with the account 
} 
除了 使 用 as 运算 符 之 外 ， 还 可 以 使 用 is 运算 符 。is 运算 符 根据 条 件 是 否 满足 ， 对 象 是 否 使 用 指定 的 类 型 ， 
返回 true 或 false。 如 果 条 件 为 tue， 则 将 所 得 的 对 象 写 入 声明 为 匹配 类 型 的 变量 中 ,如 下 面 的 代码 片段 所 示 : 
public void WorkWithManyDifferentobjects (object o) 


{ 
1if (oo is IBankAccount account) 
{ 


// work with the account 


} 


注意 : 
向 is 运算 符 添加 变量 声明 是 C#7 的 一 个 新 特性 。 这 是 模式 匹配 功能 的 一 部 分 ， 详 见 第 13 章 。 


在 类 层次 结构 内 部 的 类 型 转换 不 会 抛 出 基于 类 型 转换 的 异 币 ， 且 使 用 is 和 as 运算 符 都 是 可 行 的 。 


4.7 小结 


本 章 介 绍 了 如 何在 C# 中 进行 继承 。C# 支 持 多 接口 继承 和 单一 实现 继承 ， 还 提供 了 许多 有 用 的 语法 结构 ， 
以 使 代码 更 健壮 ， 如 override 关键 字 ， 它 表示 函数 应 在 何 时 重 写 基 类 函数 ，new 关键 字 表示 函数 在 何 时 隐藏 基 
类 函数 ， 构 造 函 数 初始 化 器 的 硬性 规则 可 以 确保 构造 函数 以 健壮 的 方式 进行 交互 操作 。 

第 5 章 介绍 了 C# 语 言 的 一 个 重要 结构 : 泛 型 。 


本 章 要 点 

泛 型 概述 
创建 泛 型 类 
泛 型 类 的 特性 
泛 型 接口 

泛 型 结构 

泛 型 方法 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代 码 。 源 代码 也 可 以 在 Generics 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

打开 网 页 http://www.wrox.com/go/professionalcsharp6， 单 击 Download Code 选项 卡 即 可 下 载 本 章 源 代码 。 
本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

。 LinkedListObjects 
LinkedListSample 


DocumentManager 


Varlance 
GenericMethods 
Specialization 


5.1 泛 型 概述 


泛 型 是 C# 和 .NET 的 一 个 重要 概念 。 泛 型 不 仅 是 C# 编 程 语言 的 一 部 分 ， 而 且 与 程序 集中 的 IL(Intermediate 
Language， 中 间 语 言 ) 代 码 紧 密 地 集成 。 有 了 没 型 ， 就 可 以 创建 独立 于 被 包含 类 型 的 类 和 方法 。 我 们 不 必 给 不 同 
的 类 型 编写 功能 相同 的 许多 方法 或 类 ， 只 创建 一 个 方法 或 类 即 可 。 

男 一 个 减少 代码 的 选项 是 使 用 Object 类 , 但 使 用 派生 自 Object 类 的 类 型 进行 传递 不 是 类 型 安全 的 。 泛 型 类 
使 用 泛 型 类 型 ， 并 可 以 根据 需要 用 特定 的 类 型 兰 换 泛 型 类 型 。 这 就 保证 了 类 型 安全 性 : 如 果 某 个 类 型 不 支持 汽 


型 类 ， 编 译 器 融会 出 现 错误 。 

泛 型 不 仅 限于 类 ， 本 章 还 将 介绍 用 于 接口 和 方法 的 泛 型 。 用 于 委托 的 泛 型 参见 第 8 章 。 

泛 型 不 仅 存 在 于 C# 中 ， 其 他 语言 中 有 类 似 的 概念 。 例 如 ，C++ 模 板 就 与 泛 型 相似 。 但 是 ，C+H+ 模 板 和 NET 
泛 型 之 则 有 一 个 很 大 的 区 别 。 对 于 C++ 模板 ， 在 用 特定 的 类 型 实例 化 模板 时 ， 需 要 模板 的 源 代 码 。C++ 编 译 器 为 每 
个 属于 特定 模板 实例 的 类 型 生成 单独 的 二 进 制 代码 。 相 反 ， 泛 型 不 仅 是 C# 语 言 的 一 种 结构 ， 而 且 是 CLR( 公 共 语 言 
运行 库 ) 定 义 的 。 所 以 ， 即 使 泛 型 类 是 在 C# 中 定义 的 ， 也 可 以 在 Visual Basic 中 用 一 个 特定 的 类 型 实例 化 该 泛 型 。 

下 面 几 节 介绍 泛 型 的 优点 和 缺点 ， 尤 其 是 : 

。 性 能 

。 类 型 安全 性 

e 二 进 制 代码 重用 

e 代码 的 扩展 

e 命名 约定 


5.1.1 性 能 


泛 型 的 一 个 主要 优点 是 性 能 。 第 10 章 介 绍 了 System.Collections 和 System.Collections.Generic 名 称 空间 的 泛 
型 和 非 泛 型 集合 类 。 对 值 类 型 使 用 非 泛 型 集合 类 , 在 把 值 类 型 转换 为 引用 类 型 ， 和 把 引用 类 型 转换 为 值 类 型 时 ， 
需要 进行 装 箱 和 拆 箱 操作 。 


后 劫 二 
装 箱 和 拆 箱 详 见 第 6 章 ， 这 里 仅 简要 复习 一 下 这 些 术 语 。 


值 类 型 存储 在 栈 上 ， 引 用 类 型 存储 在 堆 上 。C# 类 是 引用 类 型 ， 结 构 是 值 类 型 。.NET 很 容易 把 值 类 型 转换 
为 引用 类 型 ， 所 以 可 以 在 需要 对 象 (对 象 是 引用 类 型 ) 的 任意 地 方 使 用 值 类 型 。 例 如 ，int 可 以 赋予 一 个 对 象 。 从 
值 类 型 转换 为 引用 类 型 称 为 装 箱 。 如 果 方 法 需要 把 一 个 对 象 作 为 参数 ， 同 时 传递 一 个 值 类 型 ， 装 箱 操作 就 会 目 
动 进行 。 另 一 方面 ， 装 箱 的 值 类 型 可 以 使 用 拆 箱 操作 转换 为 值 关 型。 在 拆 箱 时 ， 需 要 使 用 类 型 强制 转换 运算 符 。 

下 面 的 例子 显示 了 System.Collections 名 称 空间 中 的 ArrayList 类 。ArrayList 存储 对 象 ，Add0 方 法 定义 为 需 
要 把 一 个 对 象 作为 参数 ， 所 以 要 装 箱 一 个 整数 类 型 。 在 读 取 ArrayList 中 的 值 时 ， 要 进行 拆 箱 ， 把 对 象 转换 为 整 
数 类 型 。 可 以 使 用 类 型 强制 转换 运算 符 把 ArrayList 集合 的 第 一 个 元 素 赋予 变量 il， 在 访问 int 类 型 的 变量 i2 的 
foreach 语句 中 ， 也 要 使 用 类 型 强制 转换 运算 符 : 

Var list = new ArrayList(); 

list.Add(44}; // boxing — convert a Value type to a reference type 

Int i1 = (int})}list[0]; // unboxing — convert a reference type to 

// a value type 

foreach (int 12 in list) 


| 


Console.WriteLine (i2); // unboxing 


装 箱 和 拆 箱 操作 很 容易 使 用 ， 但 性 能 损失 比较 大 ， 允 历 许 多 项 时 尤其 如 此 。 

System.Collections.Generic 名 称 空间 中 的 List<T> 类 不 使 用 对 象 , 而 是 在 使 用 时 定义 类 型 。 在 下 面 的 例子 中 ， 
List<T> 类 的 泛 型 类 型 定义 为 mt, 所 以 int 类 型 在 JIT(Just-In-Time) 编 译 器 动态 生成 的 类 中 使 用 , 不 再 进行 装 箱 和 
拆 箱 操作 : 

var 1]ist = new List<int>(); 

list.Add(44}); // no boxing — Value types are stored in the List<int> 

int 11 = list[0]; // no unboxing, no cast needed 


foreach (int 12 in list) 


Console.WriteLine (12); 
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5.1.2 ”类 型 安全 


泛 型 的 另 一 个 特性 是 类 型 安全 。 与 ArrayList 类 一 样 ， 如 果 使 用 对 象 ， 就 可 以 在 这 个 集合 中 添加 任意 类 型 。 下 
面 的 例子 在 ArrayList 类 型 的 集合 中 添加 一 个 整数 、 一 个 字符 串 和 一 个 MyClass 类 型 的 对 象 : 

Var list = new ArrayList(); 

list.Add (44); 


list.Add ("mystring"); 
list.Add (new MyClass ()); 


如 果 这 个 集合 使 用 下 面 的 foreach 语句 迭代 ， 而 该 foreach 语句 使 用 整数 元 素来 迭代 ， 编 译 器 就 会 接受 这 上 段 
代码 。 但 并 不 是 集合 中 的 所 有 元 素 都 可 以 强制 转换 为 mt， 所 以 会 出 现 一 个 运行 时 异 生 : 
foreach (int 1 in list) 


Console .WriteLine (1); 


错误 应 尽早 上 发现。 在 泛 型 类 List<T> 中 ， 泛 型 类 型 T 定义 了 允许 使 用 的 类 型 。 有 了 List<int> 的 定义 ， 就 只 
能 把 整数 类 型 添加 到 集合 中 。 编 译 器 不 会 编译 这 段 代 码 ， 因 为 Add0 方 法 的 参数 无 效 : 

var list = new List<int>(); 

list.Adqd (44); 


list.Add ("mystring"); // compile time error 
list.Add (new MyClass(}}); // compile time error 


5.1.3 二进制 代码 的 重用 

泛 型 允许 更 好 地 重用 二 进 制 代码 。 泛 型 类 可 以 定义 一 次 , 并 且 可 以 用 许多 不 同 的 类 型 实例 化 。 不 需要 像 C++ 
模板 那样 访问 源 代 码 。 

例如 ，System.Collections.Generic 名 称 空间 中 的 List<T> 类 用 一 个 int、 一 个 字符 串 和 一 个 MyClass 类 型 实 
例 化 : 


var list = new List<int>(}).; 
list.Add(44)-: 
Var stringList = new List<string>(}); 


stringList.Add ("mystring"); 
Var myClassList = new List<MyClass>(); 
myClassList.Add (new MYCLass() 1) 


泛 型 类 型 可 以 在 一 种 语言 中 定义 ， 在 任何 其 他 .NET 语言 中 使 用 。 
5.1.4 代码 的 扩展 


在 用 不 同 的 特定 类 型 实例 化 泛 型 时 ， 会 创建 多 少 代码 ?因为 泛 型 类 的 定义 会 放 在 程序 集中 ， 所 以 用 特定 类 
型 实例 化 泛 型 类 不 会 在 工 代码 中 复制 这 些 类 。 但 是 , 在 JIT 编译 器 把 泛 型 类 编译 为 本 地 代码 时 ， 会 给 每 个 值 类 
型 创建 一 个 新 类 。 引 用 类 型 共 再 同一 个 本 地 类 的 所 有 相同 的 实现 代码 。 这 是 因为 引用 类 型 在 实例 化 的 泛 型 类 中 
只 需要 4 个 字 节 的 内 存 地 址 (32 位 系统 )， 束 可 以 引用 一 个 引用 类 型 。 值 类 型 包 合 在 实例 化 的 泛 型 类 的 内 存 中 ， 
同时 因为 每 个 值 类 型 对 内 存 的 要 求 都 不 同 ， 所 以 要 为 每 个 值 类 型 实例 化 一 个 新 类 。 


5.1.5 命名 约定 


如 果 在 程序 中 使 用 泛 型 , 在 区 分 泛 型 类 型 和 非 泛 型 类 型 时 束 会 有 一 定 的 帮助 。 下 面 是 泛 型 类 型 的 命名 规则 : 
e 泛 型 类 型 的 名 称 用 字母 作为 前 缀 。 
se ”如果 没有 特殊 的 要 求 ， 泛 型 类 型 允许 用 任意 类 蔡 代 ， 且 只 使 用 了 一 个 泛 型 类 型 ， 就 可 以 用 字符 工 作为 


Public class List<T> { } 
public class LinkedList<T> { } 
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e 如 果 泛 型 类 型 有 特定 的 要 求 (例如 ， 它 必须 实现 一 个 接口 或 派生 目 基 类 )， 或 者 使 用 了 两 个 或 多 个 泛 型 类 
型 ， 就 应 给 泛 型 类 型 使 用 描述 性 的 名 称 ; 


public delegate void EventHandler<TEventArgs> (object sender, 
TEventArgs e)s 

Public delegate TOutput Converter<TInput, TOutput> (TInput from); 

Public class SortedList<TRey, TValue> { } 


5.2 创建 泛 型 类 


首先 介绍 一 个 一 般 的 、 非 泛 型 的 简化 链表 类 , 它 可 以 包含 任意 类 型 的 对 象 ， 以 后 再 把 这 个 类 转化 为 泛 型 类 。 

在 链表 中 ， 一 个 元 素 引 用 下 一 个 元 素 。 所 以 必须 创建 一 个 类 ， 它 将 对 象 封 装 在 链表 中 ， 并 引用 下 一 个 对 象 。 
类 LinkedListNode 包含 一 个 属性 Value, 该 属性 用 构造 函数 初始 化 。 男 外 ，LinkedListNode 类 包含 对 链表 中 下 一 个 
元 素 和 上 一 个 元 素 的 引用 ， 这 些 元 素 都 可 以 从 属性 中 访问 (代码 文件 LinkedListObjects/LinkedListNode.cs)。 


public class LinkedListNode 
{ 
public LinkedListNode (object value})} => Value = value; 


PUublic object Value { get; } 
PUublic LinkedListNode Next { get; internal Set } 
public LinkedListNode Prev { get; internal set; } 

} 

LinkedList 类 包含 LinkedListNode 类 型 的 First 和 Last 属性 ,它们 分 别 标记 了 链表 的 头 尾 。AddLast(0 方 法 在 
链表 尾 添 加 一 个 新 元 素 。 首 先 创建 一 个 LinkedListNode 类 型 的 对 象 。 如 果 链 表 是 空 的 ，First 和 Last 属性 就 设置 
为 该 新 元 素 ; 否则 ， 就 把 新 元 素 添 加 为 链表 中 的 最 后 一 个 元 素 。 通 过 实现 GetEnumerator0 方 法 ， 可 以 用 foreach 
语句 裔 历 链 表 。GetEnumerator0 方 法 使 用 yield 语句 创建 一 个 枚 举 器 类 型 。 

Public class LinkedList: IEnumerable 

{ 

Public LinkedListNode First { get; private set; } 
Public LinkedListNode Last { get; private set; } 
Public LinkedListNode AddLast (object node) 
{ 
Var newNode = new LinkedLlistNode (node): 
if (First == null) 
{ 
First = newNode; 
Last = First; 
} 
号 ] Se 
{ 
LinkedListNode previous = Last; 
Last .Next = newNode. 
Last = newNode. 
Last.Prev = previous; 
} 


return newNode.: 


} 


Public IEnumerator GetEnumerator () 
{ 
LinkedListNode current = First:; 
while (current != null) 
{ 
yield return current.Value; 
CUITent = current.Next.; 
} 
} 
} 


注意 : 
yield 语句 创建 一 个 枚 举 器 的 状态 机 ， 详 细 介 绍 请 参见 第 7 章 . 


现在 可 以 对 于 任意 类 型 使 用 LinkedList 类 。 在 下 面 的 代码 段 中 ， 实 例 化 了 一 个 新 LinkedList 对 象 ， 添 加 了 两 
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个 整数 类 型 和 一 个 字符 串 类 型 。 整 数 类 型 要 转换 为 一 个 对 象 ， 所 以 执行 装 箱 操作 ， 如 前 面 所 述 。 通 过 foreach 
语句 执行 拆 箱 操作 。 在 foreach 语句 中 ,链表 中 的 元 素 被 强制 转换 为 整数 ， 所 以 对 于 链表 中 的 第 3 个 元 素 ， 会 发 
生 一 个 运行 时 异 币 ， 因 为 把 它 强 制 转换 为 int 时 会 失败 (代码 文件 LinkedListObjects/Program.cs)。 


Var listl] = new LinkedList(); 
1]istl.AddLast (2); 
1]istl.AddLast (4); 
listl1.AddLast ("6"); 
foreach (int i In list]) 
{ 

ConsoD1le .WriteLine (1); 


} 

下 面 创建 链表 的 泛 型 版 本 。 泛 型 类 的 定义 与 一 般 类 类 似 ， 只 是 要 使 用 泛 型 类 型 声明 。 之 后 ， 泛 型 类 型 就 可 
以 在 类 中 用 作 一 个 字段 成 员 ， 或 者 方法 的 参数 类 型 。LinkedListNode 类 用 一 个 泛 型 类 型 T 声明 。 属 性 Value 的 
类 型 是 T, 而 不 是 object。 构造 函数 也 变 为 可 以 接受 T 类 型 的 对 象 。 也 可 以 返回 和 设置 泛 型 类 型 , 所 以 属性 Next 
和 Prev 的 类 型 是 LinkedListNode<T>( 代 码 文件 LinkedListSample/LinkedListNode.cs)。 


Public class LinkedListNode<T> 
{ 
public LinkedListNode (T value) => Value = value; 


public T Value { get; } 

public LinkedListNode<T> Next { get; internal set; } 

public LinkedListNode<T> Prev { get; internal set; } 
} 


下 面 的 代码 把 LinkedList 类 也 改 为 泛 型 类 。LinkedList<T> 包 含 LinkedListrNode<T> 元 素 。LinkedList 中 的 类 
型 定义 了 类 型 的 属性 First 和 Last。AddLast0O 方 法 现在 接受 类 型 T 的 参数 ， 并 实例 化 LinkedListNode<T> 类 
型 的 对 象 。 

除了 IEnumerable 接口 ， 还 有 一 个 泛 型 版 本 正 numerable<T>。IEnumerable<T>= 派 生 自 IEnumerable， 添 加 了 返 
回 IEnumerator<T> 的 GetEnumerator0 方法 ，LinkedList<T=> 实现 泛 型 接口 下 numerable<T>( 代 码 文 件 
LinkedListSample/LimkedList.cs)。 


注意 : 
枚 举 与 接口 IEnumerable 和 IEnumerator 详 见 第 7 章 。 


public class LinkedList<T>: IEnumerable<T> 
{ 
public LinkedListNode<T> First { get; private set; } 
public LinkedListNode<T> Last { get; private set; } 
public LinkedListNode<T> AddLast (T node) 
{ 
var newNode = new LinkedListNode<T> (node}); 
if (First == null? 
{ 
First = newNode:; 
Last = First; 
} 
= 
{ 
LinkedListNode<T> previous = Last; 
Last .Next = newNode.; 
Last = newNode.; 
Last.Prev = previous; 
} 
return newNode; 


} 


public IEnumerator<T> GetEnumerator() 
| 
LinkedListNode<T> current = First; 
While (current != null) 
{ 
yield return current.Value; 
CUrrent = Current .Next; 
} 
} 


IEnumerator IEnumerable.GetEnumerator{() => GetEnumerator(); 


} 

使 用 泛 型 LinkedList<T>, 可 以 用 int 类 型 实例 化 它 , 且 不 需要 装 箱 操作 。 如 果 不 使 用 AddLast0 方 法 传递 int， 
就 会 出 现 一 个 编译 器 错误 。 使 用 泛 型 下 numerable<T>，foreach 语句 也 是 类 型 安全 有 的， 如果 foreach 语句 中 的 变 
量 不 是 int， 就 会 出 现 一 个 编译 器 错误 (代码 文件 LinkedListSample/Program.cs)。 

var lJ]ist2 = new LinkedList<int>(); 

list2.AddLast (1}).; 

list2.AddLast (3); 

list2.AddLast (5}).，; 


foreach (jnt 1 in list2) 


Console .WriteLine (1); 


同样 ， 可 以 对 于 字符 串 类 型 使 用 泛 型 LinkedList<T>， 将 字符 串 传 递 给 AddLast0 方 法 。 
Var list3 = new LinkedList<string> (); 
1ist3.AddLast ("22"); 
list3.AddLast ("four™); 
list3.BaddLast ("foo™)s 
foreach (string s in 11ist3) 
{ 
Console .WriteLine (s).; 


} 


注意 : 
每 个 处 理 对 象 类 型 的 类 都 可 以 有 泛 型 实现 方式 。 另 外， 如 果 类 使 用 了 层次 结构 ， 泛 型 就 非常 有 助 于 消除 不 
必要 的 类 型 强制 转换 操作 。 


5.3” 泛 型 类 的 功能 


在 创建 泛 型 类 时 ， 还 需要 一 些 其 他 C# 关 键 字 。 例 如 ， 不 能 把 null 赋予 泛 型 类 型 。 此 时 ， 如 下 一 节 所 述 ， 可 
以 使 用 default 关键 字 。 如 果 泛 型 类 型 不 需要 Object 类 的 功能 , 但 需要 调用 泛 型 类 上 的 菜 些 特定 方法 , 就 可 以 定 
义 约束 。 

本 节 讨 论 如 下 主题 ; 

。 默认 值 


。 约束 
。 继承 
。 静态 成 员 


痛 先 介绍 一 个 使 用 泛 型 文档 管理 器 的 示例 。 文 档 管理 器 用 于 从 队列 中 读 写 文档 。 先 创建 一 个 新 的 控制 台 项 目 
DocumentManager， 并 添加 DocumentManager<T> 类 。AddDocument0 方 法 将 一 个 文档 添加 到 队列 中 。 如 果 队 列 不 
为 空 ，ISDocumentAvailable 只 读 属性 就 返回 tue( 代 码 文件 DocumentManager/DocumentManager.cs)。 


USing System; 

USIing System.Collections.Generic; 
namespace Wrox.ProCcSharp.Generics 
{ 


public class DocumentManager<T> 


private readonly Queue<T> documentQueue = new Wueue<T> () 7 
private readonly object lockQueue = new object(}; 


public void AddDocument (T doc) 
{ 
lock ( lockQueue) 
{ 
documentQueue.Engqueue (doc):; 
} 
} 
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Public bool IsDocumentAvallable => documentQueue.Count > 0; 
} 
} 


第 21 章 将 讨论 线程 和 lock 语句 。 


5.3.1 默认 值 


现在 给 DocumentManager<T> 类 添加 一 个 GetDocument0) 方 法 。 在 这 个 方法 中 ， 应 把 类 型 T 指定 为 null。 但 
是 ， 不 能 把 null 赋予 泛 型 类 型 。 原 因 是 泛 型 类 型 也 可 以 实例 化 为 值 类 型 ， 而 null 只 能 用 于 引用 类 型 。 为 了 解决 
这 个 问题 ， 可 以 使 用 default 关键 字 。 通 过 default 关键 字 ， 将 null 赋予 引用 类 型 ， 将 0 赋予 值 类 型 。 

Public T GetDocument () 

{ 


工 doc = default. 
lock ( lockQueue) 


{ 
doc = documentQueue.Dequeue () 7 
} 
return docs 
} 
注意 : 


default 关键 字 根据 上 下 文 可 以 有 多 种 含义 。switch 语句 使 用 default 定义 默认 情况 。 在 泛 型 中 ， 取 决 于 泛 型 
类 型 是 引用 类 型 还 是 值 类 型 ， 泛 型 default 将 泛 型 类 型 初始 化 为 null 或 0。 


5.3.2 ”约束 


如 果 泛 型 类 需要 调用 泛 型 类 型 中 的 方法 ， 就 必须 添加 约束 。 
对 于 DocumentManager<T>， 文 档 的 所 有 标题 应 在 DisplayAllDocuments0) 方 法 中 显示 。Document 类 实现 带 
有 Title 和 Content 只 读 属 性 的 IDocument 接口 (代码 文件 DocumentManager/Document.cs): 


Public interface IDocument 
{ 
string Title { get; } 
string Content { get; } 


} 
public class Document: IDocument 
0 Document (string title, string content) 
Title = title- 
Content = content; 
} 


public string Title |{ get; } 
public string Content { get; } 
} 


要 使 用 DocumentManager<T> 类 显示 文档 ， 可 以 将 类 型 工 强制 转换 为 IDocument 接口 ， 以 显示 标题 : 


Public void DisplayAllDocuments () 
{ 
foreach {TT doc in documentQueue) 
{ 
Console.WriteLine(( (IDocument}doc) .Title); 
} 
} 


问题 是 ， 如 果 类 型 T 没有 实现 IDocument 接口 ， 这 个 类 型 强制 转换 就 会 导致 一 个 运行 时 异常 。 最 好 给 
DocumentManager<TDocument> 类 定义 一 个 约束 : TDocument 类 型 必须 实现 IDocument 接口 。 为 了 在 泛 型 类 型 
的 名 称 中 指定 该 要 求 ， 将 T 改 为 TDocument。where 子 句 指定 了 实现 IDocument 接口 的 要 求 (代码 文件 
DocumentManager/DocumentManager.cs): 


Public class DocumentManager<TDocument> 
where TDocument: IDocument 


| 


给 泛 型 类 型 添加 约束 时 ， 最 好 包含 泛 型 参数 名 称 的 一 些 信息 。 现 在 ， 示 例 代码 给 泛 型 参数 使 用 TDocument 
来 代替 T。 对 于 编译 器 而 言 ， 参 数 名 不 重要 ， 但 它 更 具 可 读 性 。 


这 样 就 可 以 编写 foreach 语句 ， 从 而 使 类 型 TDocument 包含 属性 Title。Visual Studio IntelliSense 和 编译 器 都 
会 提供 这 个 支持 。 


Public void DisplayAllDocuments () 
{ 
foreach (TDocument doc in documentQueue) 
{ 
Console.WriteLine (doc.Title).; 
} 
} 


在 Main0 方 法 中 ， 用 Document 类 型 实例 化 DocumentManager<TDocument> 类 ， 而 Document 类 型 实现 了 需 
要 的 IDocument 接口 。 接 着 添加 和 显示 新 文档 ， 检 索 其 中 一 个 文档 (代码 文件 DocumentManager/Program.cs): 


public static void Main() 
{ 
Var dm = new DocumentManager<Document2>().; 
dm.AddDocument (new Document ("Title A", "Sample A")); 
dm.AddDocument (new Document ("Title B", "Sample B")); 
dm.DisplayAllDocuments (}); 
IE (dm.IsDocumentAvailable) 
{ 
Document d = dm.GetDocument (}; 
Console.WriteLine{({d.content)}):; 
} 
} 


DocumentManager 现在 可 以 处 理 任何 实现 了 IDocument 接口 的 类 。 
在 示例 应 用 程序 中 介绍 了 接口 约束 。 泛 型 支持 几 种 约束 类 型 ， 如 表 5-1 所 示 。 


表 5-1 
约 ” 束 说 明 
where T: struct 对 于 结构 约束 ， 类 型 T 必须 是 值 类 型 
Where T: class 类 约束 指定 类 型 必须 是 引用 类 型 
where T: IFoo 指定 类 型 T 必须 实现 接口 IFoo 
where T: Foo 指定 类 型 T 必须 派生 目 基 类 Foo 
Where T: new 这 是 一 个 构造 函数 约束 ， 指 定 类 型 T 必须 有 一 个 默认 构造 函数 
where T1: T2 这 个 约束 也 可 以 指定 ， 类 型 T1 派生 自 泛 型 类 型 T2 
注意 : 


只 能 为 默认 构造 函数 定义 构造 函数 约束 ， 不 能 为 其 他 构造 函数 定义 构造 函数 约束 。 


使 用 泛 型 类 型 还 可 以 合并 多 个 约束 。where T: 下 oo. new0 约 束 和 MyYClass<T> 声 明 指 定 , 类 型 工 必须 实现 IFoo 
接口 ， 且 必须 有 一 个 默认 构造 函数 。 
Public class MyClass<T> 
Where T: IFoo, newt() 


| 
/7 
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注意 : 
在 C# 中 ，where 子 句 的 一 个 重要 限制 是 ， 不 能 定义 必须 由 泛 型 类 型 实现 的 运算 符 . 运算 符 不 能 在 接口 中 定 
义 。 在 where 子 句 中， 只 能 定义 基 类 、 接 口 和 默认 构造 函数 . 


5.3.3 继承 
前 面 创建 的 LinkedList<T> 类 实现 了 IEnumerable<T> 接 口 : 


Public class LinkedList<T>: IEnumerable<T> 
{ 
/1/.- 


泛 型 类 型 可 以 实现 泛 型 接口 ， 也 可 以 派生 目 一 个 类 。 泛 型 类 可 以 派生 目 泛 型 基 类 ， 
public class Base<T> 


{ 
} 


PuUblic class Derived<T>: Base<T> 
{ 
} 


其 要 求 是 必须 重复 接口 的 泛 型 类 型 ， 或 者 必须 指定 基 类 的 类 型 ， 如 下 例 所 示 : 
Public class Base<T> 


{ 
} 


Public class Derived<T>: Base<string> 
{ 
} 


于 是 ， 派 生 类 可 以 是 泛 型 类 或 非 泛 型 类 。 例 如 ， 可 以 定义 一 个 抽象 的 泛 型 基 类 ， 它 在 派生 类 中 用 一 个 具体 
的 类 实现 。 这 允许 对 特定 类 型 执行 特殊 的 操作 : 

PUublic abstract class Calc<T> 

public abstract T Add(T x, T vy); 


public abstract T Subl(T x, T Y); 
} 


PUublic class IntcCcalc: Calc<int> 
{ 
public override int Addi{int x, int vy) => x 十 Yi 
public override int Sublt{int x, int vy) => x 一 Yr 
} 


还 可 以 创建 一 个 部 分 的 特殊 操作 ， 如 从 Query 中 派生 StringQuery 类 ， 只 定义 一 个 泛 型 参数 ， 如 字符 串 
TResult。 要 实例 化 StrineQuery， 只 需要 提供 TRequest 的 类 型 ; 
Public class Query<TRegquest, TResult> 


{ 
} 


public StringQuery<TRequest> : Query<TRequest, string> 
{ 
} 


5.3.4 静态 成 员 


泛 型 类 的 静态 成 员 需 要 特别 关注 。 泛 型 类 的 静态 成 员 只 能 在 类 的 一 个 实例 中 共享 。 下 面 看 一 个 例子 ， 其 中 
StaticDemo<T=> 类 包含 静态 字段 x: 


public class StaticDemo<T> 
{ 

public static int x; 
} 


由 于 同时 对 一 个 string 类 型 和 一 个 int 类 型 使 用 了 StaticDemo<T> 头 ， 因 此 存在 两 组 静态 字段 ， 


StaticDemo<string>.X = 4; 
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StaticDemo<int>.X = 5; 
Console .WriteLine (StaticDemo<string>.x); // writes 4 


5.4 ” 泛 型 接口 


使 用 泛 型 可 以 定义 接口 , 在 接口 中 定义 的 方法 可 以 带 泛 型 参数 。 在 链表 的 示例 中 ,实现 了 IEnumerable<out T> 
接口 ， 它 定义 了 GetEnumerator0 方 法 ， 以 返回 IEnumerator<out T=>。NET 为 不 同 的 情况 提供 了 许多 泛 型 接口 ， 例 
如 ，IComparable<T>、ICollection<T> 和 IExtensibleObject<T>。 同 一 个 接口 常常 存在 比较 老 的 非 泛 型 版 本 ， 例 
如 ，.NET 1.0 有 基于 对 象 的 IComparable 接口 。IComparable<in T> 基 于 一 个 泛 型 类 型 : 

interface IComparable<in T> 


jnt CompareTo(T other); 


} 


注意 : 
不 要 混淆 用 于 泛 型 参数 的 mh 和 out 关键 字 。 参 见 5.4.1 节 “ 协 变 和 抗 变 ”。 


比较 老 的 非 泛 型 接口 IComparable 需要 一 个 带 CompareTo( 方 法 的 对 象 。 这 需要 强制 转换 为 特定 的 类 型 , 例 
Person 类 要 使 用 LastName 属性 ， 就 需要 使 用 CompareTo0 方 法 : 


public class Person: IComparable 
{ 
Public int CompareTo (object ob]j) 
{ 
Person other = ob] as Person; 
return this.lastname.CompareTo(other.LastName); 


如 


二 


} 
/1 
实现 泛 型 版 本 时 ， 不 再 需要 将 object 的 类 型 强制 转换 为 Person: 
public class Person: IComparable<Person> 
Public int CompareTo Person other) => LastName.CompareTo (other.LastName); 


FE 


5.4.1 协 变 和 抗 变 


在 .NET 4 之 前 , 泛 型 接口 是 不 变 的 , .NET 4 通过 协 变 和 抗 变 为 泛 型 接口 和 泛 型 委托 添加 了 一 个 重要 的 扩展 。 
协 变 和 抗 变 指 对 参数 和 返回 值 的 类 型 进行 转换 。 例 如 , 可 以 给 一 个 需要 Shape 参 数 的 方法 传送 Rectangle 参 数 吗 ? 
下 面 用 示例 说 明 这 些 扩展 的 优点 。 

在 NET 中 ,参数 类 型 是 抗 变 的 。 假 定 有 Shape 和 Rectangle 类 , Rectangle 类 派生 自 Shape 基 类 。 声 明 Display0) 
方法 是 为 了 接受 Shape 类 型 的 对 象 作 为 其 参数 : 

public void Display(Shape o) { } 

现在 可 以 传递 派生 自 Shape 基 类 的 任意 对 象 。 因 为 Rectangle 派生 自 Shape， 所 以 Rectangle 满足 Shape 的 
所 有 要 求 ， 编 译 器 接受 这 个 方法 调用 : 


Var Ir = new Rectangle 1{ Width= 5, Height=2.5 }; 
Display (r); 


方法 的 返回 类 型 是 协 变 的 。 当 方法 返回 一 个 Shape 时 ， 不 能 把 它 赋 予 Rectangle， 因 为 Shape 不 一 定 总 是 
Rectangle。 反 过 来 是 可 行 的 : 如 果 一 个 方法 像 GetRectangle0 方 法 那样 返回 一 个 Rectangle， 

Public Rectangle GetRectangle(); 

就 可 以 把 结果 赋予 某 个 Shape: 

Shape 5s = GetRectangle(}.; 


在 .NET Framework 4 版 本 之 前 ， 这 种 行为 方式 不 适用 于 没 型 。 目 C#4 以 后 , 扩展 后 的 语言 支持 泛 型 接口 和 
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泛 型 委托 的 协 变 和 抗 变 。 下 面 开 始 定义 Shape 基 类 和 Rectangle 类 (代码 文件 Variance/Shape.cs 和 Rectangle.cs): 


public class Shape 
{ 

public double Width { get; Setr } 

public double Height 1{ get; set; } 

public override string ToString() => $"Width: {Width}, Height: {Height}"; 
} 


Public class Rectangle: Shape 
{ 
} 


5.4.2” 泛 型 接口 的 协 变 


如 果 泛 型 类 型 用 out 关键 字 标 注 ， 泛 型 接口 就 是 协 变 的 。 这 也 意味 着 返回 类 型 只 能 是 TT。 接口 IIndex 与 类 
型 是 协 变 的 ， 并 从 一 个 只 读 索 引 器 中 返回 这 个 类 型 (代码 文件 Variance/TIndex.cs): 


public interface IIndex<out T> 
{ 
T this[int index] { get; } 
int Count { oqet; } 
} 


Imdex<T> 接 口 用 RectangleCollection 类 来 实现 。RectangleCollection 类 为 泛 型 类 型 定义 了 Rectanele: 


注意 : 

如 果 对 接口 Index 使 用 了 读 写 索引 器 ， 就 把 泛 型 类 型 工 传递 给 方法 ， 并 从 方法 中 检索 这 个 类 型 。 这 不 能 通 
过 协 变 来 实现 一 一 泛 型 类 型 必须 定义 为 不 变 的 。 不 使 用 out 和 ih 标注 ， 就 可 以 把 类 型 定义 为 不 变 的 (代码 文件 
Variance/RectangleCollection.cs)。 


Public class RectangleCollection: IIndex<Rectangle> 
{ 
private Rectangle[] data = new Rectangle[3] 
{ 
new Rectangle { Height=2, Width=5 }, 
new Rectangle { Height=3, Width=7 }, 
new Rectangle { Height=4.5, Width=2.9 } 
}; 


private static RectangleCollection coll; 
public static RectangleCollection GetRectangles() => 
Coll 32 ( coll = new RectangleCollection()); 


Public Rectangle thisl[int index] 
{ 
det 
{ 
if (index < 0 || index > data.Length) 
throw new ArgumentOutoOfRangeException (nameof (index) ); 
return data[lindexl]; 
} 
} 


public int Count => data.Length; 
} 


注意 : 

RectangleCollection.GetRectangles( 方 法 使 用 了 本 章 后 面 将 会 介绍 的 合并 运算 符 (coalescing operator)。 如果 变 
量 coll 为 null， 则 会 调用 运算 符 的 右 侧 ， 以 创建 RectangleCollection 的 一 个 新 实例 ， 并 将 其 赋 给 变量 coll。 之 
后 ， 会 从 GetRectangles0) 方 法 中 返回 变量 col11。 这 个 运算 符 详 见 第 6 章 。 


RectangleCollection.GetRectangle0 方 法 返回 一 个 实现 Index<Rectangle> 接 口 的 RectangleCollection 类 ， 所 以 可 
以 把 返回 值 赋予 IIndex<Rectangle> 类 型 的 变量 rectangle 。 因 为 接口 是 协 变 的 ， 所 以 也 可 以 把 返回 值 赋予 
Imdex<Shape> 类 型 的 变量 。Shape 不 需要 Rectangle 没有 提供 的 内 容 。 使 用 shapes 变量 ， 就 可 以 在 for 循环 中 使 用 
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接口 中 的 索引 器 和 Count 属性 (代码 文件 Variance/Proeram.cs): 
Public static void Malnl) 
{ 
IIndex<Rectangle> rectangles = RectangleCollection.GetRectangles (); 
IIndex<Shape> shapes = rectangles; 
for (ln i = 0; 1 < shapes.Count; 1++) 


Console.WriteLine (shapes[1i]); 


} 
5.4.3” 泛 型 接口 的 抗 变 


如 果 泛 型 类 型 用 in 关键 字 标 注 , 泛 型 接口 就 是 抗 变 的 。 这样, 接口 只 能 把 泛 型 类 型 用 作 其 方法 的 输入 ( 代 
码 文 件 Variance/IDisplay.cs): 
Public interface IDisplay<in T> 


VOI1Id Show{(T item).; 


ShapeDisplay 类 实现 IDisplay<Shape>, 并 使 用 Shape 对 象 作为 输入 参数 (代码 文件 Variance/ShapeDisplay.cs): 
Public class ShapeDisplay: IDisplay<Shape> 
{ 
Public void Show (Shape s) => 
Console .WriteLinet 
s"{s.GetType() .Name} Width: {s.Width}, Height: {ss.Height}"); 
} 
创建 ShapeDisplay 的 一 个 新 实例 ,会 返回 IDisplay<Shape>, 并 把 它 赋予 shapeDisplay 变量 。 因 为 IDisplay<T> 
是 抗 变 的 ， 所 以 可 以 把 结果 赋予 IDisplay<Rectangle>， 其 中 Rectanele 派生 上 自 Shape。 这 族 接 口 的 方法 只 能 把 泛 
型 类 型 定义 为 输入 ， 而 Rectangle 满足 Shape 的 所 有 要 求 (代码 文件 Variance/Program.cs): 
Public static void Main() 
{ 
A 
IDisplay<Shape> shapeDisplay = new ShapeDisplay(); 
IDisplay<Rectangle> rectangleDisplay = shapeDisplay; 


rectangleDisplay.show (rectangles[0]); 
} 


5.5 泛 型 结构 


与 类 相似 ， 结 构 也 可 以 是 泛 型 的 。 它 们 非常 类 似 于 沁 型 类 ， 只 是 没有 继承 特性 。 本 节 介 绍 泊 型 结构 
Nullable<T>， 它 由 .NET Framework 定义 。 

.NET Framewoik 中 的 一 个 泛 型 结构 是 Nullable<T=>。 数 据 库 中 的 数字 和 编程 语言 中 的 数字 有 显著 不 同 的 特 
征 ， 因 为 数据 库 中 的 数字 可 以 为 宇 ， 而 C# 中 的 数字 不 能 为 室 。Int32 是 一 个 结构 ， 而 结构 实现 同 值 类 型 ， 所 以 
结构 不 能 为 空 。 这 种 区 别 常 常 令 人 很 头痛 ， 映 射 数据 也 要 多 做 许多 辅助 工作 。 这 个 问题 不 仅 存在 于 数据 库 中 ， 
也 存在 于 把 XML 数据 映射 到 NET 类 型 。 

一 种 解决 方案 是 把 数据 库 和 XML 文件 中 的 数字 映射 为 引用 类 型 ， 因 为 引用 类 型 可 以 为 空 值 。 但 这 也 会 
在 运行 期 间 带 来 额外 的 系统 开销 。 

使 用 Nullable<T> 结 构 很 容易 解决 这 个 问题 。 下 面 的 代码 段 说 明了 如 何 定义 Nullable<T> 的 一 个 简化 版 本 。 结 
构 Nullable<T> 定 义 了 一 个 约束 : 其 中 的 泛 型 类 型 T 必须 是 一 个 结构 。 把 类 定义 为 泛 型 类 型 后 ， 就 没有 低 系统 
开销 这 个 优点 了 , 而 且 因 为 类 的 对 象 可 以 为 空 , 所 以 对 类 使 用 Nullable<T> 类 型 是 没有 意义 的 。 除 了 Nullable<T> 
定义 的 工 类 型 之 外 , 唯一 的 系统 开销 是 hasValue 布尔 字段 ， 它 确定 是 设置 对 应 的 值 ， 还 是 使 之 为 空 。 除 此 之 外 ， 
泛 型 结构 还 定义 了 只 读 属 性 HasValue 和 Value， 以 及 一 些 运 算 符 重 载 。 把 Nullable<T> 类 型 强制 转换 为 工 类 型 的 
运算 符 重 载 是 显 式 定 义 的 ， 因 为 当 hasValue 为 false 时 ， 它 会 抛 出 一 个 异常 。 强 制 转换 为 Nullable<T> 类 型 的 运 
算 符 重 载 定义 为 隐 式 的 ， 因 为 它 总 是 能 成 功 地 转换 ; 
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public struct Nullable<T> 
where T: struct 
{ 
public Nullable (T value) 
{ 
hasValue = truer 
value = Valuer 


} 


private bool hasValue; 
public bool HasValue => hasValue; 


private T value; 
public T Value 
{ 
det 
{ 
if {! hasValue) 
{ 
throw new InvalidoperationException("no TalLue") : 
} 
return value; 
} 
} 


Public static explicit operator T(Nullable<T> value) => value.Value; 


public static implicit operator Nullable<T>(T value) => 
new Nullable<T> (value); 


Public override string ToString() => !HasValue 2? string.Empty : 
value.ToSstring(}; 


} 

在 这 个 例子 中 ，Nullable<T=> 用 Nullable<int> 实 例 化 。 变 量 x 现在 可 以 用 作 一 个 int， 进 行 赋值 或 使 用 运算 符 
执行 一 些 计 算 。 这 是 因为 强制 转换 了 Nullable<T> 类 型 的 运算 符 。 但 是 ,x 还 可 以 为 空 。Nullable<T=> 的 HasValue 
和 Value 属性 可 以 检查 是 否 有 一 个 值 ， 该 值 是 否 可 以 访问 : 


Nullable<int> XX; 


二 45 
+= 37 
if (x.HasVvalue) 
{ 
int Yy = X.Value; 
} 


= null; 

因为 可 空 类 型 使 用 得 非常 频繁 , 所 以 C# 有 一 种 特殊 的 语法 , 它 用 于 定义 可 空 类 型 的 变量 , 定义 这 类 变量 时 ， 
不 使 用 泛 型 结构 的 语法 ， 而 使 用 “?” 运 算 符 。 在 下 面 的 例子 中 ， 变 量 x1 和 x2 都 是 可 空 的 int 类 型 的 实例 : 

Nullable<int> xl; 

int? x2; 

可 空 类 型 可 以 与 null 和 数字 比较 ， 如 上 所 示 。 这 里 ，x 的 值 与 null 比较 ， 如 果 x 不 是 null， 它 就 与 小 于 0 
的 值 比较 : 

int? x = GetNullableType (); 

if ( == null) 

: Console .WriteLine ("x 1S null™y).- 

} 

lse 1f (x < 0) 

{ 


Console.WriteLine("x LS smaller than 0").; 


} 
知道 了 Nullable<T> 是 如 何 定义 的 之 后 ， 下 面 就 使 用 可 空 类 型 。 可 空 类 型 还 可 以 与 算术 运算 符 一 起 使 用 。 变 
量 x3 是 变量 xl 和 x2 的 和 。 如 果 这 两 个 可 空 变量 中 任何 一 个 的 值 是 null， 它 们 的 和 就 是 null。 


int? XL = GetNullableType (}); 
int? x2 = GetNullableType (); 
int? x3 = Kl + 2. 


注意 : 
这 里 调用 的 GetNullableType0 方 法 只 是 一 个 占 位 符 , 它 对 于 任何 方法 都 返回 一 个 可 空 的 int. 为 了 进行 测试 ， 
简单 起 见 ， 可 以 使 实现 的 GetNullableType0 和 返回 null 或 返回 任意 整数 。 


非 可 空 类 型 可 以 转换 为 可 空 类 型 。 从 非 可 空 类 型 转换 为 可 空 类 型 时 ， 在 不 需要 强制 类 型 转换 的 地 方 可 以 进 
行 隐 式 转换 。 这 种 转换 总 是 成 功 的 : 


int YL = 4; 
lint? ZL = YL; 


但 从 可 空 类 型 转换 为 非 可 空 类 型 可 能 会 失败 。 如 果 可 空 类 型 的 值 是 null， 并 且 把 null 值 赋予 非 可 空 类 型 ， 
就 会 抛 出 InvalidOperationException 类 型 的 异 弟 。 这 就 是 需要 类 型 强制 转换 运算 符 进 行 显 式 转换 的 原因 : 


int? xl] = GetNullableType (); 
int YL = (int)})xl; 


如 果 不 进 行 显 式 类 型 转换 ， 还 可 以 使 用 合并 运算 符 从 可 空 类 型 转换 为 非 可 空 类 型 。 合 并 运算 符 的 语法 是 
“2?”， 为 转换 定义 了 一 个 默认 值 ， 以 防 可 空 类 型 的 值 是 null。 这 里 ， 如 果 xl 是 null，y1 的 值 就 是 0。 


int? X1L = GetNullableType (); 
int YL = xl1 23 0; 


5.6 ” 泛 型 万 法 


除了 定义 泛 型 类 之 外 ， 还 可 以 定义 泛 型 方法 。 在 泛 型 方法 中 ， 汉 型 类 型 用 方法 声明 来 定义 。 泛 型 方法 可 以 
在 非 泛 型 类 中 定义 。 
Swap<T>0 方 法 把 TT 定义 为 泛 型 类 型 ， 该 泛 型 类 型 用 于 两 个 参数 和 一 个 变量 temp: 


VOld Swap<T> (ref T x, ref T Y) 


把 泛 型 类 型 赋予 方法 调用 ， 就 可 以 调用 泛 型 方法 : 


int 1 = 4; 
int ] = 3s 
Swap<int> (ref i, ref J); 


但 是 ， 因 为 C# 编 译 器 会 通过 调用 Swap0 方 法 来 获取 参数 的 类 型 ， 所 以 不 需要 把 泛 型 类 型 赋予 方法 调用 。 
泛 型 方法 可 以 像 非 泛 型 方法 那样 调用 : 


int i = 4; 
int ] = 35» 
swap (ref 1, ref ]) ; 


5.6.1 泛 型 方法 示例 


下 面 的 例子 使 用 泛 型 方法 累加 集合 中 的 所 有 元 束 . 为 了 说 明 泛 型 方法 的 功能 , 下 面 使 用 包含 Name 和 了 Balance 
属性 的 Account 类 (代码 文件 GenericeMethods/Account.cs): 


public class Account 
{ 
Public string Name { get; } 
Public decimal Balance { get; } 
Public Account (string name, Decimal balance) 
{ 
Name = name; 
Balance = balance; 
} 
} 
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其 中 应 累加 余额 的 所 有 账户 操作 都 添加 到 List<AccounP 类 型 的 账户 列表 中 (代码 文件 
GenericMethods/Proeram.cs): 


Var accounts = new List<Account>1() 
{ 
new Account ("Christian™.", 1500)., 
new Account ("Stephanie™., 2200), 
new BAccount ("Angela™, 1800)., 
new Account ("Matthias", 2400), 
new Account ("Katharina™", 3800), 


}i; 

累加 所 有 Account 对 象 的 传统 方式 是 用 foreach 语句 遇 历 所 有 的 Account 对 象 , 如 下 所 示 。 foreach 语句 使 用 
IEnumerable 接口 迭代 集合 的 元 素 ， 所 以 AccumnulateSimple0 方 法 的 参数 是 IEnumerable 类 型 。foreach 语句 处 理 
实现 IEnumerable 接口 的 每 个 对 象 。 这 样 ，AccumulateSimple0 方 法 就 可 以 用 于 所 有 实现 [Enumerable<Account> 
接口 的 集合 类 。 在 这 个 方法 的 实现 代码 中 ， 直 接 访问 Account 对 象 的 Balance 属性 (代码 文件 
GenericMethods/Algorithms.cs): 

public static class Algorithms 

i static decimal Accumulatesimple (IEnumerable<Account> source) 


decimal sum = 0; 
foreach (Account a in source) 


{ 
sum 十 一 a.Balance; 
} 
return sum; 
} 
} 


AccumulateSimple0 方 法 的 调用 方式 如 下 ; 


decimal amount = Algorithms.AccumulateSimple (accounts); 


5.6.2 ” 带 约 束 的 泛 型 方法 


第 一 个 实现 代码 的 问题 是 ， 它 只 能 用 于 Account 对 象 。 使 用 泛 型 方法 就 可 以 避免 这 个 问题 。 

Accumulate0 方 法 的 第 二 个 版 本 接受 实现 了 IAccount 接口 的 任意 类 型 。 如 前 面 的 泛 型 类 所 述 ， 泛 型 类 型 可 
以 用 where 子 句 来 限制 。 用 于 泛 型 类 的 这 个 子 句 也 可 以 用 于 泛 型 方法 。Accumulate0 方 法 的 参数 改 为 
下 numerable<T>。 下 numerable<T> 是 泛 型 集合 类 实现 的 泛 型 接口 (代码 文件 GenericMethods/Algorithms.cs)。 


Public static decimal Accumulate<TAccount> (IEnumerable<TAccount> source) 
where TAccount: IAccount 

{ 
decimal sum = 0; 
foreach (TAccount a in source) 


{ 

Sum 十 一 a.Balance; 
} 
ITEturn Sumr 


} 
重 构 的 Account 类 现在 实现 接口 IAccount( 代 码 文件 GenericMethods/Account.cs): 


Public class Account: IAccount 
{ 
FA 


IAccount 接口 定义 了 只 读 属性 Balance 和 Name( 代 码 文 件 GenericMethods/IAccount.cs): 


Public interface IAccount 
{ 
decimal Balance { get; } 
string Name { get; } 
} 


将 Account 类 型 定义 为 泛 型 类 型 参数 ,就 可 以 调用 新 的 Accumulate0 方 法 (代码 文件 GenericMethods/Program cs): 


decimal amount = Algorithm.Accumulate<Account> (accounts); 
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因为 编译 器 会 从 方法 的 参数 类 型 中 目 动 推断 出 泛 型 类 型 参数 ， 所 以 以 如 下 方式 调用 Accumulate0 方 法 是 有 
效 的 : 


decimal amount = Algorithm.Accumulate (accounts); 


5.6.3” 带 委托 的 泛 型 方法 


泛 型 类 型 实现 IAccount 接口 的 要 求 过 于 严格 。 下 面 的 示例 提示 了 ， 如 何 通 过 传递 一 个 泛 型 委托 来 修改 
Accumulate0 方 法 。 第 8 章 详 细 介 绍 了 如 何 使 用 泛 型 委托 ， 以 及 如 何 使 用 lambda 表达 式 。 
这 个 Accumnulate0 方 法 使 用 两 个 泛 型 参数 TI 和 T2。 第 一 个 参数 T1 用 于 实现 IEnumerable<T1> 参 数 的 集合 ， 
第 二 个 参数 使 用 泛 型 委托 Func<T1. T2. TResult>。 其 中 ,第 2 个 和 第 3 个 泛 型 参数 都 是 T2 类 型 。 需 要 传递 的 方 
法 有 两 个 输入 参数 (T1 和 T2) 和 一 个 T2 类 型 的 返回 值 (代码 文件 GenericMethods/Algorithms.cs): 
Public static T2 Accumulate<T1, T2> (IEnumerable<T1l> source ， 
FUNC<T1, T2, T2> actlion) 
| Tz sum = default (T2).，; 
foreach (Tl1 item in source) 
sum = action(item, sum); 
} 


Ireturn Sum; 


} 

在 调用 这 个 方法 时 , 需要 指定 泛 型 参数 类 型 ， 因为 编译 器 不 能 目 动 推断 出 该 类 型 。 对 于 方法 的 第 1 个 参数 ， 
所 赋予 的 accounts 集合 是 IEnumerable<Account> 类 型 .对 于 第 2 个 参数 , 使 用 一 个 lambda 表达 式 来 定义 Account 
和 decimal 类 型 的 两 个 参数 ， 返 回 一 个 小 数 。 对 于 每 一 项 ， 通 过 Accumulate0 方 法 调用 这 个 lambda 表达 式 (代码 
文件 GenericMethods/Program.cs): 


decimal amount = 员 1gorIthm.aAaccumulate<account ，aqeclmal> (人 
accounts, (item, sum) => sum += item.Balance); 


不 要 为 这 种 语法 伤 脑筋 。 该 示例 仅 说 明了 扩展 Accumulate0 方 法 的 可 能 方式 。lambda 表达 式 详 见 第 8 章 。 
5.6.4 泛 型 方法 规范 


泛 型 方法 可 以 重 载 ， 为 特定 的 类 型 定义 规范 。 这 也 适用 于 带 泛 型 参数 的 方法 。Foo0 方 法 定义 了 4 个 版 本 ， 
第 1 个 版 本 接受 一 个 泛 型 参数 ， 第 2 个 版 本 是 用 于 int 参数 的 专用 版 本 。 第 3 个 Foo 方法 接受 两 个 泛 型 参数 ， 
第 4 个 版 本 是 第 3 个 版 本 的 专用 版 本 ， 其 第 一 个 参数 是 int 类 型 。 在 编译 期 间 ， 会 使 用 最 佳 匹配 。 如 果 传 递 了 
一 个 int， 就 选择 带 int 参数 的 方法 。 对 于 任何 其 他 参数 类 型 ， 编 译 器 会 选择 方法 的 泛 型 版 本 (代码 文件 
Specialization/Proeram.cs): 


public class MethodOverloads 
{ 
public void Foo<T>{(T ob]) => 
Console.WriteLine($"Foo<T>(T ob]) ，ob] type: {ob]j .GetType () .Name}"); 


Public void Fool(int x) => 
Console.WriteLine ("Foo(int x)}"); 


public void Foo<T1，T2>(T1 objl, T2 obj2) => 
Console.WriteLine ($"Foo<T]1, T2>(T1 objl, T2 obj2); ™ + 
s"{objl.SGetType() .Name} {ob]j2.GetType() .Name}"); 


Public void Foo<T> (int ob]jl, T ob]j2) => 
Console.WriteLine($"Foo<T> (Int objl, T obj2); {obj2.GetType() .Name}"); 


public void Bar<T>(T obj) => Foo (obj); 


} 
Foo0 方 法 现在 可 以 通过 任意 参数 类 型 来 调用 。 下 面 的 示例 代码 传递 了 int 和 string 值 ， 调 用 所 有 4 个 Foo 
方法 : 


static volid Maint{) 
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{ 
var test = new MethodOwverloads (); 
test.Foo(33); 
test.Foo ("abc™); 
test.Foo{("abc™"™, 42)，; 
test.Foo(33,. "abc™),; 
} 
运行 该 程序 ， 可 以 从 输出 中 看 出 选择 了 最 佳 匹配 的 方法 : 
Foo (int x) 
Foo<T> (T obj), ob] type: String 


FOO<T1, T2>({T1 objl, T2 ob]j2); String Int32 
FOO<T> (int objl, T ob]j2); String 


需要 注意 的 是 ,所 调用 的 方法 是 在 编译 期 间 而 不 是 运行 期 间 定义 的 。 这 很 容易 举例 说 明 : 添加 一 个 调用 Foo0 
方法 的 Bar0 泛 型 方法 ， 并 传递 泛 型 参数 值 : 

public class MethodOverloads 

jf ss 


public void Bar<T> (T ob]) => 
Eoo (opb] ) ; 


Main0 方 法 现在 改 为 调用 传递 一 个 int 值 的 Bar0 方 法 : 


static woid Malinr) 

{ 
Var test = new MethodOverloads'().; 
test .Bar (44) ; 


从 控制 台 的 输出 可 以 看 出 ，Bar0 方 法 选择 了 泛 型 Foo0 方 法 ， 而 不 是 选择 用 int 参数 重 载 的 Foo0 方 法 。 原 
因 是 编译 器 是 在 编译 期 间 选 择 Bar0 方 法 调用 的 Foo0 方 法 。 由 于 Bar0 方 法 定义 了 一 个 泛 型 参数 , 而 且 泛 型 Foo() 
方法 匹配 这 个 类 型 ， 因 此 调用 了 Foo0 方 法 。 在 运行 期 间 给 Bar0 方 法 传递 一 个 int 值 不 会 改变 这 一 反 。 


FOO<T> (IT ob]) ，ob] type: Int32 
5.7 小结 


本 章 介 绍 了 CLR 中 一 个 非常 重要 的 特性 ; 泛 型 。 通过 泛 型 类 可 以 创建 独立 于 类 型 的 类 , 泛 型 方法 是 独立 于 
类 型 的 方法 。 接 口 、 结 构 和 委托 也 可 以 用 泛 型 的 方式 创建 。 泛 型 引入 了 一 种 新 的 编程 方式 。 我 们 介绍 了 如 何 实 
现 相应 的 算法 (尤其 是 操作 和 谓词 ) 以 用 于 不 同 的 类 ， 而 且 它 们 都 是 类 型 安全 的 。 泛 型 委托 可 以 去 除 集合 中 的 
算法 。 

本 书 还 将 探讨 泛 型 的 更 多 特性 和 用 法 。 第 8 章 介 绍 了 常 第 实现 为 泛 型 的 委托 ， 第 10 章 论述 了 泛 型 集合 类 ， 
第 12 章 讨 论 了 泛 型 扩展 方法 。 第 6 章 说 明了 运算 符 和 强制 类 型 转换 。 


第 


运算 符 和 类 型 强制 转换 


本 草 要 所 


C# 中 的 运算 符 

使 用 nameof 运算 符 和 空 值 条 件 运 算 符 
隐 式 和 显 式 转换 

使 用 装 箱 技术 把 值 类 型 转换 为 引用 类 型 
比较 值 类 型 和 引用 类 型 

重 载 标准 的 运算 符 以 支持 自 定 义 类 型 
实现 索引 运算 符 

通过 类 型 强制 转换 在 引用 类 型 之 间 转 换 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 OperatorsAndCasts 目录 
的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 


事 


6.1 


OperatorsSample 
BinaryCalculations 
OperatorOverloadineSample 
OperatorOverloadineSample2 
OverloadineComparisonSample 
CustomIndexerSample 
CastneSample 


运算 符 和 类 型 转换 


前 几 章 介绍 了 使 用 C# 编 写 有 用 程序 所 需要 的 大 部 分 知识 。 本 重 将 首先 讨论 基本 语言 元 素 ， 接 着 论述 C# 语 
言 的 强大 扩展 功能 。 

本 草 介 绍 使 用 运算 符 的 内 容 ， 包 括 C# 6 添加 的 运算 符 ， 例 如 空 值 条 件 运 算 符 和 nameof 运算 符 ， 以 及 C#7 
的 运算 符 扩 展 ， 例 如 is 运算 符 的 模式 匹配 。 本 章 后 面 将 讨论 运算 符 的 重 载 。 本 章 还 会 解释 如 何 使 用 运算 符 实现 
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6.2 ”运算 符 


C# 运 算 符 非常 类 似 于 C+ 和 Java 运算 符 ， 但 有 一 些 区 别 。 
C# 支 持 表 6-1 中 的 运算 符 。 


表 6-1 
类 别 运 算 符 
算术 运算 符 + 一 站 1 % 
逻辑 运算 符 人 | ~ && | |! 
字 稚 串 连 接 运算 符 一 
递增 和 递减 运算 得 ++ 一 一 
移 位 运算 符 < > 
比较 运算 符 一 一 -< 一 > 一 
赋值 运算 符 = 二 -= + 一 上 三 9% 一 &= 片 儿 < 一 >> 一 
成 员 访问 运算 符 ( 用 于 对 象 和 结构 ) 
索引 运算 符 ( 用 于 数组 和 索引 器 ) [0] 
类 型 转换 运算 符 
条 件 运算 符 ( 三 元 运算 符 ) 和 
委托 连接 和 删除 运算 符 ( 见 第 8 章 ) ee 
对 象 创建 运算 符 new 
类 型 信息 运算 符 sizeof is typeof as 
洲 出 异常 控制 运算 符 checked unchecked 
间接 寻 址 运算 符 [0] 
名 称 空间 别名 限定 符 ( 见 第 2 章 ) 了 
空 合并 运算 符 ?9 
空 值 条 件 运 算 符 ?.3[] 
标识 符 的 名 称 运算 符 nameof() 
注意 : 


有 4 个 运算 符 (sizeof、*、-> 和 &) 只 能 用 于 不 安全 的 代码 (这 些 代码 忽略 了 C# 的 类 型 安全 性 检查 )， 这 些 不 安 
全 的 代码 见 第 5 章 的 讨论 ，。 


使 用 C# 运 算 符 的 一 个 最 大 缺点 是 ， 与 C 风格 的 语言 一 样 ， 对 于 赋值 志和 比较 (一 ) 运 算 ，C# 使 用 不 同 的 运 
算 符 。 例 如 ， 下 述 语句 表示 “使 x 等 于 3”: 

二 37 

如 果 要 比较 X 和 另 一 个 值 ， 束 需要 使 用 两 个 等 号 (一 ): 


if {x = 3}) // compiler error 
{ 
} 


广 运 的 是 ，C# 非 第 严格 的 类 型 安全 规则 防止 出 现 常 见 的 C 错误 , 也 就 是 在 逻辑 语句 中 使 用 赋值 运算 符 代 蔡 
比较 运算 答 。 在 C# 中 ， 下 述 语 句 会 产生 一 个 编译 器 错误 : 


if {x = 3) // compiler error 
{ 
} 
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习惯 使 用 与 字符 (&) 来 连接 字符 串 的 Visual Basic 程序 员 必 须 改变 这 个 习惯 。 在 C# 中 ， 使 用 加 号 (+) 连 接 字 
符 串 ,而 & 符 号 表示 两 个 不 同 整数 值 的 按 位 AND 运算 。| 符 号 则 在 两 个 整数 之 间 执行 按 位 OR 运算 。Visual Basic 
程序 员 可 能 还 没有 使 用 过 取 模 (%6) 运 算 符 ， 它 返回 除 运算 的 余数 ， 例 如 ， 如 果 x 等 于 7， 则 x% 5 会 返回 2.。 

在 c# 中 很 少 会 用 到 指针 ,因此 也 很 少 用 到 间接 寻 址 运算 符 (->)。 使 用 它们 的 唯一 场合 是 在 不 安全 的 代码 块 中 ， 
因为 只 有 在 此 c# 才 人 允许 使 用 指针 。 指 针 和 不 安全 的 代码 见 第 17 章 。 


6.2.1 运算 符 的 简化 操作 
表 6-2 列 出 了 c# 中 的 全 部 简化 赋值 运算 符 。 


表 6-2 
简化 运算 符 等 价 于 

XT 蕊 二 下 十 1 
六--.-- 尺 蕊 二 及 一 ] 

Xt=Yy 下 二 四 十 YY 
和 下 二 下 一 了 
xX*=Yy X= *y 
xX/=Y X=X/y 
X=Yy X=XVy 
Ky 二 有 >Yy 
<<—=Yy 二 < 
XYy 处 二 处 硫 y 
xFy x=xX|y 


为 什么 用 两 个 例子 来 分 别 说 明 + 弟 增 和 一 递减 运算 答 ? 把 运算 符 放 在 表达 式 的 前 面 称 为 前 置 ， 把 运算 符 放 
在 表达 式 的 后 面 称 为 后 置 。 要 点 是 注意 它们 的 行为 方式 有 所 不 同 。 

递增 或 递减 运算 符 可 以 作用 于 整个 表达 式 ， 也 可 以 作用 于 表达 式 的 内 部 。 当 xHH 和 +HX 单独 占 一 行 时 ， 它 
们 的 作用 是 相同 的 ， 对 应 于 语句 x=xX+1。 但 当 它 们 用 于 较 长 的 表达 式 内 部 时 ， 把 运算 符 放 在 前 面 (t+x) 会 在 计 
算 表 达 式 之 前 递增 x;， 换言之， 递增 了 x 后， 在 表达 式 中 使 用 新 值 进行 计算 。 而 把 运算 符 放 在 后 面 (x++) 会 在 计 
算 表达 式 之 后 递增 x 一 一 使 用 x 的 原始 值 计算 表达 式 。 下 面 的 例子 使 用 ++ 增 量 运 算 符 说 明了 它们 的 区 别 (代码 文 
件 OperatorsSample/Program.cs): 


int XK = 5; 
if (++X == 6) // true 一 XxX is incremented to 6 before the evaluation 
{ 


Console.WriteLine ("This will execute™).; 


if {xt++ == 7) // false - xX is incremented to 7 after the evaluation 
{ 


Console .WriteLine ("This won't™).- 


判断 第 一 个 过 条 件 得 到 trme， 因 为 在 计算 表达 式 之 前 ,x 值 从 5 递增 为 6。 然而 ,第 二 条 于 语句 中 的 条 件 为 
false， 因 为 在 计算 整个 表达 式 (x 一 6) 后 ，x 值 才 递增 为 7。 

前 置 运算 符 一 x 和 后 置 运算 符 x 一 与 此 类 似 ， 但 它们 是 递减 ， 而 不 是 递增 。 

其 他 简化 运算 和 从， 如 += 和 -=， 需 要 两 个 操作 数 ， 通 过 对 第 一 个 操作 数 执行 算术 、 逻 辑 运算 ， 从 而 改变 该 操 
作 数 的 值 。 例 如 ， 下 面 两 行 代码 是 等 价 的 : 


下 十 一 人: 
下 二 到 十 5; 


下 面 介 绍 在 C# 代 码 中 频繁 使 用 的 基本 运算 得 和 类 型 强制 转换 运算 符 。 
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1. 条 件 运 算 符 

条 件 运 算得 (?:) 也 称 为 三 元 运算 符 ， 是 让 ..else 结构 的 简化 形式 。 其 名 称 的 出 处 是 它 带 有 3 个 操作 数 。 它 首 
先 判 断 一 个 条 件 ， 如 果 条 件 为 真 ， 就 返回 一 个 值 ， 如 果 条 件 为 假 ， 则 返回 男 一 个 值 。 其 语法 如 下 : 

condition ? true value: false value 

其 中 condition 是 要 判断 的 布尔 表达 式 ，true value 是 condition 为 真 时 返回 的 值 ，false value 是 condition 为 
假 时 返回 的 值 。 

恰当 地 使 用 三 元 运算 符 ， 可 以 使 程序 非常 简洁 。 它 特别 适合 于 给 调用 的 函数 提供 两 个 参数 中 的 一 个 。 使 用 
它 可 以 把 布尔 值 快速 转换 为 字符 串 值 true 或 false。 它 也 很 适合 于 显示 正确 的 单数 形式 或 复数 形式 (代码 文件 
OperatorsSample/Proeram.cs): 

int x = 1; 

string Ss = + ™ ™ 


s += (x == 1 2 man": "men™); 
Console .WriteLine (s}); 


如 果 X 等 于 1， 这 段 代码 就 显示 1 man; 如 果 X 等 于 其 他 数 ， 就 显示 其 正确 的 复数 形式 。 但 要 注意 ， 如 果 结 果 
需要 本 地 化 为 不 同 的 语言 ， 就 必须 编写 更 复杂 的 例 程 ， 以 考虑 到 不 同 语言 的 不 同 语法 规则 。 


2. checked 和 unchecked 运算 符 


byte b = byte.MaxValues 
bb 二 十; 


Console -WriteLine (b) ; 

byte 数据 类 型 只 能 包含 0~255 的 数 ， 给 byte.MaxValue 分 配 一 个 字 节 ， 得 到 255。 对 于 255， 字 节 中 所 有 可 
用 的 8 个 位 都 得 到 设置 : 11111111。 所 以 递增 这 个 值 会 导致 溢出 ， 得 到 0。 

CLR 如 何 处 理 这 个 洲 出 取决 于 许多 因素 ,包括 编译 器 选项 ， 所 以 只 要 有 未 预料 到 的 洲 出 风险 ， 就 需要 用 某 
种 方式 确保 得 到 我 们 希望 的 结果 。 

为 此 , C# 提 供 了 checked 和 unchecked 运算 得 。 如 果 把 一 个 代码 块 标记 为 checked, CLR 就 会 执行 洲 出 检查 ， 
如 果 发 生 洲 出 ， 就 抛 出 OverflowException 异常 。 下 面 修改 上 述 代 码 ， 使 之 包含 checked 运算 符 ( 代 码 文件 
OperatorsSample/Proeram.cs): 


byte b = 2595; 
Checked 
{ 
了 十 十 ; 
} 


Console .WriteLine (DY ; 


运行 这 段 代 码 ， 就 会 得 到 一 条 错误 信息 : 

System.OverflowException: Arithmetic operation resulted in an overflow. 

使 用 Advance Build Settings 中 的 Visual Studio 项 目 设 置 Check for Arithmetic Overflow/Underflow,， 可 以 对 所 
有 未 标记 的 代码 进行 溢出 检查 。 也 可 以 直接 在 项 目 文件 中 改变 它 : 


<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
<CheckForOverflowUnderflow>true</CheckForOQverflowUnderflow> 
</PropertySroup> 


如 果 要 禁止 洲 出 检查 ， 则 可 以 把 代码 标记 为 unchecked: 


byte b = 之 3938 
unchecked 
{ 

bt++; 


Console .WriteLine (b):; 
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在 本 例 中 不 会 抛 出 异常 ， 但 会 丢失 数据 一 一 因为 byte 数据 类 型 不 能 包含 256， 溢 出 的 位 会 被 丢弃 ， 所 以 b 
变量 得 到 的 值 是 0。 

注意 ，unchecked 是 默认 行为 。 只 有 在 需要 把 几 行 未 检查 的 代码 放 在 一 个 显 式 标记 为 checked 的 大 代码 块 中 
时 ， 才 需要 显 式 地 使 用 unchecked 关键 字 。 


注意 : 

默认 不 检查 上 溢出 和 下 溢出 ， 因 为 执行 检查 会 影响 性 能 。 使 用 checked 作为 默认 设置 时 ， 每 一 个 算术 运算 
的 结果 都 需要 验证 其 值 是 否 越 界 。 算术 运算 也 可 以 用 于 使 用 it+ 的 for 循环 中 。 为 了 避免 这 种 性 能 影响 ， 最 好 一 
直 不 使 用 默认 设置 [Check for Arithmetic Overflow/ Underflow)， 在 需要 时 使 用 checked 运算 符 。 


3. is 运算 符 

is 运算 和 从 可 以 检查 对 象 是 否 与 特定 的 类 型 兼容 。 短语 “ 菩 容 ” 表 示 对 象 或 者 是 该 类 型 ,或 者 派生 目 该 类 型 。 
例如 ， 要 检查 变量 是 否 与 object 类 型 兼容 ， 可 以 使 用 下 面 的 代码 (代码 文件 OperatorsSample/Program.cs): 

int 1 = 10; 

if (i is object) 


Console.WriteLine ("i is an object"),; 


} 

int 和 所 有 C# 数 据 类 型 一 样 ， 也 从 object 继承 而 来 ， 在 本 例 中 ， 表 达 式 i is object 将 为 tue， 并 显示 相应 的 
消息 。 
C# 7 扩展 了 具有 类 型 匹配 的 is 运算 符 。 可 以 检查 常量 、 类 型 和 var。 下 面 的 代码 片段 显示 了 常量 检查 的 示 
例 ， 它 检查 常量 42 和 常量 pull: 

int 1 = 42- 

if (i is A42) 

Console.WriteLine ("i has the Value 42"); 


} 


object oO = null; 
if {eo is null) 
{ 


Console .WriteLine{("™o is null™): 


使 用 具有 类 型 匹配 的 is 运算 从， 可 以 在 类 型 的 右边 声明 变量 。 如 果 is 运算 符 返 回 tue， 则 该 变量 通过 对 该 
类 型 的 对 象 的 引用 来 填充 。 然 后 ， 可 以 在 使 用 is 运算 符 的 让 语句 范围 内 使 用 该 变量 : 


Public static vold AMethodUsingPatternMatching (object o) 
{ 
if (oo Is Person p) 
{ 
Console.WriteLine($"o is a Person with firstname {p.FirstName}").,; 
} 
} 
i 
AMethodUsingPatternMatching (new Person("Katharina™., "Nagel™)); 


4. as 运算 符 

as 运算 和 从 用 于 执行 引用 类 型 的 显 式 类 型 转换 。 如 果 要 转换 的 类 型 与 指定 的 类 型 兼容 ， 转 换 就 会 成 功 进行 ; 
如 果 类 型 不 兼容 ，as 运算 符 就 会 返回 null 值 。 如 下 面 的 代码 所 示 ， 如 果 object 引用 实际 上 不 引用 string 实例 ， 
把 object 引用 转换 为 string 就 会 返回 null( 代 码 文件 OperatorsSample/Program.cs): 


object ol = "Some String™; 

object o2 = 5; 

string sl1 = ol as string; // sl1 = "Some String" 
string s2 = Oo2 as string; // s2 = null 


as 运算 符 允 许 在 一 步 中 进行 安全 的 类 型 转换 ， 不 需要 先 使 用 is 运算 符 测 试 类 型 ， 再 执行 转换 。 
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注意 : 
is 和 as 运算 符 也 用 于 继承 ， 参 见 第 4 章 。 模 式 匹 配 和 运算 符 的 更 多 内 容 参 见 第 13 章 。 
5. Sizeof 运算 符 


使 用 sizeof 运算 符 可 以 确定 栈 中 值 类 型 需要 的 长 度 ( 单 位 是 字 节 ) (代码 文件 OperatorsSample/Program .cs): 

ConSsoOlEe -WIILeLILInEISLZecOE (1nt)):; 

其 结果 是 显示 数字 4， 因 为 int 有 4 个 字 节 长 。 

如 果 结 构 体 只 包含 值 类 型 ， 也 可 以 使 用 sizeof 运算 符 和 结构 
OperatorsSample/Pomnt.cs): 


如 下 所 示 的 Point 类 (代码 文件 


Public struct Point 
{ 
public Point(int x, int Y) 


有 
vy 


Er 

Yr 

} 

public int X { get; } 
public int Y { get; } 


} 
注意 : 
类 不 能 使 用 sizeof 运 算 符 。 


如 果 对 复杂 类 型 (而 非 基 本 类 型 ) 使 用 sizeof 运算 符 ， 就 需要 把 代码 放 在 unsafe 块 中 ， 如 下 所 示 ( 代 码 文件 
OperatorsSample/Proeram.cs): 
unsafe 


Console .WriteLine (sizeof (Point))}): 


注意 ， 
默认 情况 下 不 允许 使 用 不 安全 的 代码 ， 需 要 在 csproj 项 目 文件 中 指定 AllowUnsafeBlocks。 第 17 章 将 详细 
论述 不 安全 的 代码 。 


6. typeof 运算 符 


typeof 运算 符 返 回 一 个 表示 特定 类 型 的 System.Type 对 象 。 例如 , typeoflstring) 返 回 表示 System.String 
类 型 的 Type 对 象 。 在 使 用 反射 技术 动态 地 碍 找 对 象 的 相关 信息 时 ， 这 个 运算 符 很 有 用 。 第 16 草 将 介绍 反射 。 


7. nameof 运算 符 


nameof 是 新 的 C# 6 运算 符 。 该 运算 符 接 受 一 个 符号 、 属 性 或 方法 ， 并 返回 其 名 称 。 
这 个 运算 符 如 何 使 用 ? 一 个 例子 是 需要 一 个 变量 的 名 称 时 ， 如 检查 参数 是 否 为 null 
Public void Method (object o) 


{ 
if (o == null) throw new ArgumentNullException (nameof (co) ) : 


当然 ， 这 类 似 于 传递 一 个 字符 串 而 不 是 使 用 nameof 运算 符 来 抛 出 异常 。 然 而 ， 如 果 名 称 拼 错 ， 传 递 字符 串 
并 不 会 显示 一 个 编译 器 错误 。 另 外 ， 改 变 参 数 的 名 称 时 ， 就 很 容易 扎 记 更 改 传 递 到 ArgumentNullException 构造 
函数 的 字符 串 。 

if (oo == nul1) throw new RATrOIuUmentNuU1L1IEXCeptIon("O") 7 

对 变量 的 名 称 使 用 nameof 运算 符 只 是 一 个 用 例 。 还 可 以 使 用 它 得 到 属性 的 名 称 ， 例 如 ， 在 属性 set 访问 器 
中 触发 改变 事件 (使 用 INotifyPropertyChanged 接口 )， 并 传递 属性 的 名 称 。 


Public string FirstName 
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get => firstName; 
Set 
{ 
firstName = value; 
OnFPropertyChanged (nameof (FirstNMame)):; 
} 
} 


nameof 运算 符 也 可 以 用 来 得 到 方法 的 名 称 。 如 果 方 法 是 重 载 的 ， 它 同样 适用 ， 因 为 所 有 的 重 载 版 本 都 得 到 
相同 的 值 ， 方法 的 名 称 。 
Public void MethoaI() 


{ 
Log(s$"{nameof (Method) } called™); 


8. index 运算 符 
在 第 7 章 “ 数 组 ”中 将 使 用 索引 运算 符 ( 括 号 ) 访 问 数组 。 这 里 传递 数值 2， 使 用 索引 运算 和 从 访问 数组 arrl 
的 第 三 个 元 素 : 


int[] arrl = {1i, 2, 3, 4}; 
int x = arrl[l2]; //x=— 3 


类 似 于 访问 数组 元 素 ， 索 引 运算 符 用 集合 类 实现 (参见 第 10 章 )。 

索引 运算 符 不 需要 把 整数 放 在 括号 内 ， 并 且 可 以 用 任何 类 型 定义 。 下 面 的 代码 片段 创建 了 一 个 泛 型 字典 ， 
其 键 是 一 个 字符 串 ， 值 是 一 个 整数 。 在 字典 中 ， 键 可 以 与 索引 器 一 起 使 用 。 在 下 面 的 示例 中 ， 字 符 串 fst 传递 
给 索引 运算 符 ， 以 设置 字典 里 的 这 个 元 素 ， 然 后 把 相同 的 字符 串 传 递 给 索引 器 来 检索 此 元 素 : 

Var dict = new Dictionary<string, int>(}); 


dict["first™"] = 1- 
int Xx = dict["first"™"]:- 


让 二 
本 章 后 面 的 6.6 节 “ 实 现 自 定义 的 索引 运算 符 ” 将 介绍 如 何在 自己 的 类 中 创建 索引 运算 符 。 


9. 可 空 类 型 和 运算 符 


值 类 型 和 引用 类 型 的 一 个 重要 区 别 是 ， 引 用 类 型 可 以 为 空 。 值 类 型 (如 inb 不 能 为 衬 。 把 C# 类 型 映射 到 数据 
库 类 型 时 ， 这 是 一 个 特殊 的 问题 。 数 据 库 中 的 数值 可 以 为 空 。 在 早期 的 C# 版 本 中 ,一 个 解决 方案 是 使 用 引用 类 
型 来 映射 可 空 的 数据 库 数 值 。 然 而 ， 这 种 方法 会 影 啊 性能， 因为 垃圾 收集 器 需要 处 理 引 用 类 型 。 现 在 可 以 使 用 
可 空 的 int 来 普 代 正常 的 int。 其 开销 只 是 使 用 一 个 额外 的 布尔 值 来 检查 或 设置 空 值 。 可 空 类 型 仍然 是 值 类 型 。 

在 下 面 的 代码 片段 中 ， 变 量 il 是 一 个 int， 并 给 它 分 配 1。i2 是 一 个 可 空 的 int， 给 它 分 配 让。 可 空 性 使 用 ? 
和 类 型 来 定义 。 给 int? 分 配 整数 值 的 方式 类 似 于 il 的 分 配 。 变 量 3 表明 ， 也 可 以 给 可 空 类 型 分 配 null( 代 码 文 
件 NullableTypesSample/Program.cs)。 

int il = 1; 


int? i2 = 卫 : 
int?3 13 = null: 


每 个 结构 都 可 以 定义 为 可 空 类 型 ， 如 下 面 的 long? 和 DateTime? 所 示 : 


long? 11 = null; 
DateTime? dl1 = null.: 


如 果 在 程序 中 使 用 可 空 类 型 ， 束 必须 考虑 null 值 在 与 各 种 运算 符 一 起 使 用 时 的 影响 。 通 党 可 空 类 型 与 一 元 
或 二 元 运算 和 从 一 起 使 用 时 ， 如 果 其 中 一 个 操作 数 或 两 个 操作 数 都 是 null， 其 结果 就 是 null。 例 如 : 

0 - fy b= null 

int2 GG =a* 5 /c= mll 

但 是 在 比较 可 空 类 型 时 ， 只 要 有 一 个 操作 数 是 null， 比 较 的 结果 就 是 锯 lse。 即 不 能 因为 一 个 条 件 是 旬 se， 就 认 
为 该 条 件 的 对 立 面 是 tve， 这 种 情况 在 使 用 非 可 空 类 型 的 程序 中 很 常见 。 例 如 ， 在 下 面 的 例子 中 ， 如 果 a 是 空 ， 则 
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无 论 b 的 值 是 +5 还 是 -5， 总 是 会 调用 else 子 句 : 


int? a = null: 

1nt2? B= 一 5: 

if (a >= b) // if a or b is null, this condition is false 
Console .WriteLine("a > 一 b"}y: 

} 

= 

{ 
Console .WriteLine({"a < b").-: 


} 


注意 : 
null 值 的 可 能 性 表示 ,不 能 随意 合并 表达 式 中 的 可 空 类 型 和 非 可 空 类 型 , 详 见 6.3.1 节 “ 类 型 转换 ”的 内 容 。 


注意 : 
使 用 C# 关 键 字 ?和 类 型 声明 时 ， 例 如 int ?， 编 译 器 会 解析 它 ， 以 使 用 泛 型 类 型 Nullable<int>。C# 编 译 器 把 


速记 符号 转换 为 泛 型 类 型 ， 来 减少 输入 量 。 


10. 空 合并 运算 符 
空 合并 运算 符 (??) 提 供 了 一 种 快捷 方式 ， 可 以 在 处 理 可 空 类 型 和 引用 类 型 时 表示 mull 值 的 可 能 性 。 这 个 运算 


符 放 在 两 个 操作 数 之 间 ， 第 一 个 操作 数 必 须 是 一 个 可 空 类 型 或 引用 类 型 ， 第 二 个 操作 数 必须 与 第 一 个 操作 数 的 类 
型 相同 ， 或 者 可 以 隐 式 地 转换 为 第 一 个 操作 数 的 类 型 。 空 合并 运算 从 的 计算 如 下 : 


e 如 果 第 一 个 操作 数 不 是 null， 整 个 表达 式 就 等 于 第 一 个 操作 数 的 值 。 
。 如 果 第 一 个 操作 数 是 null， 整 个 表达 式 束 等 于 第 二 个 操作 数 的 值 。 


int? a = null; 

int b; 

b= a 22? 10; // b has the value 10 
旦 二 3; 


b= a ?2? 10; // b has the value 3 
如 果 第 二 个 操作 数 不 能 隐 式 地 转换 为 第 一 个 操作 数 的 类 型 ， 就 生成 一 个 编译 时 错误 。 
空 合并 运算 符 不 仅 对 可 空 类 型 很 重要 ， 对 引用 类 型 也 很 重要 。 在 下 面 的 代码 片段 中 ， 属 性 Val 只 有 在 不 


为 空 时 才 返 回 _val 变量 的 值 。 如 果 它 为 空 ， 就 创建 MyClass 的 一 个 新 实例 ， 分 配给 _val 变量 ， 最 后 从 属性 中 返 


回 。 


只 有 在 变量 val 为 空 时 ， 才 执行 get 访问 器 中 表达 式 的 第 二 部 分 。 
private MyClass wal; 
public MyClass Val 
{ 
可 et => val :2 ( val = new MyClass ()); 
} 


11. 空 值 条 件 运算 符 
C# 中 减少 大 量 代码 行 的 一 个 功能 是 空 值 条 件 运算 符 。 生 产 环 境 中 的 大 量 代 码 行 都 会 验证 空 值 条 件 。 访 问 作 


为 方法 参数 传递 的 成 员 变 量 之 前 ， 需 要 检查 它 ， 以 确定 该 变量 的 值 是 否 为 nnl， 否 则 会 抛 出 一 个 


NullReferenceException 异常 。NET 设计 准则 指定 ， 代 码 不 应 该 抛 出 这 些 类 型 的 异常 ， 应 该 检查 空 值 条 件 。 然 


而 ,很 容易 忘记 这 样 的 检查 。 下 面 的 这 个 代码 片段 验证 传递 的 参数 p 是 否 非 空 。 如 果 它 为 空 ， 方 法 就 只 是 返回 ， 
而 不 会 继续 执行 : 


Public void ShowPerson (Person p) 
{ 
1f (p == null) return; 
string firstName = p.FirstName; 
Ef 


} 
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使 用 空 值 条 件 运算 符 访问 FirstName 属性 (p?.FirstName)， 当 p 为 空 时 ， 就 只 返回 null， 而 不 继续 执行 表达 
式 的 右 侧 (代码 文件 OperatorsSample/Program.cs)。 

public void ShowPerson (Person p) 

string firstName = p?.FirstName; 

/i/... 

使 用 空 值 条 件 运算 和 从 访问 int 类 型 的 属性 时 ， 不 能 把 结果 直接 分 配给 int 类 型 ， 因 为 结果 可 以 为 空 。 解 决 这 
个 问题 的 一 种 选择 是 把 结果 分 配给 可 空 的 int: 

nt? age = p?.Age; 

当然 ， 要 解决 这 个 问题 ， 也 可 以 使 用 空 合并 运算 符 ， 定 义 男 一 个 结果 (例如 0)， 以 防止 左边 的 结果 为 空 : 

int agel = p?.Age ?323 0; 

也 可 以 结合 多 个 空 值 条 件 运 算 符 。 下 面 访问 Person 对 象 的 Address 属性 ,这 个 属性 又 定义 了 City 属性 .Person 
对 象 需要 进行 null 检查 ， 如 果 它 不 为 衬 ，Address 属性 的 结果 也 不 为 空 : 

Person p = GetPerson(); 

string city = null; 

(p != null gg p.HomeAddress != null) 


city = p.HomeAddress .City; 
} 


使 用 空 值 条 件 运 算 和 从 时， 代码 会 更 简单 : 

string city = p?.HomeAddress?.City:; 

还 可 以 把 空 值 条 件 运算 符 用 于 数组 。 在 下 面 的 代码 片段 中 ， 使 用 索引 运算 符 访 问 值 为 null 的 数组 变量 元 素 
时 ， 会 抛 出 NullReferenceException 异常: 


int[] arr = RUlL:; 
int xl1 = arr[0]l:; 


当然 ， 可 以 进行 传统 的 null 检查 ， 以 避免 这 个 异常 条 件 。 更 简单 的 版 本 是 使 用 ?[0] 访 问 数组 中 的 第 一 个 元 
素 。 如 果 结 果 是 null， 空 合并 运算 符 就 返回 xl 变量 的 值 : 


int xl1 = arr?3[0] ?2 0-; 


6.2.2 ”运算 符 的 优先 级 和 关联 性 


表 6-3 显示 了 C#j 运 算 符 的 优先 级 ， 其 中 顶部 的 运算 符 有 最 高 的 优先 级 ( 即 在 包含 多 个 运算 符 的 表达 式 中 ， 
最 先 计 算 该 运算 符 )。 


表 6-3 

组 运 算 符 
基本 运算 符 2 0 中 ?x+ x--new typeof sizeof checked unchecked 
一 元 运算 符 + -! ~ + 一 x 和 数据 类 型 强制 转换 
乘 / 除 运算 符 中 /9 
加 / 减 运算 符 十 一 
移 位 运算 符 < > 
关系 运算 符 二 
比较 运算 符 = 
按 位 AND 运算 符 & 
按 位 XOR 运算 符 人 


按 位 OR 运算 符 
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( 续 表 ) 
组 运 算 符 
条 件 OR 运算 符 | 
空 合并 运算 符 9 
条 件 运 算 符 
赋值 运算 符 和 lambda = 二 -= 上 全 < 2 > 一 


除了 运算 符 优 先 级 ， 对 于 二 元 运算 符 ， 需 要 注意 运算 符 是 从 左 同 右 还 是 从 右 同 左 计 算 。 除 了 少数 运算 和 付 ， 
所 有 的 二 元 运算 符 都 是 左 关 联 的 。 例 如 : 

过 十 十 工 
就 等 于 : 

(各 十) + Zz 

需要 先 注意 运算 符 的 优先 级 ， 再 考虑 其 关联 性 。 在 以 下 表达 式 中 ， 先 计算 y 和 z 相 乘 ， 再 把 计算 的 结果 分 
配给 x， 因 为 乘法 的 优先 级 高 于 加 法 : 

下 十 村 丰 Z 

关联 性 的 重要 例外 是 赋值 运算 符 ， 它 们 是 右 关 联 。 下 面 的 表达 式 从 右 同 左 计算 : 

下 二 Y= 2Z 

因为 存在 右 关联 性 ， 所 有 变量 x、y、z 的 值 都 是 3， 且 该 运算 符 是 从 右 向 左 计 算 的 。 如 果 这 个 运算 符 是 从 
左 同 右 计 算 ， 就 不 会 是 这 种 情况 : 

es 

int ww = 1- 

X= Y= Zr 

一 个 重要 的 、 可 能 误导 的 右 关 联运 算 符 是 条 件 运算 符 。 表 达 式 

a?b: cc2?3d:e 
等 于 : 

a 二 b: (tc ? d: e) 


这 是 因为 该 运算 符 是 右 关 联 的 。 


注意 : 
在 复杂 的 表达 式 中 ， 应 避免 利用 运算 符 优先 级 来 生成 正确 的 结果 。 使 用 圆 括号 指定 运算 符 的 执行 顺序 ， 可 
以 使 代码 更 整洁 ， 避 免 出 现 潜在 的 冲突 


6.3 ”使 用 二 进 制 运 算 符 


在 学 习 编 程 时 ， 使 用 二 进 制 值 一 直 是 一 个 需要 理解 的 重要 概念 ， 因 为 计算 机 使 用 0 和 1。 现 在 ， 许 多 人 可 
能 已 经 错过 了 它 的 学 习 ， 因 为 他 们 是 使 用 Blocks、Scratch， 甚 至 可 能 是 使 用 JavaScript 开始 学 习 编程 的 。 如 果 
用 户 已 经 很 了 解 0 和 1， 本 节 仍 然 可 以 帮助 复习 。 

在 C#7 中， 由 于 使 用 数字 分 隔 符 和 二 进 制 字面 量 ， 因 此 二 进 制 值 的 处 理 比 以 前 更 容易 。 第 2 章 讨 论 了 这 两 
个 特性 。 二 进 制 运算 符 从 C# 的 第 一 个 版 本 就 开始 有 了 ， 本 节 将 介绍 它们 。 

首先 ， 从 使 用 二 进 制 运算 符 的 简单 计算 开始 。 方 法 SimpleCalculations 首先 使 用 二 进 制 值 (二 进 制 字面 量 和 
数字 分 隔 符 ) 声 明 并 初始 化 变量 binaryl 和 binary2。 使 用 上 运算 符 ， 两 个 值 用 二 进 制 ADD 运算 符合 并 起 来 ， 并 
写 入 变量 binaryAnd。 然 后 ， 使 用 运算 符 | 创建 binaryOr 变量 ， 使 用 运算 符 ^ 创建 binaryXOR 变量 ， 使 用 运算 
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付 ~ 创建 reversel 变量 (代码 文件 BinaryCalculations/Program.cs): 


static void SimpleCalculations() 
{ 
Console.WriteLine (nameof (SimpleCalculations))}); 
uint binaryl = 0bl1111 0000 1100 0011 1110 0001 0001 1000; 
uint binary2 = 0b0000 1111 1100 0011 0101 1010 1110 0111; 
uint binaryAnd = binarvyl] & binary2; 
DisplayBits ("AND", binaryAnd, binaryl, binary2).; 
uint binaryoR = binaryl | binary2; 
DisplayBits ("OR", binaryoR, binaryl, binary?2); 
uint binaryXoR = binaryl ^ binary2; 
DisplayBits ("XOR", binaryXOoOR, binaryl, binary2).; 
uint reversel = ~binaryl; 
DisplayBits ("NOT", reversel, binaryl); 
Console .WriteLine().; 


} 

要 以 二 进 制 形式 显示 uint 和 int 变量 ， 需 要 创建 扩展 方法 ToBinaryString。Convert.ToSstring 提供 的 一 个 重 载 
市 有 两 个 int 参数 , 其 中 第 二 个 int 值 是 toBase 参数 。 使 用 这 个 方法 ,可 以 通过 传递 值 >、 八进制 (8)、 十 进 制 (10) 
和 十 六 进 制 (16) 来 格式 化 输出 字符 串 binary。 默 认 情 况 下 ， 如 果 二 进 制 值 以 0 开始， 这 些 0 值 将 被 忽略 ,而 不 会 
打印 出 来 。PadLeft 方法 填充 字符 串 中 的 这 些 0 值 。 字 符 串 需要 的 字符 数 由 sizeof 运算 符 计 算 ， 并 左 移 4 位 。 如 
前 所 述 ，sizeof 运算 符 返回 指定 类 型 的 字 节 数 。 要 显示 这 些 位 ， 需 要 将 字 节 数 乘 以 8， 这 相当 于 向 左 移动 3 位 。 
另 一 个 扩展 方法 是 AddSeparators， 它 使 用 LINQ 方法 在 每 四 位 数 之 后 添加 分 隔 符 (代码 文件 BinaryCalculations/ 
BinaryExtensions.cs): 


public static class BinaryExtensions 
{ 
Public static string ToBinarySstring (this uint number) => 
Convert.ToString (number, toBase: 2) .PadLeft (sizeof (uint) << 3, '0'). 
Public static string ToBinarySsString (this int number) => 
Convert.ToString (number, toBase: 2) .PadLeft (sizeof (jnt) << 3, 0); 


PUublic static string AddSeparators (this string number) 三 > 
string-.Join("” ", 
Enumerable.Range (0, number.Length / 4) 
-Select (i => number.Substring(1i * 4, 4)) .ToArray())}).; 


注意 : 
AddSeparators 使 用 LINQ。LINQ 详 见 第 12 章 。 


方法 DisplayBits 是 从 前 面 显示 的 SimpleCalculations 方法 调用 的 ， 它 使 用 ToBinaryString 和 AddSeparators 
扩展 方法 。 在 这 里 ， 将 显示 用 于 操作 的 操作 数 ， 以 及 结果 (代码 文件 BinaryCalculations/Program.cs): 


static void DisplayBits (string title, uint result, uint left, 
uint? right = null]l) 

{ 
Console .WriteLine (title); 
Console .WriteLine (left.ToBinaryString(}) .AddSeparators () }); 
if {right.HasValue) 
{ 

Console.WriteLine (right .Value.ToBinarySstring() .AddSeparators ()); 

} 
Console.WriteLine (result.ToBinarySstring() .AddSeparators (}) ) : 
Console .WriteLine (}); 


} 
在 运行 应 用 程序 时 ， 可 以 看 到 使 用 二 进 制 运算 符 & 的 以 下 输出 。 对 于 这 个 运算 符 ， 只 有 两 个 输入 值 都 为 1 
时 ， 得 到 的 位 才 是 1: 


RND 
1111 0000 1100 0011 1110 0001 0001 1000 
0000 1111 1100 0011 0101 1010 1110 0111 
0000 0000 1100 0011 0100 0000 0000 0000 


应 用 二 进 制 运算 符 |， 如 果 设 置 一 个 输入 位 ， 则 设置 结果 位 (]): 


OR 
1111 0000 1100 0011 1110 0001 0001 1000 
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0000 1111 1100 0011 0101 1010 1110 0111 
1111 1111 1100 0011 1111 1011 1111 1111 


对 于 人 ^ 运 算 符 ， 如 果 两 个 原始 的 位 只 设置 了 一 个 ， 而 没有 设置 两 个 ， 就 设置 结果 : 


OR 

1111 0000 1100 0011 1110 0001 0001 1000 
0000 1111 1100 0011 0101 1010 1110 0111 
1111 1111 0000 0000 1011 1011 1111 1111 


最 后 ， 对 于 运算 符 ~， 结 果 是 对 原始 位 的 否定 : 


NOT 
1111 0000 1100 0011 1110 0001 0001 1000 
0000 1111 0011 1100 0001 1110 1110 0111 


6.3.1 位 的 移动 


如 前 面 的 示例 所 述 ， 同 左 移动 3 位 就 是 原来 的 数字 乘 以 8。 同 左 移动 ] 位 就 是 原来 的 数字 乘 以 2。 这 比 调用 
乘法 运算 符 要 快 得 多 一 一 假定 需要 乘 以 2、4、8、16、32 等 。 
下 面 的 代码 片段 在 变量 sl 中 设置 了 一 个 位 ,在 far 循环 中 , 这 个 位 总 是 移动 一 位 (代码 文件 BinaryCalculations 
/Program.cs): 
static void ShiftingBits () 
{ 
Console.WriteLine (nameof (ShiftingBits)); 
ushort si = Ob0l.; 
for (int 1 = 0; i < 16; i++) 
{ 
Console.WriteLine($"{s1.ToBinarSstring()} {sl1} hex: {sl :XxX}"); 
SL = (ushort) (sl << 1); 
} 


Console .WriteLine(); 


} 
在 程序 的 输出 中 ， 可 以 看 到 循环 中 的 二 进 制 、 十 进 制 和 十 六 进 制 值 : 


0000000000000001 1 hex: 1 
0000000000000010 2 hex: 2 
0000000000000100 4 hex: 4 
0000000000001000 8 hex: 8 
0000000000010000 16 hex: 10 
0000000000100000 32 hex: 20 
0000000001000000 64 hex: 40 
0000000010000000 128 hex: 80 
0000000100000000 256 hex: 100 
0000001000000000 512 hex: 200 
0000010000000000 1024 hex: 400 
0000100000000000 2048 hex: 800 
0001000000000000 4096 hex: 1000 
0010000000000000 8192 hex: 2000 
0100000000000000 16384 hex: 4000 
1000000000000000 32768 hex: 8000 


6.3.2 ”有 符号 数 和 无 符号 数 


使 用 二 进 制 时 要 记 住 的 一 件 重要 的 事情 是 ， 使 用 带 符 号 的 类 型 时 ， 如 int、long、short， 最 左 端的 一 位 用 来 
表示 符号 。 使 用 int 类 型 时 ， 可 用 的 最 大 值 是 2147483647 一 一 31 位 的 正 数 或 0x7FFF FFFF。 对 于 uint， 可 用 
的 最 大 值 是 4294967295 或 0xXFFFF FFFF。 这 表示 32 位 的 正 数 。 对 于 int， 数 字 范 围 的 另 一 半 用 于 负数 。 

为 了 理解 负数 是 如 何 表示 的 ， 下 面 的 代码 片段 使 用 int.MaxValue 将 maxNumber 变量 初始 化 为 最 大 的 31 位 
正 数 。 然 后 ， 在 for 循环 中 ， 该 变量 会 递增 三 次 。 在 所 有 的 结果 中 ， 都 将 显示 二 进 制 、 十 进 制 和 十 六 进 制 值 ( 代 
码 文 件 BinaryCalculations/Program.cs): 


private static void SignedNumbers{() 
{ 


Console .WriteLine (nameof (SignedNumbers)); 


VOD1d DisplayNumber (string title, int x) => 
Console.WriteLine(s$"{title,—11} "+ 
$s"bin: {x.ToBinarySsString{(}) .AddSeparators{()}, "+ 
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s"dec: {XxX}, hex: {x:X}"}); 


int maxNumber = jint.MaxVvalue; 
DisplayNumber{("max int™", maxNumber),; 
for (int i = 0; i < 3; i++) 
{ 
maxNumberti+; 
DisplayNumber($"added {i + 1}", maxNumber); 
} 
Console .WriteLine(); 
FF 
} 


在 应 用 程序 的 输出 中 可 以 看 到 ， 除 符号 位 之 外 的 所 有 位 都 设置 了 ， 得 到 了 最 大 的 整数 值 。 输 出 以 不 同 的 格 
式 显 示 相 同 的 值 一 一 二 进 制 、 十 进 制 和 十 六 进 制 。 在 第 一 个 输出 中 添加 1， 将 导致 设置 符号 位 的 int 类 型 溢出 ， 
其 他 所 有 位 都 是 0。 这 是 int 类 型 的 最 大 负 值 。 在 这 个 结果 之 后 ， 又 递增 了 两 次 : 


max int bin: 0111 1111 1111 1111 1111 1111 1111 1111，dec: 2147483647, 
hex: TFEFFFFFEEF 

added 1 bin: 1000 0000 0000 0000 0000 0000 0000 0000, dec: -2147483648, 
hex: 80000000 加 法 加 加 加 本 

added 2 bin: 1000 0000 0000 0000 0000 0000 0000 0001, dec: -2147483647 ， 
hex: 80000001 本 

added 3 bin: 1000 0000 0000 0000 0000 0000 0000 0010, dec: -2147483646, 


hex: 80000002 


在 下 一 个 代码 片段 中 ， 变 量 zero 初始 化 为 0。 在 for 循环 中 ， 这 个 变量 递减 三 次 : 


int zero = 0; 
DisplayNumber ("zero™", Zero); 
for (int 1 = 0; 1 < 3; 1++) 
{ 
ZEIO——} 
DisplayNumber($"subtracted {1 + 1}", zero); 
} 


Console .WriteLine():; 
在 输出 中 可 以 看 到 ， 所 有 未 设置 的 位 都 表示 为 0。 递减 的 结果 是 十 进 制 -1， 它 设置 了 所 有 位 ， 包 括 符号 位 : 


zero bin: 0000 0000 0000 0000 0000 0000 0000 0000, dec: 0, hex: 0 

subtracted 1 bin: 1111 1111 1111 1111 1111 1111 1111 1111, dec: -1, hex: FFFFFFFF 
subtracted 2 bin: 1111 1111 1111 1111 1111 1111 1111 1110，dec: -2, hex: FFFFFFFE, 
subtracted 3 bin: 1111 1111 1111 1111 1111 1111 1111 1101, dec: -3, hex: FFFFFFFD 


接 下 来 ，int 从 最 大 的 负数 开始 ， 这 个 数字 递增 了 三 次 : 


int minNumber = int.Minvalue; 
DisplayNumber ("min number™", minNumber); 
for {int 1 = 0; 1 < 3; 1++)} 
{ 

minNumbert+t+; 

DisplayNumber{(s$"added {i + 1}", minNumber); 
} 


Console .WriteLine():; 
如 前 所 述 ， 当 济 出 最 大 的 正 数 时 ， 了 就 会 显示 最 大 的 负数 。 在 使 用 intMinValue 时 ， 就 会 看 到 相同 的 数字 。 
这 个 数字 递增 了 三 次 : 


min number bin: 1000 0000 0000 0000 0000 0000 0000 0000, dec: -2147483648, 
hex: 80000000 


added 1 bin: 1000 0000 0000 0000 0000 0000 0000 0001, dec: -2147483647, 
hex: 80000001 

added 2 bin: 1000 0000 0000 0000 0000 0000 0000 0010, dec: -2147483646 ， 
hex: 80000002 加 加 加 加 加 加 

added 3 bin: 1000 0000 0000 0000 0000 0000 0000 0011, dec: -2147483645， 


hex: 80000003 


6.4 ”类 型 的 安全 性 


第 1 章 提 到 ， 中 间 语 言 GD) 可 以 对 其 代码 强制 实现 强 类 型 安全 性 。 强 类 型 化 支持 NET 提供 的 许多 服务 ， 包 
括 安全 性 和 语言 的 交互 性 。 因 为 CH 语言 会 编译 为 世 ， 所 以 C# 也 是 强 类 型 的 。 此 外 ， 这 说 明 数 据 类 型 并 不 总 是 
可 无 缝 互 换 。 本 节 将 介绍 基本 类 型 之 间 的 转换 。 
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注意 : 

C# 也 ,支持 不 同 引 用 类 型 之 间 的 转换 ， 在 与 其 他 类 型 相互 转换 时 还 允许 定义 所 创建 的 数据 类 型 的 行为 方式 。 
本 章 稍 后 将 详细 讨论 这 两 个 主题 。 

另 一 方面 ， 泛 型 可 以 避免 对 一 些 常见 的 情形 进行 类 型 转换 ， 详 见 第 5 章 。 


6.4.1 ”类 型 转换 
我 们 常常 需要 把 数据 从 一 种 类 型 转换 为 男 一 种 类 型 。 考 虑 下 面 的 代码 : 


byte valuel = 10; 

byte value2 = 23s 

byte total; 

total = valuel + value2; 
Console.WriteLine (totaly}):; 


在 试图 编译 这 些 代 码 行 时 ， 会 得 到 一 条 错误 消息 : 

Cannot implicitly convert type "1Lnt"7 to ‘byte" 

问题 是 ， 把 两 个 byte 型 数据 加 在 一 起 时 ， 应 返回 int 型 结果 ， 而 不 是 男 一 个 byte 数据 。 这 是 因为 byte 包含 
的 数据 只 能 为 8 位 ， 所 以 把 两 个 byte 型 数据 加 在 一 起 , 很 容易 得 到 不 能 存储 在 单个 byte 型 数据 中 的 值 。 如 果 要 
把 结果 存储 在 一 个 byte 变量 中 ， 就 必须 把 它 转换 回 byte 类 型 。C# 支 持 两 种 转换 方式 ， 隐 式 转 换 和 显 式 转换 。 

1. 隐 式 转换 

只 要 能 保证 值 不 会 发 生 任何 变化 ， 类 型 转换 就 可 以 自动 ( 隐 式 ) 进 行 。 这 就 是 前 面 代码 失败 的 原因 : 试图 从 
int 转换 为 byte， 而 可 能 丢失 了 3 个 字 节 的 数据 。 编 译 器 不 允许 这 么 做 ， 除 非 我 们 明确 告诉 它 这 就 是 我 们 希望 的 
结果 ! 如 果 在 long 类 型 变量 而 非 byte 类 型 变量 中 存储 结果 ， 就 不 会 有 问题 了 : 

byte valuel = 10s; 

byte value? = 23; 

long total; // this will compile fine 


total = valuel + value2; 
Console .WriteLine (total):; 


程序 可 以 顺利 编译 ,而 没有 任何 错误 ,这 是 因为 long 类 型 变量 包含 的 数据 字 节 比 byte 类 型 多 ， 所 以 没有 于 
失 数 据 的 危险 。 在 这 些 情况 下 ， 编 译 器 会 很 顺利 地 转换 ， 我 们 也 不 需要 显 式 地 提出 要 求 。 
表 6-4 列 出 了 C# 支 持 的 隐 式 类 型 转换 。 


表 6-4 

源 类 型 目标 类 型 
sbyte short、int、long、float、double、decimal、BieInteger 
byte short、ushort、mt、uint、long、ulong、tfoat、double、decimal、BigInteger 
short int、 long、 float、double、decimal、BigInteger 
ushort int、 uint~、 long、 ulong、 foat、double、decimal、BigInteger 
int long、 float、double、decimal、BiegInteger 
unt long、 ulong、 float、 double、decimal、BigInteger 
long、ulong float、double、decimal、BigInteger 
Hoat double、BigInteger 
char ushort、 int、 uint long、 ulong、 float、double、decimal、BigInteger 

注意 : 


ee 是 包含 任意 大 小 的 数字 的 结构 体 。 可 以 从 较 小 的 类 型 中 初始 化 它 ， 传 递 一 个 数字 数组 来 创建 一 
个 大 的 数字 ， 或 者 解析 包含 大 数字 的 字符 囊 。 这 种 类 型 实现 了 数学 计算 的 方法 。BigInteger 的 名 称 空 间 是 


System.Numeric, 
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注意 ， 只 能 从 较 小 的 整数 类 型 隐 式 地 转换 为 较 大 的 整数 类 型 ， 而 不 能 从 较 大 的 整数 类 型 隐 式 地 转换 为 较 小 
的 整数 类 型 。 也 可 以 在 整数 和 浮 点 数 之 间 转 换 ; 然而 ， 其 规则 略 有 不 同 。 尽 管 可 以 在 相同 大 小 的 类 型 之 间 转 换 ， 
如 intuint 转换 为 oat，longulong 转换 为 double， 也 可 以 从 longmulong 转换 回 float。 这 样 做 可 能 会 丢失 4 个 字 
节 的 数据 ， 但 这 仅 表示 得 到 的 float 值 比 使 用 double 得 到 的 值 精度 低 ; 编译 器 认为 这 是 一 种 可 以 接受 的 错误 ， 
因为 值 的 数量 级 不 会 受到 影响 。 还 可 以 将 无 符号 的 变量 分 配给 有 符号 的 变量 ， 只 要 无 符号 变量 值 的 大 小 在 有 
符号 变量 的 范围 之 内 即 可 。 
在 隐 式 地 转换 值 类 型 时 ， 对 于 可 空 类 型 需要 考虑 其 他 因素 : 
e 可 空 类 型 隐 式 地 转换 为 其 他 可 空 类 型 ， 应 遵循 表 6-4 中 非 可 空 类 型 的 转换 规则 。 即 int? 隐 式 地 转换 为 
lone?、float?、double? 和 decimal?。 
@ 非 可 空 类 型 隐 式 地 转换 为 可 空 类 型 也 遵循 表 6-4 中 的 转换 规则 , 即 int 隐 式 地 转换 为 lone? .tloat? double? 
和 decimal?。 
e 可 空 类 型 不 能 隐 式 地 转换 为 非 可 空 类 型 ， 此 时 必须 进行 显 式 转换 ， 如 下 一 节 所 述 。 这 是 因为 可 空 类 型 
的 值 可 以 是 null， 但 非 可 空 类 型 不 能 表示 这 个 值 。 
2. 显 式 转换 
有 许多 场合 不 能 隐 式 地 转换 类 型 ， 否 则 编译 器 会 报告 错误 。 下 面 是 不 能 进行 隐 式 转换 的 一 些 场合 : 
int 转换 为 short 一 一 会 丢失 数据 。 
uint 转换 为 int 一 一 会 丢失 数据 。 
float 转换 为 int 一 一 会 丢失 小 数 点 后 面 的 所 有 数据 。 
任何 数字 类 型 转换 为 char 一 一 会 丢失 数据 。 
decimal 转换 为 任何 数字 类 型 一 一 因为 decimal 类 型 的 内 部 结构 不 同 于 整数 和 浮 点 数 。 
e int? 转 换 为 nt 一 一 可 空 类 型 的 值 可 以 是 null。 
但 是 ， 可 以 使 用 类 型 强制 转换 (cast) 显 式 地 执行 这 些 转 换 。 在 把 一 种 类 型 强制 转换 为 男 一 种 类 型 时 ， 有 意 地 
迫使 编译 器 进行 转换 。 类 型 强制 转换 的 一 般 语法 如 下 : 


long val = 30000; 
int i = (int)val; // A valid cast. The maximum int is 2147483647 


这 表示 ， 把 强制 转换 的 目标 类 型 名 放 在 要 转换 值 之 前 的 圆 括号 中 。 对 于 熟悉 C 的 程序 员 ， 这 是 类 型 强制 转 
换 的 典型 语法 。 对 于 熟悉 C++ 类 型 强制 转换 关键 字 ( 如 static cast) 的 程序 员 ， 这 些 关键 字 在 C# 中 不 存在 ， 必 须 
使 用 C 风格 的 旧 语 法 。 

这 种 类 型 强制 转换 是 一 种 比较 危险 的 操作 ， 即 使 在 从 long 转换 为 int 这 样 简单 的 类 型 强制 转换 过 程 中 ， 如 
果 原 来 long 的 值 比 int 的 最 大 值 还 大 ， 就 会 出 现 问题 : 


long val = 3000000000; 
int i = (int)val; /an invalid cast. The maximum int is 2147483647 


在 本 例 中 ， 不 会 报告 错误 ， 但 也 得 不 到 期 望 的 结果 。 如 果 运 行 上 面 的 代码 ， 并 将 输出 结果 存储 在 i 中 ， 则 
其 值 为 ; 

-1294961296 

最 好 假定 显 式 类 型 强制 转换 不 会 给 出 希望 的 结果 。 如 前 所 述 ，C# 提 供 了 一 个 checked 运算 符 ， 使 用 它 可 以 
测试 操作 是 否 会 导致 算术 洲 出 。 使 用 checked 运算 符 可 以 检查 类 型 强制 转换 是 否 安全 ， 如 果 不 安 全 ， 就 要 迫使 
运行 库 抛 出 一 个 溢出 异 和 : 


londg val = 3000000000; 
int 1 = ee 


记 住 , 所 有 的 显 式 类 型 强制 转换 都 可 能 不 ee 在 应 用 程序 中 应 包含 代码 来 处 理 可 能 失败 的 类 型 强制 转换 。 
第 14 章 将 使 用 try 和 catch 语句 引入 结构 化 异常 
spies dba ad dopo ON 例如 ， 下 面 的 代码 给 price 
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加 上 0.5， 再 把 结果 强制 转换 为 int: 


double price = 25.30; 
It approximatePrice = (int) (price + 0.5); 


这 会 把 价格 四 省 五 入 为 最 接近 的 美元 数 。 但 在 这 个 转换 过 程 中 ， 小 数 点 后 面 的 所 有 数据 都 会 丢失 。 因 此 ， 
如 果 要 使 用 这 个 修改 过 的 价格 进行 更 多 的 计算 ， 最 好 不 要 使 用 这 种 转换 ， 如 果 要 输出 全 部 计算 或 部 分 计算 的 
近似 值 ， 且 不 希望 由 于 小 数 点 后 面 的 多 位 数据 而 麻烦 用 户 ， 这 种 转换 就 很 合适 。 

下 面 的 例子 说 明了 把 无 符号 整数 转换 为 char 时 会 发 生 的 情况 ; 

ushort c = 43; 


char svymbol = {char)e; 
Console .WriteLine (symbol); 


输出 结果 是 ASCII 码 为 43 的 字符 ， 即 + 符号 。 可 以 尝试 数字 类 型 (包括 char) 之 间 的 任何 转换 ， 这 种 转换 是 
可 行 的 ， 例 如 ， 把 decimal 转换 为 char， 或 把 char 转换 为 decimal。 

值 类 型 之 间 的 转换 并 不 仅 限于 孤立 的 变量 。 还 可 以 把 类 型 为 double 的 数组 元 素 转换 为 类 型 为 int 的 结构 成 

struct ItemDetails 


public string Description; 
public int AppIroxPrice; 
} 
1 
double[] Prices = { 25.30, 26.20, 27.40, 30.00 }; 
ItemDetails id; 
1d.Description = "Hello there.™; 
1d.ApproxPrice = {int) (Prices[0] + 0.5); 


要 把 一 个 可 空 类 型 转换 为 非 可 空 类 型 ， 或 转换 为 男 一 个 可 空 类 型 ， 并 且 其 中 可 能 会 丢失 数据 ， 就 必须 使 用 
显 式 的 类 型 强制 转换 。 甚 至 在 底层 基本 类 型 相同 的 元 素 之 间 进 行 转换 时 ,也 要 使 用 显 式 的 类 型 强制 转换 。 例 如， 
int? 转 换 为 int， 或 float? 转 换 为 float。 这 是 因为 可 空 类 型 的 值 可 以 是 null， 而 非 可 空 类 型 不 能 表示 这 个 值 。 只 要 
可 以 在 两 种 等 价 的 非 可 空 类 型 之 间 进 行 显 式 的 类 型 强制 转换 ， 对 应 可 空 类 型 之 间 显 式 的 类 型 强制 转换 就 可 以 进 
行 。 但 如 果 从 可 空 类 型 强制 转换 为 非 可 空 类 型 ， 且 变量 的 值 是 nul， 就 会 抛 出 InvalidOperationException 异常。 
例如 : 


int? a = null; 
int b = (int})a; // Will throw exception 


谨慎 地 使 用 显 式 的 类 型 强制 转换 ， 就 可 以 把 简单 值 类 型 的 任何 实例 转换 为 几乎 任何 其 他 类 型 。 但 在 进行 显 
式 的 类 型 转换 时 有 一 些 限制 ， 就 值 关 型 来 说 ， 只 能 在 数字 、char 类 型 和 enum 类 型 之 间 转 换 。 不 能 直接 把 布尔 
型 强制 转换 为 其 他 类 型 ， 也 不 能 把 其 他 类 型 转换 为 布尔 型 。 

如 果 需 要 在 数字 和 字符 串 之 间 转 换 , 就 可 以 使 用 .NET 类 库 中 提供 的 一 些 方法 .Object 类 实现 了 一 个 ToString0 
方法 ， 该 方法 在 所 有 的 .NET 预定 义 类 型 中 都 进行 了 重 写 ， 并 返回 对 象 的 字符 串 表 示 ; 


int 1 = 10; 
string s = 1.ToString(); 


同样 , 如 果 需 要 分 析 一 个 字符 串 , 以 检索 一 个 数字 或 布尔 值 , 就 可 以 使 用 所 有 预定 义 值 类 型 都 支持 的 Parse() 
方法 : 

string s = "100"; 

0 50); // Add 50 to prove it is really an int 

注意 ,如果 不 能 转换 字符 串 (例如 ,要 把 字符 串 Hello 转换 为 一 个 整数 )，Parse0 方 法 就 会 通过 抛 出 一 个 异常， 
注册 一 个 错误 。 第 14 章 将 介绍 异常 。 


6.4.2 ” 装 箱 和 拆 箱 


第 2 章 介 绍 了 所 有 类 型 , 包括 简单 的 预定 义 类 型 (如 int 和 char) 和 复杂 类 型 (如 从 object 类 型 中 派生 的 类 和 结 
构 )。 这 意味 着 可 以 像 处 理 对 象 那样 处 理 字 面值 : 


第 6 章 ”运算 符 和 类 型 强制 转换 | 133 


string s = 10.Tostring() ; 

但 是 ，C# 数 据 类 型 可 以 分 为 在 栈 上 分 配 内 存 的 值 类 型 和 在 托管 堆 上 分 配 内 存 的 引用 类 型 。 如 果 int 不 过 是 
栈 上 一 个 4 字 节 的 值 ， 该 如 何在 它 上 面 调用 方法 ? 

C# 的 实现 方式 是 通过 一 个 有 点 魔术 性 的 方式 ， 即 装 箱 (boxing)。 装 箱 和 拆 箱 (unboxing) 可 以 把 值 类 型 转换 为 
引用 类 型 ， 并 把 引用 类 型 转换 回 值 类 型 。 这 些 操作 包含 在 6.7 节 中 ， 因 为 它们 是 基本 的 操作 ， 即 把 值 强制 转换 
为 object 类 型 。 装 箱 用 于 描述 把 一 个 值 类 型 转换 为 引用 类 型 。 运 行 库 会 为 堆 上 的 对 象 创建 一 个 临时 的 引用 类 型 
“箱子 ”。 

该 转换 可 以 隐 式 地 进行 ， 如 上 面 的 例子 所 述 。 还 可 以 显 式 地 进行 转换 


int myIntNumber = 20; 
object myObject = myIntNumber; 


拆 箱 用 于 描述 相反 的 过 程 ， 其 中 以 前 装 箱 的 值 类 型 强制 转换 回 值 类 型 。 这 里 使 用 术语 “强制 转换 ”， 是 因为 
这 种 转换 是 显 式 进 行 的 。 其 语法 类 似 于 前 面 的 显 式 类 型 转换 : 

int myIntNumber = 20; 

object myobject = myIntNumber; // Box the int 

int mySecondNumber = (int)myObject; // Unbox it back into an int 

只 能 对 以 前 装 箱 的 变量 进行 拆 箱 。 当 myObject 不 是 装 箱 的 int 类 型 时 ， 如 果 执 行 最 后 一 行 代码 ， 就 会 在 运 
行 期 间 抛 出 一 个 运行 时 异常 。 

这 里 有 一 个 警告 : 在 拆 箱 时 必须 非常 小 心 ， 确 保 得 到 的 值 变 量 有 足够 的 空间 存储 拆 箱 的 值 中 的 所 有 字 节 。 
例如 ，C# 的 int 类 型 只 有 32 位 ,所 以 把 long 值 (64 位 ) 拆 箱 为 mt 时， 会 导致 抛 出 一 个 mvalidCastException 异常 : 

long myLongNumber = 333333423; 


object myObject = (object}myLongNumber; 
int myIntNumber = (int)myObject; 


6.5 ”比较 对 象 的 相等 性 


在 讨论 了 运算 符 并 简要 介绍 了 相等 运算 符 后 ， 就 应 考虑 在 处 理 类 和 结构 的 实例 时 ,“ 相 等 ”意味 着 什么 。 
解 对 象 相等 的 机 制 对 逻辑 表达 式 的 编程 非 党 重要， 另外 对 实现 运算 符 重 载 和 类 型 蝇 制 转换 也 非 间 重要， 本 和 章 后 
面 将 讨论 运算 符 重 载 。 

对 和 象 相等 的 机 制 有 所 不 同 ， 这 取决 于 比较 的 是 引用 类 型 (类 的 实例 ) 还 是 值 类 型 (基本 数据 类 型 、 结 构 或 枚 举 
的 实例 )。 下 面 分 别 介绍 引用 类 型 和 值 类 型 的 相等 性 。 


6.5.1 比较 引用 类 型 的 相等 性 


System.Object 定义 了 3 个 不 同 的 方法 来 比较 对 象 的 相等 性 : ReferenceEquals0 和 两 个 版 本 的 Equals0: 一 个 
是 静态 的 方法 ， 一 个 是 可 以 重 写 的 虚拟 实例 方法 。 还 可 以 实现 接口 下 quality<T>， 它 提供 了 一 个 具有 泛 型 类 型 
参数 而 不 是 对 象 的 Equals 方法 。 再 加 上 比较 运算 符 ( 一 )， 实 际 上 有 4 种 比较 相等 性 的 方法 。 这 些 方 法 有 一 些 细 
微 的 区 别 ， 下 面 就 介绍 它们 。 


1. ReferenceEquals() 方 法 


ReferenceEquals0O 是 一 个 静态 方法 ， 其 测试 两 个 引用 是 否 指 回 类 的 同一 个 实例 , 特别 是 两 个 引用 是 否 包 含 内 
存 中 的 相同 地 址 。 作 为 静态 方法 ， 它 不 能 重 写 ， 所 以 System.Object 的 实现 代码 保持 不 变 。 如 果 提 供 的 两 个 引用 
指 回 同一 个 对 象 实例 ， 则 ReferenceEquals0 总 是 返回 tue; 否则 就 返回 false。 但 是 ， 它 认为 null 等 于 null( 代 码 
文件 EqualsSample/Program.cs): 

a void ReferenceEqualssample() 


SomeClass X = new SomeClass(}, Yy = new SomeClass(), z = xX; 


bool bl = object.ReferenceFEquals (null, null}); // returns true 
bool b2 = object.ReferenceEquals (null, xX); /:/ returns false 
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bool b3 = object.ReferenceEquals (x, vy); // returns false because x and y 
/!/ references different objects 
bool bd = object.ReferenceEquals (x, 2Z); /i returns true because x and z 
/:/: references the same object 
下 
} 
2. Equals() 虚 方法 


Equals0 虚 版 本 的 System.Object 实现 代码 也 可 以 比较 引用 。 但 因为 这 是 虚 方法 ， 所 以 可 以 在 自己 的 类 中 重 
写 它 ， 从 而 按 值 来 比较 对 象 。 特 别 是 如 果 和 希望 类 的 实例 用 作 字 上 典 中 的 键 ， 就 需要 重 写 这 个 方法 ， 以 比较 相关 值 。 
否则 ， 根 据 重 写 Object.GetHashCodeO 的 方式 ， 包含 对 象 的 字典 类 要 么 不 工作 ， 要 人 么 工作 的 效率 非常 低 。 在 重 写 
Equals0 方 法 时 要 注意 ， 重 写 的 代码 不 应 抛 出 异常 。 同 理 ， 这 是 因为 如 果 抛 出 异常 ， 字 典 类 就 会 出 问题 ， 一 些 在 
内 部 调用 这 个 方法 的 NET 基 类 也 可 能 出 问题 。 

3. 静态 的 Equals() 方 法 

EqualsO 的 静态 版 本 与 其 虚实 例 版 本 的 作用 相同 ， 其 区 别 是 静态 版 本 带 有 两 个 参数 ， 并 对 它们 进行 相等 性 比 
较 。 这 个 方法 可 以 处 理 两 个 对 象 中 有 一 个 是 null 的 情况 ， 因 此， 如 果 一 个 对 象 可 能 是 null， 这 个 方法 就 可 以 抛 
出 异 弟 ， 提 供 额 外 的 保护 。 静 态 重 载 版 本 前 先 要 检查 传递 给 它 的 引用 是 否 为 null。 如 果 它 们 都 是 null， 就 返回 
true( 因 为 null 与 null 相等 )。 如 果 只 有 一 个 引用 是 pull， 它 就 返回 false。 如 果 两 个 引用 实际 上 引用 了 某 个 对 象 ， 
它 就 调用 Equals0 的 虚实 例 版 本 。 这 表示 在 重 写 Equals0 的 实例 版 本 时 ， 其 效果 相当 于 也 重 写 了 静态 版 本 。 

4. 比较 运算 符 (== 

最 好 将 比较 运算 符 看 作 严 格 的 值 比 较 和 严格 的 引用 比较 之 间 的 中 间 选 项 。 在 大 多 数 情 况 下 ， 下 面 的 代码 表 
示 正 在 比较 引用 : 

bool b = (X == Y); // x, Y object references 

但 是 ， 如 果 把 一 些 类 看 作 值 ， 其 售 义 就 会 比较 直观 ， 这 是 可 以 接受 的 方法 。 在 这 些 情况 下 ， 最 好 重 写 比 较 
运算 从， 以 执行 值 的 比较 。 后 面 将 讨论 运算 和 从 的 重 载 ， 但 一 个 明显 例子 是 System.String 类 ，Microsoft 重 写 了 这 
个 运算 符 ， 以 比较 字符 串 的 内 容 ， 而 不 是 比较 它们 的 引用 。 


6.5.2 比较 值 类 型 的 相等 性 


在 比较 值 类 型 的 相等 性 时 ， 采 用 与 引用 类 型 相同 的 规则 ReferenceEqualsO 用 于 比较 引用 ，EqualsO 用 于 比 
较 值 ， 比 较 运 算 符 可 以 看 作 一 个 中 间 项 。 但 最 大 的 区 别 是 值 类 型 需要 装 箱 ， 才 能 把 它们 转换 为 引用 ， 进 而 才能 
对 它们 执行 方法 。 另 外 ，Microsoft 已 经 在 System ValueType 类 中 重 载 了 实例 方法 Equals0， 以 便 对 值 类 型 进行 
合适 的 相等 性 测试 。 如 果 调 用 sA.Equals(sB)， 其 中 sA 和 sB 是 某 个 结构 的 实例 ， 则 根据 sA 和 sB 是 否 在 其 所 有 
的 字段 中 包含 相同 的 值 而 返回 hue 或 false。 男 一 方面 ， 在 默认 情况 下 ， 不 能 对 目 己 的 结构 重 载 一 运算 件 。 在 表 
达 式 中 使 用 (sA 一 sB) 会 导致 一 个 编译 错误 ， 除 非 在 代码 中 为 当前 的 结构 提供 了 一 的 重 载 版 本 。 

另外 ，ReferenceEqualsO 在 应 用 于 值 类 型 时 总 是 返回 false， 因 为 为 了 调用 这 个 方法 ， 值 类 型 需要 装 箱 到 对 
象 中 。 即 使 编写 下 面 的 代码 : 

bool b = ReferenceEquals (Vv,v); // v is a variable of some Value type 
也 会 返回 false， 因 为 在 转换 每 个 参数 时 ，v 都 会 被 单独 装 箱 ， 这 意味 着 会 得 到 不 同 的 引用 。 出 于 上 述 原 因 ， 调 
用 ReferenceEquals0 〇 来 比较 值 类 型 实际 上 没有 什么 意义 ， 所 以 不 能 调用 它 。 

尽管 System.ValueType 提供 的 Equals0 默 认 重 写 版 本 肯定 足以 应 付 绝 大 多 数目 定义 的 结构 ， 但 仍 可 以 针对 
目 己 的 结构 再 次 重 写 它 ， 以 提高 性 能 。 男 外 ， 如 果 值 类 型 包含 作为 字段 的 引用 类 型 ， 就 需要 重 写 Equals0， 以 
便 为 这 些 字 段 提供 合适 的 语义 ， 因 为 EqualsO 的 默认 重 写 版 本 仅 比 较 它 们 的 地 址 。 
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6.6 ”运算 符 重 载 


本 节 将 介绍 为 类 或 结构 定义 的 另 一 种 类 型 的 成 员 : 运算 符 重 载 。 C++ 开 发 人 员 应 很 熟悉 运算 符 重 载 。 但 是 ， 
因为 这 对 于 Java 和 Visual Basic 开发 人 员 来 说 是 全 新 的 概念 ， 所 以 这 里 要 解释 一 下 。C++ 开 发 人 员 可 以 直接 跳 
到 主要 的 运算 符 重 载 示例 上 。 

运算 符 重 载 的 关键 是 在 对 象 上 不 能 总 是 只 调用 方法 或 属性 ， 有 时 还 需要 做 一 些 其 他 工作 ， 例 如 对 数值 进行 相 
加 、 相 乘 或 逻辑 操作 (如 比较 对 象 ) 等 。 假 定 已 经 定义 了 一 个 表示 数学 矩阵 的 类 。 在 数学 领域 中 ， 和 矩阵 可 以 相 加 和 
相 乘 ， 就 像 数字 一 样 。 所 以 可 以 编写 下 面 的 代码 : 

Matrix 日 ，D，C; 


fassume a, b and c have been initialized 
Matrix d=ce* (a+ by; 


通过 重 载 运算 符 ， 就 可 以 告诉 编译 器 ，+ 和 * 对 Matrix 对 象 执行 什么 操作 ， 以 便 编 写 类 似 于 上 面 的 代码 。 如 
果 用 不 支持 运算 符 重 载 的 语言 编写 代码 ， 就 必须 定义 一 个 方法 ， 以 执行 这 些 操作 。 结 果 肯 定 不 太 直观 ， 可 能 如 
下 所 示 : 

Matrix d = c.Multiply (a.Add (b) ); 

学 习 到 现在 可 以 知道 ， 像 + 和 * 这 样 的 运算 符 只 能 用 于 预定 义 的 数据 类 型 ， 原 因 很 简单 : 编译 器 知道 所 有 党 
见 的 运算 符 对 于 这 些 数 据 类 型 的 含义 。 例 如 ， 它 知道 如 何 把 两 个 long 数据 加 起 来 ， 或 者 如 何 对 两 个 double 
数据 执行 相 除 操作 ， 并 且 可 以 生成 合适 的 中 间 语 言 代 码 。 但 在 定义 自己 的 类 或 结构 时 ， 必 须 告诉 编译 器 : 什 
么 方法 可 以 调用 ， 每 个 实例 存储 了 什么 字段 等 所 有 信息 。 同 样 ， 如 果 要 对 自 定义 的 类 使 用 运算 符 ， 就 必须 告 
诉 编译 器 相关 的 运算 符 在 这 个 类 的 上 下 文中 的 含义 。 此 时 就 要 定义 运算 符 的 重 载 。 

要 强调 的 另 一 个 问题 是 重 载 不 仅仅 限于 算术 运算 符 。 还 需要 考虑 比较 运算 符 一 、<、>、!=、>= 和 <=。 例 
如 ， 考 虑 语句 f(a 一 b)。 对 于 类 ， 这 条 语句 在 默认 状态 下 会 比较 引用 a 和 b。 检测 这 两 个 引用 是 否 指 问 内 存 中 的 
同一 个 地 址 ， 而 不 是 检测 两 个 实例 实际 上 是 否 包含 相同 的 数据 。 对 于 string 类 ， 这 种 行为 就 会 重 写 ， 于 是 比较 
字符 串 实际 上 就 是 比较 每 个 字符 串 的 内 容 。 可 以 对 自己 的 类 进行 这 样 的 操作 。 对 于 结构 ， 一 运算 符 在 默认 状态 
下 不 做 任何 工作 。 试 图 比较 两 个 结构 ， 看 看 它们 是 否 相 等 ， 就 会 产生 一 个 编译 错误 ， 除 非 显 式 地 重 载 了 一 ， 告 
诉 编译 器 如 何 进行 比较 。 

在 许多 情况 下 ， 重 载运 算 符 用 于 生成 可 读 性 更 高 、 更 直观 的 代码 ， 包 括 : 

e 在 数学 领域 中 ， 几 乎 包括 所 有 的 数学 对 象 ; 坐标 、 矢 量 、 和 矩阵 、 张 量 (tensor) 和 函数 等 。 如 果 编 写 一 个 

程序 执行 某 些 数学 或 物理 建 模 ， 就 几乎 肯定 会 用 类 表示 这 些 对 和 象 。 

es 图 形 程序 在 计算 屏幕 上 的 位 置 时 ， 也 使 用 与 数学 或 坐标 相关 的 对 象 。 

e 表示 大 量 金钱 的 类 (例如 ， 在 财务 程序 中 )。 

e 字 处 理 或 文本 分 析 程 序 也 有 表示 语句 、 子 句 等 方面 的 类 ， 可 以 使 用 运算 符合 并 语句 (这 是 字符 串 连 接 的 

一 种 比较 复杂 的 版 本 )。 

但 是 ， 也 有 许多 类 型 与 运算 符 重 载 并 不 相关 。 不 恰当 地 使 用 运算 符 重 载 ， 会 使 使 用 类 型 的 代码 更 难 理解 。 

例如 ， 把 两 个 DateTime 对 象 相 乘 ， 在 概念 上 没有 任何 意义 。 


6.6.1 运算 符 的 工作 方式 


为 了 理解 运算 符 是 如 何 重 载 的， 考虑 一 下 在 编译 器 遇 到 运算 符 时 会 发 生 什 么 情况 就 很 有 有 用。 用 加 法 运算 符 
(0+) 作为 例子 ， 假 定编 译 嚣 处理 下 面 的 代码 : 

int myInteger = 3; 

uint myUnsignedInt = 2; 

double myDouble = 4.0; 

long myLong = myInteger + myUnsignedInt; 

double myotherDouble = myDouble + mylInteger; 


考虑 当 编 译 器 遇 到 下 面 这 行 代码 时 会 发 生 什么 情况 : 
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long myLong = myInteger + myUnsignedInt.; 

编译 器 知道 它 需 要 把 两 个 整数 加 起 来 ， 并 把 结果 赋予 一 个 long 型 变量 。 调 用 一 个 方法 把 数字 加 在 一 起 时 ， 
表达 式 myInteger + myUnsignedmt 是 一 种 非常 直观 和 方便 的 语法 。 该 方法 接受 两 个 参数 myImteger 和 
myUnsienedInt， 并 返回 它们 的 和 。 所 以 编译 器 完成 的 任务 与 任何 方法 调用 一 样 一 一 它 会 根据 参数 类 型 查找 最 
匹配 的 + 运算 符 重 载 ， 这 里 是 带 两 个 整数 参数 的 + 运算 符 重 载 。 与 一 般 的 重 载 方法 一 样 ， 预 定义 的 返回 类 型 不 会 
因为 编译 器 调用 方法 的 哪个 版 本 而 影响 其 选择 。 在 本 例 中 调用 的 重 载 方法 接受 两 个 nt 参数， 返回 一 个 int 值 ， 
这 个 返回 值 随后 会 转换 为 long 类 型 。 

下 一 行 代码 让 编译 器 使 用 + 运算 符 的 另 一 个 重 载 版 本 ; 

double myotherDouble = myDouble + myInteger; 

在 这 个 实例 中 ,参数 是 一 个 double 类 型 的 数据 和 一 个 int 类 型 的 数据 , 但 + 运算 符 没 有 这 种 复合 参数 的 重 载 
形式 ， 所 以 编译 器 认为 ， 最 匹配 的 + 运算 符 重 载 是 把 两 个 double 数据 作为 其 参数 的 版 本 ， 并 隐 式 地 把 int 强制 转 
换 为 double。 把 两 个 double 数据 加 在 一 起 与 把 两 个 整数 加 在 一 起 完全 不 同 , 浮 点 数 人 存储 为 一 个 尾数 和 一 个 指数 。 
把 它们 加 在 一 起 要 按 位 移动 一 个 double 数据 的 尾数 ， 从 而 使 两 个 指数 有 相同 的 值 ， 然 后 把 尾数 加 起 来 ， 移 动 所 
得 到 尾数 的 位 ， 调 整 其 指数 ， 保 证 答案 有 尽 可 能 高 的 精度 。 

现在 ， 看 看 如 果 编 译 器 遇 到 下 面 的 代码 会 发 生 什 么 : 

ne 


VECt3 = vectl + 如 EC 七 之 ， 
VECtl1 = vectl] * 2- 


其 中 ，Vector 是 结构 ， 稍 后 再 定义 它 。 编 译 器 知道 它 需 要 把 两 个 Vector 实例 加 起 来 ， 即 vectl 和 vect2。 
它 会 查找 + 运算 符 的 重 载 ， 该 重 载 版 本 把 两 个 Vector 实例 作为 参数 。 

如 果 编 译 器 找到 这 样 的 重 载 版 本 ， 它 就 调用 该 运算 和 从 的 实现 代码 。 如 果 找 不 到 ， 它 就 要 看 看 有 没有 可 以 用 
作 最 佳 匹 配 的 其 他 + 运算 符 重 载 ， 例 如 ， 某 个 运算 符 重 载 对 应 的 两 个 参数 是 其 他 数据 类 型 ， 但 可 以 隐 式 地 转换 
为 Vector 实例 。 如 果 编 译 器 找 不 到 合适 的 运算 符 重 载 ， 就 会 产生 一 个 编译 错误 ， 就 像 找 不 到 其 他 方法 调用 的 合 
适 重 载 版 本 一 样 。 


6.6.2 ”运算 符 重 载 的 示例 : Vector 结构 


本 小 节 将 开发 一 个 结构 Vector 来 说 明 运 算 符 重 载 ， 这 个 Vector 结构 表示 一 个 三 维 数学 矢量 。 如 果 数 学 不 是 
你 的 强项 ， 不 必 担 心 ， 我 们 会 使 这 个 例子 尽 可 能 简单 。 束 此 处 而 言 ， 三 维 矢 量 只 是 3 个 (double) 数 字 的 集合 ， 说 
明 物 体 的 移动 速度 。 表 示 数 字 的 变量 是 X、 y 和 z， x 表示 物体 同 东 移动 的 速度 ，y 表示 物体 癌 北 移动 的 速 
度 ，z 表示 物体 同上 移动 的 速度 (高 度 )。 把 这 3 个 数字 组 合 起 来 ， 就 得 到 总 移动 量 。 例 如 ， 如 果 x=3.0、 y=3.0、 
_z=1.0， 一 般 可 以 写作 (3.0, 3.0, 1.0)， 表 示 物 体 问 东 移 动 3 个 单位 ， 回 北 移 动 3 个 单位 ， 癌 上 移动 1 个 单位 。 

矢量 可 以 与 其 他 矢量 或 数字 相 加 或 相 乘 。 在 这 里 我 们 还 使 用 术语 “标量 ”， 它 是 简单 数字 的 数学 用 语 一 一 在 
C# 中 就 是 一 个 double 数据 。 相 加 的 作用 很 明显 。 如果 先 移 动 (3.0. 3.0, 1.0) 天 量 对 应 的 距离 , 再 移动 (2.0. -4.0, -4.0) 
天 量 对 应 的 距离 ， 总 移动 量 就 是 把 这 两 个 天 量 加 起 来 。 矢 量 的 相 加 指 把 每 个 对 应 的 组 成 元 素 分 别 相 加 ， 因 此 得 
到 (5.0, 一 1.0, -3.0)。 此 时 ， 数 学 表达 式 总 是 写成 c=atb， 其 中 a 和 b 是 矢量 ,，c¢ 是 结果 矢量 。 这 与 Vector 结构 的 
使 用 方式 一 样 。 

注意 : 

这 个 例子 将 作为 一 个 结构 而 不 是 类 来 开发 ， 但 这 并 不 重要 。 运 算 符 重 载 用 于 结构 和 类 时 ， 其 工作 方式 是 一 
样 的 。 

下 面 是 Vector 的 定义 一 一 包含 只 读 属 性 、 构 造 函 数 和 重 写 的 ToString0 方 法 , 以 便 轻 松 地 查看 Vector 的 内 容 ， 
最 后 是 运算 符 重 载 (代码 文件 OperatorOverloadingSample/Vector.cs): 


struct Vector 
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{ 
Public Vector (double x, double y, double z) 
{ 


public double X { get; } 

PUublic double Y { get; } 

Public double 2 { get; } 

public override string ToString() => S$"™( {xX}, {Y}, {2} }"™s; 
} 


这 里 提供 了 两 个 构造 函数 ,通过 传递 每 个 元 素 的 值 或 者 提供 男 一 个 复制 其 值 的 Vector 来 指定 天 量 的 初始 值 。 
第 二 个 构造 函数 带 一 个 Vector 参数 ， 通 第 称 为 复制 构造 函数 ， 因 为 它们 允许 通过 复制 男 一 个 实例 来 初始 化 一 个 
下 面 是 Vector 结构 的 有 趣 部 分 一 一 为 + 运算 符 提供 支持 的 运算 从重 载 ; 


public static Vector operator +(Vector left, Vector right) 三 > 
new Vector (1eftt-X + right.X, left.Y + right.Y¥Y, left.% + right.2); 


运算 符 重 载 的 声明 方式 与 静态 方法 基本 相同 ， 但 operator 关键 字 告 诉 编译 器 ， 它 实际 上 是 一 个 自 定义 的 运 
算 符 重 载 ， 后 面 是 相关 运算 符 的 实际 符号 ， 在 本 例 中 就 是 +。 返 回 类 型 是 在 使 用 这 个 运算 符 时 获得 的 类 型 。 在 
本 例 中 ， 把 两 个 矢量 加 起 来 会 得 到 另 一 个 矢量 ， 所 以 返回 类 型 也 是 Vector。 对 于 这 个 特定 的 + 运算 符 重 载 ， 返 回 
类 型 与 包含 的 类 一 样 ， 但 并 不 一 定 是 这 种 情况 ， 在 本 示例 中 稍 后 将 看 到 。 两 个 参数 就 是 要 操作 的 对 象 。 对 于 二 
元 运算 符 ( 带 两 个 参数 )， 如 + 和 -运算 待 ， 第 一 个 参数 是 运算 符 左 边 的 值 ， 第 二 个 参数 是 运算 符 右 边 的 值 。 

这 个 实现 代码 返回 一 个 新 的 矢量 ， 该 矢量 用 left 和 right 变量 的 X、 立 和 Z 属性 初始 化 。 

C# 要 求 所 有 的 运算 符 重 载 都 声明 为 public 和 static, 这 表示 它们 与 其 类 或 结构 相关 联 , 而 不 是 与 某 个 特定 实 
例 相 关联 ， 所 以 运算 符 重 载 的 代码 体 不 能 访问 非 静态 类 成 员 ， 也 不 能 访问 this 标识 符 ， 这 是 可 行 的 ， 因 为 参数 
提供 了 运算 符 执行 其 任务 所 需要 知道 的 所 有 输入 数据 。 

下 面 需 要 编写 一 些 简单 的 代码 来 测试 Vector 结构 (代码 文件 OperatorOverloadingSample/Program.cs): 

VOId Maln() 

Vector vectl, vect2, vect3; 


Vectl = new Vector(3.0, 3.0, 1.0)s 
VeEct2z = new Vector{(2.0, -4.0, 4.0})}; 


VEect3 = vectl + vect2,; 

Console.WriteLine (S$"vectl] = {vectl1}"); 
Console .WriteLine ($"vect2 = {vect2}"); 
Console.WriteLine ($"vect3 = {vect3}"); 


} 

编译 并 运行 这 些 代 码 ， 结 果 如 下 : 

vectl1 = ( 3, 3, 1) 

vect2 = ( 2, -4, -4) 

vect3 = ( 5, -1, -3) 

舌 量 除了 可 以 相 加 之 外 ， 还 可 以 相 乘 、 相 减 和 比较 它们 的 值 。 本 节 通 过 添加 几 个 运算 符 重 载 ， 扩 展 了 这 个 
Vector 例子 。 这 并 不 是 一 个 功能 齐全 的 真实 的 Vector 类 型 ， 但 足以 说 明 运 算 符 重 载 的 其 他 方面 了 。 首 先 要 重 载 
乘法 运算 待 ， 以 文 持 标量 和 矢量 的 相 乘 以 及 和 天 量 和 和 天 量 的 相 乘 。 

和 天 量 乘 以 标量 只 意味 着 矢量 的 每 个 组 成 元 背 分 别 与 标量 相 乘 ， 例 如 ，2*#(1.0. 2.5, 2.0) 返 回 (2.0. 5.0, 4.0)。 相 
关 的 运算 符 重 载 如 下 所 示 ( 代 码 文件 OperatorOverloadingSample2/Vector.cs): 


public static Vector operator *(double left, Vector right) => 
new Vector(left * right.X, left * right.Y¥Y, left * right.%); 
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但 这 还 不 够 ， 如 果 a 和 hb 声明 为 Wector 类 型 ， 就 可 以 编写 下 面 的 代码 : 


b= 2 * ar 
编译 器 会 隐 式 地 把 整数 2 转换 为 double 类 型 ， 以 匹配 运算 符 重 载 的 签名 。 但 不 能 编译 下 面 的 代码 : 
DD=a* Ar 


编译 器 处 理 运 算 符 重 载 的 方式 与 方法 重 载 是 一 样 的 。 它 会 查看 给 定 运 算 符 的 所 有 可 用 重 载 ， 找 到 与 之 最 匹 
配 的 重 载 方式 。 上 面 的 语句 要 求 第 一 个 参数 是 Vector， 第 二 个 参数 是 整数 ， 或 者 可 以 隐 式 转换 为 整数 的 其 他 数 
据 类 型 。 我 们 没有 提供 这 样 一 个 重 载 。 有 一 个 运算 符 重 载 ， 其 参数 依次 是 一 个 double 和 一 个 Vector， 但 编译 器 不 
能 交换 参数 的 顺序 ， 所 以 这 是 不 可 行 的 。 需 要 显 式 地 定义 一 个 运算 符 重 载 ， 其 参数 依次 是 一 个 Vector 和 一 个 
double， 有 两 种 方式 可 以 实现 这 样 的 运算 符 重 载 。 第 一 种 方式 是 对 矢量 乘法 进行 分 解 ， 和 处 理 所 有 运算 符 的 方 
式 一 样 ， 显 式 执 行 天 量 相 乘 操作 : 


Public static Vector operator *(Vector left, double right) => 
mew Vector (right * left.X, right 六 left.Y, right * left.2}); 


前 面 已 经 编写 了 实现 基本 相 乘 操作 的 代码 ， 最 好 重用 该 代码 : 

public static Vector operator * (Vector left, double right) => right * left; 

这 段 代码 会 有 效 地 告诉 编译 器 ， 如 果 有 Vector 和 double 数据 的 相 乘 操作 ， 编 译 器 就 颠倒 参数 的 顺序 ， 调 用 
另 一 个 运算 符 重 载 。 本 章 的 示例 代码 使 用 第 二 个 版 本 ， 因 为 它 看 起 来 比较 简洁 ， 同 时 阐述 了 该 行为 的 思想 。 利 
用 这 个 版 本 可 以 编写 出 可 维护 性 更 好 的 代码 ， 因 为 不 需要 复制 代码 ， 就 可 在 两 个 独立 的 重 载 中 执行 相 乘 操作 。 

下 一 个 要 重 载 的 乘法 运算 符 文 持 天 量 相 乘 。 在 数学 领域 ， 和 天 量 相 乘 有 两 种 方式 ， 但 这 里 我 们 感 兴趣 的 是 点 
积 或 内 积 ， 其 结果 实际 上 是 一 个 标量 。 这 就 是 我 们 介绍 这 个 例子 的 原因 : 算术 运算 符 不 必 返 回 与 定义 它们 的 类 
相同 的 类 型 。 

在 数学 术语 中 ， 如 果 有 两 个 矢量 (x, y, z) 和 (X,Y. Z)， 其 内 积 就 定义 为 X* 义 +y* Y+zZ* Z 的 值 。 两 个 天 量 
这 样 相 乘 很 奇怪 ， 但 这 实际 上 很 有 用 ， 因 为 它 可 以 用 于 计算 各 种 其 他 的 数 。 当 然 ， 如 果 要 使 用 Direct3D 或 
DirectDraw 编写 代码 来 显示 复杂 的 3D 图 形 ， 那 么 在 计算 对 象 放 在 屏幕 上 的 什么 位 置 时 ， 中 间 第 背 需 要 编写 代 
码 来 计算 矢量 的 内 积 。 这 里 我 们 关心 的 是 使 用 Vector 编写 出 doubleX= axb， 其 中 a 和 hb 是 两 个 Vector 对 象 ， 
并 计算 出 它们 的 点 积 。 相 关 的 运算 从重 载 如 下 所 示 : 


Public static double operator *(Vector left, Vector right) => 
left.X * right.X + left.Y * right.Y + left.2 * right.2; 


理解 了 算术 运算 符 后 ， 就 可 以 用 一 个 简单 的 测试 方法 来 检验 它们 是 否 能 正常 运行 (代码 文件 
OperatorOverloadineSample2/Proegram.cs): 
static woid Maint() 


i:/ stuff to demonstrate arithmetic operations 
Vector vectl1l, vect2, vect3: 

Vectl1 = new Vector(l1l.0, 1.3, 2.0)5; 

VECt2 = new Vector(0.0, 0.0, 10.0).; 


Vect3 = vectl + 了 EC 之， 

Console .WriteLine($"wvectl1 = {vectl1}"):; 

Console .WriteLine (S$S"vect2 = {vect2}"). 

Console .WriteLine($"vect3 = vectl1 + vect2 = {vect3}").; 

Console .WriteLine($"2 * vect3 = {2 * vect3}").: 

Console .WriteLine($"vect3 += vect2 gives {vect3 += vect2}").; 
Console .WriteLine (S$"vect3 = vectl] * 2 gives {vect3 = vectl * 2}"); 
Console .WriteLine (S$"vectl] 太 vect3 = {vectl * wect3}"): 


} 
运行 此 代码 ， 得 到 如 下 所 示 的 结果 : 


Vectl1 = ( 1, 1.5,. 2 ) 

Vect2 = ( 0, 0, -10 ) 

Vect3 = vectl] + vect2 = (1, 1.5, -8 ) 
2 *# vect3 = ( 2, 3, -16 } 

Vect3 二 = vect2 gives ( 1, 1.5, 18 } 
Vect3 = vectl * 2 gives ( 2, 3, 4) 
Vectl1 太 vect3 = 14.5 


这 说 明 ， 运 算 符 重 载 会 给 出 正确 的 结果 ， 但 如 果 仔细 看 看 测试 代码 ， 就 会 惊奇 地 注意 到 ， 实 际 上 它 使 用 的 
是 没有 重 载 的 运算 符 一 - 相 加 赋值 运算 符 (+=): 

Console .WriteLine ($"vect3 += Vect2 gives {vect3 += vect2}"); 

虽然 + 一 般 计 为 单个 运算 符 ， 但 实际 上 它 对 应 的 操作 分 为 两 步 : 相 加 和 赋值 。 与 C+ 语言 不 同 ，C# 不 允许 
重 载 -运算 符 ， 但 如 果 重 载 + 运 算 符 ， 编 译 器 就 会 自动 使 用 + 运算 符 的 重 载 来 执行 +=- 运 算 符 的 操作 。- =、*=-、 广 
和 &= 等 所 有 赋值 运算 符 也 遵循 此 原则 。 


6.6.3 比较 运算 符 的 重 载 


本 章 前 面 介绍 过 ，C# 中 有 6 个 比较 运算 符 ， 它 们 分 为 3 对 : 
@ == 各!= 
多 二 和 一 


e > 一 和 = 一 


注意 : 
.NET 指南 指定 ， 在 比较 两 个 对 象 时 ， 如 果 一 运算 符 返 回 true， 就 应 总 是 返回 tue。 所 以 应 在 不 可 改变 的 类 
型 上 只 重 载 一 运算 符 。 


C#i 语 言 要 求 成 对 重 载 比较 运算 全。 即 ， 如 果 重 载 了 一 ， 也 就 必须 重 载 !=， 否 则 会 产生 编译 器 错误 。 男 外 ， 
比较 运算 符 必 须 返 回 布尔 类 型 的 值 。 这 是 它们 与 算术 运算 符 的 根本 区 别 。 例 如 ， 两 个 数 相 加 或 相 减 的 结果 理论 
上 取决 于 这 些 数值 的 类 型 。 前 面 提 到 ， 两 个 Vector 对 象 相 乘 会 得 到 一 个 标量 。 另 一 个 例子 是 NET 基 类 
System.DateTime。 两 个 DateTime 实例 相 减 ， 得 到 的 结果 不 是 一 个 DateTime， 而 是 一 个 System.TimeSpan 实例 。 
相 比 之 下 ， 如 果 比 较 运算 得 到 的 不 是 布尔 类 型 的 值 ， 就 没有 任何 意义 。 

除了 这 些 区 别 外 ， 重 载 比 较 运 算 符 所 遵循 的 原则 与 重 载 算 术 运 算 符 相 同 。 但 比较 两 个 数 并 不 那么 简单 。 例 
如 ， 如 果 只 比较 两 个 对 象 引 用 ， 束 是 比较 存储 对 象 的 内 存 地 址 。 比 较 运 算 符 很 少 进行 这 样 的 比较 ， 所 以 必须 纺 
写 代 人 码 重 载运 算 符 ， 比 较 对 象 的 值 ， 并 返回 相应 的 布尔 结果 。 下 面 对 Vector 结构 重 载 一 和 != 运 算 待 。 首 先是 实 
现 一 重 载 的 代码 (代码 文件 OverloadingComparisonSample/Vectorcs): 

ee static bool operator == (Vector left, Vector right) 


if (object.ReferenceEquals (left, right)) return true; 
return left.X == right.X && left.Y == rijght.Y && left.2 == right.2; 


这 种 方式 仅 根 据 Vector 组 成 元 素 的 值 来 对 它们 进行 相等 性 比较 。 对 于 大 多 数 结构 , 这 就 是 我 们 希望 的 方式 ， 
但 在 茶 些 情况 下 ， 可 能 需要 仔细 考虑 相等 性 的 含义 。 例 如 ， 如 果 有 风 入 的 类 ， 那 么 是 应 比较 引用 是 否 指 向 同一 
个 对 象 ( 浅 度 比 较 )， 还 是 应 比较 对 象 的 值 是 人 否 相 等 (深度 比较 )? 

浅 度 比较 是 比较 对 象 是 否 指 同 内 存 中 的 同一 个 位 置 ， 而 深度 比较 是 比较 对 象 的 值 和 属性 是 否 相 等 。 应 根据 
具体 情况 进行 相等 性 检查 ， 从 而 有 助 于 确定 要 验证 的 结果 。 


让 

不 要 通过 调用 从 System.Object 中 继承 的 Equals(0) 方 法 的 实例 版 本 来 重 载 比较 运算 符 。 如 果 这 么 做 ， 在 objA 
是 null 时 判断 (objA=-objB)， 就 会 产生 一 个 异常 ， 因 为 NET 运行 库 会 试图 判断 null Equals(objB)。 采 用 其 他 方 
法 ( 重 写 Equals(0) 方 法 以 调用 比较 运算 符 ) 比 较 安 全 。 

还 需要 重 载运 算 符 !=， 采 用 的 方式 如 下 : 

Public static bool operator !=(Vector left, Vector right) => !(left == right}); 

现在 重 写 Equals 和 GetHashCode 方法 。 这 些 方法 应 该 总 是 在 重 写 一 运算 符 时 进行 重 写 , 否则 编译 器 会 报错 。 

Public override bool Equals (object ob] ) 

{ 


if (ob] == null} return false; 
return this == (Vector)ob]; 
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ol} 


} 


Public override int GetHashCode() 三 > 
(Y .GetHashCode() 2».GetHashCode (); 


xX.GetHashCode() ~ 


Equals 方法 可 以 转 而 调用 一 运算 符 。 散 列 代 码 的 实现 应 比较 快速 ， 且 总 是 对 相同 的 对 象 返 回 相 同 的 值 。 这 
个 方法 在 使 用 字典 时 很 重要 。 在 字典 中 ， 它 用 来 建立 对 象 的 树 ， 所 以 最 好 把 返回 值 分 布 到 整数 范围 内 。double 
类 型 的 GetHashCode 方法 返回 double 值 的 整数 表示 。 对 于 Vector 类 型 ， 只 是 通过 XOR 合并 展 层 类 型 的 散 列 值 。 

对 于 值 类 型 , 也 应 该 实现 接口 下 quatable < 工 >。 这 个 接口 是 Equals 方法 的 一 个 强 类 型 化 版 本 , 由 基 类 Object 
定义 。 有 了 所 有 其 他 代码 ， 就 很 容易 实现 该 方法 : 

public bool Equals(Vector other) => this =- other; 

像 往 萤 一 样 ， 应 该 用 一 些 测 试 代码 快速 检查 重 写 方法 的 工作 情况 。 这 灵 定 义 3 个 Vector 对 象 ， 并 进行 比较 
(代码 文件 OverloadingComparisonSample/Prosgram.cs): 


static void Mainil)} 


{ 


TBT VEectl = new Vector(3.0, 3.0, -10.0)5 
VAar vect2 = new Vector(3.0, 3.0, 10.0}); 
Var Vect3 = new Vectort(2.0, 3.0, 6.0); 
Console .WriteLine($"vectl] == vect2 returns {(vectl == vect2) }").; 
Console .WriteLine (S$"™vectl1] == vect3 returns {lvectl1 == vect3)}").-: 
Console .WriteLine (S$"vect2 == vect3 returns {(vect2 == vect3) 1}").: 
Console .WriteLine(). 
Console .WriteLine{($"vectl] != vect2 returns {(vectl ‘= vect2)}").; 
Console .WriteLine (S$"vectl1 I!= vect3 returns {lvectl ‘= vect3)}").; 
Console .WriteLine (S$"vect2 != vect3 returns {(vect2 != vect3)}").: 

} 

在 命令 行 上 运行 该 示例 ， 生 成 如 下 结果 : 

Vectl1 == vect2 returns True 

VECctl1 一 一 vect3 returns False 

VECct2 == Vvect3 returns False 

VEectl1 【一 vect2 returns False 

了 EC 【一 Vect3 returns True 

Vect2 I= Vect3 returns True 


6.6.4 可 以 重 载 的 运算 符 


并 不 是 所 有 的 运算 符 都 可 以 重 载 。 可 以 重 载 的 运算 符 如 表 6-5 所 示 。 


按 位 二 元 运算 符 
按 位 一 元 运算 符 
比较 运算 符 
赋值 运算 符 


索引 运算 符 


类 型 强制 转换 运 
算 符 


表 6-5 
制 | 


true 和 和 lse 运算 符 必须 成 对 重 载 

比较 运算 符 必 须 成 对 重 载 

不 能 显 式 地 重 载 这 些 运算 符 ， 在 重 写 单个 运算 符 ( 如 +、-、% 等 时， 它们 
会 被 隐 式 地 重 写 

不 能 直接 重 载 索引 运算 符 。 第 2 章 介绍 的 索引 器 成 员 类 型 多 许 在 类 和 结 
构 上 支持 索引 运算 符 

不 能 直接 重 载 类 型 强制 转换 运算 符 。 用 户 定义 的 类 型 强制 转换 (本 章 后 面 
介绍 ) 允 许 定 义 定 制 的 类 型 强制 转换 行为 
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注意 : 

为 什么 要 重 载 true 和 false 操作 符 ? 有 一 个 很 好 的 原因 : 根据 所 使 用 的 技术 或 框架 ， 哪 些 整 数值 代表 true 
或 false 是 不 同 的 。 在 许多 技术 中 ，0 是 false，1 是 true: 其 他 技术 把 非 0 值 定义 为 tue， 还 有 一 些 技术 把 -1 
定义 为 false。 


6.7 ”实现 自 定义 的 索引 运算 符 


自 定义 索引 器 不 能 使 用 运算 符 重 载 语法 来 实现 ， 但 是 它们 可 以 用 与 属性 非常 相似 的 语法 来 实现 。 

首先 看 看 数组 元 素 的 访问 。 这 里 创建 一 个 int 元 素数 组 。 第 二 行 代码 使 用 索引 器 来 访问 第 二 个 元 素 ， 并 给 
它 传递 42。 第 三 行使 用 索引 器 来 访问 第 三 个 元 素 ， 并 给 该 元 素 传 递 变量 x。 

1nt[] arrl = {1, 2, 3}; 


arrl[il] = 42; 
int x = arrli[2]: 


数组 在 第 7 章 益 述 。 


CustomIndexerSample 使 用 如 下 名 称 空间 : 


SYStem 
System.Collections.Generic 
System.Ling 


要 创建 自 定 义 索 引 器 ， 首 先 要 创建 一 个 Person 类 ， 其 中 包含 FirstName、LastName 和 Birthday 只 读 属性 ( 代 
码 文 件 CustomIndexerSample/Person.cs): 

public class Person 

public DateTime Birthday { get; } 


public string FirstName { get; } 
public string LastName { get; } 


Public Person(string firstName, string lastName, DateTime birthDay) 


FirstName = firstName.; 
LastName = lastName; 
Birthday = birthDay; 

} 


public override string ToString() => $"{FirstName} {LastName}"; 
} 
类 PersonCollection 定义 了 一 个 包含 Person 元 素 的 私有 数组 字段 ， 以 及 一 个 可 以 传递 许多 Person 对 象 的 构 
造 图 数 ( 代 码 文件 CustomIndexerSample/PersonCollection.cs): 
Public class PersonCollection 
private Person[] people; 
public PersonCollection(params Person[] people) => 
People = people.ToArray () 7 
为 了 允许 使 用 索引 器 语法 访问 PersonCollection 并 返回 Person 对 象 ， 可 以 创建 一 个 索引 器 。 索 引 器 看 起 来 
非常 类 似 于 属性 ， 因 为 它 也 包含 get 和 set 访问 器 。 两 者 的 不 同 之 处 是 名 称 。 指 定 索引 器 要 使 用 this 关键 字 。this 
关键 字 后 面 的 括号 指定 索引 使 用 的 类 型 。 数 组 提供 int 类 型 的 索引 器 ， 所 以 这 里 使 用 int 类 型 直接 把 信息 传递 给 
被 包含 的 数组 people。get 和 set 访问 器 的 使 用 非常 类 似 于 属性 。 检 索 值 时 调用 get 访问 器 ， 在 右边 传递 Person 
对 象 时 调用 set 访问 器 。 
Public Person this[int index] 
| get => people[index]; 


Set =» people[indexl] = Value; 


} 
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对 于 索引 器 , 不 能 仅 定 义 int 类 型 作为 索引 类 型 .任何 类 型 都 是 有 效 的 , 如 下 面 的 代码 所 示 , 其 中 把 DateTime 
结构 作为 索引 类 型 。 这 个 索引 器 用 来 返回 有 指定 生日 的 每 个 人 。 因 为 多 个 人 员 可 以 有 相同 的 生日 ， 所 以 不 是 返 
回 一 个 Person 对 象 ， 而 是 用 接口 下 numerable<Person> 人 返回 一 个 Person 对 象 列表 。 所 使 用 的 Where 方法 根据 
lambda 表达 式 进 行 过 滤 。Where 方法 在 名 称 空间 System.Linq 中 定义 : 

public IEnumerable<Person> this[DateTime birthDay] 


get => people.Where(p => p.Birthday == birthDay); 
} 


使 用 DateTime 类 型 的 索引 器 检索 人 员 对 象 ， 但 不 允许 把 人 员 对 象 设置 为 只 有 get 访问 器 ， 而 没有 set 访问 
器 。 在 C# 6 中 有 一 个 速记 符号 ， 可 使 用 表达 式 主 体 的 成 员 创 建 相同 的 代码 (属性 也 可 使 用 该 语法 ): 


public IEnumerable<Person> this[DateTime birthDay] => 
people.Where(p => p.Birthday °— birthDay); 


示例 应 用 程序 的 Main0 方 法 创建 一 个 PersonCollection 对 象 ， 给 构造 函数 传递 4 个 Person 对 象 。 在 第 一 个 
WriteLine 方法 中 ， 使 用 索引 器 的 get 访问 器 和 int 参数 访问 第 三 个 元 素 。 在 foreach 循环 中 ， 带 有 DateTime 参 
数 的 索引 器 用 来 传递 指定 的 日 期 (代码 文件 CustomIndexerSample/Program.cs): 


static void Malnl) 


{ 
Var pl = new Person("Ayrton™", "Senna", new DateTime (1960, 3, 21)); 
Var p2 = new Person("Ronnie™", "Peterson", new DateTime (1944, 2, 14)); 
Var p3 = new Person("Jochen™., "Rindt", new DateTime (1942, 4, 18)); 
Var p41 = new Person("Francois", "Cevert", new DateTime (1944, 2, 25)); 


Var CoOll = new PersonCollection(pl, p2, Pp3, p4); 
Console .WriteLine (coll[2]); 
foreach (var T in colll[new DateTime (1960, 3, 21)]) 


Console.WriteLine (r):; 
} 


Console.ReadLine (}); 


} 
运行 程序 ， 第 一 个 WriteLine 方法 把 Jochen Rindt 写 到 控制 台 。foreach 循环 的 结果 是 Ayrton Senna， 因 为 他 
的 生日 是 第 二 个 索引 器 中 指定 的 日 期 。 


6.8 用 户 定 义 的 类 型 强制 转换 


本 章 前 面 介绍 了 如 何在 预定 义 的 数据 类 型 之 间 转 换 数值 ， 这 通过 类 型 强制 转换 过 程 来 完成 。C# 人 允许 进行 两 
种 不 同类 型 的 强制 转换 隐 式 强制 转换 和 显 式 强制 转换 。 本 节 将 讨论 这 两 种 类 型 的 强制 转换 。 

显 式 强制 转换 要 在 代码 中 显 式 地 标记 强制 转换 ， 即 应 该 在 圆 括 号 中 写 出 目标 数据 类 型 

a 

short s = (short}i; // explicit 

对 于 预定 义 的 数据 类 型 ， 当 类 型 强制 转换 可 能 失败 或 丢失 某 些 数据 时 ， 需 要 显 式 强制 转换 。 例 如 : 

e 把 int 转换 为 short 时 ，short 可 能 不 够 大 ， 不 能 包含 对 应 int 的 数值 。 

e 把 有 符号 的 数据 类 型 转换 为 无 符号 的 数据 类 型 时 ， 如 果 有 符号 的 变量 包含 一 个 负 值 ， 就 会 得 到 不 正确 

的 结果 。 

e 把 浮 丘 数 转换 为 整数 数据 类 型 时 ， 数 字 的 小 数 部 分 会 丢失 。 

e 把 可 空 类 型 转换 为 非 可 空 类 型 时 ，null 值 会 导致 异 弟 。 

此 时 应 在 代码 中 进行 显 式 强制 转换 ， 告 诉 编 译 器 你 知道 存在 丢失 数据 的 危险 ， 因 此 编写 代码 时 要 把 这 种 可 
能 性 考虑 在 内 。 

C# 人 允许 定 义 自 己 的 数据 类 型 (结构 和 类 )， 这 意味 着 需要 某 些 工具 文 持 在 自 定义 的 数据 类 型 之 间 进 行 类 型 强 
制 转换 。 方 法 是 把 类 型 强制 转换 运算 符 定 义 为 相关 类 的 一 个 成 员 运 算 符 。 类 型 强制 转换 运算 符 必 须 标记 为 隐 式 
或 显 式 ， 以 说 明 希 望 如 何 使 用 它 。 我 们 应 遵循 与 预定 义 的 类 型 强制 转换 相同 的 指导 原则 ;， 如 果 知 道 无论 在 源 变 
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量 中 存储 什么 值 ， 类 型 强制 转换 总 是 安全 的 ， 就 可 以 把 它 定 义 为 隐 式 强制 转换 。 然 而 ， 如 果 茶 些 数值 可 能 会 出 
错 ， 如 丢失 数据 或 抛 出 异常 ， 就 应 把 数据 类 型 转换 定义 为 显 式 强制 转换 。 


注意 : 
如 果 源 数据 值 会 使 类 型 强制 转换 失败 ， 或 者 可 能 会 抛 出 异常 ， 就 应 把 任何 自 定 义 类 型 强制 转换 定义 为 显 式 
强制 转换 。 


定义 类 型 强制 转换 的 语法 类 似 于 本 章 前 面 介 绍 的 重 载运 算 符 。 这 并 不 是 偶然 现象 ， 类 型 强制 转换 在 某 种 情 
况 下 可 以 看 为 一 种 运算 符 ， 其 作用 是 从 源 类 型 转换 为 目标 类 型 。 为 了 说 明 这 种 语法 ， 下 面 的 代码 从 本 节 后 面 介 
绍 的 结构 Currency 示例 中 节选 而 来 : 

public static implicit operator float (Currency value) 


/i processing 


} 

运算 符 的 返回 类 型 定义 了 类 型 强制 转换 操作 的 目标 类 型 ， 它 有 一 个 参数 ， 即 要 转换 的 源 对 象 。 这 里 定义 的 
类 型 强制 转换 可 以 隐 式 地 把 Currency 型 的 值 转换 为 float 型 。 注 意 ， 如 果 数 据 类 型 转换 声明 为 隐 式 ， 编 译 器 就 
可 以 隐 式 或 显 式 地 使 用 这 个 转换 。 如 果 数 据 类 型 转换 声明 为 显 式 ， 编 译 器 就 只 能 显 式 地 使 用 它 。 与 其 他 运算 符 
重 载 一 样 ， 类 型 强制 转换 必须 同时 声明 为 public 和 static。 


C++ 开发 人 员 应 注意 ， 这 种 情况 与 C++ 中 的 用 法 不 同 ， 在 C++ 中 ， 类 型 强制 转换 用 于 类 的 实例 成 员 。 


6.8.1 实现 用 户 定义 的 类 型 强制 转换 


本 节 将 在 示例 SimpleCurency 中 介绍 隐 式 和 显 式 的 用 户 定义 类 型 强制 转换 用 法 。 在 这 个 示例 中 ， 定 义 一 个 
结构 Currency, 它 包含 一 个 正 的 USD(S) 金 额 。C# 为 此 提供 了 decimal 类 型 , 但 如 果 要 进行 比较 复杂 的 财务 处 理 ， 
仍 可 以 编写 自己 的 结构 和 类 来 表示 相应 的 金额 ， 在 这 样 的 类 上 实现 特定 的 方法 。 


注意 : 
类 型 强制 转换 的 语法 对 于 结构 和 类 是 一 样 的 。 本 示例 定义 了 一 个 结构 , 但 把 Currency 声明 为 类 也 是 可 行 的 。 


首先 ，Curency 结构 的 定义 如 下 所 示 ( 代 码 文 件 CastingSample/Currency.cs): 


public struct Currency 

| 
Public uint Dollars { get; } 
Public ushort Cents { get; } 


Public Currency(uint dollars, ushort cents) 
Dollars = dollars; 
Cents = cents.; 


} 


Public override string ToString{() => $"${Dollars}.{Cents,—2:00}"» 
} 


Dollars 和 Cents 属性 使 用 无 符号 的 数据 类 型 ， 可 以 确保 Currency 实例 只 能 包含 正 值 。 采 用 这 样 的 限制 是 为 
了 在 后 面 说 明显 式 强制 转换 的 一 些 要 点 。 可 以 像 这 样 使 用 一 个 类 来 存储 公司 员工 的 薪水 信息 。 员 工 的 薪水 不 会 


是 负 值 ! 
下 面 先 假定 要 把 Currency 实例 转换 为 float 值 ， 其 中 float 值 的 整数 部 分 表示 美元 。 换 言 之 ， 应 编写 下 面 的 
代码 : 


Var balance = new Currency(10, 50); 
float f = balance; // We want f to be set to 10.5 
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为 此 ， 需 要 定义 一 种 类 型 强制 转换 。 给 Currency 的 定义 添加 下 述 代码 : 


Public static implicit operator float (Currency value) 三 > 
value.Dollars + (value.Cents/100.0f); 


这 种 类 型 强制 转换 是 隐 式 的 。 在 本 例 中 这 是 一 种 合理 的 选择 ， 因 为 在 Curency 的 定义 中 ， 可 以 存储 在 
Currency 中 的 值 也 都 可 以 存储 在 float 数据 中 。 在 这 种 强制 转换 中 ， 不 应 出 现任 何 错误 。 


注意 : 
这 里 有 一 点 欺骗 性 : 实际 上 ， 当 把 uint 转换 为 float 时 ,精确 度 会 降低 , 但 Microsoft 认为 这 种 错误 并 不 重要 ， 
因此 把 从 uint 到 float 的 类 型 强制 转换 都 当 作 隐 式 转换 。 


但 是 ， 如 果 把 float 型 转换 为 Currency 型 ， 就 不 能 保证 转换 肯定 成 功 了 。float 型 可 以 存储 负 值 ， 而 Currency 
实例 不 能 ， 且 float 型 存储 数值 的 数量 级 要 比 Currency 型 的 (uint)jDollar 字段 大 得 多 。 所 以 ， 如 果 float 型 包含 一 
个 不 合适 的 值 ， 把 它 转 换 为 Currency 型 就 会 得 到 意 想不到 的 结果 。 因 此 ， 从 float 型 转换 到 Currency 型 就 应 定 
义 为 显 式 转换 。 下 面 是 我 们 的 第 一 次 尝试 ， 这 次 不 会 得 到 正确 的 结果 ,但 有 助 于 解释 原因 : 


public static explicit operator Currency (float value) 


{ 


uint dollars = (uint)}value; 
ushort cents = {ushort} ((value—-dollars} *100}). 
return new Currency(dollars, cents); 

} 


下 面 的 代码 现在 可 以 成 功 编译 : 


float amount = 45.63f; 
Currency amount2 = (Currency) amount; 


但 是 ， 下 面 的 代码 会 抛 出 一 个 编译 错误 ， 因 为 它 试图 隐 式 地 使 用 一 个 显 式 的 类 型 强制 转换 : 


float amount = 45.63f; 
Currency amount2 = amount; // wrong 


把 类 型 强制 转换 声明 为 显 式 ， 就 是 警告 开发 人 员 要 小 心 ， 因 为 可 能 会 丢失 数据 。 但 这 不 是 我 们 和 希望 的 
Curency 结构 的 行为 方式 。 下 面 编写 一 个 测试 程序 ， 并 运行 该 示例 。 其 中 有 一 个 Main0 方 法 ， 它 实例 化 一 个 
Currency 结构 ， 并 试图 进行 几 次 转换 。 在 这 段 代 码 的 开头 ， 以 两 种 不 同 的 方式 计算 balance 的 值 ， 因 为 要 使 用 
它们 来 说 明 后 面 的 内 容 ( 代 码 文 件 CastingSample/Program.cs): 


static void Mainl() 
{ 
try 
{ 
var balance = new Currency (50,35)s 
Console.WriteLine (balance}.: 
Console .WriteLine($"balance is {balance}"™); // implicitly invokes ToString 
float balance2 = balance; 
Console.WriteLine($"After converting to float, = {balance2}"); 
balance = (Currency) balance2; 
Console.WriteLine ($s$"After converting back to Currency, = {balance}"); 
Console.WriteLine ("Now attempt to convert out of range value of ™ + 
"一 5$50-50 to a Currency:"); 


checked 
{ 
balance = (Currency) (~-30.50) 5 
Console .WriteLine($"Result is {balance}"),;} 
} 
} 
catch (Exception e) 
| 
Console.WriteLine($"Exception occurred: {e-Messagel") ， 
} 
} 


注意 ， 所 有 的 代码 都 放 在 一 个 ty 块 中 ， 以 捕获 在 类 型 强制 转换 过 程 中 发 生 的 任何 异常 。 在 checked 块 
中 还 添加 了 把 超出 范围 的 值 转换 为 Currency 的 测试 代码 ， 以 试图 捕获 负 值 。 运 行 这 段 代码 ， 得 到 如 下 所 示 
的 结果 : 
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50.35 

Balance 1s $50.35 

After converting to float, = 50.35 

After converting back to Currency, = $50.34 

Now attempt to convert out of range value of -$50.50 to a Currency: 
Result is $4294967246.00 


这 个 结果 表示 代码 并 没有 像 我 们 希望 的 那样 工作 。 首 先 ， 从 float 型 转换 回 Currency 型 得 到 一 个 错误 的 结 
果 $50.34， 而 不 是 $50.35。 其 次 ， 在 试图 转换 明显 超出 范围 的 值 时 ， 没 有 生成 异常 。 

第 一 个 问题 是 由 舍 入 错误 引起 的 。 如 果 类 型 强制 转换 用 于 把 float 值 转换 为 uint 值 , 计算 机 就 会 截 去 多 余 的 
数字 ， 而 不 是 执行 四 舍 五 入 。 计 算 机 以 二 进 制 而 非 十 进 制 方式 存储 数字 ， 小 数 部 分 0.35 不 能 用 二 进 制 小 数 来 精 
确 表示 ( 像 1/3 这 样 的 分 数 不 能 精确 地 表示 为 十 进 制 小 数 ， 它 应 等 于 循环 小 数 0.3333)。 所 以 , 计算 机 最 后 存储 了 
一 个 略 小 于 0.35 的 值 ， 它 可 以 用 二 进 制 格式 精确 地 表示 。 把 该 数字 乘 以 100， 就 会 得 到 一 个 小 于 35 的 数字 ， 它 
截 去 了 34 美 分 。 显 然 在 本 例 中 ， 这 种 由 截 去 引起 的 错误 是 很 严重 的 ， 避 免 该 错误 的 方式 是 确保 在 数字 转换 过 程 
中 执行 智能 的 四 舍 五 入 操作 。 

走运 的 是 ，Microsoft 编写 了 一 个 类 System.Convert 来 完成 该 任务 。System.Convert 对 象 包含 大 量 的 静态 
方法 来 完成 各 种 数字 转换 , 我们 需要 使 用 的 是 Convert.ToUInt160。 注意, 在 使 用 System.Convert 类 的 方法 
时 会 造成 额外 的 性 能 损失 ， 所 以 只 应 在 需要 时 使 用 它们 。 

下 面 看 看 为 什么 没有 抛 出 期 望 的 洲 出 异常 。 此 处 的 问题 是 游 出 异常 实际 发 生 的 位 置 根本 不 在 MainO0 例 程 
中 一 一 它 是 在 强制 转换 运算 符 的 代码 中 发 生 的 ， 该 代码 在 Main0 方 法 中 调用 ， 而 且 没 有 标记 为 checked。 

其 解决 方法 是 确保 类 型 强制 转换 本 和 喘 也 在 checked 环境 下 进行 。 进 行 了 这 两 处 修改 后 ， 修 订 的 转换 代码 如 
下 所 示 。 


Public static explicit operator Currency (float value) 
{ 
checked 


{ 
uint dollars = (uint}value; 
usShort cents = Convert.ToUIntlé( (value-dollars}*100)});， 
return new Currency (dollars, cents); 


} 
注意 ， 使 用 Convert.ToUInt160 计 算数 字 的 美 分 部 分 ， 如 上 所 示 ， 但 没有 使 用 它 计 算数 字 的 美元 部 分 。 在 计算 
美元 值 时 不 需要 使 用 System.Convert， 因 为 在 此 我 们 希望 截 去 float 值 。 


注意 : 
System.Convert 类 的 方法 还 执行 它们 自己 的 溢出 检查 .因此 对 于 本 例 的 情况 , 不 需要 把 对 Convert.ToUInt16() 
的 调用 放 在 checked 环境 下 。 但 把 value 显 式 地 强制 转换 为 美元 值 仍 需要 checked 环境 。 


这 里 没有 给 出 这 个 新 的 checked 强制 转换 的 结果 , 因为 在 本 节 后 面 还 要 对 SimpleCurency 示例 进行 一 些 修改 。 


注意 : 

如 果 定 义 了 一 种 使 用 非常 频繁 的 类 型 强制 转换 ， 其 性 能 也 非常 好 ， 就 可 以 不 进行 任何 错误 检查 。 如 果 对 用 
户 定义 的 类 型 强制 转换 和 没有 检查 的 错误 进行 了 清晰 的 说 明 ， 这 也 是 一 种 合理 的 解决 方案 。 

1. 类 之 间 的 类 型 强制 转换 

Currency 示例 仅 涉及 与 float( 一 种 预定 义 的 数据 类 型 ) 来 回转 换 的 类 。 但 类 型 转换 不 一 定 会 涉及 任何 简单 
的 数据 类 型 。 定 义 不 同 结构 或 类 的 实例 之 间 的 类 型 强制 转换 是 完全 合法 的 ， 但 有 两 点 限制 : 

。 如果 某 个 类 派生 自 另 一 个 类 ， 就 不 能 定义 这 两 个 类 之 间 的 类 型 强制 转换 (这 些 类 型 的 强制 转换 已 经 

存在 )。 
。 类 型 强制 转换 必须 在 源 数 据 类 型 或 目标 数据 类 型 的 内 部 定义 。 
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为 说 明 这 些 要求 ， 假 定 有 如 图 6-1 所 示 的 类 层次 结构 。 


System Object 


换言之 ， 类 C 和 DD 间接 派生 于 A。 在 这 种 情况 下 ,在 A、B、C 或 D 之 间 唯 一 合法 的 自 定义 类 型 强制 转换 
就 是 类 C 和 D 之 间 的 转换 ， 因 为 这 些 类 并 没有 互相 派生 。 对 应 的 代码 如 下 所 示 ( 假 定 希 望 类 型 强制 转换 是 显 式 
的 ， 这 是 在 用 户 定 义 的 类 之 间 定 义 类 型 强制 转换 的 通 当 情况 ): 

Be static explicit operator D(C value) 


2 
} 


Public static explicit operator C(D value) 
{ 

FF 
} 


对 于 这 些 类 型 强制 转换 ， 可 以 选择 放置 定义 的 地 方 一 在 C 的 类 定义 内 部 ， 或 者 在 D 的 类 定义 内 部 ， 但 不 
能 在 其 他 地 方 定义 。c# 要 求 把 类 型 强制 转换 的 定义 放 在 源 类 (或 结构 ) 或 目标 类 (或 结构 ) 的 内 部 。 这 一 要 求 的 副 作 
用 是 不 能 定义 两 个 类 之 间 的 类 型 强制 转换 ， 除 非 至 少 可 以 编辑 其 中 一 个 类 的 源 代码 。 这 是 因为 ， 这 样 可 以 防止 
第 三 方 把 类 型 强制 转换 引入 类 中 。 

一 旦 在 一 个 类 的 内 部 定义 了 类 型 强制 转换 ， 就 不 能 在 另 一 个 类 中 定义 相同 的 类 型 强制 转换 。 显 然 ， 对 于 每 
一 种 转换 只 能 有 一 种 类 型 强制 转换 ， 否 则 编译 器 就 不 知道 该 选择 哪个 类 型 强制 转换 。 


2. 基 类 和 派生 类 之 间 的 类 型 强制 转换 


要 了 解 这 些 类 型 强制 转换 是 如 何 工 作 的 ， 首 先 看 看 源 和 目标 数据 类 型 都 是 引用 类 型 的 情况 。 考 虑 两 个 类 
MyBase 和 MyDerived， 其 中 MyDerived 直接 或 间接 派生 自 MyBase。 
首先 是 从 MyDerived 到 MyBase 的 转换 ， 代 码 如 下 (假定 提供 了 构造 函数 ): 


MyDerived derivedObject = new MyDerivedl(); 
MyBase baseCopy = derivedObject,; 


在 本 例 中 ， 是 从 MyDerived 隐 式 地 强制 转换 为 MyBase。 这 是 可 行 的 ， 因 为 对 类 型 MyBase 的 任何 引用 都 
可 以 引用 MyBase 类 的 对 象 或 派生 自 MyBase 的 对 象 。 在 OO 编程 中 ， 派 生 类 的 实例 实际 上 是 基 类 的 实例 ， 但 
加 入 了 一 些 额 外 的 信息 。 在 基 类 上 定义 的 所 有 函数 和 字段 也 都 在 派生 类 上 得 到 定义 。 

下 面 分 析 男 一 种 方式 ， 编 写 如 下 的 代码 : 

MyBase derivedobject = new MyDerived(); 

MyBase baseOQbJject = new MyBase(); 


MyDerived derivedCopyl = (MYDerived) derivedObject; // OK 
MyDerived derivedCopy2 = (MyDerived) baseQbject; // Throws exception 


上 面 的 代码 都 是 合法 的 C# 代 码 (从 语法 的 角度 来 看 是 合法 的 )， 它 说 明了 把 基 类 强制 转换 为 派生 类 。 但 是 ， 在 
执行 时 最 后 一 条 语句 会 抛 出 一 个 异常 。 在 进行 类 型 强制 转换 时 ， 会 检查 被 引用 的 对 象 。 因 为 基 类 引用 原则 上 可 以 
引用 一 个 派生 类 的 实例 ， 所 以 这 个 对 象 可 能 是 要 强制 转换 的 派生 类 的 一 个 实例 。 如 果 是 这 样 ， 强 制 转换 就 会 成 功 ， 
派生 的 引用 设置 为 引用 这 个 对 象 。 但 如 果 该 对 象 不 是 派生 类 (或 者 派生 于 这 个 类 的 其 他 类 ) 的 一 个 实例 ， 强 制 转换 
就 会 失败 ， 并 抛 出 一 个 异常 。 
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注意 ， 编 译 器 已 经 提供 了 基 类 和 派生 类 之 间 的 强制 转换 ， 这 种 转换 实际 上 并 没有 对 讨论 的 对 象 进行 任何 数 
据 转 换 。 如 果 要 进行 的 转换 是 合法 的 ， 它 们 也 仅 是 把 新 引用 设置 为 对 对 象 的 引用 。 这 些 强制 转换 在 本 质 上 与 用 
户 定义 的 强制 转换 不 同 。 例 如 ， 在 前 面 的 SimpleCurrency 示例 中 ， 我 们 定义 了 Curency 结构 和 float 数 之 间 的 
强制 转换 。 在 float 型 到 Currency 型 的 强制 转换 中 ， 实 际 上 实例 化 了 一 个 新 的 Currency 结构 ， 并 用 要 求 的 值 初 
始 化 它 。 在 基 类 和 派生 类 之 间 的 预定 义 强制 转换 则 不 是 这 样 。 如 果实 际 上 要 把 MyBase 实例 转换 为 真实 的 
MyDerived 对 象 ， 该 对 象 的 值 根据 MyBase 实例 的 内 容 来 确定 ， 就 不 能 使 用 类 型 强制 转换 语法 。 最 合适 的 选 
项 通常 是 定义 一 个 派生 类 的 构造 函数 ， 它 以 基 类 的 实例 作为 参数 ， 让 这 个 构造 函数 完成 相关 的 初始 化 : 

class DerivedClass: BaseClass 

public DerivedCclass (BaseClass base) 

// initialize object from the Base instance 
7 


3. 装 箱 和 拆 箱 类 型 强制 转换 

前 面 主要 讨论 了 基 类 和 派生 类 之 间 的 类 型 强制 转换 ， 其 中 ， 基 类 和 派生 类 都 是 引用 类 型 。 类 似 的 原则 也 适 
用 于 强制 转换 值 类 型 ， 尽 管 在 转换 值 类 型 时 ， 不 可 能 仅仅 复制 引用 ， 还 必须 复制 一 些 数据 。 

当然 ， 不 能 从 结构 或 基本 值 类 型 中 派生 。 所 以 基本 结构 和 派生 结构 之 间 的 强制 转换 总 是 基本 类 型 或 结构 与 
System.Object 之 间 的 转换 (理论 上 可 以 在 结构 和 System.ValueType 之 间 进 行 强 制 转 换 ， 但 一 般 很 少 这 么 做 )。 

从 结构 (或 基本 类 型 ) 到 object 的 强制 转换 总 是 一 种 隐 式 的 强制 转换 ， 因 为 这 种 强制 转换 是 从 派生 类 型 到 基 
本 类 型 的 转换 ， 即 第 2 章 简要 介绍 的 装 箱 过 程 。 例 如 ， 使 用 Currency 结构 : 


var balance = new Currency  dD DD) 
object baseCopy = balance; 


在 执行 上 述 隐 式 的 强制 转换 时 ，balance 的 内 容 被 复制 到 堆 上 ， 放 在 一 个 装 箱 的 对 象 中 ， 并 且 baseCopy 
对 象 引用 被 设置 为 该 对 象 。 在 后 台 实际 发 生 的 情况 是 ;在 最 初 定义 Currency 结构 时 ，NET Framework 隐 式 
地 提供 另 一 个 (隐藏 的 ) 类 ， 即 装 箱 的 Currency 类 ， 它 包含 与 Currency 结构 相同 的 所 有 字段 ， 但 它 是 一 个 引用 类 
型 ， 存 储 在 堆 上 。 无 论 定义 的 这 个 值 类 型 是 一 个 结构 ， 还 是 一 个 枚 举 ， 定 义 它 时 都 存在 类 似 的 装 箱 引用 类 型 ， 
对 应 于 所 有 的 基本 值 类 型 ， 如 int、double 和 uint 等 。 不 能 也 不 必 在 源 代码 中 直接 通过 编程 访问 某 些 装 箱 类 ,但 
在 把 一 个 值 类 型 强制 转换 为 object 型 时 ， 它 们 是 在 后 台 工作 的 对 象 。 在 隐 式 地 把 Currency 转换 为 object 时 ， 
会 实例 化 一 个 装 箱 的 Currency 实例 ， 并 用 Currency 结构 中 的 所 有 数据 进行 初始 化 。 在 上 面 的 代码 中 ，baseCopy 
对 象 引 用 的 就 是 这 个 已 装 箱 的 Currency 实例 。 通 过 这 种 方式 ， 就 可 以 实现 从 派生 类 型 到 基本 类 型 的 强制 转换 ， 
并 且 值 类 型 的 语法 与 引用 类 型 的 语法 一 样 。 

强制 转换 的 另 一 种 方式 称 为 拆 箱 。 与 在 基本 引用 类 型 和 派生 引用 类 型 之 间 的 强制 转换 一 样 ， 这 是 一 种 显 式 
的 强制 转换 ， 因 为 如 果 要 强制 转换 的 对 象 不 是 正确 的 类 型 ， 就 会 抛 出 一 个 异常 : 

object derivedobject = new Currency (40,0); 

object baseobject = new object(); 


Currency derivedCopyl = (Currency)derivedoObject; // OK 
Currency derivedCopy2 = {Currency)baseObject; // Exception thrown 


上 述 代 码 的 工作 方式 与 前 面 关 于 引用 类 型 的 代码 一 样 。 把 derivedObject 强制 转换 为 Currency 会 成 功 执行 ， 
因为 derivedObject 实际 上 引用 的 是 装 箱 Currency 实例 一 一 强制 转换 的 过 程 是 把 已 装 箱 的 Currency 对 象 的 字段 复 
制 到 一 个 新 的 Currency 结构 中 。 第 二 种 强制 转换 会 失败 ， 因 为 baseObject 没有 引用 已 装 箱 的 Currency 对 象 。 

在 使 用 装 箱 和 拆 箱 时 ， 这 两 个 过 程 都 把 数据 复制 到 新 装 箱 或 拆 箱 的 对 象 上 ， 理 解 这 一 点 非常 重要 。 这 样 ， 
对 装 箱 对 象 的 操作 就 不 会 影响 原始 值 类 型 的 内 容 。 


6.8.2 多重 类 型 强制 转换 


在 定义 类 型 强制 转换 时 必须 考虑 的 一 个 问题 是 ， 如 果 在 进行 要 求 的 数据 类 型 转换 时 没有 可 用 的 直接 强制 转 
换 方 式 ，C# 编 译 占 就 会 寻找 一 种 转换 方式 ， 把 几 种 强制 转换 合并 起 来 。 例如， 在 Currency 结构 中 ， 假 定编 译 嚣 
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遇 到 下 面 几 行 代码 ; 

var balance = new Currency(10,50) ; 

long amount = (long)balance; 

double amountD = balance; 

首先 初始 化 一 个 Currency 实例 ， 再 把 它 转换 为 long 型 。 问 题 是 没有 定义 这 样 的 强制 转换 。 但 是 ， 这 段 代 码 
仍 可 以 编译 成 功 。 因 为 编译 器 知道 我 们 已 经 定义 一 个 从 Currency 到 float 的 隐 式 强制 转换 ， 而 且 它 知道 如 何 显 
式 地 从 float 强制 转换 为 long。 所 以 它 会 把 这 行 代码 编译 为 中 国语 言 (GD) 代 码 , 并 代码 首先 把 balance 转换 为 float 
型 ， 再 把 结果 转换 为 long 型 。 把 balance 转换 为 double 型 时 ， 在 上 述 代 码 的 最 后 一 行 中 也 执行 了 同样 的 操作 。 
因为 从 Currency 到 float 的 强制 转换 和 从 float 到 double 的 预定 义 强制 转换 都 是 隐 式 的 ， 所 以 可 以 在 编写 代码 
时 把 这 种 转换 当 作 一 种 隐 式 转换 。 如 果 要 显 式 地 指定 强制 转换 过 程 ， 则 可 以 编写 如 下 代码 ; 

var balance = new Currency (10,50); 


long amount = (long) (float}balance; 
double amountD = (double) (float}balance; 


但 是 在 大 多 数 情况 下 ， 这 会 使 代码 变 得 比较 复杂 ， 因 此 是 不 必要 的 。 相 比 之 下 ， 下 面 的 代码 会 产生 一 个 编 


Var balance = new Currency (10,50).; 
long amount = balance; 


原因 是 编译 器 可 以 找到 的 最 佳 丐 配 转 换 仍 是 首先 转换 为 float 型 ， 再 转换 为 long 型 。 但 需要 显 式 地 指定 从 
float 型 到 long 型 的 转换 。 

并 非 所 有 这 些 转 换 都 会 带 来 太 多 的 有 抹 烦 。 毕 竟 转 换 的 规则 非常 直观 ， 主 要 是 为 了 防止 在 开发 人 员 不 知情 的 
情况 下 丢失 数据 。 但 是 , 在 定义 类 型 强制 转换 时 如 果 不 小 心 , 编译 器 就 有 可 能 指定 一 条 导致 不 期 望 结果 的 路 径 。 
例如 ， 假 定编 写 Currency 结构 的 其 他 小 组 成 员 要 把 一 个 uint 数据 转换 为 Currency 型 ， 其 中 该 uint 数据 中 包含 
了 美 分 的 总 数 (是 美 分 而 非 美 元 ， 因 为 我 们 不 希望 丢失 美元 的 小 数 部 分 )。 为 此 应 编写 如 下 代码 来 实现 强制 转换 : 

// Do not do this! 


Public static implicit operator Currency (uint value) => 
new Currency (value/100u, (ushort) (value$®100)); 


注意 , 在 这 段 代 码 中 , 第 一 个 100 后 面 的 u 可 以 确保 把 value/100u 解释 为 一 个 uint 值 。 如 果 写 成 value/100， 
编译 器 就 会 把 它 解释 为 一 个 int 型 的 值 ， 而 不 是 uint 型 的 值 。 

在 这 段 代 码 中 清楚 地 标注 了 “Do not do it( 不 要 这 么 做 ) ”下面 说 明 其 原因 。 看 看 下 面 的 代码 段 ， 它 把 包含 值 
350 的 一 个 uint 数据 转换 为 一 个 Curency， 再 转换 回 uint 型 。 那 么 在 执行 完 这 段 代 码 后 ，bal2 中 又 将 包含 什么 ? 

uint bal = 350; 


Currency balance = bal; 
uint bal2 = (uint}balance.: 


答案 不 是 350, 而 是 3! 而 且 这 是 符合 逻辑 的 ,我 们 把 350 隐 式 地 转换 为 Currency, 得 到 的 结果 是 balance.Dollars=3 
和 balance.Cents=50。 然 后 编译 器 进行 通常 的 操作 ， 为 转换 回 uint 型 指定 最 佳 路 径 。balance 最 终 会 被 隐 式 地 转换 为 
float 型 (其 值 为 3.5)， 然 后 显 式 地 转换 为 uint 型 ， 其 值 为 3。 

当然 ， 在 其 他 示例 中 ， 转 换 为 男 一 种 数据 类 型 后 ， 再 转换 回来 有 时 会 丢失 数据 。 例 如 ， 把 包含 5.8 的 float 
数值 转换 为 int 数值 ， 再 转换 回 float 数值 ， 会 丢失 数字 中 的 小 数 部 分 ， 得 到 5， 但 原则 上 上， 丢失 数字 的 小 数 部 
分 和 一 个 整数 被 大 于 100 的 数 整 除 的 情况 略 有 区 别 。Curency 现在 成 为 一 种 相当 危险 的 类 ， 它 会 对 整数 进行 一 
些 奇怪 的 操作 。 

问题 是 ， 在 转换 过 程 中 如 何 解释 整数 存在 冲突 。 从 Currency 型 到 float 型 的 强制 转换 会 把 整数 1 解释 为 1 
美元 ,但 从 uint 型 到 Currency 型 的 强制 转换 会 把 这 个 整数 解释 为 1 美 分 ， 这 是 很 糟糕 的 一 个 示例 。 如 果 和 希望 类 
易于 使 用 ， 就 应 确保 所 有 的 强制 转换 都 按 一 种 互相 兼容 的 方式 执行 ， 即 这 些 转换 直观 上 应 得 到 相同 的 结果 。 在 
本 例 中 ， 显 然 要 重新 编写 从 uint 型 到 Curency 型 的 强制 转换 ， 把 整数 值 1 解释 为 1 美元 : 


Public static implicit operator Currency (uint Value) => 
new Currency (value, 0).; 


偶尔 你 也 会 觉得 这 种 新 的 转换 方式 可 能 根本 不 必要 。 但 实际 上 ， 这 种 转换 方式 可 能 非常 有 用 。 没 有 这 种 强 
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制 转换 ， 编 译 器 在 执行 从 uint 型 到 Currency 型 的 转换 时 ， 就 只 能 通过 float 型 来 进行 。 此 时 直接 转换 的 效率 要 
高 得 多 ， 所 以 进行 这 种 额外 的 强制 转换 会 提高 性 能 ， 但 需要 确保 它 的 结果 与 通过 float 型 进行 转换 得 到 的 结果 相 
同 。 在 其 他 情况 下 ， 也 可 以 为 不 同 的 预定 义 数 据 类 型 分 别 定 义 强 制 转换 ， 让 更 多 的 转换 隐 式 地 执行 ， 而 不 是 显 
式 地 执行 ， 但 本 例 不 是 这 样 。 

测试 这 种 强制 转换 是 否 兼 容 ， 应 确定 无 论 使 用 什么 转换 路 径 ， 它 是 否 都 能 得 到 相同 的 结果 (而 不 是 像 在 从 
float 型 到 int 型 的 转换 过 程 中 那样 丢失 数据 )。Currency 类 就 是 一 个 很 好 的 示例 。 看 看 下 面 的 代码 ; 


var balance = new Currency (50, 35}); 
Ulong bal = {ulong) balancer 


目前 , 编译 器 只 能 采用 一 种 方式 来 完成 这 个 转换 : 把 Currency 型 隐 式 地 转换 为 float 型 , 再 显 式 地 转换 为 ulong 
型 。 从 float 型 到 ulong 型 的 转换 需要 显 式 转换 ， 本 例 就 显 式 指定 了 这 个 转换 ， 所 以 编译 是 成 功 的 。 

但 假定 要 添加 另 一 种 强制 转换 ， 从 Curency 型 隐 式 地 转换 为 unt 型 ， 就 需要 修改 Currency 结构 ， 添 加 从 
uint 型 到 Curmency 型 的 强制 转换 和 从 Curency 型 到 uint 型 的 强制 转换 (代码 文件 CastingSample/Currency.cs): 


Public static jmplicit operator Currency (uint value) => 
new Currency (value, 0); 
Public static jmplicit operator uint (Currency value) => value.Dollars; 


现在 ， 编 译 器 从 Currency 型 转换 到 ulong 型 可 以 使 用 另 一 条 路 径 : 先 从 Currency 型 隐 式 地 转换 为 uint 型 ， 
再 隐 式 地 转换 为 ulong 型 。 该 采用 哪 条 路 径 ? C# 有 一 些 严格 的 规则 (本 书 不 详细 讨论 这 些 规则 ， 有 兴趣 的 读者 
可 参阅 MSDN 文档 )， 告 诉 编译 器 如 何 确定 哪 条 是 最 佳 路 径 。 但 最 好 目 己 设计 类 型 强制 转换 ， 让 所 有 的 转换 路 
径 都 得 到 相同 的 结果 (但 没有 精确 度 的 损失 )， 此 时 编译 器 选择 哪 条 路 径 就 不 重要 了 (在 本 例 中 ， 编 译 器 会 选择 
Curency 一 uint 一 ulong 路 径 ， 而 不 是 Currency 一 float 一 ulong 路 径 )。 

为 了 测试 把 Curency 强制 转换 为 unt 的 过 程 ， 给 Main0 方 法 添加 如 下 代码 (代码 文件 
CastingSample/Proeram.cs): 


static void Maint({) 
{ 
try 
{ 
var balance = new Currency (530,35).; 
Console.WriteLine (balance). 
Console.WriteLine(S$"balance 15 {balance}"™):; 
uint balance3 = {uint) balance. 
Console .WriteLine($"Converting to uint gives {balance3}").; 
} 


catch (Exception ex) 


Console.WriteLine ($"Exception occurred: {ee.Message}"™); 


} 
运行 这 个 示例 ， 得 到 如 下 所 示 的 结果 : 
20 


balance 1is $50.35 
Converting to uint gives 50 


这 个 结果 显示 了 到 uint 型 的 转换 是 成 功 的 ， 但 在 转换 过 程 中 丢失 了 Curency 的 美 分 部 分 (小 数 部 分 )。 把 负 
的 float 类 型 强制 转换 为 Currency 型 也 产生 了 预料 中 的 洲 出 异常 , 因为 float 型 到 Currency 型 的 强制 转换 本 身 定 
义 了 一 个 checked 环境 。 

但 是 ， 这 个 输出 结果 也 说 明了 进行 强制 转换 时 最 后 一 个 要 注意 的 潜在 问题 ， 结果 的 第 一 行 没有 正确 显示 余 
额 ， 显 示 了 50， 而 不 是 $50.35。 

这 是 为 什么 ?问题 是 在 把 类 型 强制 转换 和 方法 重 载 合并 起 来 时 ， 会 出 现 另 一 个 不 希望 的 错误 源 。 

WriteLineO0 语 句 使 用 格式 字符 串 隐 式 地 调用 Currency.ToString0 方 法 ， 以 确保 Curency 显示 为 一 个 字符 串 。 

但 是 ,第 1 行 的 WriteLine0 方 法 只 把 原始 Currency 结构 传递 给 WriteLine()。 目 前 WriteLine0 有 许多 重 载 版 
本 ， 但 它们 的 参数 都 不 是 Currency 结构 。 所 以 编译 器 会 到 处 搜索 ， 看 看 它 能 把 Currency 强制 转换 为 什么 类 型 ， 
以 便 与 WriteLine0 的 一 个 重 载 方法 匹配 。 如 上 所 示 ，WiriteLine0 的 一 个 重 载 方法 可 以 快速 而 高 效 地 显示 uint 型 ， 
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且 其 参数 是 一 个 uint 值 。 因 此 应 把 Currency 隐 式 地 强制 转换 为 uint 型 。 

实际 上 ，WriteLineO0 有 另 一 个 重 载 方法 ， 它 的 参数 是 一 个 double 值 ， 结 果 显 示 该 double 的 值 。 如 果 仔 细 看 
看 前 面 SimpleCurrency 示例 的 结果 , 就 会 发 现 该 结果 的 第 1 行 就 是 使 用 这 个 重 载 方法 把 Currency 显示 为 double 
型 。 在 这 个 示例 中 ， 没 有 直接 把 Curency 强制 转换 为 uint 型 ， 所 以 编译 器 选择 Currency 一 float 一 double 作为 可 
用 于 WriteLine0 重 载 方法 的 首选 强制 转换 方式 。 但 在 SimpleCurency2 中 可 以 直接 强制 转换 为 uint 型 ， 所 以 编 
译 器 会 选择 该 路 径 。 

结论 是 : 如 果 方 法 调用 带 有 多 个 重 载 方法 ， 并 要 给 该 方法 传送 参数 ， 而 该 参数 的 数据 类 型 不 匹配 任何 重 载 
方法 ， 就 可 以 迫使 编译 器 确定 使 用 哪些 强制 转换 方式 进行 数据 转换 ， 从 而 诀 定 使 用 哪个 重 载 方法 (并 进行 相应 的 
数据 转换 )。 当 然 ， 编 译 器 总 是 按 逻 辑 和 严格 的 规则 来 工作 ， 但 结果 可 能 并 不 是 我 们 所 期 望 的 。 如 果 存 在 任何 疑 
问 ， 最 好 指定 显 式 地 使 用 哪 种 强制 转换 。 


6.9 ”小 结 


本 章 介 绍 了 C# 提 供 的 标准 运算 符 , 摘 述 了 对 象 的 相等 性 机 制 , 讨论 了 编译 器 如 何 将 一 种 标准 数据 类 型 转换 
为 另 一 种 标准 数据 类 型 。 本 和 章 还 前 述 了 如 何 使 用 运算 符 重 载 在 自己 的 数据 类 型 上 实现 自 定义 运算 符 。 最 后 ， 讨 
论 了 运算 符 重 载 的 一 种 特殊 类 型 ， 即 类 型 强制 转换 运算 符 ， 它 允许 用 户 指定 如 何 将 目 定 义 基 型 的 实例 转换 为 其 
第 7 章 将 介绍 数组 ， 其 中 索引 运算 待 有 很 重要 的 作用 。 


第 
数 组 


本 章 要 点 
e 简单 数组 
e 多 维 数组 
锯齿 数组 
Array 类 
作为 参数 的 数组 


妾 当 洲 洗 
训 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Arrays 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

® SimpleArrays 


® SortineSsample 

® AiTaySeement 

® YleldSsample 

® StructuralComparison 
® SpanSample 

® AlTayPoolsample 


7.1 相同 类 型 的 多 个 对 象 


如 果 需 要 使 用 相同 类 型 的 多 个 对 象 ， 就 可 以 使 用 集合 (参见 第 10 章 ) 和 数组 。C# 用 特殊 的 记号 声明 、 初 始 化 
和 使 用 数组 。Array 类 在 后 台 发 挥 作用 ， 它 为 数组 中 元 素 的 排序 和 过 滤 提 供 了 几 个 方法 。 使 用 枚 举 器 ， 可 以 迁 
代数 组 中 的 所 有 元 素 。 
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注意 : 
如 果 需 要 使 用 不 同类 型 的 多 个 对 象 ， 可 以 通过 类 、 结 构 和 元 组 使 用 它们 。 类 和 结构 参见 第 3 章 ， 元 组 参见 
第 13 章 。 


7.2 ”简单 数组 

如 果 需 要 使 用 同一 类 型 的 多 个 对 象 ， 就 可 以 使 用 数组 。 数 组 是 一 种 数据 结构 ， 它 可 以 包含 同一 类 型 的 多 个 
元 素 。 
7.2.1 数组 的 声明 


在 声明 数组 时 ， 应 先 定义 数组 中 元 素 的 类 型 ， 其 后 是 一 对 空 方 括号 和 一 个 变量 名 。 例 如 ， 下 面 声 明了 一 个 
包含 整 型 元 素 的 数组 : 


int[] myArray; 


7.2.2 数组 的 初始 化 


声明 了 数组 后 ， 就 必须 为 数组 分 配 内 存 ， 以 保存 数组 的 所 有 元 素 。 数 组 是 引用 类 型 ， 所 以 必须 给 它 分 配 堆 
上 的 内 存 。 为 此 ， 应 使 用 new 运算 符 ， 指 定数 组 中 元 素 的 类 型 和 数量 来 初始 化 数组 的 变量 。 下 面 指定 了 数组 的 
py Wh 


myArray = new int[4]; 


注意 : 

值 类 型 和 引用 类 型 请 参见 第 3 章 。 

在 声明 和 初始 化 数组 后 ， 变 量 myArray 就 引用 了 4 个 整 型 值 ， 它 们 位 于 托管 堆 上 ， 如 图 7-1 所 示 。 
栈 托管 堆 

注意 : 


在 指定 了 数组 的 大 小 后 ， 如 果 不 复制 数组 中 的 所 有 元 素 ， 就 不 能 重新 设置 数组 的 大 小 。 如 果 事 先 不 知道 数 
组 中 应 包含 多 少 个 元 素 ， 就 可 以 使 用 集合 (参见 第 10 章 )。 

除了 在 两 条 语句 中 声明 和 初始 化 数组 外 ， 还 可 以 在 一 条 语句 中 声明 和 初始 化 数组 : 

int[] myArray = new int[4]; 

还 可 以 使 用 数组 初始 化 器 为 数组 的 每 个 元 素 赋值 。 数 组 初始 化 器 只 能 在 声明 数组 变量 时 使 用 ， 不 能 在 声明 
数组 之 后 使 用 。 


int[] myArray = new int[4] {4, 7, 11, 2}; 


如 果 用 花 括号 初始 化 数组 ， 则 还 可 以 不 指定 数组 的 大 小 ， 因 为 编译 器 会 目 动 统计 元 系 的 个 数 : 
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int[] myArray = new int[] {4, 7, 11, 2}; 
使 用 C# 编 译 器 还 有 一 种 更 简化 的 形式 。 使 用 花 括号 可 以 同时 声明 和 初始 化 数组 , 编译 器 生成 的 代码 与 前 面 
的 例子 相同 : 


int[] myYyarTray = {4, 7, 11, 2}; 


7.2.3 访问 数组 元 素 


在 声明 和 初始 化 数组 后 ， 就 可 以 使 用 索引 器 访问 其 中 的 元 素 了 了 。 数 组 只 文 持 有 整 型 参数 的 索引 器 。 

通过 索引 器 传递 元 素 编号 ， 就 可 以 访问 数组 。 索 引 器 总 是 以 0 开头 ， 表 示 第 一 个 元 素 。 可 以 传递 给 索 
引 器 的 最 大 值 是 元 素 个 数 减 1， 因 为 索引 从 0 开始 。 在 下 面 的 例子 中 ， 数 组 myArray 用 4 个 整 型 值 声 明和 初始 
化 。 用 索引 器 对 应 的 值 0、1、2 和 3 就 可 以 访问 该 数组 中 的 元 素 。 

int[] myaArray = new int[] {4, 7, 11, 2}; 

int wl = myArray[0]; // read first element 


int w2 = myArray[l]; // read second element 
myarray[3] = 44; // change fourth element 


注意 : 

如 果 使 用 错误 的 索引 器 值 (大 于 数组 的 长 度 )， 就 会 抛 出 IndexOutOfRangeException 类 型 的 异常 。 
如 果 不 知道 数组 中 的 元 素 个 数 ， 则 可 在 for 语句 中 使 用 Length 属性 : 

for {int 1 = 0; 1 < myArray.Length; 1i++) 

Console.WriteLine (myArray[1i]).; 

} 

除了 使 用 for 语句 迭代 数组 中 的 所 有 元 素 之 外 ， 还 可 以 使 用 foreach 语句 : 

foreach (var val in myArray) 


Console .WriteLine (val); 


注意 : 
foreach 语句 利用 了 本 章 后 面 讨论 的 IEnumerable 和 IEnumerator 接口 ， 从 第 一 个 索引 遍历 数组 ， 直 到 最 后 一 
个 索引 。 


7.2.4 使 用 引用 类 型 


除了 能 声明 预定 义 类 型 的 数组 ， 还 可 以 声明 和 目 定义 类 型 的 数组 。 下 面 用 Person 类 来 说 明 ， 这 个 类 有 目 动 实现 
的 只 读 属 性 Firsthame 和 Lastname， 以 及 从 Object 类 重 写 的 ToString0 方 法 (代码 文件 SimpleArrays/Person.cs): 


Public class Person 


{ 
Public Person(string firstName, string lastName) 
{ 
FirstName = firstName.; 
LastName = lastName; 
} 


public string FirstName { get; } 
public string LastName { get; } 
public override string ToString() => S$"{FirstName} {LastName}"; 


} 
声明 一 个 包含 两 个 Person 元 素 的 数组 与 声明 一 个 int 数组 类 似 : 
Personl[] myPersons = new Personl[2]; 


但 是 必须 注意 ， 如 果 数 组 中 的 元 素 是 引用 类 型 ， 就 必须 为 每 个 数组 元 素 分 配 内 存 。 如 果 使 用 了 数组 中 未 分 
配 内 存 的 元 素 ， 则 会 抛 出 NullReferenceException 类 型 的 异常 。 
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注意 : 
第 14 章 介绍 了 错误 和 异常 的 详细 内 容 。 


使 用 从 0 开始 的 索引 髓 ， 可 以 为 数组 的 每 个 元 素 分 配 内 存 : 


mYyPersons[0] = new Person("Ayrton™", "SeTmTma") 7 


myPersons[l1] = new Person("Michael™., "Schumacher™); 


图 7-2 显示 了 Person 数组 中 的 对 象 在 托管 堆 中 的 情况 。myPersons 是 存储 在 栈 上 的 一 个 变量 ， 该 变量 引用 了 
存储 在 托管 堆 上 的 Person 元 素 对 应 的 数组 。 这 个 数组 有 足够 容纳 两 个 引用 的 空间 。 数 组 中 的 每 一 项 都 引用 了 一 个 
Person 对 象 ， 而 这 些 Person 对 象 也 存储 在 托管 堆 上 。 

栈 托管 堆 


图 7-2 
与 int 类 型 一 样 ， 也 可 以 对 目 定义 类 型 使 用 数组 初始 化 器 ; 


Person[] myPersons2 = 
{ 
new Person("Ayrton", "Senna™)., 
new Person("Michael™., "schumacher™) 


} 7 


7.3 ”多 维 数 组 


阶 )。 


ee 


一 般 数 组 (也 称 为 一 维 数组 ) 用 一 个 整数 来 索引 。 多 维 数组 用 两 个 或 多 个 整数 来 索引 。 
图 7-3 是 二 维 数组 的 数学 表示 法 ， 该 数组 有 3 行 3 列 。 第 1 行 的 值 是 1、2 和 3， 第 3 行 的 值 是 7、8 和 9。 


在 C# 中 声明 这 个 二 维 数组 ， 需 要 在 方 括号 中 加 上 一 个 有 逗号。 数组 在 初始 化 时 应 指定 每 一 维 的 大 小 (也 称 为 
接着 ， 就 可 以 使 用 两 个 整数 作为 索引 器 来 访问 数组 中 的 元 素 : 

int[,] twodim = new int[3, 3]; 

twodim[0, 0] 
twodim[0, 1] 
twodim[0, 2] 
twodim[1, 0] 
twodim[1, 1] 
twodim[1, 2] 
twodim[2, 0] 
twodim[2, 1] 
twodim[2, 2] 


3 
| 


注意 : 
声明 数组 后 ， 就 不 能 修改 其 阶 数 了 。 


如 果 事 先知 道 元 素 的 值 ， 就 可 以 使 用 数组 索引 器 来 初始 化 二 维 数 组 。 在 初始 化 数组 时 ， 使 用 一 个 外 层 的 花 
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括号 ， 每 一 行 用 包含 在 外 层 花 括号 中 的 内 层 花 括号 进行 初始 化 。 


int[,] twodim = { 
tls Zs hs 
{44， “了 G1}, 
{7, 8, 93} 
} 7 


注意 : 
使 用 数组 初始 化 器 时 ， 必 须 初 始 化 数组 的 每 个 元 素 ， 不 能 把 某 些 值 的 初始 化 放 在 以 后 完成 。 


在 花 括 号 中 使 用 两 个 逗号 ， 束 可 以 声明 一 个 三 维 数组 ; 


int[,,] threedim = { 

| 1 

{ {ss 6 {71,8} |}, 

{ { 3, IO { ii 12 } 1 
}; 


Console .WriteLine (threedim[0, 1, 1]); 


7.4 ”锯齿 数组 


二 维 数组 的 大 小 对 应 于 一 个 和 矩形， 如 对 应 的 元 素 个 数 为 3X3。 而 锯齿 数组 的 大 小 设置 比较 灵活 ， 在 锯齿 数 
组 中 ， 每 一 行 都 可 以 有 不 同 的 大 小 。 

图 7-4 比较 了 有 3X3 个 元 素 的 二 维 数组 和 锯齿 数组 。 图 7-4 中 的 锯齿 数组 有 3 行 ， 第 1 行 有 两 个 元 素 ， 第 
2 行 有 6 个 元 素 ， 第 3 行 有 3 个 元 素 。 


图 7-4 


在 声明 饥 郊 数组 时 ， 要 依次 放置 顽 右 括号 。 在 初始 化 饮 齿 数组 时 ， 只 在 第 1 对 方 括号 中 设置 该 数组 包含 的 
行 数 。 定 义 各 行 中 元 素 个 数 的 第 2 个 方 括号 设置 为 空 ， 因 为 这 类 数组 的 每 一 行 包 含 不 同 的 元 素 个 数 。 之 后 ， 为 
每 一 行 指定 行 中 的 元 素 个 数 (代码 文件 SimpleArrays/Program.cs): 


Int[][] jagged = mew 1nmt[3] [] ; 

Jagged[0] = new int[2] { 1, 2 }; 

Jagged[1] new int[6] { 3, 4, 5, 6, 7, 8 }; 
Jjagged[2] new int[3] { 9, 10, 11 }; 


迭代 锯齿 数组 中 所 有 元 际 的 代码 可 以 放 在 典 套 的 for 循环 中 。 在 外 层 的 for 循环 中 迭代 每 一 行 ,在 内 层 的 for 
循环 中 达 代 一 行 中 的 每 个 元 素 : 

for (int row = 0; row < jagged.Length; row++) 

Ss (int element = 0; element < jagged[row] .Length; element++) 


Console.WriteLine($s"row: {row}, element: {element}, "™ 十 
s"value: {jagged[row] [element] }"); 


} 
} 


该 迁 代 结果 显示 了 所 有 的 行 和 每 一 行 中 的 各 个 元 素 ; 


row: 0, element: 0, wvalue: 1 
row: 0, element: 1, wvalue: 2 
row: l1,. element: 0, value: 3 
row: 1, element: 1, walue: 4 
row: 1, element: 2, value: 5 
row: l1, element: 3, value: 6 
row: l1, element: 4, walue: 1 
row: l1,. element: 5, value: 8 
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row: 2, element: 0, value: 9 
TOW:- 2, element: 1, value: 10 
row: 2, element: 2, Value: 11 


7.5 Array 类 


用 方 括号 声明 数组 是 C# 中 使 用 Array 类 的 表示 法 。 在 后 台 使 用 C# 语 法 ,会 创建 一 个 派生 目 抽 象 基 类 Array 
的 新 类 。 这 样 ， 就 可 以 使 用 Array 类 为 每 个 C# 数 组 定义 的 方法 和 属性 了 。 例 如 ， 前 面 就 使 用 了 Length 属性 ， 
或 者 使 用 foreach 语句 迭代 数组 。 其 实 这 是 使 用 了 Array 类 中 的 GetEnumerator(0 方 法 。 

Array 类 实现 的 其 他 属性 有 LongLength 和 Rank。 如 果 数 组 包含 的 元 素 个 数 超出 了 整数 的 取 值 范围 , 就 可 以 
使 用 LongLength 属性 来 获得 元 素 个 数 。 使 用 Rank 属性 可 以 获得 数组 的 维 数 。 

下 面 通 过 了 解 不 同 的 功能 来 看 看 Array 类 的 其 他 成 员 。 


7.5.1 创建 数组 


Array 类 是 一 个 抽象 类 ， 所 以 不 能 使 用 构造 函数 来 创建 数组 。 但 除了 可 以 使 用 C# 语 法 创建 数组 实例 之 外 ， 
还 可 以 使 用 静态 方法 CreateInstance0) 创 建 数组 。 如 果 事 先 不 知道 元 素 的 类 型 ， 该 静态 方法 就 非常 有 用 ， 因 为 类 
型 可 以 作为 Type 对 象 传递 给 CreateInstance0 方 法 。 

下 面 的 例子 说 明了 如 何 创 建 类 型 为 int、 大 小 为 5 的 数组 。CreateInstance0 方 法 的 第 1 个 参数 应 是 元 素 的 类 
型 ， 第 2 个 参数 定义 数组 的 大 小 。 可 以 用 SetValue0 方 法 设置 对 应 元 率 的 值 ， 用 GetValue0 方 法 读 取 对 应 元 素 的 
值 (代码 文件 SimpleArrays/Program.cs): 

Array intArrayl = Array.CreateInstance (typeof (int), Ss 

for {int 1 = 0; 1 < 2; 1++) 

intArrayl.SetVvalue (33, i); 

} 

for {int 1 = 0; 1 5; 工 十 十 ) 


{ 
Console .WriteLine (intArrayl .GetValue (1)); 


} 

还 可 以 将 已 创建 的 数组 强制 转换 成 声明 为 nt 的 数组 : 

int[] intarray2 = (int[])intArrayl; 

CreateInstance0) 方 法 有 许多 重 载 版 本 ， 可 以 创建 多 维 数 组 和 不 基于 0 的 数组 .。 下面 的 例子 创建 了 一 个 包含 2 
X3 个 元 系 的 二 维 数组 。 第 一 维基 于 1， 第 二 维基 于 10: 

int[] lengths = { 2, 3 }; 


int[] lowerBounds = { 1, 10 }; 
Array Iacers = Array.CreateInstance (typeof (Person}), lengths, lowerBounds); 


SetValue() 方 法 设置 数组 的 元 素 ， 其 参数 是 每 一 维 的 索引 : 


racers.SetValue (new Person("Alain™., "Prost"), 1, 10); 
racers.SetValue (new Person ("Emerson™, "Fittipaldi™", 1, 11); 
racers.SetValue (new Person("Ayrton™", "Senna™.), 1, 12); 
racers.SetValue (new Person ("Michael"™"., "Schumacher™), 2, 10); 
racers.SetValue (new Person("Fernando™, "Alonso™)}), 2, 11); 
racers.SetValue (new Person("Jenson",. "Button™), 2, 12); 


尽管 数组 不 是 基于 0， 但 可 以 用 一 般 的 C# 表 示 法 为 它 赋 予 一 个 变量 。 只 需要 注意 不 要 超出 边界 即 可 : 


Person[,] racers2 = (Personl,|]} racers; 
Person first = racers2[1, 10]; 
Person lJast = racers2[2, 1l12]; 


7.5.2 复制 数组 


因为 数组 是 引用 类 型 ， 所 以 将 一 个 数组 变量 赋予 男 一 个 数组 变量 ， 就 会 得 到 两 个 引用 同一 数组 的 变量 。 而 
复制 数组 ， 会 使 数组 实现 ICloneable 接口 。 这 个 接口 定义 的 Clone0 方 法 会 创建 数组 的 浅 表 副 本 。 
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如 果 数 组 的 元 素 是 值 类 型 ， 以 下 代码 段 就 会 复制 所 有 值 ， 如 图 7-5 所 示 : 


int[] intArravyl = {1, 2}; 
int[] intArray2 = (int[]}intArrayl .Clone(); 


正本 
2 


图 7-5 


如 末 数 组 包含 引用 类 型 ， 则 不 复制 元 素 ， 而 只 复制 引用 。 图 7-6 显示 了 变量 beatles 和 beatlesClone， 其 中 
beatlesClone 通过 从 beatles 中 调用 Clone0 方 法 来 创建 。beatles 和 beatlesClone 引用 的 Person 对 象 是 相同 的 。 如 
果 修 改 beatlesClone 中 一 个 元 率 的 属性 ， 就 会 改变 beatles 中 的 对 应 对 象 (代码 文件 SimpleArray/Proeram.cs)。 

Person[] beatles = { 

new Person { FirstName="John", LastName="Lennon™ }, 

new Person { FirstName="Paul", LastName="McCartney" } 

} ; 


person[] beatlesClone = (Person[]j}beatles.Clone(}).; 


beatles » Person 


beatlesClone Person 


图 7-6 


除了 使 用 Clone0 方 法 之 外 ,还 可 以 使 用 Array.Copy0 方 法 创建 浅 表 副 本 。 但 Clone0 方 法 和 Copy0 方 法 有 一 
个 重要 区 别 ，Clone0 方 法 会 创建 一 个 新 数组 ， 而 Copy0 方 法 必须 传递 阶 数 相同 且 有 足够 元 素 的 已 有 数组 。 


入 可 二 
如 果 需 要 包含 引用 类 型 的 数组 的 深层 副本 ， 就 必须 迭代 数组 并 创建 新 对 象 。 


7.5.3 排序 


Array 类 使 用 Quicksort 算法 对 数组 中 的 元 素 进 行 排序 .Sort0 方 法 需要 数组 中 的 元 素 实 现 IComparable 接口 。 
因为 简单 类 型 (如 System.String 和 System.Int32) 实 现 IComparable 接口 ， 所 以 可 以 对 包含 这 些 类 型 的 元 素 排 序 。 
在 示例 程序 中 , 数组 name 包含 string 类 型 的 元 素 , 这 个 数组 可 以 排序 (代码 文件 SortingSample/Program.cs)。 


string[] names = I 
"Christina Aguilera", 
"Shak]ITra" ， 


"BeYCTCE”， 
"Lady Gaga™ 
} 
Brray.Sort (names); 
foreach (Var name in names) 
{ 

Console .WriteLine (mame) : 


} 
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该 应 用 程序 的 输出 是 排 好 序 的 数组 : 
Beyonce 

christina Aguilera 

Lady Gaga 

shakira 


如 果 对 数组 使 用 自 定 义 类 ， 就 必须 实现 IComparable 接口 。 这 个 接口 只 定义 了 一 个 方法 CompareIo0， 如 果 
要 比较 的 对 象 相等 ， 该 方法 就 返回 0。 如 果 该 实例 应 排 在 参数 对 象 的 前 面 ， 该 方法 就 返回 小 于 0 的 值 。 如 果 该 
实例 应 排 在 参数 对 象 的 后 面 ， 该 方法 就 返回 大 于 0 的 值 。 

修改 Person 类 ， 使 之 实现 IComparable<Person> 接 口 。 先 使 用 String 类 中 的 CompareTo0 方 法 对 LastName 
的 值 进行 比较 。 如 果 LastName 的 值 相 同 ， 就 比较 FirstName( 代 码 文 件 SortingSample/Person.cs): 


public class Person: IComparable<Person> 


: public int CompareTo (Person other) 
| if (other == null}) return 1; 

int result 二 string -COmPare (this. LastName, other.LastName); 

1f (result == 0 

| result = string.Ccompare (this.FirstName, other.FirstName); 

eturn result. 
J 
现在 可 以 按照 姓氏 对 Person 对 象 对 应 的 数组 排序 (代码 文件 SortingSample/Program.cs): 
Person[] persons = I 


new Person("Damon™., "Hill1"™"), 
new Person ("Niki", "Lauda™), 
new Person{("Ayrton", "Senna™), 
new Personl("Graham™", "Hill1") 

}; 

BrrayY.Sort (persons}); 

foreach (var p in persons) 

{ 
Console .WriteLine (p); 


} 
使 用 Person 类 的 排序 功能 ， 会 得 到 按 姓氏 排序 的 姓名 : 


Damon Hill 
Graham Hill 
Niki Lauda 
Ayrton Senna 


如 果 Person 对 象 的 排序 方式 与 上 述 不 同 ， 或 者 不 能 修改 在 数组 中 用 作 元 素 的 类 ， 就 可 以 实现 IComparer 接 
口 或 IComparer<T> 接 口 。 这 两 个 接口 定义 了 方法 Compare0。 要 比较 的 类 必须 实现 这 两 个 接口 之 一 。IComparer 
接口 独立 于 要 比较 的 类 。 这 就 是 Compare0 方 法 定义 了 两 个 要 比较 的 参数 的 原因 。 其 返回 值 与 IComparable 接口 
的 CompareTo0 方 法 类 似 。 

类 PersonComparer 实现 了 IComparer<Person> 接 口 ， 可 以 按照 fstName 或 lastName 对 Person 对 象 排序 。 
枚 举 PersonCompareType 定义 了 可 用 于 PersonComparer 的 排序 选项 : FirstName 和 LastName。 排 序 方式 由 
PersonComparer 类 的 构造 函数 定义 , 在 该 构造 函数 中 设置 了 一 个 PersonCompareType 值 。 实现 Compare0 方 法 时 
用 一 个 switch 语句 指定 是 按 FirstName 还 是 LastName 排序 (代码 文件 SortingSample/PersonComparercs)。 

public enum PersonCompareType 

FirstName, 


LastNMame 


} 


Public class PersonComparer: IComparer<Person> 
{ 
private PersonCompareType compareTypes 
Public PersonComparer (PersonCompareType compareType) => 
CompareType = compareTyper; 


public int Compare (Person xX, Person Y) 
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if (x is null &&E Y 15 null) return 0; 
if (X is null) return 1; 
if (yY 1S null) return 一 1; 
switch ( compareType) 
{ 
case PersonCompareType.FirstName: 
return string.Compare (x.FirstName, Yy.FirstName).,;} 
CaSe PersonComareTyYpe.LastName: 
return string.Ccompare (x.LastName, Yy.LastName); 
default: 
throw new ArgumentException ("unexpected compare type™); 
} 
} 
} 
现在 ， 可 以 将 一 个 PersonComparer 对 象 传递 给 Array.Sort0 方 法 的 第 2 个 参数 。 下 面 按 名 字 对 persons 数组 
排序 (代码 文件 SortingSample/Program.cs): 
Array.Sort (Persons，new PersonComparer (PersonCompareType.FirstName)); 
foreach (var p in persons) 
{ 


Console .WriteLine (p); 


} 
persons 数组 现在 按 名 字 排 序 : 


Ayrton Senna 
Damon Hill 
Graham Hill 
NIK1I Lauda 


注意 : 
Array 类 还 提供 了 Sort 方法， 它 需 要 将 一 个 委托 作为 参数 。 这 个 参数 可 以 传递 给 方法 ， 从 而 比较 两 个 对 象 ， 
而 不 需要 依赖 IComparable 或 IComparer 接口 。 第 8 章 将 介绍 如 何 使 用 委托 。 


7.6 ”数组 作为 参数 


数组 可 以 作为 参数 传递 给 方法 ， 也 可 以 从 方法 返回 。 要 返回 一 个 数组 ， 只 需要 把 数组 声明 为 返回 类 型 ， 如 
下 面 的 方法 GetPersonsO 所 示 ; 


static Person[] GetPersons() => 
new Person[] 1 
new Person({"Damon™, "Hil11"), 
new Person ("Niki", "Lauda™), 
new Person("Ayrton™", "Senna™), 
new Person("Graham™", "HI11") 


}s 


要 把 数组 传递 给 方法 ， 应 把 数组 声明 为 参数 ， 如 下 面 的 DisplayPersons( 〇 方法 所 示 : 


static void DisplayPersons (Person[] persons) 
{ 

i --- 
} 


7.7 数组 协 变 


数组 文 持 协 变 。 这 表示 数组 可 以 声明 为 基 类 ， 其 派生 类 型 的 元 素 可 以 赋予 数组 元 素 。 
例如 ， 可 以 声明 一 个 object[] 类 型 的 参数 ， 给 它 传 递 一 个 Person[]: 

static void DisplavyArray (object[] data) 

{ 


Pe 
} 
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注意 : 

数组 协 变 只 能 用 于 引用 类 型 ， 不 能 用 于 值 类 型 。 另 外 ， 数 组 协 变 有 一 个 问题 ， 它 只 能 通过 运行 时 异常 来 解 
决 。 如 果 把 Person 数组 赋予 object 数组 ，object 数组 就 可 以 使 用 派生 自 object 的 任何 元 素 。 例 如 ， 编 译 器 允许 
把 字符 串 传 递 给 数组 元 素 。 但 因为 object 数组 引用 Person 数组 ， 所 以 会 出 现 一 个 运行 时 异常 
ArrayTypeMismatchException. 


7.8 枚 举 


在 foreach 语句 中 使 用 枚 举 ， 可 以 大 代 集合 中 的 元 率 ， 且 不 需要 知道 集合 中 的 元 束 个 数 。foreach 语句 使 用 
了 一 个 枚 举 器 。 图 7-7 显示 了 调用 foreach 方法 的 客户 端 和 集合 之 间 的 关系 。 数 组 或 集合 实现 带 GetEumerator() 
方法 的 IEumerable 接口 。GetEumerator0 方 法 返回 一 个 实现 IEumerator 接口 的 枚 举 。 接 着 ，foreach 语句 就 可 以 
使 用 IEnumerator 接口 迁 代 集合 了 了 。 


IEnumerator 0 


Enumerator 


Collection 


IEhnumerable i 


图 7-7 


注意 : 
GetEnumerator0 方 法 用 IEnumerable 接口 定义 。foreach 语句 并 不 需要 在 集合 类 中 实现 这 个 接口 。 有 一 个 名 
为 GetfEnumerator() 的 方法 ， 它 返回 实现 了 IEnumerator 接口 的 对 象 就 足够 了 。 


7.8.1 IEnumerator 接口 


foreach 语句 使 用 IEnumerator 接口 的 方法 和 属性 , 夺 代 集合 中 的 所 有 元 素 。 为 此 ,IEnumerator 定义 了 了 Curent 
属性 ， 来 返回 光标 所 在 的 元 素 ， 该 接口 的 MoveNext0 方 法 移动 到 集合 的 下 一 个 元 素 上 。 如 果 有 这 个 元 素 ， 访 方 
法 就 返回 hue。 如 果 集 合 不 再 有 更 多 的 元 素 ， 该 方法 就 返回 false。 

这 个 接口 的 泛 型 版 本 IEnumerator<T> 派 生 目 接口 IDisposable， 因 此 定义 了 Dispose0 方 法 ， 来 清理 给 枚 举 器 
分 配 的 资源 。 


注意 : 
IEnumerator 接口 还 定义 了 Reset0 方法， 以 与 COM 交互 操作 。 许 多 NET 枚 举 器 通过 抛 出 
NotSupportedException 类 型 的 异常 ， 来 实现 这 个 方法 。 


7.8.2 foreach 语句 


C# 的 foreach 语句 不 会 解析 为 开 代码 中 的 foreach 语句 。C# 编 译 器 会 把 foreach 语句 转换 为 IEnumerator 接口 
的 方法 和 属性 。 下 面 是 一 条 简单 的 foreach 语句 ， 它 迁 代 persons 数组 中 的 所 有 元 素 ， 并 逐个 显示 它们 : 


foreach (var p in persons) 
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Console -WIIteLInme (p); 


foreach 语句 会 解析 为 下 面 的 代码 段 。 首 先 ， 调 用 GetEnumerator0 方 法 ， 获 得 数组 的 一 个 枚 举 器 。 在 while 
循环 中 一 一 只 要 MoveNext0 返 回 tue 一 就 用 Current 属性 访问 数组 中 的 元 素 : 


IEnumerator<Person> enumerator = persons.GetEnumeratort(); 
While (enumerator.MoveNext (}) 
{ 

Person pp = enumerator.Current.; 

Console.WriteLine (p); 


} 


7.8.3 yield 语句 


自 C# 的 第 1 个 版 本 以 来 ， 使 用 foreach 语句 可 以 轻松 地 友 代 集合 。 在 C# 1.0 中 ， 创 建 枚 举 器 仍 需要 做 大 量 
的 工作 。C# 2.0 添加 了 yield 语句 ， 以 便于 创建 枚 举 器 。yield retum 语句 返回 集合 的 一 个 元 素 ， 并 移动 到 下 一 个 
元 素 上 。vyield break 可 停止 迭代 。 

下 一 个 例子 是 用 yield retum 语句 实现 一 个 简单 集合 的 代码 。HelloCollection 类 包含 GetfEnumerator0 方 法 。 
该 方法 的 实现 代码 包含 两 条 yield retum 语句 ， 它 们 分 别 返 回 字 符 串 Hello 和 World( 代 码 文 件 
Yeldsample/Program.cs)。 


USing System; 
USing System.Collections; 
namespace Wrox.ProCcSsharp.Arrays 
{ 
Public class HelloCollection 
{ 
Public IEnumerator<string> GetEnumerator () 
{ 
yield return "Hello™; 
yield return "World™; 
} 
} 
} 


注意 : 
包含 yield 语句 的 方法 或 属性 也 称 为 迁 代 块 。 和 迭代 块 必须 声明 为 返回 IEnumerator 或 IEnumerable 接口 ， 或 
者 这 些 接 口 的 泛 型 版 本 。 这 个 块 可 以 包含 多 条 yield retum 语句 或 yield break 语句 ， 但 不 能 包含 Tetum 语句 。 


现在 可 以 用 foreach 语句 迭代 集合 了 : 
Public void HelloWorld1') 
{ 


var hellocollection = new Hellocollectiont():; 
foreach (var 5s in hellocollection) 


Console.WriteLine(s):; 
} 
} 


使 用 迭代 块 ， 编 译 器 会 生成 一 个 yield 类 型 ， 其 中 包含 一 个 状态 机 ， 如 下 面 的 代码 段 所 示 。yield 类 型 实现 
IEnumerator 和 IDisposable 接口 的 属性 和 方法 。 在 下 面 的 例子 中 ， 可 以 把 yield 类 型 看 作 内 部 类 Enumerator。 外 
部 类 的 GetEnumerator0 方 法 实例 化 并 返回 一 个 新 的 yield 类 型 。 在 yield 类 型 中 ， 变 量 state 定义 了 迭代 的 当前 
位 置 ， 每 次 调用 MoveNext0 时 ， 当 前 位 置 都 会 改变 。MoveNext0 封 装 了 迭代 块 的 代码 ， 并 设置 了 current 变量 的 
值 ， 从 而 使 Current 属性 根据 位 置 返 回 一 个 对 象 。 

public class Hellocollection 


| 


public IEnumerator GetEnumerator() => new Enumerator (DO) ; 
Public class Enumerator: IEnumerator<string>, IEnumerator, IDisposable 


private int state; 
private string current; 
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Public EnumeTrator (Int state) => state = state; 
bool System.cCcollections.IEnumerator.MoveNext() 
{ 


switch (state) 
{ 


Case 0: 
Current = "Hello"™, 
state = 1; 
IeEturn trues 
Case 1: 
Current = "World", 
state = 2 
return true; 
CaSEe 2: 
break; 
} 


return false; 


] 


vold System.Collections.IEnumerator.Reset() => 
throw new NotSupportedException().; 


string System.Collections.Generic.IEnumerator<string>.Current => current; 
object System.Collections.IEnumerator.Current => current; 
voOld IDisposable.Dispose() { } 


注意 : 


yield 语句 会 生成 一 个 枚 举 器 ， 而 不 仅仅 生成 一 个 包含 的 项 的 列表 。 这 个 枚 举 器 通过 foreach 语句 调用 。 从 
foreach 中 依次 访问 每 一 项 时 ， 就 会 访问 枚 举 器 。 这 样 就 可 以 迭代 大 量 的 数据 ， 而 不 需要 一 次 把 所 有 的 数据 都 读 
入 内 存 。 


1. 迭代 集合 的 不 同方 式 


在 下 面 这 个 比 Hello World 示例 略 大 但 比较 真实 的 示例 中 ， 可 以 使 用 yield retum 语句 ， 以 不 同方 式 欠 代 集 


合 的 类 。 类 MusicTitles 可 以 用 默认 方式 通过 GetEnumerator0 方 法 迭代 标题 ， 用 Reverse0) 方 法 逆序 迭代 标题 ， 用 
Subset0 方 法 迭代 子 集 ( 代 码 文件 YieldSample/MusicTitles.cs): 


Public class MusicTitles 


{ 


string[] names = 


= {"Tubular Bells™", "Hergest Ridge"™, 


"Ommadawn™, 
Public IEnumerator<string> GetEnumerator () 
| 


"Platinum™}; 


for {int 1 = 0; 1 < 4; 1++) 
{ 

ylield return names[il]; 
} 
} 


public IEnumerable<string> Reverse() 
{ 
for (int i = 3; i >= 0; 1i-) 
{ 
yield return names[1i]; 
} 
} 


public IEnumerable<string> Subset (int index, int length) 
{ 

for {int 1 = index; 1 < index + length; 1i++) 

{ 

yield return names[il]; 

} 

} 
} 


注意 : 


类 支持 的 默认 迁 代 是 定义 为 返回 IEnumerator 的 GetEnumerator0 方 法 。 命 名 的 迭代 返回 IEnumerable。 
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夺 代 字符 串 数 组 的 客户 端 代 码 先 使 用 GetEnumerator0 方 法 ， 该 方法 不 必 在 代码 中 编写 ， 因 为 这 是 foreach 
语句 默认 使 用 的 方法 。 然 后 道 序 途 代 标 题 ， 最 后 将 夫 引 和 要 迭代 的 项 数 传递 给 Subset0 方 法 ， 来 迭代 子 集 (代码 
文件 YieldSample/Proeram.cs): 


var titles = new MusicTitles(); 
foreach (Var title in titles) 
{ 
Console.WriteLine (title).; 
} 


Console .WriteLine ():; 


Console .WriteLine ("reverse™).: 
foreach (Var title in titles.Reversel()) 
{ 
Console.WriteLine (title).; 
} 


Console .WriteLine ():; 


Console .WriteLine ("subset™):; 
foreach (var title in titles.Ssubset(2, 2)) 
{ 

Console.WriteLine (title}).; 


} 
2. 用 yield return 返回 枚 举 器 


使 用 yield 语句 还 可 以 完成 更 复杂 的 任务 ， 例 如 ， 从 yield retum 中 返回 枚 举 器 。 在 Tic-Tac-Toe 游戏 中 有 9 
个 域 ， 玩 家 轮流 在 这 些 域 中 放置 一 个 “十 ” 字 或 一 个 圆 。 这 些 移动 操作 由 GameMoves 类 模拟 。 方 法 Cross0 和 
Circle0 是 创建 从 代 类 型 的 迭代 块 。 变 量 cross 和 circle 在 GameMoves 类 的 构造 函数 中 设置 为 Cross0 和 Circle0) 
方法 。 这 些 字段 不 设置 为 调用 的 方法 ， 而 是 设置 为 用 迭代 坎 定 义 的 途 代 类 型 。 在 Cross0 连 代 块 中 ， 将 移动 操作 
的 信息 写 到 控制 全 上， 并 递增 移动 次 数 。 如 果 移 动 次 数 大 于 8， 就 用 yield break 停止 欠 代 ; 否则 ， 就 在 每 次 碗 
代 中 返回 yield 类 型 circle 的 枚 举 对 象 。 Circle0 适 代 块 非常 类 似 于 Cross0 适 代 块 , 只 是 它 在 每 次 近代 中 返回 cross 
迁 代 器 类 型 (代码 文件 YieldSample/GameMoves.cs)。 

Public class GameMoves 

| 

private IEnumerator Cross; 
private IEnumerator circle; 
public GameMoves() 
{ 

_Cross = Cross () ， 

C1ICle = CILFTCLET TY ; 

private int move = 0; 
const int MaxMoves = 9; 


public IEnumerator Cross() 


{ 
while (true)} 
{ 
Console .WriteLine ($"Cross, move { move}"™); 
if {++ move >= MaxMoves) 
{ 
Vield break; 
} 
Yield return circle; 
} 
} 
Public IEnumerator Circle{() 
{ 
while (true) 
{ 


Console .WriteLine ($"Circle, move {move}"™); 
if {++ move >= MaxMoves) 
{ 

Yield break; 
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} 


yield return _ Crosss 


} 
} 
} 


在 客户 并 程序 中 , 可 以 以 如 下 方式 使 用 GameMoves 类 ,将 枚 举 器 设置 为 由 game.Cross0 返 回 的 枚 举 器 类 型， 
以 设置 第 一 次 移动 。 在 while 循环 中 ， 调 用 enumerator MoveNextO0。 第 一 次 调用 enumeratorMoveNextO0 时 ， 会 
调用 Cross0 方 法 ，Cross0 方 法 使 用 yield 语句 返回 另 一 个 枚 举 器 。 返 回 的 值 可 以 用 Current 属性 访问 ， 并 设置 为 
enumerator 变量 ， 用 于 下 一 次 循环 : 

var game = new GameMoves () ; 


IENnumerator enumerator = game.Cross (); 
while (enumerator .MoveNext ()) 


{ 


enumerator = enumerator.Current as IEnumerator; 


} 


这 个 程序 的 输出 会 显示 区 蔡 移 动 的 情况 ， 直 到 最 后 一 次 移动 : 


Cross, 
Circle, 
CIOSS, 
Circle, 
Cross, 
Circle, 
CIOSS, 
Circle, 
Cross, 


move 0 
move 1 
IDOTE 2 
move 3 
move 4 
move 5 
move & 
move 了 
move 8 


7.9 结构 比较 


数组 和 元 组 都 实现 接口 IStucturalEquatable 和 IStructuralComparable。 这 两 个 接口 不 仅 可 以 比较 引用 ， 还 可 
以 比较 内 容 。 这 些 接口 都 是 显 式 实现 的 ， 所 以 在 使 用 时 需要 把 数组 和 元 组 强制 转换 为 这 个 接口 。 
IStructuralEquatable 接口 用 于 比较 两 个 元 组 或 数组 是 否 有 相同 的 内 容 ，IStructuralComparable 接口 用 于 给 元 组 或 


数组 排序 。 
正 E 


元 组 参见 第 13 章 。 


对 于 说 明 IStructuralEquatable 接口 的 示例 ， 使 用 实现 正 quatable 接口 的 Person 类 。IEquatable 接口 定义 了 一 
个 强 类 型 化 的 Equals0 方 法 ， 以 比较 FirstName 和 LastName 属性 的 值 (代码 文件 StucturalComparison/Person.cs): 


Public class Person: IEquatable<Person> 


{ 


public int Id { get; } 
public string FirstName { get; } 
public string LastName { get; } 


public Personl(int id, string firstName, string lastName) 


{ 
Id = iqd: 
FirstName = firstName.: 
LastName = lastName; 

} 


public override string ToString() => $"{Id}, {FirstName} {LastName}"; 


public override bool Equals (object ob]j) 


{ 


if (ob] == null) 


{ 


return base.Equals (ob]j]); 


] 


return Equals (ob] as Person); 


} 
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public override 1Int GetHashCode() => Id.GetHashCode () : 


public bool Equals (Person other) 


{ 
if (other == null) 
return base.Egquals (other}: 
return Id == other.Id && FirstName == other.FirstName && 
LastMame == other.LastName; 
} 
} 


现在 创建 了 两 个 包含 Person 项 的 数组 。 这 两 个 数组 通过 变量 名 janet 包含 相同 的 Person 对 象 ， 和 两 个 内 容 
相同 的 不 同 Person 对 象 。 比 较 运 算 特 “!=” 返 回 tue， 因 为 这 其 实 是 两 个 变量 personsl 和 persons2 引用 的 两 个 
不 同 数组 。 因 为 Array 类 没有 重 写 带 一 个 参数 的 Equals0 方 法 ， 所 以 用 “ 王 ” 运 算 符 比较 引用 也 会 得 到 相同 的 
结果 ， 即 这 两 个 变量 不 相同 (代码 文件 StucturalComparison/Program.cs): 

var Janet = new Person("Janet™"™, "Jackson™).; 

Person[] peoplel = { 
new Person("Michael™", "Jackson™), 
janet 
Es Deoplez = { 
new Person("Michael™., "Jackson"™) 
janet 


} 7 
if (Peoplel != people2) 
{ 


Console.WriteLine ("not the same reference™):; 


对 于 IStructuralEquatable 接口 定义 的 Equals0 方 法 ， 它 的 第 一 个 参数 是 object 类 型 ， 第 二 个 参数 是 
IEqualityComparer 类 型 。 调 用 这 个 方法 时 ， 通 过 传递 一 个 实现 了 IEqualityComparer<T> 的 对 象 ， 就 可 以 定义 如 
何 进行 比较 。 通 过 EqualityComparer<T> 类 完成 IEqualityComparer 的 一 个 默认 实现 。 这 个 实现 检查 该 类 型 是 否 
实现 了 正 quatable 接口 ， 并 调用 IEquatable Equals0 方 法 。 如 果 该 类 型 没有 实现 下 quatable， 就 调用 Object 基 类 
中 的 Equals0 方 法 进行 比较 。 

Person 实现 下 quatable<Person>， 在 此 过 程 中 比较 对 象 的 内 容 ， 而 数组 的 确 包含 相同 的 内 容 : 

if {{peoplel as IStructuralEquatable}) .Equals (people2, 

EqualityComparer<Person> .Default)) 

{ 


Console.WriteLine("the same content™).; 


} 


7.10 Span 


为 了 快速 访问 托管 或 非 托 管 的 连续 内 存 ， 可 以 使 用 Span<T> 结 构 。 一 个 可 以 使 用 Span<T> 的 例子 是 数组 ; 
Span<T> 结构 在 后 台 保 存在 连续 的 内 存 中 。 男 一 个 例子 是 长 字符 串 。 在 第 9 章 中 使 用 了 Span<T> 和 字符 串 。 
使 用 Span<T>， 可 以 直接 访问 数组 元 素 。 数 组 的 元 素 没 有 复制 ， 但 是 它们 可 以 直接 使 用 ， 这 比 复制 要 快 。 
在 下 面 的 代码 片段 中 ， 首 先 创建 并 初始 化 一 个 简单 的 int 数组 。 调 用 构造 图 数 ， 并 将 数组 传递 给 Span<int>， 
以 创建 一 个 Span<int> 对 象 。Span<T> 类 型 提供 了 一 个 索引 器 ， 因 此 可 以 使 用 这 个 索引 器 访问 Span<T> 的 元 素 。 
这 里 ， 第 二 个 元 素 的 值 改 为 11。 由 于 数组 arrl 是 在 span 中 引用 的 ， 因 此 通过 改变 span <T> 元 素来 改变 数组 的 
第 二 个 元 素 ( 代 码 文 件 SpanSample/Program.cs): 
private static Span<int> Introspans () 
int[] arrl = { 1, 4, 5, 11, 13, 18 ]}; 
var spanl = new Span<int> (arr1); 
spanl[l1] = 11; 


Console.WriteLine ($"arrl[i] is changed wia spanl[1]: {arrl[1i]}"); 
return spanil; 
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7.10.1 创建 切片 


Span<T> 的 一 个 强大 特性 是 ， 可 以 使 用 它 访 问 数组 的 部 分 或 切片 。 使 用 切片 时 ， 不 会 复制 数组 元 素 ， 它 们 
是 从 Span 中 直接 访问 的 。 

下 面 的 代码 片段 展示 了 创建 切片 的 两 种 方法 。 第 一 种 方法 是 ， 使 用 一 个 构造 函数 重 载 版 本 传递 应 使 用 的 数 
组 的 开头 和 长 度 。 使 用 变量 span3 引用 这 个 新 创建 的 Span<int>， 它 只 能 访问 数组 arr2 的 3 个 元 素 ， 从 第 四 个 元 
素 开 始 。 构 千 函 数 还 有 男 一 个 重 载 版 本 ， 它 可 以 仅 传递 切片 的 开 尖 。 在 这 个 重 载 版 本 中 ， 会 提取 数组 的 剩余 部 
分 ,一 直到 数组 的 末尾 。 调 用 Slice 方法 ， 也 可 以 从 Span<T> 对 象 中 创建 一 个 切片 。 它 有 类 似 的 重 载 版 本 。 通 过 
变量 span4， 使 用 之 前 创建 的 spanl 创建 一 个 包含 4 个 元 背 的 切片 ， 且 从 spanl 的 第 3 个 元 素 开始 (代码 文件 
SpanSample/Program.cs): 


private static Span<int> CreateSlices (Span<int> spanl) 
{ 
Console .WriteLine (nameof (CreateSsSlices)}))}):; 
int[] arr2 = { 3, 5, 7, 9, 11, 13, 15 1}; 
Var Span2 = new Span<int> (arr2); 
Var span3 = new Span<int> (arr2, start: 3, length: 3); 
Var SPand = spanl .Slice(start: 2, length: 4); 


DisplaySspan("content of span3", span3); 
DisplaySspan("content of span4™", spand4); 
Console .WriteLine():; 

return span2s 


} 

DisplaySpan 方法 用 于 显示 span 的 内 容 。 下 面 代 码 段 中 的 方法 利用 了 ReadOnlySpan。 如 果 不 需 要 更 改 span 
引用 的 内 容 ， 就 可 以 使 用 这 个 span 类 型 ，DisplaySpan 方法 就 是 这 样 。ReadOnlySpan<T> 在 本 章 后 面 详细 讨论 : 

private static void Displayspan(string title, ReadonlySsSpan<int> span) 


Console .WriteLine (title).: 
for (int i = 0; i < span.Length; i++) 
{ 
Console.Write($"{span[i]}."); 
} 


Console .WriteLine().; 


} 

运行 应 用 程序 时 ， 显 示 span3 和 span4 的 内 容 ， 它 们 是 arr2 和 arrl 的 子 集 。 
content of span3 

9.11 .13. 


content of spand4 
6-8-10-12 - 


注意 : 
Span<T> 是 安全 的 ， 不 会 出 界 。 如 果 在 创建 的 span 超出 包含 的 数组 长 度 ， 就 会 抛 出 
AreumentOutOfRangeException 类 型 的 异常 。 阅 读 第 14 章 ， 了 解 关于 异常 处 理 的 更 多 信息 。 


7.10.2 使 用 Span 改变 值 


前 面 介绍 了 如 何 使 用 Span <T> 类 型 的 索引 器 ， 直 接 更 改 由 span 引用 的 数组 元 素 。 下 面 的 代码 片段 显示 了 
更 多 的 选项 。 

可 以 调用 Clear 方法 ， 该 方法 用 0 填充 包含 int 类 型 的 span; 可 以 调用 Fill 方法 ， 用 传递 给 Fill 方法 的 值 来 
填充 span; 可 以 将 一 个 Span<T> 复 制 到 另 一 个 Span<T>。 在 CopyTo 方法 中 ， 如 果 目 标 span 不 够 大 ， 就 会 抛 出 
AregumentException 类 型 的 异常 。 可 以 使 用 TryCopyTo 方法 来 避免 这 个 结果 。 如 果 目 标 span 不 够 大 ， 此 方法 不 
会 抛 出 异 间 ;而 是 返回 false， 因 为 复制 没有 成 功 (代码 文件 SpanSample/Program.cs): 

static void ChangeValues (Span<int> spanl, Span<int> span2) 


Console.WriteLine (nameof (ChangeValues)); 
Span<int> span4 = spanl.Slicel(start: 4); 


第 7 章 数 组 1167 


spand4.Clear(); 

DisplaySsSpan{("content of spanl™", spanl); 

Span<int> span5 = span?2.Slijce (start: 3, length: 3); 
spans .Fill(42).; 

DisplaySsSpan{("content of span2", span2); 
span.CopyTo (spanl); 

DisplaySspan{("content of spanl™", spanl); 


1f (!'spanl .TryCopyTo (spand4)) 
{ 
Console.WriteLine("Couldn't copy spanl to span4 because span4 is ™+ 
"too small™)}); 
Console.WriteLine($"length of span4: {span4.Length}, length of ™ + 
$s"spanl: {spanl.Length}"); 
} 
Console .WriteLine().; 


} 

运行 应 用 程序 时 ， 可 以 看 到 spanl 的 内 容 ， 其 中 的 最 后 两 个 数 使 用 span4 清除 ， 还 可 以 看 到 span2 的 内 容 ， 
其 中 有 三 个 元 素 用 span5 来 填充 值 42， 也 可 以 看 到 spanl 的 内 容 ， 其 中 前 三 个 数字 从 spans 中 复制 。 从 spanl 
复制 到 span4 是 不 成 功 的 ， 因 为 span4 的 长 度 只 有 4， 而 spanl 的 长 度 是 6: 


content of spanl 

2.11.6.8.0.0. 

content of span2z 

3.5.7.42.42.42.15. 

content of spanl 

A42 .42.42.8.0.0. 

Couldn't copy spanl to span4 because span4 is too small 
Length of span4: 2, length of spanl: 6 


7.10.3 ”只 读 的 Span 


如 果 只 需要 对 数组 段 进行 读 访问 ， 就 可 以 使 用 ReadOnlySpan<T=>， 如 前 面 的 DisplaySpan 方法 所 示 。 对 于 
ReadOnlySpan<T>， 索 引 器 是 只 读 的 ， 这 种 类 型 没有 提供 Clear 和 Fil 方法 。 但是， 可 以 调用 CopyTo 方法 ， 将 
ReadOnlySpan<T> 的 内 容 复 制 到 Span<T>。 

下 面 的 代码 片段 使 用 ReadOnlySpan<T> 的 构造 函数 从 一 个 数组 中 创建 了 readOnlySpan1，readOnlySpan2 和 
readOnlySpan3 是 由 Span<int> 和 int[] 的 直接 赋予 创建 的 。 隐 式 转 换 操 作 符 可 用 于 ReadOnlySpan<T>( 代 码 文 件 
SpanSample/Proeram.cs): 

private static void ReadonlySsSpanl(Span<int> spanl) 

{ 
Console.WriteLine (nameof (ReadonlySspan) ) ; 
int[] arr = spanl.ToArray(); 
ReadoOnlySpan<int> readOnlySpanl = new ReadOnlySpan<int»> (arr); 
DisplaySpan("readonlySsSpanl", readonlySspanl)});} 
ReadonlySpan<int> readonlySspan?2 = Spanl:; 
DisplaySspan("readonlySsSpan2", readonlySspan2); 
ReadOonlySpan<int> readOnlySpan3 = arr; 


DisplaySsSpan("readonlySsSpan3", readonlyspan3);} 
Console .WriteLine(}); 


注意 : 

本 书 的 先前 版 本 演示 了 ArraySegment<T> 的 用 法 ， 尽 管 ArraySegment<T> 仍 然 可 用 ， 但 它 有 一 些 缺 点 ， 可 
以 使 用 更 灵活 的 Span<T> 作 为 替换 。 如 果 已 经 使 用 了 ArraySegment<T>, 可 以 保留 代码 并 与 span 交互 。Span<T> 
的 构造 函数 也 允许 传递 ArraySegment<T> 来 创建 Span<T> 实 例 。 


7.11 数组 池 


如 果 一 个 应 用 程序 创建 和 销毁 了 许多 数组 ， 垃 圾 收集 器 就 有 一 些 工作 要 做 。 为 了 减少 垃圾 收集 器 的 工作 ， 
可 以 通过 ArrayPool 类 使 用 数组 池 。ArrayPool 管理 一 个 数组 池 。 数 组 可 以 从 这 里 租借 ， 并 返回 到 池 中 。 内 存在 
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ArrayPool 中 管理 。 


7.11.1 创建 数组 池 


通过 调用 议 态 Create 方法 ， 可 以 创建 ArrayPool<T>。 为 了 提高 效率 ， 数 组 池 在 多 个 桶 中 为 大 小 类 似 的 数组 
管理 内 存 。 使 用 Create 方法 ， 可 以 在 需要 一 个 桶 之 前 ， 在 男 一 个 桶 中 定义 最 大 的 数组 长 度 和 数组 的 数量 : 


ArrayPool<int> customPool = ArrayPool<int>.Createl 
maxArravLength: 40000, maxArraysPerBucket: 10).; 


maxArrayLeneth 的 默认 值 是 1024 * 1024 字 节 ，maxArraysPerBucket 的 默认 值 是 50。 数 组 池 使 用 多 个 桶 ， 
以 便 在 使 用 多 个 数组 时 更 快 地 访问 数组 。 只 要 还 没有 到 达 数 组 的 最 大 数量 ， 大 小 类 似 的 数组 就 尽 可 能 保存 在 同 
一 个 桶 中 。 

还 可 以 通过 访问 ArrayPool<T> 类 的 共享 属性 ， 来 使 用 预定 义 的 共享 池 : 


ArrayPool<int> sharedPool = ArrayPool<int>.Shared; 


7.11.2 ”从 池 中 租用 内 存 


调用 Rent 方法 可 以 请 求 池 中 的 内 存 。Rent 方法 接受 应 请 求 的 最 小 数组 长 度 。 如 果 池 中 已经 有 内 存 ， 则 返 
回 该 内 存 。 如 果 它 不 可 用 , 就 给 池 分 配 内 存 , 然后 返回 。 在 下 面 的 代码 片段 中 , 在 for 循环 中 请 求 一 个 包含 1024、 
2048、3096 等 元 系 的 数组 (代码 文件 ArrayPoolSample/Program.cs): 

private static void UseSsharedPool{() 


for (nt 1 = 07 1 < 10; 1++) 

{ 
int arrayLength = (LI + 1) << 10; 
int[] arr = ArrayPool<int»> .Shared.Rent (arrayLength); 
Console.WriteLine($"requested an array of {arrayLength} ™ 十 

ss"and received {arr.Length}"); 

Ef 

} 

} 


Rent 方法 返回 一 个 数组 ， 其 中 至 少 包 含 所 请 求 的 元 素 个 数 。 返 回 的 数组 可 能 有 更 多 的 可 用 内 存 。 共 享 池 中 
至 少 有 16 个 元 素 。 托 管 数组 的 元 素 计 数 总 是 重复 的 一 例如，16、32、64、128、256、512、1024、2048、4096、 
8192 个 元 素 等 。 

运行 应 用 程序 时 ， 如 果 请 求 的 数组 大 小 不 符合 池 管 理 的 数组 ， 就 返回 较 大 的 数组 : 

requested an array of 1024 and received 1024 

requested an array of 2048 and received 2048 

requested an array of 3072 and received 4096 

requested an array of 4096 and received 4096 

requested an array of 5120 and received 8192 

requested an array of 6144 and received 8192 

requested an array of 7168 and received 8192 

requested an array of 8192 and received 8192 


requested an array of 9216 and received 16384 
requested an array of 10240 and received 16384 


7.11.3 ”将 内 存 返 回 给 池 


不 再 需要 数组 时 ， 可 以 将 其 返回 到 池 中 。 数 组 返回 后 ， 可 以 稍 后 再 用 另 一 个 Rent 来 重用 它 。 

调用 数组 池 的 Returm 方法 并 将 数组 传递 给 Retum 方法 ， 将 数组 返回 到 池 中 。 使 用 一 个 可 选 参 数 ， 可 以 指定 
在 返回 池 之 前 是 否 清 除 该 数组 。 如 果 不 清 除 它 ， 下 一 个 从 池 中 租用 数组 的 人 可 以 读 取 数 据 。 清 除数 据 ， 可 以 避 
倪 这 一 点 ， 但 是 需要 更 多 的 CPU 时 间 ( 代 码 文件 ArrayPoolSample/Proegram.cs): 


ArrayPool<int>.Shared.Returnl(larr, clearArray: true).; 
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注意 : 
第 17 章 讨论 了 垃圾 收集 器 以 及 如 何 获取 内 存 地 址 的 信息 。 


7.12 小结 


本 章 介 绍 了 创建 和 使 用 简单 数组 、 多 维 数组 和 锯齿 数组 的 C# 表 示 法 。C# 数 组 在 后 台 使 用 Array 类 ， 这 样 就 
可 以 用 数组 变量 调用 这 个 类 的 属性 和 方法 。 

我 们 还 探讨 了 如 何 使 用 IComparable 和 IComparer 接口 给 数组 中 的 元 背 排 序 ， 摘 述 了 如 何 创建 和 使 用 枚 举 
器 、IEnumerable 和 IFEnumerator 接口 ， 以 及 yield 语句 。 

最 后 介绍 了 如 何 通过 Span<T> 和 ArrayPool 高 效 地 使 用 数组 。 

第 8 章 介 绍 C# 的 更 多 重要 功能 : 委托 、lambda 和 事件 。 


第 
委托 、lambda 表达 式 和 事件 


本 章 要 点 
。 委托 
。 闭 包 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Delegates 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

e 向 单 委托 (Simple Delegates) 

se 冒 泡 排 序 (Bubble Sorter) 

e lambda 表达 式 (lambda Expressions) 

e 事件 示例 (Events Sample) 


8.1 引用 方法 


委托 是 寻 址 方法 的 .NET 版 本 。 在 C++ 中 , 函数 指针 只 不 过 是 一 个 指向 内 存 位 置 的 指针 , 它 不 是 类 型 安全 的 。 
我 们 无 法 判断 这 个 指针 实际 指向 什么 ， 参数 和 返回 类 型 等 项 就 更 无 从 知晓 了 。 而 .NET 委托 完全 不 同 ; 委托 是 
类 型 安全 的 类 ， 它 定义 了 返回 类 型 和 参数 的 类 型 。 委 托 类 不 仅 包 含 对 方法 的 引用 ， 也 可 以 包含 对 多 个 方法 的 
引用 。 

lambda 表达 式 与 委托 直接 相关 。 当 参数 是 委托 类 型 时 ， 就 可 以 使 用 lambda 表达 式 实现 委托 引用 的 方法 。 

本 重 介 绍 委托 和 lambda 表达 式 的 基础 知识 ， 说 明 如 何 通 过 lambda 表达 式 实现 委托 方法 调用 ， 并 前 述 .NET 
如 何 将 委托 用 作 实 现 事件 的 方式 。 


8.2 ”委托 


第 8 章 委托、lambda 表达 式 和 事件 | 171 


int 1 = int.Parse ("99"); 

我 们 习惯 于 把 数据 作为 参数 传递 给 方法 ， 如 上 面 的 例子 所 示 。 所 以 ， 给 方法 传递 男 一 个 方法 听 起 来 有 点 奇怪 。 
而 有 时 某 个 方法 执行 的 操作 并 不 是 针对 数据 进行 的 ， 而 是 要 对 忆 一 个 方法 进行 调用 。 更 麻烦 的 是 ,在 编译 时 我 们 不 
知道 第 二 个 方法 是 什么 ， 这 个 信息 只 能 在 运行 时 得 到 ， 所 以 需要 把 第 二 个 方法 作为 参数 传递 给 第 一 个 方法 。 这 听 起 
来 很 令 人 迷惑 ， 下 面 用 几 个 示例 来 说 明 : 


局 动 线程 和 任务 一 一 在 C# 中 ， 可 以 告诉 计算 机 并 行 运行 茶 些 新 的 执行 序列 ， 同 时 运行 当前 的 任务 。 这 
种 序列 就 称 为 线程 ， 在 一 个 基 类 System.Threading.Thread 的 实例 上 使 用 方法 Start0， 就 可 以 启动 一 个 线 
程 。 如 果 要 告诉 计算 机 启动 一 个 新 的 执行 序列 ， 就 必须 说 明 要 在 哪里 局 动 该 序列 必须 为 计算 机 提供 
开始 启动 的 方法 的 细节 ， 即 Thread 类 的 构造 函数 必须 带 有 一 个 参数 ， 该 参数 定义 了 线程 调用 的 方法 。 
通用 库 类 一 一 许多 库 包 含 执行 各 种 标准 任务 的 代码 。 这 些 库 通常 可 以 自我 包含 ， 这 样 在 编写 库 时 ， 就 会 
知道 任务 该 如 何 执行 。 但 是 有 时 在 任务 中 还 包含 子 任务 ， 只 有 使 用 该 库 的 客户 问 代 码 才 知道 如 何 执行 
这 些 子 任务 。 例 如 ， 假 设 要 编写 一 个 类 ， 它 带 有 一 个 对 象 数 组 ， 并 把 它们 按 升 序 排列 。 但 是 ， 排 序 的 
部 分 过 程 会 涉及 重复 使 用 数组 中 的 两 个 对 象 ， 比 较 它 们 ， 看 看 哪 一 个 应 放 在 前 面 。 如 果 要 编写 的 类 必 
须 能 对 任何 对 象 数组 排序 ， 就 无 法 提前 各 诉 计 算 机 应 如 何 比较 对 象 。 处 理 类 中 对 象 数组 的 客户 瑞 代 码 
也 必须 告诉 类 如 何 比 较 要 排序 的 特定 对 象 。 换 言 之 ,客户 端 代 码 必 须 给 类 传递 茶 个 可 以 调用 并 进行 
这 种 比较 的 合适 方法 的 细节 。 

事件 一 一 一 般 的 思路 是 通知 代码 发 生 了 什么 事件 。GUI 编程 主要 处 理事 件 。 在 引发 事件 时 ， 运行 库 需要 
知道 应 执行 哪个 方法 。 这 就 需要 把 处 理事 件 的 方法 作为 一 个 参数 传递 给 委托 。 这 些 将 在 本 章 后 面 讨论 。 


在 C 和 C++ 中 ， 只 能 提取 函数 的 地 址 ， 并 作为 一 个 参数 传递 它 。C 没有 类 型 安全 性 ， 可 以 把 任何 函数 传递 
给 需要 函数 指针 的 方法 。 但 是 ， 这 种 直接 方法 不 仅 会 导致 一 些 关 于 类 型 安全 性 的 问题 ， 而 且 没 有 意识 到 : 在 进 
行 面 品 对象 编程 时 ， 几 乎 没有 方法 是 孤立 存在 的 ， 而 是 在 调用 方法 前 通 币 需要 与 类 实例 相关 联 。 所 以 -NET 
Framework 在 语法 上 不 允许 使 用 这 种 直接 方法 。 如 果 要 传递 方法 ， 就 必须 把 方法 的 细节 封装 在 一 种 新 的 对 象 类 
型 中 ， 即 委托 。 委 托 只 是 一 种 特殊 类 型 的 对 象 ， 其 特殊 之 处 在 于 ， 我 们 以 前 定义 的 所 有 对 象 都 包含 数据 ， 而 委 
托 包含 的 只 是 一 个 或 多 个 方法 的 地 址 。 


8.2.1 


声明 委托 


在 C# 中 使 用 一 个 类 时 ,分 两 个 阶段 操作 。 首 先 ， 需 要 定义 这 个 类 ， 即 告诉 编译 器 这 个 类 由 什么 字段 和 方法 
组 成 。 然 后 (除非 只 使 用 静态 方法 )， 实 例 化 该 类 的 一 个 对 象 。 使 用 委托 时 ， 也 需要 经 过 这 两 个 步骤 。 首 先 必须 
定义 要 使 用 的 委托 ， 对 于 委托 ， 定 义 它 就 是 告诉 编译 器 这 种 类 型 的 委托 表示 哪 种 类 型 的 方法 。 然 后 ， 必 须 创 建 
该 委托 的 一 个 或 多 个 实例 。 编 译 器 在 后 台 将 创建 表示 该 委托 的 一 个 类 。 

声明 委托 的 语法 如 下 : 

delegate void IntMethodInvoker (int x); 

在 这 个 示例 中 ， 声 明了 一 个 委托 IntMethodInvoker， 并 指定 该 委托 的 每 个 实例 都 可 以 包含 一 个 方法 的 引用 ， 
该 方法 带 有 一 个 int 参数 ， 并 返回 void。 理 解 委 托 的 一 个 要 点 是 它们 的 类 型 安全 性 非常 高 。 在 定义 委托 时 ， 必 
须 给 出 它 所 表示 的 方法 的 签名 和 返回 类 型 等 全 部 细节 。 


注意 : 

理解 委托 的 一 种 好 方式 是 把 委托 视 为 给 方法 的 签名 和 返回 类 型 指定 名 称 。 

假定 要 定义 一 个 委托 TwoLongsOp， 该 委托 表示 的 方法 有 两 个 long 型 参数 ， 返 回 类 型 为 double。 可 以 编写 
如 下 代码 : 

delegate double TwoLongsop (long first, long second) ，; 

或 者 要 定义 一 个 委托 ， 它 表示 的 方法 不 带 参 数 ， 返 回 一 个 string 型 的 值 ， 可 以 编写 如 下 代码 : 


delegate string GetAString(); 
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其 语法 类 似 于 方法 的 定义 ， 但 没有 方法 主体 ， 且 定义 的 前 面 要 加 上 关键 字 delegate。 因 为 定义 委托 基本 上 
是 定义 一 个 新 类 ， 所 以 可 以 在 定义 类 的 任何 相同 地 方 定义 委托 。 也 就 是 说 ， 可 以 在 男 一 个 类 的 内 部 定义 委托 ， 
也 可 以 在 任何 类 的 外 部 定义 , 还 可 以 在 名 称 空间 中 把 委托 定义 为 项 层 对 象 。 根据 定义 的 可 见 性 和 委托 的 作用 域 ， 
可 以 在 委托 的 定义 上 应 用 任意 常见 的 访问 修饰 人行 ，public、private、protected 等 


Public delegate string GetAString(); 


注意 : 

实际 上 ，“ 定 义 一 个 委托 ”是 指 “ 定 义 一 个 新 类 ”。 委 托 实现 为 派生 自 基 类 System. MulticastDelegate 的 类 ， 
System.MulticastDelegate 又 派生 自 基 类 System.Delegate。C# 编 译 器 能 识别 这 个 类 ， 会 使 用 其 委托 语法 ， 因 此 我 
们 不 需要 了 解 这 个 类 的 具体 执行 情况 。 这 是 C# 与 基 类 共同 合作 以 使 编程 更 易 完 成 的 另 一 个 范例 。 


定义 好 委托 后 ， 就 可 以 创建 它 的 一 个 实例 ， 从 而 用 该 实例 存储 特定 方法 的 细节 。 


注意 : 

但 是 ， 此 处 在 术语 方面 有 一 个 问题 。 类 有 两 个 不 同 的 术语 : “类 ”表示 较 广 义 的 定义 ，“ 对 象 ”表示 类 的 
实例 。 但 委托 只 有 一 个 术语 。 在 创建 委托 的 实例 时 ， 所 创建 的 委托 的 实例 仍 称 为 委托 。 必 须 从 上 下 文中 确定 所 
使 用 委托 的 确切 含义 。 


8.2.2 ”使 用 委托 


下 面 的 代码 段 说 明了 如 何 使 用 委托 。 这 是 在 int 值 上 调用 ToString0 方 法 的 一 种 相当 元 长 的 方式 (代码 文件 
GetAStrneDemo/Program.cs): 
private delegate string GetAString(}); 
public static void Maint{) 
{ 
int XX = 40; 
GetAString firstSstringMethod = new GetAString (x.ToString); 
Console.WriteLine($"SsString is {firststringMethod() }").; 
/:/ With firststringMethod initialized to x.ToString(), 
/:/ the above statement is equivalent to savying 
/:/ Console.WriteLine ($"String is {xX.ToString()}"); 
} 


在 这 段 代 码 中 ， 实 例 化 类 型 为 GetAString 的 委托 ， 并 对 它 进行 初始 化 ， 使 其 引用 整 型 变量 x 的 ToStringO 
方法 。 在 C# 中 ， 委 托 在 语法 上 总 是 接受 一 个 参数 的 构造 函数 ， 这 个 参数 就 是 委托 引用 的 方法 。 这 个 方法 必须 匹 
配 最 初 定 义 委 托 时 的 签名 。 所 以 在 这 个 示例 中 ， 如 果 用 不 带 参 数 并 返回 一 个 字符 串 的 方法 来 初始 化 
firstStrineMethod 变量 ， 就 会 产生 一 个 编译 错误 。 注 意 ， 因 为 int.ToString0 是 一 个 实例 方法 (不 是 静态 方法 )， 所 
以 需要 指定 实例 (x) 和 方法 名 来 正确 地 初始 化 委托 。 

下 一 行 代码 使 用 这 个 委托 来 显示 字符 串 。 在 任何 代码 中 ， 都 应 提供 委托 实例 的 名 称 ， 后 面 的 圆 括号 中 应 包 
含 调用 该 委托 中 的 方法 时 使 用 的 任何 等 效 参 数 。 所 以 在 上 和 面 的 代码 中 ，Console.WriteLine0 语 句 完 全 等 价 于 注释 
掉 的 代码 行 。 

实际 上 , 给 委托 实例 提供 圆 括号 与 调用 委托 类 的 Invoke0 方 法 完全 相同 。 因 为 firstStrineMethod 是 委托 类 型 
的 一 个 变量 ， 所 以 C# 编 译 器 会 用 fstStringMethod.Invoke0O 代 蔡 firstStringMethod0。 


firststringMethod ();} 
firststringMethod.Invoke (});} 


为 了 减少 输入 量 ， 在 需要 委托 实例 的 每 个 位 置 可 以 只 传送 地 址 的 名 称 。 这 称 为 委托 推断 。 只 要 编译 器 可 以 
把 委托 实例 解析 为 特定 的 类 型 ， 这 个 C# 特 性 就 是 有 效 的。 下 面 的 示例 用 GetAString 委托 的 一 个 新 实例 初始 化 
GetAString 类 型 的 frstStringMethod 变量 : 

GetAString firststringMethod = new GetAString (XxX.ToString); 


只 要 用 变量 x 将 方法 名 传送 给 变量 frstStingMethod， 就 可 以 编写 出 作用 相同 的 代码 : 
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GetAString firststringMethod = Xx.ToString; 
C# 编 译 器 创建 的 代码 是 一 样 的 。 由 于 编译 器 会 用 frstStringMethod 检测 需要 的 委托 类 型 ， 因 此 它 创 建 
GetAString 委托 类 型 的 一 个 实例 ， 用 对 象 x 将 方法 的 地 址 传送 给 构造 函数 。 


注意 : 

调用 上 述 方法 名 时 ， 输 入 形式 不 能 为 X.ToString0( 不 要 输入 圆 括号 )， 也 不 能 把 它 传 送 给 委托 变量 。 输 入 辆 
括号 会 调用 一 个 方法 ， 而 调用 XToString(0) 方 法 会 返回 一 个 不 能 赋予 委托 变量 的 字符 串 对 象 。 只 能 把 方法 的 地 址 
赋予 委托 变量 。 


委托 推 疡 可 以 在 需要 委托 实例 的 任何 地 方 使 用 。 委 托 推断 也 可 以 用 于 事件 ， 因 为 事件 基于 委托 (参见 本 章 后 
面 的 内 容 )。 

委托 的 一 个 特征 是 它们 的 类 型 是 安全 的 ， 可 以 确保 被 调用 的 方法 的 签名 是 正确 的 。 但 有 趣 的 是 ， 它 们 不 关心 
在 什么 类 型 的 对 象 上 调用 该 方法 ， 甚 至 不 考虑 该 方法 是 静态 方法 还 是 实例 方法 。 


Ee 
给 定 委托 的 实例 可 以 引用 任何 类 型 的 任何 对 象 上 的 实例 方法 或 静态 方法 
名 即 可 。 


为 了 说 明 这 一 点 ， 扩 展 上 面 的 代码 段 ， 让 它 使 用 frstStingMethod 委托 在 另 一 个 对 象 上 调用 其 他 两 个 方法 ， 
其 中 一 个 是 实例 方法 ， 男 一 个 是 静态 方法 。 为 此 ， 使 用 本 章 前 面 定 义 的 Currency 结构 。Currency 结构 有 目 己 的 
ToString0 重 载 方法 和 一 个 与 GetCurrencyUnit0 签 名 相同 的 静态 方法 。 这 样 ， 就 可 以 用 同一 个 委托 变量 调用 这 些 
方法 (代码 文件 GetAStrineDemo/Currency.cs): 
struct Currency 
| 
PUublic uint Dollars; 
PUublic ushort Cents; 


PUublic Currency(uint dollars, ushort cents) 


{ 


只 要 方法 的 签名 匹配 委托 的 签 


Dollars = dollars; 
Cents = cents; 
} 
public override string ToSsString{() => $"${Dollars}.{Cents,2:00}"™; 


Public static string GetCurrencyUnit() => "Dollar™; 


Public static explicit operator Currency (float value) 


{ 
checked 
{ 
uint dollars = (uint)wvalue; 
ushort cents = (ushort}) ({({value—dollars})} * 100); 
return new Currency(dollars, cents}); 
} 
} 


Public static implicit operator float (Currency value) => 
value.Dollars + (value-Cents / 100.0f); 


public static implicit operator Currency (uint value) => 
mew Currency (value, 0).; 


Public static implicit operator uint (Currency value) => 
Value .Dollars; 


} 


下 面 可 以 使 用 GetAString 实例 ， 代 码 如 下 所 示 ( 代 码 文件 GetAStringDemo/Program.cs): 


private delegate string GetAString(); 
public static void Main() 
{ 

int XxX = 40; 

GetAString firstSstringMethod = x.ToString; 
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Console .WrIteLlIne(S"StrliIng is {firstSstringMethod() }"); 
Var balance = new Currency(34, 0)5; 


/:/ firststringMethod references an instance method 
firstSstringMethod = balance.ToString; 
Console .WriteLine($"String is {firststringMethod() }"); 


// firststringMethod references a static method 
firststringMethod = new GetAString (Currency.GetCurrencyUnit); 
Console .WriteLine ($"String is {firststringMethod() }"); 

} 


这 段 代码 说 明了 如 何 通 过 委托 来 调用 方法 ， 然 后 重新 给 委托 指定 在 类 的 不 同 实例 上 引用 的 不 同方 法 ， 甚 至 
可 以 指定 静态 方法 ， 或 者 指定 在 类 的 不 同类 型 实例 上 引用 的 方法 ， 只 要 每 个 方法 的 签名 匹配 委托 定义 即 可 。 
运行 此 应 用 程序 ， 会 得 到 委托 引用 的 不 同方 法 的 输出 结果 : 


String is 40 
String is $34.50 
String is Dollar 


但 是 , 我 们 实际 上 还 没有 说 明 把 一 个 委托 传递 给 男 一 个 方法 的 具体 过 程 , 也 没有 得 到 任何 特别 有 用 的 结果 。 
调用 int 和 Curency 对 象 的 ToString0 方 法 要 比 使 用 委托 直观 得 多 ! 但 是 ， 需 要 用 一 个 相当 复杂 的 示例 来 说 明 委 
托 的 本 质 ， 才 能 真正 领会 到 委托 的 用 处 。 下 一 节 会 给 出 两 个 委托 的 示例 。 第 一 个 示例 仅 使 用 委托 来 调用 两 个 不 
同 的 操作 。 它 说 明了 如 何 把 委托 传递 给 方法 ， 如 何 使 用 委托 数组 ， 但 这 仍 没有 很 好 地 说 明 : 没有 委托 ， 融 不 能 
完成 很 多 工作 。 第 二 个 示例 就 复杂 得 多 了 ， 它 有 一 个 类 BubbleSorter， 该 类 实现 一 个 方法 来 按照 升序 排列 一 个 
对 象 数组 。 没 有 委托 ， 就 很 难 编写 出 这 个 类 。 


8.2.3 简单 的 委托 示例 


在 这 个 示例 中 ， 定 义 一 个 类 MathOperations， 它 有 两 个 静态 方法 ， 对 double 类 型 的 值 执行 两 种 操作 。 然 后 
使 用 该 委托 调用 这 些 方法 。MathOperations 类 如 下 所 示 : 


class MathOperations 

{ 
public static double MultiplyByTwo (double value) => value 六 2; 
public static double Square (double value) => walue * value; 


} 
下 面 调用 这 些 方法 (代码 文件 SimpleDelegate/Program.cs): 
usSing System; 


namespace WIox.ProCcsharp.Delegates 
{ 
delegate double Doubleop (ldouble XX})s; 


class Program 
{ 


static volid Maint{) 


DoubleOp[] cperations = 

{ 
MathOperations.MultiplyByTwo, 
MathOperations.Sqauare 

}i 


for {int i=0; 1 < operations.Length; 1++) 

{ 
Console -WIIteLIne ($"Using operatlions [{I1]:); 
ProcessAndDisplayNumber (operations[i], 2.0); 
PFrocesshAndDisplayNumber (operations[i], 7.94); 
ProcessAndDisplayNumber (operations[i], 1.414); 
Console.WriteLine (); 


} 
} 
static void ProcesshndDisplayNumber (Doupleop action, double value) 
{ 

double result = action (valuey}).; 


Console .WriteLine($s"Value is {value}, result of operation is {result}"),; 
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} 
} 

} 

在 这 段 代 码 中 ， 实 例 化 了 一 个 DoubleOp 委托 的 数组 ( 记 住 ， 一 旦 定义 了 委托 类 ， 基 本 上 就 可 以 实例 化 它 的 
实例 ， 就 像 处 理 一 般 的 类 那样 一 一 所 以 把 一 些 委托 的 实例 放 在 数组 中 是 可 行 的 )。 该 数组 的 每 个 元 素 都 初始 化 为 
指 回 由 MathOperations 类 实现 的 不 同 操作 。 然 后 过 历 这 个 数组 ， 把 每 个 操作 应 用 到 3 个 不 同 的 值 上 。 这 说 明了 
使 用 委托 的 一 种 方式 一 一 把 方法 组 合 到 一 个 数组 中 来 使 用 ， 这 样 就 可 以 在 循环 中 调用 不 同 的 方法 了 。 

这 段 代 码 的 关键 一 行 是 把 每 个 委托 实际 传递 给 ProcessAndDisplayNumber 方法 ， 例 如 : 

ProcessAndDisplayNumber (operations[i], 2.0); 

其 中 传递 了 委托 名 ， 但 不 带 任何 参数 。 假 定 operations[il 是 一 个 委托 ， 在 语法 上 : 

e operations[i] 表 示 “ 这 个 委托 ”。 换言之 ， 就 是 委托 表示 的 方法 。 

e operations[il(2.0) 表 示 “ 实 际 上 调用 这 个 方法 ， 参 数 放 在 圆 括号 中 ”。 

ProcessAndDisplayNumber 方法 定义 为 把 一 个 委托 作为 其 第 一 个 参数 : 

static void ProcessAndDisplayNumber (DoubleOp action, double value) 

然后 ， 在 这 个 方法 中 ， 调用 : 

double result = action (value):; 

这 实际 上 是 调用 action 委托 实例 封装 的 方法 ， 其 返回 结果 存储 在 result 中 。 运 行 这 个 示例 ， 得 到 如 下 所 示 
的 结果 : 

SimpleDelegate 

Using operations[0]: 

Value 1s 2, result of operation 15 4 

Value 1s 7.94, result of operation is 15.88 

Value is 1.414, result of operation 15 2.828 

Using operations[1]: 

Value 1is 2, result of operation 15 4 


Value 1s 7.94, result of operation is 63.0436 
Value 1is 1.414, result of operation 15 1.999396 


8.24 Action<T> 和 Func<T> 委 托 


除了 为 每 个 参数 和 返回 类 型 定义 一 个 新 委托 类 型 之 外 ， 还 可 以 使 用 Action<T> 和 Func<T> 委 托 。 泛 型 
Action<T> 委 托 表 示 引 用 一 个 void 返回 类 型 的 方法 。 这 个 委托 类 存在 不 同 的 变 体 ， 可 以 传递 至 多 16 种 不 同 的 参 
数 类 型 。 没 有 泛 型 参数 的 Action 类 可 调用 没有 参数 的 方法 。Action<in T> 调 用 带 一 个 参数 的 方法 ，Action<in Tl, 
in T2> 调 用 带 两 个 参数 的 方法 , Action<in T1, in T2. in T3, in T4, in T5, in T6, in T7.in T8> 调 用 带 8 个 参数 的 方法 。 

Func<T> 委 托 可 以 以 类 似 的 方式 使 用 。Func<T> 人 允许 调用 带 返 回 类 型 的 方法 。 与 Action<T> 类 似 ，Func<T> 
也 定义 了 不 同 的 变 体 ， 至 多 也 可 以 传递 16 个 参数 类 型 和 一 个 返回 类 型 。Func<out TResult> 委 托 类 型 可 以 调用 带 
返回 类 型 日 无 参数 的 方法 ，Func<in T, out TResult> 调 用 带 一 个 参数 的 方法 ，Func<in Tl, in T2, in T3, in T4, out 
TResult> 调 用 带 4 个 参数 的 方法 。 

8.2.3 节 中 的 示例 声明 了 一 个 委托 ， 其 参数 是 double 类 型 ， 返 回 类 型 是 double: 

delegate double Doubleop (double x); 

除了 声明 自 定义 委托 DoubleOp 之 外 ， 还 可 以 使 用 Func<in 工 out TResult> 委 托 。 可 以 声明 一 个 该 委托 类 型 
的 变量 ， 或 者 声明 该 委托 类 型 的 数组 ， 如 下 所 示 : 

Func<double, double>[] operations = 

, Mathoperations.MultiplyByTwo, 

Rathoperations .Square 

使 用 该 委托 ， 并 将 ProcessAndDisplayNumber0 方 法 作为 参数 : 


static void ProcessAndDisplayNumber (Func<double, double> action, 
double value) 
{ 


double result = action (value).: 


176 | 第 1 部 分 C# 语 言 


Console.WriteLine($"Value 15 {value}, result of operation 15 {result}"); 


} 


8.2.5 BubbleSorter 示例 


下 面 的 示例 将 说 明 委 托 的 真正 用 途 。 我 们 要 编写 一 个 类 BubbleSorter， 它 实现 一 个 静态 方法 Sort0， 这 个 方 
法 的 第 一 个 参数 是 一 个 对 象 数 组 ,把 该 数组 按照 升序 重新 排列 。 例如, 假定 传递 给 该 委托 的 是 int 数组 : {0. 5. 6. 
2, 1}， 则 返回 的 结果 应 是 {0, 1, 2, 5, 6}。 

冒 泡 排序 算法 非常 著名 ， 是 一 种 简单 的 数字 排序 方法 。 它 适合 于 一 小 组 数字 ， 因 为 对 于 大 量 的 数字 (超过 10 
个 )， 还 有 更 高 效 的 算法 。 冒 泡 排 序 算法 重复 遍历 数组 ， 比 较 每 一 对 数字 ， 按 照 需要 交换 它们 的 位 置 ， 从 而 把 最 大 
的 数字 逐步 移动 到 数组 的 末尾 。 对 于 给 int 型 数字 排序 ， 进 行 冒 泡 排 序 的 方法 如 下 所 示 : 


bool swapped = true; 
do 
{ 
SwWwappbped = false; 
for (int 1 = 0; 1 < sortArray.Length—l1; 1++) 
{ 
if (sortArray[i] > sortArray[i+1]})) // problem with this test 


int temp = sortArrayl[il]; 
sortArray[i] = sortArravy[i + 1]; 
sortArray[i + 1] = temp; 

swapped = trues 


} 
} while (swapped); 


它 非常 适合 于 int 型 , 但 我 们 希望 Sort0 方 法 能 给 任何 对 象 排序 。 换言之 , 如 果 茶 段 客 户 问 代码 包含 Currency 
结构 或 目 定义 的 其 他 类 和 结构 的 数组 , 就 需要 对 该 数组 排序 。 这 样 , 上 面 代码 中 的 if(sortArray[i] > sortArray[i+1]) 
就 有 问题 了 ， 因 为 它 需 要 比较 数组 中 的 两 个 对 象 ， 看 看 哪 一 个 更 大 。 可 以 对 int 型 进行 这 样 的 比较 ， 但 如 何 对 
没有 实现 “>” 运 算 符 的 新 类 进行 比较 ? 答案 是 能 识别 该 类 的 客户 器 代 码 必 须 在 委托 中 传递 一 个 封装 的 方法 ， 
这 个 方法 可 以 进行 比较 。 另 外 ， 不 对 temp 变量 使 用 int 类 型 ， 而 使 用 泛 型 类 型 就 可 以 实现 泛 型 方法 SortO。 

对 于 接受 类 型 T 的 泛 型 方法 Sort<T>0， 需 要 一 个 比较 方法 ， 其 两 个 参数 的 类 型 是 T，if 比较 的 返回 类 型 是 
布尔 类 型 。 这 个 方法 可 以 从 Func<T1, T2, TResult> 委 托 中 引用 ， 其 中 Tl 和 T2 的 类 型 相同 : Func<T 工 booT>。 

给 Sort<T> 方 法 指定 下 述 签名 : 

static public void Sort<T> (IList<T> sortArray, Func<T, T, bool> comparison) 

这 个 方法 的 文档 声明 ，comparison 必须 引用 一 个 方法 ， 该 方法 禹 有 两 个 参数 ， 如 果 第 一 个 参数 的 值 “ 小 于 ” 
第 二 个 参数 ， 就 返回 true。 

设置 完毕 后 ， 下 面 定 义 BubbleSorter 类 (代码 文件 BubbleSorter/BubbleSorter.cs): 

class Bubblesorter 

static public void Sort<T> (IList<T> sortArray, Func<T, T, bool> comparison) 

bool swapped = true; 


do 


{ 


swapped = false; 
for (int 1 = 0; 1 < sortArray.Count—l; 1i++) 
{ 


if (comparison(sortArray[i+1], sortArray[i])) 


T temp = sortArrayl[il]; 
sortArray[i] = sortArray[i + 1]; 
sortArray[i + 1] = temp; 
SWapped = true; 
} 
} 
} while (swapped); 
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为 了 使 用 这 个 类 ， 需 要 定义 另 一 个 类 ， 从 而 建立 要 排序 的 数组 。 在 本 例 中 ， 假 定 Mortimer Phones 移动 电话 
公司 有 一 个 员工 列表 , 要 根据 他 们 的 薪水 进行 排序 。 每 个 员工 分 别 由 类 Employee 的 一 个 实例 表示 , 如 下 所 示 ( 代 
码 文件 BubbleSorter/Employee.cs): 


class EmployYee 
{ 
Public Employee (string name, decimal salary) 
{ 
Name = name; 
Salary = salarys; 


} 


Public string Name { get; } 
public decimal Salary { get; } 


Public override string ToString{() => $"{Name}, {Salary:cC}"; 
Public static bool CompareSalary (Employee eel, Employee ee2) => 
el .Salary < e2.Salary; 
} 


注意 ， 为 了 匹配 Func<T, 工 bool> 委 托 的 签名 ， 在 这 个 类 中 必须 定义 CompareSalary， 它 的 参数 是 两 个 
Employee 引用 ， 并 返回 一 个 布尔 值 。 在 实现 比较 的 代码 中 ， 根 据 薪水 进行 比较 。 

下 面 编 写 一 些 客户 新 代码 ， 完 成 排序 (代码 文件 BubbleSorter/Program.cs): 

USing System; 


namespace Wrox.ProCcsharp.Delegates 
{ 
Class Program 
{ 
static volid Maint{) 
{ 
EmpPloyee[] employees = 
{ 
new Employee ("Bugs Bunny™”, 20000)., 
new Employee ("Elmer Fudd™", 10000)., 
new Employee ("Daffy Duck™, 25000)., 
new Employee ("Wile Coyote™"™, 1000000.38m), 
new Employeel"Foghorn Leghorn™, 23000), 
new Employee ("RoadRunner™", S50000) 
}s 


BubbleSorter.Ssort (employees, Employee.CompareSalary}; 
foreach (var employee in employees) 

{ 

Console.WriteLine (employee); 
} 
} 
} 
} 


运行 这 段 代 码 ， 正 确 显示 按照 薪水 排列 的 Employee， 如 下 所 示 ; 


Elmer Fudd, $10,000.00 
Bugs Bunny, $20,000.00 
Foghorn Leghorn, $23,000.00 
Daffy Duck, $25,000.00 
RoadRuUuNnner, $50,000.00 
Wile Coyote, $1,000,000.38 


8.2.6 多 播 委 托 


前 面 使 用 的 每 个 委托 都 只 包含 一 个 方法 调用 。 调 用 委托 的 次 数 与 调用 方法 的 次 数 相同 。 如 果 要 调用 多 个 方 
法 ， 就 需要 多 次 显 式 调 用 这 个 委托 。 但 是 ， 委 托 也 可 以 包含 多 个 方法 。 这 种 委托 称 为 多 播 委 托 。 如 果 调 用 多 播 
委托 ， 就 可 以 按 顺 序 连 续 调 用 多 个 方法 。 为 此 ， 委 托 的 签名 就 必须 返回 void; 否则 ， 就 只 能 得 到 委托 调用 的 最 
后 一 个 方法 的 结果 。 

可 以 使 用 返回 类 型 为 void 的 Action<double> 委 托 ( 代 码 文 件 MulticastDelegates/Program.cs): 


class Program 


| 
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static void Mainil) 

| 
Action<double> operations = MathOperations.MultiplyByTwo; 
operations += MathOperations.Ssquare; 


在 前 面 的 示例 中 ， 因 为 要 存储 对 两 个 方法 的 引用 ， 所 以 实例 化 了 一 个 委托 数组 。 而 这 里 只 是 在 同一 个 多 揪 
委托 中 添加 两 个 操作 。 多 播 委 托 可 以 识别 运算 符 “+” 和 “+=”。 男 外 ， 还 可 以 扩展 上 述 代 码 中 的 最 后 两 行 ， 如 
下 面 的 代码 段 所 示 : 


Action<double> operationl 
Action<double> operation2 
Action<double> operations 


MathOperations.MultiplyByTwo; 
MathOperations.Square; 
operationl + operation2; 


多 播 委 托 还 识别 运算 人 特 “-” 和 “- =”， 以 从 委托 中 删除 方法 调用 。 


注意 : 
根据 后 台 执 行 的 操作 ， 多 播 委 托 实 际 上 是 一 个 派生 自 System.MulticastDelegate 的 类 ，System.MulticastDelegate 
又 派生 自 基 类 System.Delegate。System MulticastDelegate 的 其 他 成 员 人 允许 把 多 个 方法 调用 链接 为 一 个 列表 。 


为 了 说 明 多 播 委托 的 用 法 ， 下 面 把 SimpleDelegate 示例 转换 为 一 个 新 示例 MulticastDelegate。 现 在 需要 委托 引用 
MulticastDelegates/MathOperations.cs): 


Class MathOperations 
{ 
public static void MultiplyByTwo (double value) 
{ 
double result = value * 2. 
Console.WriteLine ($"Multiplying by 2: {value} gives {result}"); 
} 


public static void Square (double value) 
| 
double result = walue * value; 
Console.WriteLine($"Squaring: {value} gives {result}"); 
} 
} 


为 了 适应 这 个 改变 ， 也 必须 重 写 ProcessAndDisplayNumber0 方 法 (代码 文件 MulticastDelegates/Program.cs): 


static void ProcessAndDisplayNumber (Action<double> action, double value) 

{ 
Console .WriteLine().; 
Console.WriteLine ($"ProcessAndDisplayNumber called with Value = {value}™); 
action (value):; 


} 
下 面 测试 多 播 委托 ， 其 代码 如 下 : 


static volid Mainl() 

{ 
Action<double> operations = MathOperations.MultiplyByTwo; 
operations += MathOperations.SsSquare; 
ProcessAndDisplayNumber (operations, 2.0); 
ProcessAndDisplayNumber (operations, 7.94);，; 
ProcessAndDisplayNumber (operations, 1.414); 
Console .WriteLine().: 


} 

现在 ， 每 次 调用 ProcessAndDisplayNumber0 方 法 时 ， 都 会 显示 一 条 消息 ， 说 明 它 已 经 被 调用 。 然后 ， 下 面 
的 语句 会 按 顺序 调用 action 委托 实例 中 的 每 个 方法 : 

action (valuey}).: 

运行 这 段 代 码 ， 得 到 如 下 所 示 的 结果 : 


ProcessAndDisplayNumber called with Value = 2 
Multiplying by 2: 2 gives 4 
Squaring: 2 gives 4 


ProcessAndDisplayNumber called with value = 7.94 
Multiplying by 2: 7.94 gives 15.88 
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Squaring: 7 了 7.94 gives 63.0436 


ProcessAndDisplayNumber called with value = 1.414 
Multiplying by 2: 1.414 gives 2.828 
Squaring: 1.414 gives 1.999396 


如 果 正 在 使 用 多 播 委托 ， 就 应 知道 对 同一 个 委托 ， 调 用 其 方法 链 的 顺序 并 未 正式 定义 。 因 此 应 避免 编写 依 


赖 于 以 特定 顺序 调用 方法 的 代码 。 


通过 一 个 委托 调用 多 个 方法 还 可 能 导致 一 个 更 严重 的 问题 。 多 播 委托 包含 一 个 逐个 调用 的 委托 集合 。 如 打通 


过 委托 调用 的 其 中 一 个 方法 抛 出 一 个 异 遂 ， 整 个 途 代 就 会 停止 。 下 面 是 MulticastIteration 示例 ， 其 中 定义 了 一 
个 简单 的 委托 Action， 它 没有 参数 并 返回 void。 这 个 委托 打算 调用 One0 和 Two0 方 法 ， 这 两 个 方法 满足 委托 
的 参数 和 返回 类 型 要 求 。 注 意 One0 方 法 抛 出 了 一 个 异常 (代码 文件 MulticastDelegateWithIteration/Program.cs): 


USIing System; 


namespace Wrox.ProCcsharp.Delegates 
{ 
Class Program 
{ 
static void OneT ) 
{ 
Console .WriteLine ("One™),; 
throw new Exception ("Error in one™).; 


} 


static volid Twot) 
{ 
Console .WriteLine ("TwoO™).; 


} 


在 Main0 方 法 中 ， 创 建 了 委托 d1， 它 引用 方法 One0; 接着 把 Two0 方 法 的 地 址 添加 到 同一 个 委托 中 。 调 


用 dl 委托 ， 就 可 以 调用 这 两 个 方法 。 在 try/catch 块 中 捕获 异 单 : 


static void Maint({) 
{ 

Action dl = Oner 

dl1 += TWOD; 

tryY 

{ 

dl (}s 
} 
catch (Exception) 


Console.WriteLine ("Exception caught™"),; 

} 
} 
委托 只 调用 了 第 一 个 方法 。 因 为 第 一 个 方法 抛 出 了 一 个 异常 ， 所 以 委托 的 迭代 会 停止 ， 不 再 调用 Two0 方 
。 没 有 指定 调用 方法 的 顺序 时 ， 结 果 会 有 所 不 同 。 
One 
Exceptlion Caught 
注意 : 
错误 和 异常 的 介绍 详 见 第 14 章 。 


在 这 种 情况 下 ， 为 了 避免 这 个 问题 ， 应 目 己 迭代 方法 列表 。Delegate 类 定义 GetInvocationList0 方 法 ， 它 返 


回 一 个 Delegate 对 象 数 组 。 现 在 可 以 使 用 这 个 委托 调用 与 委托 直接 相关 的 方法 ， 捕 获 异 前， 并 继续 下 一 次 友 代 
(代码 文件 MulticastDelegatesUsineInvocationList/Program.cs): 


static woild Maint{) 
{ 
BAction dl1 = One; 
dl += Two; 
Delegate[] delegates = dl.GetInvocationList(); 
foreach (Action d in delegates) 
{ 
try 
{ 
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d()s 
catch (Exception) 
Console .WriteLine ("Exception Caught") ; 


} 
} 


修改 了 代码 后 ， 运 行 应 用 程序 ， 会 看 到 在 捕获 了 异常 后 将 继续 友 代 下 一 个 方法 。 


Exception caught 
TWO 


8.27 匿名 方法 


到 目前 为 止 ， 要 想 使 委托 工作 ， 方 法 必须 已 经 存在 ( 即 委托 通过 其 将 调用 方法 的 相同 签名 定义 )。 但 还 有 另 
外 一 种 使 用 委托 的 方式 : 通过 匿名 方法 。 匿 名 方法 是 用 作 委 托 的 参数 的 一 段 代 码 。 

用 匿名 方法 定义 委托 的 语法 与 前 面 的 定义 并 没有 区 别 。 但 在 实例 化 委托 时 ， 就 会 出 现 区 别 。 下 面 是 一 个 非 
第 简单 的 控制 人 台 应 用 程序 ， 它 说 明了 如 何 使 用 匿名 方法 (代码 文件 AnonymousMethods/Program_.cs): 


Class Program 
{ 
static void Main{() 
| 
string mid = ", middle part,"; 
Func<string, string> anonDel = delegate (string param) 
{ 
Param 二 = mid.; 
param += "” and this was added to the string.™; 
return param; 
上 7 
Console.WriteLine (anonDel ("start of StIIDnG") ) ， 
} 
} 


Func<string, string> 委 托 接受 一 个 字符 串 参 数 ， 返 回 一 个 字符 串 。anonDel 是 这 种 委托 类 型 的 变量 。 不 是 把 
方法 名 赋予 这 个 变量 ， 而 是 使 用 一 段 简单 的 代码 : 前 面 是 关键 字 delegate， 后 面 是 一 个 字符 串 参 数 。 

可 以 看 出 ， 该 代码 块 使 用 方法 级 的 字符 串 变量 mid， 该 变量 是 在 匿名 方法 的 外 部 定义 的 ， 并 将 其 添加 到 要 
传递 的 参数 中 。 接 着 代码 返回 该 字符 串 值 。 在 调用 委托 时 ， 把 一 个 字符 串 作为 参数 传递 ， 将 返回 的 字符 串 输 出 
到 控制 人 台 上 。 

使 用 匿名 方法 的 优点 是 减少 了 要 编写 的 代码 。 不 必定 义 仅 由 委托 使 用 的 方法 。 在 为 事件 定义 委托 时 ， 这 一 
点 非 营 明显 (本 重 后 面 探讨 事件 )。 这 有 助 于 降低 代码 的 复杂 性 ， 尤 其 是 在 定义 了 好 几 个 事件 时 ， 代 码 会 显得 比 
较 简 单 。 使 用 匿名 方法 时 ， 代 码 执行 速度 并 没有 加 快 。 编 译 器 仍 定义 了 一 个 方法 ， 该 方法 只 有 一 个 目 动 指定 的 
名 称 ， 我 们 不 需要 知道 这 个 名 称 。 

在 使 用 匿名 方法 时 ， 必 须 遵循 两 条 规则 。 在 匿名 方法 中 不 能 使 用 跳 转 语句 (break、goto 或 continue) 跳 到 该 
匿名 方法 的 外 部 ， 反 之 亦 然 : 匿名 方法 外 部 的 跳 转 语句 不 能 跳 到 该 匿名 方法 的 内 部 。 

在 匿名 方法 内 部 不 能 访问 不 安全 的 代码 。 另 外 ， 也 不 能 访问 在 匿名 方法 外 部 使 用 的 ref 和 out 参数 。 但 可 以 
使 用 在 匿名 方法 外 部 定义 的 其 他 变量 。 

如 果 需 要 用 匿名 方法 多 次 编写 同一 个 功能 ， 就 不 要 使 用 匿名 方法 。 此 时 与 复制 代码 相 比 ， 编 写 一 个 命名 方 
法 比较 好 ， 因 为 该 方法 只 需要 编写 一 次 ， 以 后 可 通过 名 称 引 用 它 。 


注意 : 

匿名 方法 的 语法 在 C# 2 中 引入 。 在 新 的 程序 中 ， 并 不 需要 这 个 语法 ， 因 为 lambda 表达 式 (参见 下 一 节 ) 
提供 了 相同 的 功能 ， 还 提供 了 其 他 功能 。 但 是 ， 在 已 有 的 源 代码 中 ， 许 多 地 方 都 使 用 了 匿名 方法 ， 所 以 最 好 
了 解 它 。 

从 C#3.0 开始 ， 可 以 使 用 lambda 表达 式 。 
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8.3 lambda 表达 式 


使 用 lambda 表达 式 的 一 个 场合 是 把 lambda 表达 式 赋予 委托 类 型 : 在 线 实 现代 码 。 只 要 有 委托 参数 类 型 的 地 
方 ， 就 可 以 使 用 lambda 表达 式 。 前 面 使 用 匿名 方法 的 例子 可 以 改 为 使 用 lambda 表达 式 。 
class Program 
{ 
static void Maint) 
{ 
string mid = ", middle part, ™; 
Func<string, string> lambda = param 三 > 
{ 
param += mid; 
param += " and this was added to the string."™; 
return param; 
}; 
Console.WriteLine(lambdal("start of string"™)); 
} 
} 


lambda 运算 生 “=>” 的 左边 列 出 了 需要 的 参数 ， 而 其 右边 定义 了 赋予 lambda 变量 的 方法 的 实现 代码 。 
8.3.1 参数 


lambda 表达 式 有 几 种 定义 参数 的 方式 。 如 果 只 有 一 个 参数 ， 只 写 出 参数 名 就 足够 了 。 下 面 的 lambda 表达 式 
使 用 了 参数 s。 因 为 委托 类 型 定义 了 一 个 string 参数 ， 所 以 s 的 类 型 就 是 string。 实 现代 码 调 用 StringFormat0 方 法 
来 返回 一 个 字符 串 ， 在 调用 该 委托 时 ， 就 把 该 字符 串 最 终 写 入 控制 台 ( 代 码 文 件 LambdaExpressions/Program.cs): 


Func<string, string> oneParam = SS => $"change uppercase {5.ToUpper()}"; 
Console .WriteLine (oneParaml("test")); 


如 果 委 托 使 用 多 个 参数 , 就 把 这 些 参数 名 放 在 圆 括 号 中 。 这 里 参数 x 和 y 的 类 型 是 double, 由 Func<double. 
double, double> 委 托 定 义 : 

Func<double, double, double> twoParams = (XK, Y) => XX * Yi 

Console .WriteLine (twoParams (3, 2)1); 

为 了 方便 起 见 ， 可 以 在 圆 括 号 中 给 变量 名 添加 参数 类 型 。 如 果 编 译 器 不 能 匹配 重 载 后 的 版 本 ， 那 么 使 用 参 
数 类 型 可 以 帮助 找到 匹配 的 委托 : 


Func<double, double, double> twoParamsWithTypes = 
(double XxX, double YY) => KX * Yi 
Console .WriteLine (twoParamsWithTypes (4, 2)); 


8.3.2 ”多 行 代码 


如 果 lambda 表达 式 只 有 一 条 语句 ， 在 方法 块 内 就 不 需要 花 括号 和 retum 语句 ， 因 为 编译 器 会 添加 一 条 隐 式 的 
retum 语句 ]; 
Func<double, double> square = X 一 > XX * XX} 


添加 花 括 号 、retum 语句 和 分 号 是 完全 合法 的 ， 通 党 这 比 不 添加 这 些 符号 更 容易 阅读 : 
Func<double, double> square = X 三 > 


{ 


return 到 广 下; 


} 
但 是 ， 如 果 在 lambda 表达 式 的 实现 代码 中 需要 多 条 语句 ， 就 必须 添加 人 花 括 号 和 retum 语句 : 


Func<string, string> lambda = Param 三 > 

{ 

param += mid; 

param += " and this was added to the string.™; 
return param; 


}; 
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8.3.3” 闭 包 


通过 lambda 表达 式 可 以 访问 lambda 表达 式 块 外 部 的 变量 ， 这 称 为 闭 包 。 闭 包 是 非常 好 用 的 功能 ， 但 如 果 
使 用 不 当 ， 也 会 非常 危险 。 

在 下 面 的 示例 中 ，Func<int it 类 型 的 lambda 表达 式 需 要 一 个 int 参数， 返回 一 个 nt 值 。 该 lambda 表达 
式 的 参数 用 变量 x 定义 。 实现 代码 还 访问 了 lambda 表达 式 外 部 的 变量 someVal。 只 要 不 假设 在 调用 f 时 , lambda 
表达 式 创建 了 一 个 以 后 使 用 的 新 方法 ， 这 似乎 没有 什么 问题 。 看 看 下 面 这 个 代码 块 ， 调 用 了 的 返回 值 应 是 x 加 
5 的 结果 ， 但 实情 似乎 不 是 这 样 (代码 文件 LambdaExpressions/Program.cs): 


int someVal = 5; 
Func<int, int> f = xX => X + someval; 


假定 以 后 要 修改 变量 someVal, 于 是 调用 lambda 表达 式 时 , 会 使 用 someVal 的 新 值 。 调 用 f3) 的 结果 是 10: 


someVval = 7; 
WriteLine (f (3))- 


同样 ， 在 lambda 表达 式 中 修改 闭 包 的 值 时 ， 可 以 在 lambda 表达 式 外 部 访问 已 改动 的 值 。 

现在 我 们 也 许 会 奇怪 ， 如 何在 lambda 表达 式 的 内 部 访问 lambda 表达 式 外 部 的 变量 。 为 了 理解 这 一 点 ， 看 
看 编译 器 在 定义 lambda 表达 式 时 做 了 什么 。 对 于 lambda 表达 式 x => x + someVal， 编 译 器 会 创建 一 个 匿名 类 ， 
它 有 一 个 构造 函数 来 传递 外 部 变量 。 该 构造 函数 取决 于 从 外 部 访问 的 变量 数 。 对 于 这 个 简单 的 例子 ， 构 造 函 数 
接受 一 个 int 值 。 匿 名 类 包含 一 个 匿名 方法 ， 其 实现 代码 、 参 数 和 返回 类 型 由 lambda 表达 式 定义 : 

class AnonymousClass 


private int SomeVal: 
public AnonymousClass (int someVal) 


{ 
this.someVYal = somevVval; 
} 
public int AnonymousMethodl(int x) => XxX + someVal; 


} 


使 用 lambda 表达 式 并 调用 该 方法 ， 会 创建 匿名 类 的 一 个 实例 ， 并 传递 调用 该 方法 时 变量 的 值 。 


注意 : 
如 果 给 多 个 线程 使 用 闭 包 ,就 可 能 遇 到 并 发 冲突 。 最 好 仅 给 闭 巴 使 用 不 变 的 类 型 .这样 可 以 确保 不 改变 值 ， 
也 不 需要 同步 。 


注意 : 
lambda 表达 式 可 以 用 于 类 型 为 委托 的 任意 地 方 。 类 型 是 Expression 或 Expression<T> 时 , 也 可 以 使 用 lambda 
表达 式 ， 此 时 编译 器 会 创建 一 个 表达 式 树 。 该 功能 的 介绍 详 见 第 12 章 。 


8.4 事件 


事件 基于 委托 ， 为 委托 提供 了 一 种 发 布 /订阅 机 制 。 在 .NET 架构 内 到 处 都 能 看 到 事件 。 在 Windows 应 用 
程序 中 , Button 类 提供 了 Click 事件 。 这 类 事件 就 是 委托 。 触发 Click 事件 时 调用 的 处 理 程序 方法 需要 得 到 定义 ， 
而 其 参数 由 委托 类 型 定义 。 

在 本 节 的 示例 代码 中 ， 事 件 用 于 连接 CarDealer 类 和 Consumer 类 。CarDealer 类 提供 了 一 个 新 车 到 达 时 触 
发 的 事件 。Consumer 类 订阅 该 事件 ， 以 获得 新 车 到 达 的 通知 。 


8.4.1 事件 发 布 程序 


我 们 从 CarDealer 类 开始 介绍 ， 它 基于 事件 提供 一 个 订阅 。CarDealer 类 用 event 关键 字 定 义 了 类 型 为 
EventHandler<CarInfoEventArgs> 的 NewCarInfo 事件 。 在 NewCar0 方 法 中 ， 通 过 调用 RaiseNewCarInfo 方法 触发 
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NewCarInfo 事件 。 这 个 方法 的 实现 确认 委托 是 否 为 空 ,如 果 不 为 空 ,就 引发 事件 (代码 文件 EventSample/CarDealercs); 


UsInG System; 
namespace Wrox.Procsharp.Delegates 


{ 
public class CarIinfoEventArgs: EventArgs 


Public CarinfoEventArgs (string Car) => Car = car; 


public string Car { get; } 
} 


Public class CarDealer 
{ 
public event EventHandler<CarIinfoEventArgs> NewCarInfo; 
Public void NewCar (string car) 
{ 
Console .WriteLine ($"CarDealer, new car {car}™); 
NewCarIinfo?.Invoke (this, new CarInfopventArgs (car)); 
} 
} 
} 


EE 
前 面 例子 中 使 用 的 空 传播 运算 符 .? 是 C#6 新 增 的 运算 符 。 这 个 运算 符 的 讨论 参见 第 6 章 。 


CarDealer 类 提供 了 EventHandler<CarInfoEventArss> 类 型 的 NewCarInfo 事件 。 作 为 一 个 约定 ， 事 件 一 般 使 
用 和 带 两 个 参数 的 方法 其 中 第 一 个 参数 是 一 个 对 象 ， 包 含 事件 的 发 送 者 ， 第 二 个 参数 提供 了 事件 的 相关 信息 。 
第 二 个 参数 随 不 同 的 事件 类 型 而 改变 。.NET 1.0 为 所 有 不 同 数 据 类 型 的 事件 定义 了 几 百 个 委托 。 有 了 泛 型 委托 
EventHandler<T> 后 ， 就 不 再 需要 委托 了 。EventHandler<TEventArgs> 定 义 了 一 个 处 理 程序 ， 它 返回 void， 接 受 
两 个 参数 。 对 于 EventHandler<TEventAres>， 第 一 个 参数 必须 是 object 类 型 ， 第 二 个 参数 是 T 类 型 。 
EventHandler<TEventArgs> 还 定义 了 一 个 关于 工 的 约束 ; 它 必须 派生 目 基 类 EventArgs，CarInfoEventArgs 就 派 
生 自 基 类 EventArgs: 

public event EventHandler<CarInfoEventargds> NewCarIinfo; 

委托 EventHandler<TEventArgs> 的 定义 如 下 : 


public delegate void EventHandler<TEventArgs> (object sender, TEventArgs e) 
where TEventArgs: EventArgs 


在 一 行 上 定义 事件 是 C# 的 简化 记 法 。 编译 器 会 创建 一 个 EventHandler<CarmfoEventAres> 委 托 类 型 的 变量 ， 
并 添加 方法 ， 以 便 从 委托 中 订阅 和 取消 订阅 。 该 简化 记 法 的 较 长 形式 如 下 所 示 。 这 非常 类 似 于 自动 属性 和 完整 
属性 之 间 的 关系 。 对 于 事件 ， 使 用 add 和 remove 关键 字 添 加 和 删除 委托 的 处 理 程序 : 


private EventHandler<CarIinfoEventArgs> newCarlinfo; 


Public event EventHandler<CarIinfopventArgs> NewCarIinfo 


| 


add => newCarinfo += Valuer 
remove => newCarlInfo -= value; 
} 
注意 : 


如 果 不 仅 需要 添加 和 删除 事件 处 理 程序 ， 定 义 事件 的 长 记 法 就 很 有 用 ， 例 如， 需要 为 多 个 线程 访问 添加 同 
步 操作 。WPF 控件 使 用 长 记 法 给 事件 添加 冒 泡 和 隧道 功能 。 

CarDealer 类 通过 调用 委托 的 Invoke 方法 触发 事件 。 可 以 调用 给 事件 订阅 的 所 有 处 理 程序 。 注 意 ， 与 之 前 
的 多 播 委托 一 样 ， 方 法 的 调用 顺序 无 法 保证 。 为 了 更 多 地 控制 处 理 程序 的 调用 ， 可 以 使 用 Delegate 类 的 
GetInvocationList0 方 法 ， 访 问 委 托 列表 中 的 每 一 项 ， 并 独立 地 调用 每 个 方法 ， 如 上 所 示 。 


NewCarInfo? .Invoke (this, new CarlInfoEventArgs (car)); 
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触发 事件 是 只 包含 一 行 代 码 的 程序 。 然 而 ， 这 只 是 C# 6 的 功能 。 在 C# 6 版 本 之 前 ， 触 发 事件 会 更 复杂 。 


这 是 C# 6 之 前 实现 的 相同 功能 。 在 触发 事件 之 前 ， 需 要 检查 事件 是 否 为 空 。 因 为 在 进行 null 检查 和 触发 事件 之 
间 ， 可 以 使 用 另 一 个 线程 把 事件 设置 为 null， 所 以 使 用 一 个 局 部 变量 ， 如 下 所 示 : 


EventHandler<CarInfoEventArgs> newCcarInfo = MewCarInfto,; 


if (newCarInfo != null) 


{ 


newCarInfo (this, new CarInfoEventArgs (car)); 


} 


在 C# 6 中 ， 所 有 这 一 切 都 可 以 使 用 null 传播 运算 行 和 一 个 代码 行 取代 ， 如 前 所 示 。 
在 触发 事件 之 前 ， 需 要 检查 委托 NewCarInfo 是 否 不 为 空 。 如 果 没 有 订阅 处 理 程序 ， 委 托 就 为 空 : 


protected wirtual void RalseNewCarInfto(stIrInG car) 


{ 


NewCarIinfo?.Invoke (this, new CarIinfopventArgs (car)); 


} 


8.4.2 事件 侦 听 器 
Consumer 类 用 作 事 件 侦 听 器 。 这 个 类 订阅 了 CarDealer 类 的 事件 ， 并 定义 了 NewCarIsHere 方法 ,该 方 


法 满足 EventHandler<CarInfoEventAres> 委 托 的 要 求 ， 该 委托 的 参数 类 型 是 object 和 CarInfoEventArgs( 代 码 


文件 EventsSample/Consumer.cs): 


Public class Consumer 
{ 


private strijng name; 


public Consumer (string name) => name = name; 


public void NewCarIsHere (object sender, CarInfogEventArgs e) 


{ 


Console.WriteLine ($s"{ name}: car {fe.Car} 1s new"™); 


} 
} 


现在 需要 连接 事件 发 布 程 序 和 订阅 器 。 为 此 使 用 CarDealer 类 的 NewCarInfo 事件 ， 通 过 “+=” 创 建 一 个 订 


阅 。 消 费 者 Valtteri 订阅 了 事件 ， 接 着 消费 者 Max 也 订阅 了 事件 ， 然 后 Valtteri 通过 “一 ”取消 了 订阅 (代码 文 


件 EventsSample/Program.cs)。 


Class Program 
{ 
static void Malnl) 


{ 


var dealer = new CarDealer(); 
Var valtteri = new Consumer{(" valtteri™"™).: 
dealer.NewCarInfo 十 一 valtteri.NewCarIsHere; 


dealer.NewCar ("Williams™).; 


Var max = new Consumer ("Max™).; 
dealer.NewCarInfo 十 一 max.NewCarIsHere; 


dealer.NewCar ("Mercedes™).: 


dealer.NewCarIinfo -= valtteri.NewCcarIsHere; 


dealer.NewCar{("Ferrari™); 
} 
} 


运行 应 用 程序 , 一 辆 Williams 汽车 到 达 ，Valtteri 得 到 了 通知 。 因 为 之 后 Max 也 注册 了 该 订阅 ,所 以 Valtteri 


和 Max 都 获得 了 新 款 Mercedes 汽车 的 通知 。 接 着 Valtteri 取消 了 订阅 ， 所 以 只 有 Max 获得 了 Ferrari 汽车 的 


通知 : 


CarDealer, new car Williams 
Valtteri: car Williams is new 
CarDealer, new car Mercedes 
Valtteri: car Mercedes is new 
Max: car Mercedes 15 new 
CarDealer, new Car Ferrari 
Max: Car Ferrarli 工 S new 
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8.5 ”小 结 


本 章 介 绍 了 委托 、lambda 表达 式 和 事件 的 基础 知识 ， 解 释 了 如 何 声明 委托 ， 如 何 给 委托 列表 添加 方法 ， 如 
何 实现 通过 委托 和 lambda 表达 式 调用 的 方法 , 并 讨论 了 声明 事件 处 理 程序 来 啊 应 事件 的 过 程 ， 以 及 如 何 创建 自 
定义 事件 ， 使 用 引发 事件 的 模式 。 

在 设计 大 型 应 用 程序 时 ， 使 用 委托 和 事件 可 以 减少 依赖 性 和 各 层 的 耦合 ， 并 能 开发 出 具有 更 高 重用 性 的 
组 件 。 

lambda 表达 式 是 基于 委托 的 C# 语 言 特 性 ， 通 过 它们 可 以 减少 需要 编写 的 代码 量 。lambda 表达 式 不 仅仅 用 
于 委托 ， 也 用 于 LINQ( 详 见 第 12 章 )。 

第 9 章 介绍 字符 串 和 正则 表达 式 的 使 用 。 


3 
字符 串 和 正则 表达 式 


本 章 要 点 

。 创建 字符 串 
格式 化 表达 式 

使 用 正则 表达 式 

使 用 Span<T> 和 字符 串 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 Www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 StringsAndRegularExpressions 

目录 的 https://github.comyProfessionalCShamp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

® StrneSsample 

® StrngFormats 

® ReeularExpressionPlayeround 

® SpanWithStrings 

从 本 书 一 开始 , 我 们 就 在 使 用 字符 串 , 因为 每 个 程序 都 需要 字符 串 。 但 读者 可 能 没有 意识 到 , 在 C# 中 string 

关键 字 的 映射 实际 上 指向 NET 基 类 System.String。System.String 是 一 个 功能 非常 强大 且 用 途 广 泛 的 基 类 ， 但 它 
不 是 .NET 库 中 唯一 与 字符 串 相关 的 类 。 本 章 首先 复习 一 下 System.String 的 特性 ， 再 介绍 如 何 使 用 其 他 的 .NET 
库 类 来 处 理 字 付 串 ， 特 别 是 System_.Text 和 System.TextResgularExpressions 名 称 空 间 中 的 类 。 本 章 主要 介绍 下 述 
内 容 : 

e 构建 字符 串 一 一 如 果 多 次 修改 一 个 字符 串 , 例 如， 创建 一 个 长 字符 串 ， 然 后 显示 该 字符 串 或 将 其 传递 给 
其 他 方法 或 应 用 程序 ，String 类 就 会 变 得 效率 低下 。 对 于 这 种 情况 ， 应 使 用 另 一 个 类 
System.Text.StringBuilder， 因 为 它 是 专门 为 这 种 情况 设计 的 。 

e 格式 化 表达 式 一 一 这 些 格式 化 表达 式 将 用 于 后 面 几 章 中 的 Console.WiriteLine0 方 法 。 格 式 化 表达 式 使 用 
两 个 有 用 的 接口 下 ormatProvider 和 下 ormattable 来 处 理 。 在 自己 的 类 上 实现 这 两 个 接口 ， 实 际 上 就 可 以 
定义 自己 的 格式 化 序列 ， 这 样 ，Console.WriteLine0 和 类 似 的 类 就 可 以 按 指 定 的 方式 显示 类 的 值 。 

e 正则 表达 式 一 一 NET 还 提供 了 一 些 非常 复杂 的 类 来 识别 字符 串 ， 或 从 长 字符 串 中 提取 满足 某 些 复杂 条 
件 的 子 字 符 串 。 例 如 ， 找 出 字符 串 中 所 有 重复 出 现 的 某 个 字符 或 一 组 字符 ， 或 者 找 出 以 s 开头 且 至 少 包 
舍 一 个 na 的 所 有 单词 ,又 或 者 找 出 遵循 雇员 ID 或 社会 安全 号 码 结构 的 字符 串 。 虽然 可 以 使 用 String 类 ， 
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编写 方法 来 完成 这 类 处 理 ， 但 这 类 方法 编写 起 来 比较 烦琐 。 而 使 用 System.TextRegularExpressions 名 称 
空间 中 的 类 就 比较 简单 ，System.Text RegularExpressions 专门 用 于 完成 这 类 处 理 。 

e Span 一 一 NET Core 提供 了 泛 型 Span 结构 ， 它 允许 快速 访问 内 存 。Span<T> 人 允许 访问 字符 串 的 切片 ， 而 
不 需要 复制 字符 串 。 


9.1 System.String 类 


在 介绍 其 他 字符 串 类 之 前 ， 先 快速 复习 一 下 String 类 中 一 些 可 用 的 方法 。 

System Sting 类 专门 用 于 存储 字符 串 ， 人 允许 对 字符 串 进行 许多 操作 。 此 外 ， 由 于 这 种 数据 类 型 非常 重要 ，C# 
提供 了 它 自己 的 关键 字 和 相关 的 语法 ， 以 便 使 用 这 个 类 来 轻松 地 处 理 字符 串 。 

使 用 运算 符 重 载 可 以 连接 字符 串 : 


string messagel = "Hello™"; // returns "Hello" 
messagel += ", There"; // returns "Hello, There" 
string message2 = messagel + "i"; // returns "Hello, There!™" 


C# 还 允许 使 用 类 似 于 索引 器 的 语法 来 提取 指定 的 字符 : 


string message = "Hello"; 
char char4 = message[4]; 


这 个 类 可 以 完成 许多 第 见 的 任务 ， 如 昔 换 字符 、 删 除 空白 和 把 字母 变 成 大 写 形式 等 。 可 用 的 方法 如 表 9-1 
所 示 。 


// returns 'o'. Note the string is zero-indexed 


表 9-1 

方 法 作 用 
Compare 比较 字符 串 的 内 容 ， 考 虑 区 域 值 背景 (区 域 设置 )， 判 断 茶 些 字符 是 否 相等 
CompareOrdinal 与 Compare 一 样 ， 但 不 考虑 区 域 值 背景 
Concat 把 多 个 字符 串 实 例 合 并 为 一 个 实例 
CopyTo 把 从 选 定 下 标 开始 的 特定 数量 字符 复制 到 数组 的 一 个 全 新 实例 中 
Format 格式 化 包含 名 种 值 的 字符 串 和 如 何 格 式 化 每 个 值 的 说 明 得 
IndexOf 定位 字符 串 中 第 一 次 出 现 某 个 给 定子 字符 串 或 字符 的 位 置 
IndexOfAny 定位 字符 串 中 第 一 次 出 现 茶 个 字符 或 一 组 字符 的 位 置 
Insert 把 一 个 字符 串 实例 插入 到 另 一 个 字符 串 实例 的 指定 索引 处 
Join 合并 字符 串 数组 ， 创 建 一 个 新 字符 串 
LastIndexOf 与 IndexOf 一 样 ， 但 定位 最 后 一 次 出 现 的 位 置 
LastIndexOfAny 与 IndexOfAny 一 样 ， 但 定位 最 后 一 次 出 现 的 位 置 
PadLeft 在 字符 串 的 左 侧 ， 通 过 添加 指定 的 重复 字符 填充 字符 串 
PadRight 在 字符 串 的 右 侧 ， 通 过 添加 指定 的 重复 字符 填充 字符 串 
Replace 用 另 一 个 字符 或 子 字符 串 葵 换 字符 串 中 给 定 的 字符 或 子 字 符 串 
Split 在 出 现 给 定 字 得 的 地 方 ， 把 字符 串 拆 分 为 一 个 子 字符 串 数组 
Substring 在 字符 串 中 检索 给 定位 置 的 子 字符 串 
ToLower 把 字符 串 转换 为 小 写 形式 
ToUpper 把 字符 串 转 换 为 大 写 形 式 
Trim 删除 首尾 的 空白 
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注意 : 
表 9-1 并 不 完整 ， 但 可 以 让 你 明白 字符 事 所 提供 的 功能 . 


9.1.1 构建 字符 串 


如 上 所 述 ，String 类 是 一 个 功能 非常 强大 的 类 ， 它 实现 许多 很 有 用 的 方法 。 但 是 ，String 类 存在 一 个 问题 ; 
重复 修改 给 定 的 字符 串 ， 效 率 会 很 低 ， 它 实际 上 是 一 个 不 可 变 的 数据 类 型 ， 这 意味 着 一 旦 对 字符 串 对 象 进行 了 
初始 化 ， 该 字符 串 对 和 象 就 不 能 改变 了 。 表 面 上 修改 字符 串 内 容 的 方法 和 运算 和 付 实 际 上 是 创建 一 个 新 字符 串 ， 根 
据 需 要 , 可 以 把 旧 字 符 串 的 内 容 复 制 到 新 字符 串 中 。 例如, 考虑 下 面 的 代码 (代码 文件 StringSample/Program .cs): 


string greetingText = "Hello from all the People at Wrox Press. ™; 
greetingText += "We do hope You enjoy this book as much as we enjoyed writing it."; 


在 执行 这 段 代码 时 ,首先 创建 一 个 System.String 类 型 的 对 象 , 并 把 它 初 始 化 为 文本 “Hello from all the people 
at Wrox Press. ”， 注 意 句 号 后 面 有 一 个 空格 。 此 时 .NET 运行 库 会 为 该 字符 串 分 配 足 够 的 内 存 来 保存 这 个 文本 (41 
个 字符 )， 再 设置 变量 greetingText 来 表示 这 个 字符 串 实 例 。 

从 语法 上 看 ， 下 一 行 代码 是 把 更 多 的 文本 添加 到 字符 串 中 。 实 际 上 并 非 如 此 ， 在 此 是 创建 一 个 新 字符 串 实 
例 ， 给 它 分 配 足够 的 内 存 ， 以 存储 合并 的 文本 ( 共 104 个 字符 )。 把 最 初 的 文本 “Hello from all the people at Wrox 
Press. ”复制 到 这 个 新 字符 串 中 ， 再 加 上 额外 的 文本 “We do hope youenjoy this book as much as we enjoyed writing 
让 ”。 然 后 更 新 存储 在 变量 greetingText 中 的 地 址 ， 使 变量 正确 地 指 同 新 的 字符 串 对 象 。 现 在 没有 引用 旧 的 字符 串 
对 象 一 一 不 再 有 变量 引用 它 ， 下 一 次 垃圾 收集 器 清理 应 用 程序 中 所 有 未 使 用 的 对 象 时 ， 就 会 删除 它 。 

这 段 代 人 码 本 和 里 还 不 错 ， 但 假定 要 对 这 个 字符 串 编码 ， 将 其 中 的 每 个 字符 的 ASCII 值 加 1， 形 成 非常 简单 的 
加 密 模 式 。 这 就 会 把 该 字符 串 变 成 “Ifmmp gspn bmm uif hvst bu Xspy Qsftt. Xf ep ipqfzpv fokpz uijt cppl bt nvdi bt 
xf fokpzfe xsjujoh ju”。 完 成 这 个 任务 有 好 几 种 方式 ， 但 最 简单 、 最 高 效 的 一 种 (假定 只 使 用 String 类 ) 是 使 用 
String.Replace0 方 法 ， 该 方法 把 字符 串 中 指定 的 子 字符 串 用 另 一 个 子 字符 串 代 蔡 。 使 用 Replace0， 对 文本 进行 编 
码 的 代码 如 下 所 示 : 


string greetijngText = "Hello from all the People at Wrox Press. ™; 
greetingText += "We do hope You enjoy this book as much as we ™ + 
"enjoved writing it."™s 
Console.WriteLine ($"Not encoded:\n {greetingText}"); 
for(int 1 = "zz"'; 1i>= "a'; 工 一 一 ) 

char oldl1 = (char}i1; 

char newl = (char) (1+1):; 

greetingText = greetingText.Replace (oldl1l, newl); 


for{lint i = ‘gs'; i>="A'; 工 一 一 ) 
char oldl = (char}i: 
char newl = (char}) (1+1); 


greetingText = greetingText.Replace (oldl, newl); 


Console.WriteLine ($s$"Encoded:\n {greetingText}"),; 


注意 : 
为 了 简单 起 见 ， 这 段 代 码 没有 把 乙 换 成 A， 也 没有 把 z 换 成 a。 这 些 字符 分 别 编码 为 [和 {。 


在 本 示例 中 ，Replace0 方 法 以 一 种 智能 的 方式 工作 ， 在 茶 种 程度 上 ， 它 并 没有 创建 一 个 新 字符 串 ， 除 非 其 
实际 上 要 对 旧 字 符 串 进行 某 些 改变 。 原 来 的 字符 串 包 含 23 个 不 同 的 小 写字 母 和 3 个 不 同 的 大 写字 母 。 所 以 
Replace0 分 配 一 个 新 字符 串 ， 共 计 分 配 26 次 ， 每 个 新 字符 串 都 包含 103 个 字符 。 因 此 加 密 过 程 需要 在 堆 上 有 一 
个 总 共 能 存储 2678 个 字符 的 字符 串 对 象 ， 该 对 象 最终 将 等 竺 被 垃圾 收集 ! 显然 ， 如 果 使 用 字符 串 频繁 进行 文字 
处 理 ， 应 用 程序 就 会 遇 到 严重 的 性 能 问题 。 

为 了 解决 这 类 问题 ，Microsoft 提供 了 System.Text.StrineBuilder 类 ，StringBuilder 类 不 像 String 类 那样 能 够 
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文 持 非常 多 的 方法 。 在 StringBuilder 类 上 可 以 进行 的 处 理 仅 限 于 苦 换 和 退 加 或 删除 字符 串 中 的 文本 。 但 是 ， 它 
的 工作 方式 非常 高 效 。 

在 使 用 String 类 构造 一 个 字符 串 时 ， 要 给 它 分 配 足够 的 内 存 来 保存 字符 串 。 然 而 ，StringBuilder 类 通常 分 
配 的 内 存 会 比 它 需 要 的 更 多 。 开 发 人 员 可 以 选择 指定 StringBuilder 要 分 配 多 少 内 存 ， 但 如 果 没 有 指定 ， 在 默认 
情况 下 就 根据 初始 化 StringBuilder 实例 时 的 字符 串 长 度 来 确定 所 用 内 存 的 大 小 。StringBuilder 类 有 两 个 主要 的 


属性 : 
e Length 一 一 指定 包含 字符 串 的 实际 长 度 。 
e Capacity 一 一 指定 字符 串 在 分 配 的 内 存 中 的 最 大 长 度 。 


对 字符 串 的 修改 就 在 赋予 StringBuilder 实例 的 内 存 块 中 进行 ， 这 就 大 大 提高 了 追加 子 字符 串 和 蔡 换 单个 字 
符 的 效率 。 删 除 或 插入 子 字 符 串 仍然 效率 低下 ， 因 为 这 需要 移动 随后 的 字符 串 部 分 。 只 有 执行 扩展 字符 串 容 量 
的 操作 时 ， 才 需要 给 字符 串 分 配 新 内 存 ， 这 样 才能 移动 包含 的 整个 字符 串 。 在 添加 额外 的 容量 时 ， 从 经 验 来 看 ， 
如 果 StringBuilder 类 检测 到 容量 超出 ， 且 没有 设置 新 值 ， 就 会 使 自己 的 容量 翻 倍 。 

例如 ， 如 果 使 用 StringBuilder 对 象 构造 最 初 的 欢迎 字符 串 ， 就 可 以 编写 下 面 的 代码 : 

0 from all the People at Wrox Press. ", 150); 


greetingBuilder.Append("We do hope You enjoy this book as much ™ 十 
"as We enjoyYed writing it"); 


注意 : 
为 了 使 用 StringBuilder 类 ， 需 要 在 代码 中 引用 System.Text 类 。 


在 这 段 代码 中 ， 为 StringBuilder 类 设置 的 初始 容量 是 130。 最 好 把 容量 设置 为 字符 串 可 能 的 最 大 长 度 ， 确 
保 StringBuilder 类 不 需要 重新 分 配 内 存 ， 因 为 其 容量 足够 用 了 。 该 容量 默认 设置 为 16。 理 论 上 ， 可 以 设置 尽 可 
能 大 的 数字 ， 足 够 给 该 容量 传送 一 个 int 值 ， 但 如 果实 际 上 给 字符 串 分 配 20 亿 个 字符 的 空间 (这 是 StringBuilder 
实例 理论 上 允许 拥有 的 最 大 空间 )， 系 统 就 可 能 会 没有 足够 的 内 存 。 

然后 ， 在 调用 AppendFormat0 方 法 时 ， 其 他 文本 就 放 在 空 的 空间 中 ， 不 需要 分 配 更 多 的 内 存 。 但 是 ， 多 次 
葵 换 文本 才能 获得 使 用 StringBuilder 类 所 带 来 的 高 效 性 能 。 例 如 ， 如 果 要 以 前 面 的 方式 加 密 文 本 ， 就 可 以 执行 
整个 加 密 过 程 ， 不 需要 分 配 更 多 的 内 存 : 

var greetingBulillder = 

new StringBuilder ("Hello from all the people at Wrox Press. ", 150); 
greetingBuilder.AppendFormat ("We do hope You enjoy this book as much " + 


"as We enjoved writing it"); 
Console .WriteLine ("Not Encoded:\n™." + greetijngBuilder); 


For (lint 1 = "Tay 13=—"H"? 1—) 
{ 
char Gldl = (char)})i; 
char newl = (char) (i+1):- 
greetijngBulilder = greetingBuillder.Replace(oldl, newl); 
} 
for(int i = "zz'; 1i>—"A'; i——) 
char oldl = (tchar)i; 
char newl = tchar) (1+1}:-: 


greetingBuilder = greetingBuilder.Replace (oldl1l, newl); 
Console .WriteLine ($"Encoded:\n {greetingBulillder}").; 
这 段 代码 使 用 了 StringBuilderReplace0 方 法 , 它 的 功能 与 Sting Replace0 一 样 , 但 不 需要 在 过 程 中 复制 字符 
串 。 在 上 述 代码 中 ， 为 存储 字符 串 而 分 配 的 总 存储 单元 是 用 于 StringBuilder 实例 的 150 个 字符 ， 以 及 在 最 后 一 
条 Console WriteLine0 语 句 中 执行 字符 串 操 作 期 间 分 配 的 内 存 。 
一 般 而 言 ， 使 用 StingBuilder 类 执行 字符 串 的 任何 操作 ， 而 使 用 Sting 类 存储 字符 串 或 显示 最 终结 果 。 
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9.1.2 StringBuilder 成 员 


前 面 介绍 了 StringBuilder 类 的 一 个 构造 函数 ,， 它 的 参数 是 一 个 初始 字符 串 及 该 字符 串 的 容量 。StringBuilder 
类 还 有 几 个 其 他 的 构造 函数 。 例 如 ， 可 以 只 提供 一 个 字符 串 : 

var sb = new StringBuilder ("Hello"); 

或 者 用 给 定 的 容量 创建 一 个 空 的 StringBuilder 类 : 

var sb = new StringBuilder (20); 

除了 前 面 介 绍 的 Length 和 Capacity 属性 外 , 还 有 一 个 只 读 属 性 MaxCapacity, 它 表示 对 给 定 的 StringBuilder 
实例 的 容量 限制 。 在 默认 情况 下 ， 这 由 intMaxValue 给 定 (大 约 20 亿 ， 如 前 所 述 )。 但 在 构造 StringBuilder 对 象 
时 ， 也 可 以 把 这 个 值 设 置 为 较 低 的 值 : 

// This will set the initial capacity to 100, but the max will be 500. 

//: Hence，this StringBuilder can never grow to more than 500 characters, 


:i/: otherwise it will raise an exception if You try to do that. 
Var sb = new StringBuilder(100, 500); 


还 可 以 随时 显 式 地 设置 容量 ， 但 如 果 把 这 个 值 设置 为 小 于 字符 串 的 当前 长 度 ， 或 者 是 超出 了 最 大 容量 的 茶 
个 值 ， 就 会 抛 出 一 个 异 第 : 


Var sb = new StringBuilder ("Hello"™); 
sb.capacity = 100; 


StringBuilder 类 主要 的 方法 如 表 9-2 所 示 。 


表 9-2 
方 ”法 说 了 明 
Append0 给 当前 字符 串 追 加 一 个 字符 串 
AppendFormatO 追加 特定 格式 的 字符 串 
Insert0 在 当前 字符 串 中 插入 一 个 子 字符 串 
Removel() 从 当前 字符 串 中 删除 字符 
Replace() 在 当前 字符 串 中 ， 用 某 个 字符 全 部 替换 另 一 个 字符 ， 或 者 用 当前 字符 串 中 的 一 个 子 字 符 串 全 部 替 
换 另 一 个 字符 串 

ToSstring0) 返回 当前 强制 转换 为 System.String 对 象 的 字符 串 (在 System.Object 中 重 写 ) 

其 中 一 些 方法 还 有 几 种 重 载 版 本 。 

注意 : 


AppendFormat0 方 法 实际 上 会 在 最 终 调 用 Console.WriteLine0 方 法 时 被 调用 , 它 负 责 确定 所 有 像 {0:D1 的 格式 
化 表达 式 应 使 用 什么 表达 式 替 代 。 下 一 节 讨论 这 个 问题 。 

不 能 把 StringBuilder 强制 转换 为 Sting( 隐 式 转换 和 显 式 转换 都 不 行 )。 如 果 要 把 StringBuilder 的 内 容 输出 为 
String， 唯 一 的 方式 就 是 使 用 ToString0 方 法 。 

前 面 介绍 了 StringBuilder 类 ， 说 明了 使 用 它 提高 性 能 的 一 些 方式 。 但 要 注意 ， 这 个 类 并 不 总 能 提高 性 能 。 
StringBuilder 类 基本 上 应 在 处 理 多 个 字符 串 时 使 用 。 但 如 果 只 是 连接 两 个 字符 串 ， 使 用 System.String 类 会 较 好 。 


9.2 字符 串 格式 


之 前 的 章节 介绍 了 用 $ 前 缀 给 字符 串 传递 变量 。 本 章 讨论 这 个 C# 功 能 背后 的 理论 ， 并 训 括 格式 化 字符 串 提 
供 的 所 有 其 他 功能 。 
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9.2.1 字符 串 插 值 


C# 6 引入 了 给 字符 串 使 用 $ 前 缀 的 字符 串 插值 。 下 面 的 示例 使 用 $ 前 缀 创建 了 字符 串 s2， 这 个 前 级 允许 在 花 
括号 中 包含 占 位 符 来 引用 代码 的 结果 。{ sl } 是 字符 串 中 的 一 个 占 位 符 ， 编 译 器 将 变量 sl 的 值 放 在 字符 串 s2 中 
(代码 文件 StringFormats/Program.cs): 


string si = "World"; 
string s2 = S$"Hello, {sl}"; 


在 现实 中 ， 这 只 是 语法 糖 。 对 于 带 $ 前 缀 的 字符 串 ， 编 译 器 创建 String.Format 方法 的 调用 。 所 以 前 面 的 代 
码 段 解读 为 ; 


string sl = "World"™s; 
string s2 = String.Format ("Hello, {0}", sl1); 


String.Format 方法 的 第 一 个 参数 接受 一 个 格式 字符 串 ， 其 中 的 占 位 符 从 0 开始 编号 ， 其 后 是 帮 入 字符 串 空 
日 处 的 参数 。 

新 的 字符 串 格 式 要 方便 得 多 ， 不 需要 编写 那么 多 代码 。 

不 仅 可 以 使 用 变量 来 填写 字符 串 的 空白 处 ， 还 可 以 使 用 返回 一 个 值 的 任何 方法 : 

string s2 = S$"Hello, {5s1.ToUpper ()}"; 

这 段 代 码 可 解读 为 如 下 类 似 的 语句 : 

string s2 = string.Format ("Hello, {0}", s1.ToUpper ()); 

字符 串 还 可 以 有 多 个 空白 处 ， 如 下 所 示 的 代码 : 


Int = 3, Y= 4; 
string s3 = S$"The result of {x} + {y} is {x + y}"™; 


解读 为 : 


string 5s3 = String.Format ("The result of {0} and {1} is {2}", xX, Y, X+ y); 


1. Formattablestring 


把 字符 串 赋 予 FormattableStrng， 就 很 容易 得 到 翻译 过 来 的 插值 字符 串 。 插 值 字符 串 可 以 直接 分 配 ， 因 为 
FormattableString 比 正 第 的 字符 串 更 适合 匹配 。 这 个 类 型 定义 了 Format 属性 (返回 得 到 的 格式 字符 串 )、 
AreumentCount 属性 和 方法 GetAreument( 返 回 值 ): 

int XxX = 3, Y= 4; 

FormattableString s = $"The result of {x} + {1Y} is {XxX + vy}"s 

Console .WriteLine(s$"format: {sas.Format}"). 


for (int 1 = 0; 1 < sg.ArgumentCount; I++) 
{ 


Console.WriteLine (S$"argument {i}: {s.GetArgument (i)}"); 
} 
运行 此 代码 段 ， 输 出 结果 如 下 : 
format: The result of {0} + {1} 1is {2} 
argument 0: 3 


argument 1: 4 
argument 之 了 


注意 : 

类 FormattableString 在 System 名 称 空间 中 定义 ， 但 是 需要 NET 4.6。 如 果 想 在 .NET 旧版 本 中 使 用 
FormattableString， 可 以 自己 创建 这 种 类 型 ， 或 使 用 NuGet 包 StringInterpolationBridge。 

2. 给 字符 串 持 值 使 用 其 他 区 域 值 

插值 字符 串 默 认 使 用 当前 的 区 域 值 ， 这 很 容易 改变 。 辅 助 方法 mvariant 把 插值 字符 串 改 为 使 用 不 变 的 区 域 


值 ， 而 不 是 当前 的 区 域 值 。 因 为 插值 字符 串 可 以 分 配给 FormattableString 类 型 ， 所 以 它们 可 以 传递 给 这 个 方法 。 
FormattableString 定义 了 人 允许 传递 正 ormatProvider 的 ToString 方法 。 接 口 下 ormatProvider 由 CultureInfo 类 实现 。 
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把 CultureInfo.InvariantCulture 传递 给 正 ormatProvider 参数 ， 就 可 把 字符 串 改 为 使 用 不 变 的 区 域 值 : 


private string InVarlLant (Formattablestring s) => 
Ss.ToString (CultureInfo.InvariantCulture).; 


注意 : 
第 27 章 讨论 了 格式 字符 串 的 语言 专 有 问题 ， 以 及 区 域 值 和 不 变 的 区 域 值 。 


在 下 面 的 代码 段 中 ，Invariant 方法 用 来 把 一 个 字符 串 传 递 给 第 二 个 WriteLine 方法 。WriteLine 的 第 一 个 调 
用 使 用 当前 的 区 域 值 ， 而 第 二 个 调用 使 用 不 变 的 区 域 值 : 
Var day = new DateTime (2025, 2, 14); 


Console.WriteLine ($"{day:qd}"); 
Console .WriteLine (Invariant ($"{day:d}")); 


如 果 有 英语 区 域 值 设 置 ， 结 果 就 如 下 所 示 。 如 果 系 统 配 置 了 男 一 个 区 域 值 ， 第 一 个 结果 就 是 不 同 的 。 在 任 
何 情况 下 ， 都 会 看 到 不 变 区 域 值 的 差异 : 


2/14/2025 
02/14/2015 


使 用 不 变 的 区 域 值 ， 不 需要 目 己 实现 方法 ， 而 可 以 直接 使 用 FormattableString 类 的 静态 方法 Invariant: 


Console -WIILeLIne(Eormattab1lLeStriIngd-Invarlant(S"faay:Ql")) 7; 
3. 转 义 花 插 号 
如 果 希 望 在 插值 字符 串 中 包括 花 插 号 ， 可 以 使 用 两 个 花 括 号 转 义 它们 : 


string s = "Hello™s 
Console.WriteLine ($"{{s}} displays the Value of s: {5s}"); 


WiriteLine 方法 被 解读 为 如 下 实现 代码 : 

Console.WriteLine (String.Format ("{s} displays the Value of s: {0}", 5s)); 

输出 如 下 : 

{Ss} displays the Value of s : Hello 

还 可 以 转 义 花 括号 ， 从 格式 字符 串 中 建立 一 个 新 的 格式 字符 串 。 下 面 看 看 这 个 代码 段 : 
string formatstring = $"{s}, {{0}}"; 

string s2 = "World"™; 

WIriteLine (formatstring, s2); 

有 了 字符 串 变 量 formatString， 编 译 器 会 把 占 位 符 0 插入 变量 s， 调 用 String.Format: 
string formatstring = String.Format ("{0}, {{0}}", 5S) 7 

这 会 生成 格式 字符 串 ， 其 中 变量 s 蔡 换 为 值 Hello， 删 除 第 二 个 格式 最 外 层 的 花 括 号 : 
string formatstring = "Hello, {0}"™; 

在 WriteLine 方法 的 最 后 一 行 ， 使 用 变量 s2 的 值 把 World 字符 串 插 值 到 新 的 占 位 符 0 中 : 


WriteLine ("Hello, World"™).; 


9.2.2 日 期 时 间 和 数字 的 格式 


除了 给 占 位 符 使 用 字符 串 格式 之 外 ， 还 可 以 根据 数据 类 型 使 用 特定 的 格式 。 下 面 先 从 日 期 开始 。 在 占 位 符 


中 ， 格 式 字 符 串 跟 在 表达 式 的 后 面 ， 用 冒号 隔 开 。 下 面 所 示 的 例子 是 用 于 DateTime 类 型 的 D 和 d 格式: 


Var day = new DateTime (2025, 2, 14); 
WriteLine($"{day:D}"); 
WriteLine($"{day:d}"),; 


结果 显示 ， 用 大 写字 母 D 表示 长 日 期 格式 字符 串 ， 用 小 写字 母 d 表示 短 日 期 字符 串 : 


Friday, February 14, 2025 
2/14/2025 
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根据 所 使 用 的 大 写 或 小 写字 符 串 , DateTime 类 型 会 得 到 不 同 的 结果 。 根据 系统 的 语言 设置 , 输出 可 能 不 同 。 
日 期 和 时 间 是 特定 于 语言 的 。 

DateTime 类 型 支持 很 多 不 同 的 标准 格式 字符 串 ， 显 示 日 期 和 时 间 的 所 有 表示 : 例如 , t 表 示 短 时 间 格 式 ,T 
表示 长 时 间 格式 ,g 和 G 显示 日 期 和 时 间 。 这 里 不 讨论 所 有 其 他 选项 ,在 MSDN 文档 的 DateTime 类 型 的 ToString 
方法 中 ， 可 以 找到 相关 介绍 。 


注意 : 

应 该 提 到 的 一 个 问题 是 , 为 DateTime 构建 自 定义 的 格式 字符 串 。 自 定义 的 日 期 和 时 间 格 式 字 符 串 可 以 结合 
格式 说 明 符 ， 例 如 dd-MMM-yyyy: 

Console -WriteLine (S$S"{day:dd-MMM—yyyy}"); 

结 采 如 下 : 

14—Feb—2025 

这 个 自 定义 格式 字符 囊 利 用 dd 把 日 期 显示 为 两 个 数字 (如 果 某 个 日 期 在 10 日 之 前 ， 这 就 很 重要 ， 从 这 里 可 
以 看 到 d 和 dd 之 间 的 区 别 ).MMM( 月 份 的 缩写 名 称 , 注意 它 是 大 写 , 而 mm 表示 分 钟 ) 和 表示 四 位 数 年 份 的 yyyy。 
同样 ， 在 MSDN 文档 中 可 以 找到 用 于 自 定义 日 斯 和 时 间 格 式 字 符 囊 的 所 有 其 他 格式 说 明 符 。 


数字 的 格式 字符 串 不 区 分 大 小 写 。 下 面 看 看 n、e、 X 和 cc 标准 数字 格式 字符 串 : 


int 1 = 477 了: 
Console .WriteLine(s"{i:n} {1i:e} {i:x} {1i:c}"™).- 


n 格式 字符 串 定义 了 一 个 数字 格式 ， 用 组 分 隔 符 显示 整数 和 小 数 。e 表示 使 用 指数 表示 法 ，x 表示 转换 为 十 
六 进 制 ，c 显示 货币 : 

2,477.00 2.477000e+003 9ad $2,477.00 

对 于 数字 的 表示 ， 还 可 以 使 用 定制 的 格式 字符 串 。# 格 式 说 明 答 是 一 个 数字 占 位 符 ， 如 果 数 字 可 用 ,就 显示 
数字 ， 如 果 数 字 不 可 用 ， 就 不 显示 数字 。0 格式 说 明 符 是 一 个 零 占 位 符 ， 显 示 相 应 的 数字 ， 如 果 数 字 不 存在 ， 
就 显示 零 。 

double d = 3.1415; 

Console .WriteLine (S$"{d:#t## .t###}"); 

Console .WriteLine ($"{d:000.000}"); 

在 示例 代码 中 ， 对 于 double 值 ， 第 一 个 结果 把 有 逗 号 后 的 值 舍 入 为 三 位 小 数 ， 第 二 个 结果 是 显示 逗号 前 的 三 
个 数字 : 


.142 
003.142 


MSDN 文档 给 百分比 、 往 返 和 定点 显示 提供 了 所 有 的 标准 数字 格式 字符 串 ， 以 及 提供 目 定义 格式 字符 串 ， 
用 于 使 指数 、 小 数 点 、 组 分 隔 符 等 显示 不 同 的 外 观 。 


9.2.3 自 定 义 字 符 串 格式 


格式 字符 串 不 限于 内 置 类 型 ， 可 以 为 和 目 己 的 类 型 创建 自 定 义 格 式 字 符 串 。 为 此 ， 只 需要 实现 接口 
IFormattabje。 

首先 是 一 个 简单 的 Person 类 ， 它 包含 FirstName 和 LastName 属性 (代码 文件 StringFormats/Person.cs): 

Public class Person 

| Public string FirstName { get; set; } 


Public string LastName { get; set; } 
} 


为 了 获得 这 个 类 的 简单 字符 串 表 示 ， 重 写 基 类 的 ToString 方法 。 这 个 方法 返回 由 FirstName 和 LastName 
组 成 的 字符 串 : 


public override string ToString() => FirstName + " " + LastName; 
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除了 简单 的 字符 串 表 示 之 外 ，Person 类 也 应 该 支持 格式 字符 串 FE， 返 回 名 工 和 姓 A， 后 者 代表 “all”; 并 
且 应 该 提供 与 ToString 方法 相同 的 字符 串 表 示 。 为 实现 目 定 义 字 符 串 ， 接 口 下 ormattable 定义 了 带 两 个 参数 的 
ToString 方法 : 一 个 是 格式 的 字符 串 参 数 ， 另 一 个 是 下 ormatProvider 参数 。IFormatProvider 参数 未 在 示例 代码 
中 使 用 。 可 以 基于 区 域 值 使 用 这 个 参数 ， 进 行 不 同 的 显示 ， 因 为 CultureInfo 类 实现 了 该 接口 。 
实现 了 这 个 接口 的 其 他 类 是 NumberFormatInfo 和 DateTimeFormatInfo。 可 以 把 实例 传递 到 ToString 方 
法 的 第 二 个 参数 , 使 用 这 些 类 配置 数字 和 DateTime 的 字符 串 表 示 。 ToString 方法 的 实现 代码 只 使 用 switch 语句 ， 
基于 格式 字符 串 返回 不 同 的 字符 串 。 为 了 使 用 格式 字符 串 直 接 调用 ToString 方法 ， 而 不 提供 格式 提供 程序 ， 应 重 
载 ToString 方法 。 这 个 方法 又 调用 有 两 个 参数 的 ToString 方法 : 
Public class Person : IFormattable 
{ 
public string FirstName 1{ get; set; } 
public string LastName |{ get; set; } 
public override string ToString() => FirstName + " " + LastName; 
public virtual string ToString (string format) => ToString (format, null); 
Public string ToString (string format, IFormatProvider formatProvider) 
switch (format) 
{ 
Case null: 
Case "A™-: 
return ToString(); 
CasSe "EE™: 
return FirstName; 
Case “ 工 ”: 
return LastName; 
default: 
throw new FormatException($"invalid format string {format}™); 
} 


} 
} 


有 了 这 些 代 码 ， 就 可 以 显 式 传递 格式 字符 串 ， 或 隐 式 使 用 字符 串 插 值 ， 以 调用 ToString 方法 。 隐 式 的 
调用 使 用 带 两 个 参数 的 ToString 方法 ,并 给 IFormatProvider 参数 传递 null( 代 码 文件 StrineFormats/Program.cs): 
Var pl = new Person { FirstName = "Stephanle"，LastName = "Nagel™ }; 


Console.WriteLine (pl .ToString("F")); 
Console.WriteLine ($"{pl:F}").; 


9.3 ”正则 表达 式 


正则 表达 式 作 为 小 型 搁 术 领域 的 一 部 分 ， 在 各 种 程序 中 都 有 厦 难 以 置信 的 作用 。 正 则 表达 式 可 以 看 成 一 
种 有 特定 功能 的 小 型 编程 语言 ， 在 大 的 字符 串 表 达 式 中 定位 子 字 符 串 。 它 不 是 一 种 新 搁 术 ， 最 初 是 在 UNIX 
环境 中 开发 的 ， 与 Perl 和 JavaScript 编程 语言 一 起 使 用 得 比较 多 。System.Text.RegularExpressions 名 称 空间 中 的 
许多 .NET 类 都 文 持 正则 表达 式 。.NET Framework 的 各 个 部 分 也 使 用 正则 表达 式 。 例 如 ， 在 ASPNET 验证 服务 器 
的 控件 中 就 使 用 了 正则 表达 式 。 

对 于 不 大 熟悉 正则 表达 式 语 言 的 读者 ,本 节 将 主要 解释 正则 表达 式 和 相关 的 .NET 类 。 如 果 你 很 熟悉 正则 表 
达 式 ， 就 可 以 浏览 本 节 ， 选 择 学 习 与 .NET 基 类 引用 有 关 的 内 容 。 注 意 ，.NET 正则 表达 式 引 车 用 于 兼容 Perl 5 
的 正则 表达 式 ， 但 它 有 一 些 新 功能 。 


9.3.1 正则 表达 式 概述 


正则 表达 式 语言 是 一 种 专门 用 于 字符 串 处 理 的 语言 。 它 包含 两 个 功能 : 

。 一 组 用 于 标识 特殊 字符 类 型 的 转 义 代码 。 你 可 能 很 熟悉 DOS 命令 中 使 用 * 字 符 表示 任意 子 字符 串 (例如 ， 
DOS 命令 Dir Re* 会 列 出 名 称 以 Re 开头 的 所 有 文件 )。 正 则 表达 式 使 用 与 * 类 似 的 许多 序列 来 表示 “ 任 
意 一 个 字符 ”、“ 一 个 单词 的 中 断 ” 和 “一 个 可 选 的 字符 ”等 。 

。 一 个 系统 ， 在 搜索 操作 中 把 子 字符 串 和 中 间 结 果 的 各 个 部 分 组 合 起 来 。 
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使 用 正则 表达 式 ， 可 以 对 字符 串 执 行 许多 复杂 而 高 级 的 操作 ， 例 如 ; 
e 识别 (可 以 是 标记 或 删除 ) 字 符 串 中 所 有 重复 的 单词 ， 例 如 ， 把 “The computer books books” 转 换 为 “The 
computer books”。 
把 所 有 单词 都 转换 为 标题 格式 ， 例 如 ， 把 “this is a Title” 转 换 为 “This Is A Title”。 
把 长 于 3 个 字符 的 所 有 单词 都 转换 为 标题 格式 ， 例 如 ， 把 “this is a Title” 转 换 为 “This is a Title”。 
确保 句子 有 正确 的 大 写 形式 。 

。 区 分 URI 的 各 个 元 素 ( 例 如 ， 给 定 http:/www.wrox.com， 提 取出 其 中 的 协议 、 计 算 机 名 和 文件 名 等 )。 

当然 ， 这 些 都 是 可 以 在 C# 中 用 System.String 和 System.Text.StringBuilder 的 各 种 方法 执行 的 任务 。 但 是 ， 在 
一 些 情况 下 ， 还 需要 编写 相当 多 的 C# 代 码 。 如 果 使 用 正则 表达 式 ， 这 些 代 码 一 般 可 以 压缩 为 几 行 。 实 际 上 ， 这 是 实 
例 化 了 一 个 对 象 System_.TextRegularExpressions.RegEx( 甚 全 更 简单 ， 调 用 静态 的 RegEx0 方 法 ), 给 它 传递 要 处 理 
的 字符 串 和 一 个 正则 表达 式 (这 是 一 个 字符 串 ， 它 包含 用 正则 表达 式 语言 编写 的 指令 )。 

正则 表达 式 字 符 串 初 看 起 来 像 是 一 般 的 字符 串 ， 但 其 中 包含 了 转 义 序列 和 有 特定 含义 的 其 他 字符 。 例 如 ， 
序列 bp 表示 一 个 字 的 开头 和 结尾 ( 字 的 边界 )， 因 此 如 果 要 表示 正在 查找 以 字符 也 开头 的 字 ， 就 可 以 编写 正则 表 
达 式 \bth( 即 字 边 界 是 序列 -t-h)。 如 果 要 搜索 所 有 以 也 结尾 的 单词 , 就 可 以 编写 了 h\b( 字 边界 是 序列 th-)。 但 是 ， 
正则 表达 式 要 比 这 复杂 得 多 ， 包 括 可 以 在 搜索 操作 中 找到 存储 部 分 文本 的 工具 性 程序 。 本 节 仅 简要 介绍 正则 表 
达 式 的 功能 


注意 : 
正则 表达 式 的 更 多 信息 可 参阅 Andrew Watt 撰写 的 图 书 Beginning Reeular Expressions(John Wiley & Sons, 
2005)。 


假定 应 用 程序 需要 把 美国 电话 号 码 转换 为 国际 格式 。 在 美国 ， 电 话 号 码 的 格式 为 314-123-1234， 常 常 写作 
(314)123-1234。 在 把 这 个 国家 格式 转换 为 国际 格式 时 ， 必 须 在 电话 号 码 的 前 面 加 上 +1( 美 国 的 国家 代码 )， 并 给 
区 号 加 上 圆 括号 : +1(314) 123-1234。 在 查找 和 替换 时 ， 这 并 不 复杂 。 但 如 果 要 使 用 String 类 完成 这 个 转换 ， 就 
需要 编写 一 些 代 码 (这 表示 必须 使 用 System.String 类 的 方法 来 编写 代码 )。 而 正则 表达 式 语言 可 以 构造 一 个 短 的 
字符 串 来 表达 上 述 含义 。 

所 以 ， 本 节 只 有 一 个 非常 简单 的 示例 ， 我 们 只 考虑 如 何 查找 字符 串 中 的 某 些 子 字符 串 ， 不 需要 考虑 如 何 修 
改 它 们 。 


9.3.2 RegularExpressionsPlayground 示例 
本 章 的 正则 表达 式 示 例 使 用 如 下 名 称 空 间 : 


System 

System.Text.ReeularExpressions 

下 面 将 开发 一 个 小 示例 RegularExpressionsPlayground， 通 过 实现 并 显示 一 些 搜索 的 结果 ， 说 明正 则 表达 
式 的 一 些 功能 ， 以 及 如 何在 C# 中 使 用 .NET 正则 表达 式 引 擎 。 在 这 个 示例 文档 中 使 用 的 文本 是 本 书 前 一 版 的 部 
分 简介 (代码 文件 RegularExpressionsPlayeround/Prosram.cs): 


const string text = 
@"Professional C# 6 anq .NET Core 1.0 provides complete coverage ™ + 
"of the latest updates, features, and capabilities, giving You ™ 十 
"everything You need for C#. Get expert instruction on the latest ™ + 
"changes to Visual Studio 2015, Windows Runtijme, ADO.NET, ASP.NET, ™ 十 
"Windows Store Apps, Windows Workflow Foundation, and more, with ™ + 
"clear explanations, no-nonsense pacing, and valuable expert insight. ™ + 
"This incredibly useful guide serves as both tutorial and desk ™ + 
"reference, Providing a professional-level review of C# architecture ™ + 
"and its application in a number of areas- You'll gain a solid ™ + 
"background in managed code and -NET constructs within the context of ™ 十 
"the 2015 release, So You can get acclimated quickly and get back to work."™; 
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注意 : 
上 面 的 代码 说 明了 前 组 为 @ 符 号 的 逐 字 字符 囊 的 实用 性 。 这 个 前 组 在 正则 表达 式 中 非常 有 用 . 


我 们 把 这 个 文本 称 为 输入 字符 串 。 为 了 说 明 .NET 类 的 正则 表达 式 ， 我 们 先进 行 一 次 纯 文 本 的 基本 搜索 ， 这 
次 搜索 不 带 任何 转 义 序列 或 正则 表达 式 命令 。 假 定 要 查找 所 有 的 字符 串 ion， 把 这 个 搜索 字符 串 称 为 模式 。 使 
用 正则 表达 式 和 前 面 声明 的 变量 input, 可 编写 出 下 面 的 代码 (代码 文件 RegularExpressionPlayground/Program.cs): 
Public static void Findl (text) 
const string pattern = "lon™; 
MatchCcollection matches = Regex.Matches (text, pattern, 
RegexOptions.IgnoreCase | RegexOptions.ExplicitCapture); 
WriteMatches (text, matches); 
} 


在 这 段 代码 中 ， 使 用 了 System.Text.ReeularExpressions 名 称 空间 中 Regex 类 的 静态 方法 Matches0。 这 个 方 
法 的 参数 是 一 些 输入 文本 、 一 个 模式 和 从 RegexOptions 枚 举 中 提取 的 一 组 可 选 标 志 。 在 本 例 中 ， 指 定 所 有 的 搜 
索 都 不 应 区 分 大 小 写 。 男 一 个 标记 ExplicitCapture 改变 了 收集 匹配 的 方式 ， 对 于 本 例 ， 这 样 可 以 使 搜索 的 效率 
更 高 ， 其 原因 详 见 后 面 的 内 容 ( 尽 管 它 还 有 这 里 没有 探讨 的 其 他 用 法 )。Matches0 方 法 返回 MatchCollections 对 象 
的 引用 。 匹 配 是 一 个 技术 术语 ， 表 示 在 表达 式 中 查找 模式 实例 的 结果 ， 用 System.Text.RegularExpressions.Match 类 
表示 它 。 因 此 ， 我 们 返回 一 个 包含 所 有 匹配 的 MatchCollection， 每 个 匹配 都 用 一 个 Match 对 象 来 表示 。 在 上 面 
的 代码 中 ， 只 是 运 代 集 合 ， 并 使 用 Match 类 的 Index 属性 ，Match 类 返回 输入 文本 中 匹配 所 在 的 索引 。 

Find1 方法 的 结果 列 出 了 6 个 匹配 : 


NO. of matches: 6& 


Index: 了 ， String: ion, ofessional C# 
Index: 172, String: ion, truction on 七 
Index: 300, String: lion, undation, and 
Index: 334, String: ion, lanations, no 
Index: 481, String: lion, ofessional—-le 
Index: 535, String: ion, lication in a 


表 9-3 描述 了 RegexOptions 枚 举 的 一 些 成 员 。 


表 9-3 
成 员 名 说 明 

CnultureInvariant 指定 忽略 字符 串 的 区 域 值 

ExplicitCapture 修改 收集 匹配 的 方式 ， 方 法 是 确保 把 显 式 指定 的 匹配 作为 有 效 的 搜索 结果 

IenoreCase 忽略 输入 字符 串 的 大 小 写 

IenorePatternWhitespace 在 字符 串 中 删除 未 转 义 的 空白 ， 启 用 通过 # 符 号 指定 的 注释 

Multiline 修改 字符 ^ 和 $， 把 它们 应 用 于 每 一 行 的 开头 和 结尾 ， 而 不 仅仅 应 用 于 整个 字符 串 的 开头 和 
结尾 

RightToLeft 从 右 到 左 地 读 取 输入 字符 串 ， 而 不 是 默认 地 从 左 到 右 读 取 ( 适 合 于 一 些 亚洲 语言 或 其 他 以 这 
种 方式 读 取 的 语言 ) 

Singleline 指定 句点 的 含义 ()， 它 原来 表示 单行 模式 ， 现 在 改 为 匹配 每 个 字符 


到 目前 为 止 ， 在 前 面 的 示例 中 ， 除 了 一 些 新 的 NET 基 类 外 ， 其 他 都 不 是 新 的 内 容 。 但 正则 表达 式 的 能 力主 
要 取决 于 模式 字符 串 ， 原 因 是 模式 字符 串 不 必 仪 包含 纯 文本 。 如 前 所 述 ， 它 还 可 以 包含 元 字符 和 转 义 序列 ， 其 
中 元 字符 是 给 出 命令 的 特定 字符 ,而 转 义 序列 的 工作 方式 与 C# 的 转 义 序列 相同 。 它们 都 是 以 反 斜 杠 Q) 开 头 的 字 
符 ， 且 具有 特殊 的 含义 。 

例如 ,假定 要 查找 以 n 开头 的 字 ， 那 么 可 以 使 用 转 义 序列 b， 它 表示 一 个 字 的 边界 ( 字 的 边界 是 以 字母 数字 
表 中 的 菜 个 字符 开头 ， 或 者 后 面 是 一 个 空白 字符 或 标点 符号 )。 可 以 编写 如 下 代码 : 


const string pattern = @"\bn", 
MatchCollection myMatches = Regex.Matches (input, pattern, 
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RegexOptions.IgnoreCase | 
RegexOptions .ExplicitCapture),; 


注意 字符 串 前 面 的 符号 @。 要 在 运行 时 把 \b 传递 给 .NET 正则 表达 式 引擎 ， 反 斜 杠 (人 不 应 被 C# 编 译 器 解释 
为 转 义 序列 。 

如 果 要 查找 以 序列 ure 结尾 的 字 ， 就 可 以 使 用 下 面 的 代码 : 

const string pattern = f"ure\b"; 

如 果 要 查找 以 字母 a 开头 、 以 序列 ure 结尾 的 所 有 字 ( 在 本 例 中 仅 有 一 个 匹配 的 字 architecture)， 束 必须 在 上 
面 的 代码 中 添加 一 些 内 容 。 显 然 ， 我 们 需要 一 个 以 \ba 开头 、 以 ure\b 结尾 的 模式 ， 但 中 间 的 内 容 怎么 办 ? 需要 
告诉 应 用 程序 ， 在 a 和 ure 中 间 的 内 容 可 以 是 任意 长 度 的 字符 ， 只 要 这 些 字 符 不 是 空 日 即 可 。 实 际 上 ， 正 确 的 
模式 如 下 所 示 。 

const string Pattern = &"\ba\S*ure\b"; 

使 用 正则 表达 式 要 习惯 的 一 点 是 ， 对 像 这 样 怪异 的 字符 序列 应 见怪 不 怪 。 但 这 个 序列 的 工作 是 非常 逻辑 化 
的 。 转 义 序列 \S 表示 任何 不 是 空白 字符 的 字符 。* 称 为 限定 符 ， 其 含义 是 前 面 的 字符 可 以 重复 任意 次 ， 包 括 0 
次 。 序 列 \S* 表 示 任 意 数 量 不 是 空白 字符 的 字符 。 因 此 ， 上 面 的 模式 匹配 以 a 开头 以 ure 结尾 的 任何 单个 单词 。 

表 9-4 是 可 以 使 用 的 一 些 主要 的 特定 字符 或 转 义 序列 , 但 这 个 表 并 不 完整 , 完整 的 列表 请 参考 MSDN 文档 。 


匹配 的 示例 
B， 但 只 能 是 文本 中 的 第 一 个 字符 
只 能 是 文本 中 的 最 后 一 个 字符 


1sation ~、 ization 


rat、raat 和 raaat 等 (但 不 能 是 tt) 

只 有 rt 和 rat 匹配 

任何 空白 字符 [spacela、'\ta、'ma Qt 和 Mn 与 C# 中 的 \t 和 wn 含义 相同 ) 
任何 不 是 空白 的 字符 aF、IF、cF， 但 不 能 是 \tf 

字 边界 以 ion 结尾 的 任何 字 

不 是 字 边 界 的 任意 位 置 > 字 中 间 的 任何 六 


\s 
‘5 
也 
\B 


如 果 要 搜索 其 中 一 个 元 字符 ， 就 可 以 通过 带 有 反 斜 杠 的 相应 转 义 字符 来 表示 。 例 如 ,“.”( 一 个 句点 ) 表 示 除 
了 换行 字符 以 外 的 任何 单个 字符 ， 而 “\.” 表 示 一 个 点 。 

可 以 把 蔡 换 的 字符 放 在 方 括号 中 ， 请 求 丐 配 包含 这 些 字 符 。 例 如 ，[1|c] 表 示 字 符 可 以 是 1 或 c。 如 果 要 搜索 
map 或 man， 就 可 以 使 用 序列 malnlp]。 在 方 括号 中 ， 也 可 以 指定 一 个 范围 ， 例 如 ，[a-z] 表 示 所 有 的 小 写字 母 ， 
[A-E] 表 示 A~E 之 间 的 所 有 大 写字 母 (包括 字母 A 和 了)，[0-9] 表 示 一 个 数字 ， 其 简写 方式 是 d。 如 果 要 搜索 一 个 整 
数 (该 序列 只 包含 0-9 的 字符 )， 就 可 以 编写 [0-9]+ 或 [d]+。 


注意 : 

使 用 “+” 字 符 表 示 至 少 要 有 这 样 一 个 数字 ， 但 可 以 有 多 个 数字 ， 所 以 9、 83 和 854 等 都 是 匹配 的 。 

^ 用 在 方 括号 中 时 有 不 同 的 含义 。 在 方 括号 外 部 使 用 它 ， 就 标记 输入 文本 的 开头 。 在 方 括号 内 使 用 它 ， 表 示 
除了 ^ 之 后 的 字符 之 外 的 任意 字符 。 
9.3.3 ”显示 结果 


本 节 编 写 一 个 示例 RegularExpressionsPlayground， 看 看 正则 表达 式 的 工作 方式 。 
该 示例 的 核心 是 方法 WriteMatches0， 它 把 MatchCollection 中 的 所 有 匹配 以 比较 详细 的 格式 显示 出 来 。 对 
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于 每 个 匹配 结果 ， 该 方法 都 会 显示 匹配 在 输入 字符 串 中 的 索引 、 匹 配 的 字符 串 和 一 个 略 长 的 字符 串 ， 其 中 包含 
匹配 结果 和 输入 文本 中 至 多 10 个 外 围 字符 , 其 中 至 多 有 5 个 字符 放 在 匹配 结果 的 前 面 , 至 多 5 个 字符 放 在 匹配 
结果 的 后 面 (如 果 匹 配 结果 的 位 置 在 输入 文本 的 开头 或 结尾 $ 个 字符 内 , 则 结果 中 匹配 字符 串 前 后 的 字符 就 会 少 
于 5 个)。 换言之 ， 在 RegularExpressionsPlayeround 示例 开始 时 ， 如 果 要 匹配 的 单词 是 applications， 靠 近 输 入 文 
本 开头 的 匹配 结果 应 是 “web applications imme”， 匹 配 结果 的 前 后 各 有 5 个 字符 ， 但 位 于 输入 文本 的 最 后 一 个 
字 immediately 上 的 匹配 结果 就 应 是 " ions immediately " 一 一 匹配 结果 的 后 面 只 有 一 个 字符 ， 因 为 在 该 字符 的 后 
面 是 字符 串 的 结尾 。 下面 这 个 长 字符 串 可 以 更 清楚 地 表明 正则 表达 式 是 在 什么 地 方 查找 到 匹配 结果 的 (代码 文件 
ReeularExpressionPlayeround/Proeram.cs): 


Public static void WriteMatches (string text, MatchCollection matches) 
{ 
Console .WriteLine($"Original text was: \n\n{text}\n"),; 
Console .WriteLine (S$"No. of matches: {matches.Count}"™"). 
foreach (Match nextMatch in matches) 
{ 
int index = nextMatch.Index; 
string result = nextMatch.ToString().; 
int charsBefore = (index < 5) 3 index : 5; 
int fromEnd = text.Length 一 index 一 result.Length; 
int charsAfter = {fromEnd < 5) 2 fromEnd : 5; 
int charsToDisplay = CharsBefore + charsAfter + result.Length; 
Console.WriteLine($"Index: {index}, ‘\tSstring: {result}, ‘\t"™ + 
"{text.Substring(index 一 charsBefore, charsToDisplay) }"); 
} 
} 


在 这 个 方法 中 ， 处 理 过 程 是 确定 在 较 长 的 子 字符 串 中 有 多 少 个 字符 可 以 显示 ， 而 不 需要 超出 输入 文本 的 开 
头 或 结尾 。 注 意 在 Match 对 象 上 使 用 了 另 一 个 属性 Value， 它 包含 标识 该 匹配 的 字符 串 。 而 且 ， 
RegularExpressionsPlayeround 只 包含 名 为 Finmd1、Find2 等 的 方法 ， 这 些 方法 根据 本 节 中 的 示例 执行 某 些 搜索 操 
作 。 例 如 ，Find2 香 找 以 a 开 头 、 以 ure 结尾 的 任意 字符 串 : 

Public static void Find2 (string text) 

string pattern = @"\ba\S*ure\b"; 

MatchCollection matches = Regex.Matches (text, pattern, 
RegexOptions.IgnoreCase); 


Console .WriteMatches (text, matches).; 


} 
下 面 是 一 个 简单 的 Main0 方 法 ， 可 以 编 


public static void Main() 
{ 
Find2 (); 
Console.ReadLine (); 


} 
这 段 代码 还 需要 使 用 RegularExpressions 名 称 空间 : 


usSing System; 
usSing System.Text.RegularExpressions; 


运行 带 有 Find 20 方 法 的 示例 ， 得 到 如 下 所 示 的 结果 : 


No. of matches: 1 
Index: 506, string: architecture, f C# architecture and 


腊 它 ， 从 而 选择 一 个 Find<n>0 方 法 : 


9.3.4 匹配 、 组 和 捕获 


正则 表达 式 的 一 个 优秀 特性 是 可 以 把 字符 组 合 起 来 ， 其 工作 方式 与 C# 中 的 复合 语句 一 样 。 在 C# 中 ， 可 以 
把 任意 数量 的 语句 放 在 花 括 号 中 ， 把 它们 组 合 在 一 起 ， 其 结果 视 为 复合 语句 。 在 正则 表达 式 模式 中 ， 也 可 以 把 
任何 字符 组 合 起 来 (包括 元 字符 和 转 义 序列 )， 像 处 理 单 个 字符 那样 处 理 它们 。 唯 一 的 区 别 是 要 使 用 圆 括 号 而 不 
是 花 括 号 ， 得 到 的 序列 称 为 一 组 。 

例如 ， 模 式 (an)i+ 定 位 任意 重复 出 现 的 序列 amn。 限 定 竺 “+” 只 应 用 于 它 前 面 的 一 个 字符 ， 但 因为 我 们 把 字 
符 组 合 起 来 了 ,所 以 它 现在 把 重复 的 an 作 为 一 个 单元 来 对 等 ,这 意味 着 ,如 果 (an)+ 应 用 到 输入 文本 “bananas came 
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to Europe late in the annals of history” 上 ， 就 会 从 bananas 中 识别 出 anan。 另 一 方面 ， 如 果 使 用 an+， 则 程序 将 
从 annals 中 选择 aan， 从 bananas 中 选择 出 两 个 分 开 的 an 序列 。 表 达 式 (an)+ 可 以 识别 出 am、anan、ananan 等 ， 
而 表达 式 an+ 可 以 识别 出 am、ann、annn 等 。 


注意 : 
在 上 面 的 示例 中 ， 为 什么 (am+ 从 banana 中 选择 的 是 anan， 而 没有 把 其 中 一 个 an 作为 一 个 匹配 结果 ? 因为 
匹配 结果 是 不 能 重 登 的 。 如 果 有 可 能 重 登 ， 在 默认 情况 下 就 选择 最 长 的 匹配 序列 。 


但 是 ， 组 的 功能 要 比 这 强大 得 多 。 在 默认 情况 下 ， 把 模式 的 一 部 分 组 合 为 一 个 组 时 ， 就 要 求 正 则 表达 式 引 
擎 按照 该 组 来 匹配 ， 或 按照 整个 模式 来 匹配 。 换 言 之 ， 可 以 把 组 当成 一 个 要 匹配 和 返回 的 模式 。 如 果 要 把 字符 
串 分 解 为 各 个 部 分 ， 这 种 模式 就 非常 有 效 。 

例如 ，URI 的 格式 是 <protocol>:/W<address>:<port>， 其 中 端口 是 可 选 的 。 它 的 一 个 示例 是 http://Wwww.wrox. 
com:80。 假 定 要 从 一 个 URI 中 提取 协议 、 地 址 和 羡 口 ， 而 且 不 考虑 URI 的 后 面 是 否 紧 跟着 空白 (但 没有 标点 符 
号 )， 那 么 可 以 使 用 下 面 的 表达 式 ; 

\b (https3?) (:/7/) ([.Aw]+) ([\s:] (I\d]1 {2,51)?) Nb 

该 表达 式 的 工作 方式 如 下 : 首先 ， 前 导 \b 序列 和 结尾 \b 序列 确保 只 需要 考虑 完全 是 字 的 文本 部 分 。 在 这 个 
文本 部 分 中 ， 第 一 组 (https?) 会 识别 http 或 https 协议 。S 字符 后 面 的 ?指定 这 个 字符 可 能 出 现 0 次 或 1 次 ， 因 此 
找到 http 和 https。 括 号 表示 把 协议 存储 为 一 组 。 

第 二 组 是 一 个 简单 的 (:/))。 它 仅 指定 字符 ://。 

第 三 组 ([w]Hb) 比 较 有 趣 。 这 个 组 包含 一 个 放 在 括号 里 的 表达 式 ， 该 表达 式 要 人 么 是 句点 字符 ()， 要 人 么 是 用 \w 
指定 的 任意 字母 数字 字符 。 这 些 字 符 可 以 重复 任意 多 次 ， 因 此 匹配 www.wrox.com。 

第 四 组 (Ms:](MNd]{2,5})?) 是 一 个 较 长 的 表达 式 ， 包 含 一 个 内 部 组 。 在 该 组 中 ， 第 一 个 放 在 括号 中 的 表达 式 允 
许 通 过 \s 指定 空白 字符 或 冒号 。 内 部 组 用 [Md] 指定 一 个 数字 。 表 达 式 { 2, 5 } 指 定 前 面 的 字符 (数字 ) 允 许 至 少 出 现 
两 次 但 不 超过 5 次 。 数 字 的 完整 表达 式 用 内 部 组 后 面 的 ?指定 允许 出 现 0 次 或 1 次 。 使 这 个 组 变 成 可 选 非常 重要 ， 
因为 端口 号 并 不 总 是 在 URI 中 指定 ; 事实 上 ， 通 常 不 指定 它 。 

下 面 定 义 一 个 字符 串 来 运行 这 个 表达 式 (代码 文件 RegularExpressionsPlayground/Program.cs): 


string line = "Hey, I've ]ust found this amazing URI at ™ 十 
"mttp:// what was it -oh Yes https://www.wrox.com or ™ + 
"http: / /Www .wrox.com: 80"; 


与 这 个 表达 式 匹 配 的 代码 使 用 类 似 于 之 前 的 Matches 方 法。 区 别 是 在 Match.Groups 属性 内 过 代 所 有 的 Group 
对 象 ， 在 控制 人 台 上 输出 每 组 得 到 的 索引 和 值 : 


string pattern = @"\b(https?3) (2://) ([-.\w]+) ([\s:]([\d] {2,4}) ?3) \b"; 
Var I 一 new Regex (pattern}); 
MatchcCcollection mc = Ir.Matches (line); 
foreach (Match m in mc) 
{ 
Console .WriteLine ($"Match: {m}"™"); 
foreach (Group 9g In m.Groups) 


if {(g.Success) 
{ 
Console .WriteLine ($"group index: {g.Index}, value: {9g.Value}");} 


} 


Console.WriteLine (); 
} 
运行 程序 ， 得 到 如 下 组 和 值 : 
Match https://Www .wrox.com 
group index 70, value: https://Wwww .wrox.com 
group index 70, value: https 
group index 75, value: :// 
group index 78, value: WWW .WIOXx.Com 
group index 90, value: 
Match http:/ /Www.wrox.com:80 
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group index 94, value http://Wwww.wrox.com:80 
group index 94, value: http 

group index 98, walue: :// 

group index 101, value: WwW .WIoOx.cCom 

group index 113, value: :80 

group index 114, value: 80 


之 后 ， 就 匹配 文本 中 的 URI，URI 的 不 同 部 分 得 到 了 很 好 的 分 组 。 组 还 提供 了 更 多 的 功能 。 一 些 组 ， 如 协 
议和 地 址 之 间 的 分 隔 ， 可 以 忽略 ， 并 且 组 也 可 以 命名 。 
修改 正则 表达 式 ， 命 名 每 个 组 ， 忽 略 一 些 名 称 。 在 组 的 开头 指定 ?<name=， 就 可 给 组 命名 。 例 如 ， 协 议 、 
地 址 和 端口 的 正则 表达 式 组 就 采用 相应 的 名 称 。 在 组 的 开头 使 用 ?: 来 忽略 该 组 。 不 要 迷惑 于 组 内 的 ?::/ /， 它 表示 
搜索 ://， 组 本 身 因为 前 面 的 ?: 而 被 忽略 : 
string pattern = @"\b(?<protocol>https?) (2: ://)"™ 十 
@"(?<address>[.\w]+) ([\s:] (2<port>[\d] {2,4}) 2?) \b"; 
为 了 从 正则 表达 式 中 获得 组 ，Regex 类 定义 了 GetGroupNames 方法 。 在 下 面 的 代码 段 中 ， 每 个 匹配 都 使 用 
所 有 的 组 名 ， 使 用 Groups 属性 和 索引 器 输出 组 名 和 值 : 
Regex I = new Regex(pattern, RegexOptions.ExplicitCapture),; 
MatchCollection mec = r.Matches (line}); 
foreach (Match m in me) 
{ 
Console .WriteLine ($s"match: {m} at {m.Index}™).: 
foreach (var groupName in Ir.GetGroupNames ()) 
{ 
Console.WriteLine($"match for {groupName}: {m.Groups [groupName] .Value}"); 
} 
} 
运行 程序 ， 就 可 以 看 到 组 名 及 其 值 : 
match: https://www.wrox.com at 70 
match for 0: https:/ /www .wrox.com 
match for protocol: https 
match for address: WWW .WIOX.COm 
match for port: 
match: http://www .wrox.com:30 at 94 
match for 0: http://www.wrox.com:80 
match for protocol: http 
match for address: WWW .WIOXN .COmMm 
match for port: 80 


9.4 字符 串 和 Span 


今天 的 编程 代码 通常 处 理 需要 操作 的 长 字符 串 。 例 如 ，Web API 以 JSON 或 XML 格式 返回 一 个 长 字符 串 。 
将 如 此 大 的 字符 串 分 割 成 许多 更 小 的 字符 串 ， 意 味 着 创建 了 许多 对 象 ， 而 垃圾 收集 器 不 再 需要 这 些 字符 串 时 ， 
需要 做 很 多 事情 来 释放 这 些 字符 串 所 占 的 内 存 。 

.NET Core 有 一 个 新 的 方法 : Span<T> 类 型 。 这 一 类 型 参阅 第 7 章 。 该 类 型 引用 数组 的 一 个 切片 ， 而 不 需要 
复制 它 的 内 容 。 同 样 ，Span<T> 可 以 用 来 引用 一 个 字符 串 的 片段 ， 而 不 需要 复制 原始 内 容 。 

下 面 的 代码 片段 从 一 个 由 变量 文本 引用 的 非常 长 的 字符 串 中 创建 了 span。 它 与 以 前 使 用 正则 表达 式 的 字符 
串 相同 。ReadOnlySpan<char> 从 AsSpan 扩展 方法 中 返回 。AsSpan 扩展 了 字符 串 类 型 ， 并 返回 一 个 
ReadOnlySpan<char>， 因 为 字符 串 由 char 元 素 组 成 。 在 内 部 ，Span<T> 使 用 ref 关键 字 来 保存 引用 。 在 Slice 方 
法 中 ， 可 以 从 完整 的 字符 串 中 获取 一 个 切片 。 用 第 一 个 参数 选择 开头 ， 在 该 索引 中 ， 在 字符 串 中 找到 的 第 一 个 
文本 Visual 是 索引 。 从 那里 ， 第 二 个 参数 使 用 13 个 字符 定义 。 结 果 还 是 一 个 ReadOnlySpan。 只 有 使 用 span 的 
ToArray 方法 才能 分 配 内 存 。ToArray 方法 分 配 切 片 所 需 的 内 存 。 然 后 将 char 数组 传递 给 string 类 型 的 构造 函数 ， 
以 创建 一 个 新 的 字符 串 ( 代 码 文 件 SpanWithString /Program.cs):: 

int ix = text.Indexof ("Visual"); 

Readonlyspan<char> spanToText = text.AsSpan(); 

Readonlyspan<char> slice = spanToText.Slice (ix, 13); 


string newSstring = new string(slice.ToArray (})); 
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Console .WriteLine (newSstring); 


从 切片 中 新 分 配 的 字符 串 包含 Visual Studio。 


注意 : 
第 7 章 介绍 了 Span 和 数组 .第 17 章 讨论 了 Span 映射 到 本 机 内 存 和 ref 关键 字 。 返回 JSON 或 XML 的 Web 
API 在 第 32 章 中 介绍 。JSON 和 XML 的 详细 信息 可 以 参阅 网 上 附加 第 2 章 。 


9.5 ”小 结 


在 使 用 .NET Framework 时 ， 可 用 的 数据 类 型 相当 多 。 在 应 用 程序 (特别 是 关注 数据 提交 和 检索 的 应 用 程序 ) 
中 ， 最 第 用 的 一 种 类 型 就 是 Sting 数据 类 型 。Sting 非常 重要 ， 这 也 是 本 书 用 一 整 章 的 扁 幅 介绍 如 何在 应 用 程 
序 中 使 用 和 处 理 String 数据 类 型 的 原因 。 

过 去 在 使 用 字符 串 时 ， 第 第 需要 通过 连接 来 分 解 字符 串 。 而 在 NET Framework 中 ， 可 以 使 用 StringBuilder 
类 完成 许多 这 类 任务 ， 而 且 性 能 更 好 。 

字符 串 的 另 一 个 特点 是 字符 串 插值 。 在 大 多 数 应 用 程序 中 ， 该 特性 使 字符 串 的 处 理 容易 得 多 。 

最 后 ， 使 用 正则 表达 式 进行 高 级 的 字符 串 处 理 是 搜索 和 验证 字符 串 的 一 种 最 佳 工具 。 

接 下 来 的 两 章 介 绍 不 同 的 集合 类 。 


集 


人 人 
= 


本 章 要 点 

e 理解 集合 接口 和 类 型 
e 使 用 列表 、 队 列 和 栈 
es 使 用 链表 和 有 序列 表 
e 使 用 字典 和 集 

e 评估 性 能 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Delegates 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 ; 


10.1 


列表 示例 (List Samples) 

队列 示例 (Queue Sample) 

链表 示例 (Linked List Sample) 
有 序列 表示 例 (Sorted List Sample) 
字典 示例 (Dictionary Sample) 

集 示例 (Set Sample) 


第 7 章 介绍 了 数组 和 Array 类 实现 的 接口 。 数 组 的 大 小 是 固定 的 。 如 果 元 素 个 数 是 动态 的 ， 就 应 使 用 集 


合 类 


List<T> 是 与 数组 相当 的 集合 类 。 还 有 其 他 类 型 的 集合 : 队列 、 栈 、 链 表 、 字 典 和 集 。 其 他 集合 类 提供 的 访 


问 集 合 元 素 的 API 可 能 稍 有 不 同 ， 它 们 在 内 存 中 存储 元 素 的 内 部 结构 也 有 区 别 。 本 章 将 介绍 所 有 的 集合 类 和 筷 
们 的 区 别 ， 包 括 性 能 差异 。 


第 10 章 集 合 | 203 


10.2 集合 接口 和 类 型 


大 多 数 集合 类 都 可 在 System.Collections 和 System.Collections.Generic 名 称 空间 中 找到 。 泛 型 集合 类 位 于 
System.Collections.Generic 名 称 空间 中 ; 专用 于 特定 类 型 的 集合 类 位 于 System.Collections. Specialized 名 称 空间 中 。 
线程 安全 的 集合 类 位 于 System.Collections.Concurrent 名 称 空 间 中 。 不 可 变 的 集合 类 在 System.Collections Immnutable 
名 称 空间 中 。 

当然 ， 组 合集 合 类 还 有 其 他 方式 。 集 合 可 以 根据 集合 类 实现 的 接口 组 合 为 列表 、 集 合 和 字典 。 


注意 : 
接口 [Enumerable 和 IEnumerator 的 内 容 详 见 第 7 章 。 


集合 和 列表 实现 的 接口 如 表 10-1 所 示 。 


表 10-1 
接口 说 明 

IEnumerable<T> 如 果 将 foreach 语句 用 于 和 集合， 就 需要 IEnumerable 接口 。 这 个 接口 定义 了 方法 GetEnumerator0， 它 
返回 一 个 实现 了 IEnumerator 接口 的 枚 举 

ICollection<T> ICollection<T> 接 口 由 泛 型 集合 类 实现 . 使 用 这 个 接口 可 以 获得 集合 中 的 元 素 个 数 (Count 属性 ), 把 
集合 复制 到 数组 中 (CopyTo0 方 法 )， 还 可 以 从 集合 中 添加 和 删除 元 素 (Add0、Remove0、Clear0) 

IList<T> IList<T> 接 口 用 于 可 通过 位 置 访问 其 中 的 元 素 列 表 ， 这 个 接口 定义 了 一 个 索引 器 ， 可 以 在 集合 的 
指定 位 置 插入 或 删除 某 些 项 (Insert0 和 RemoveAt0 方 法 )。IList<T=> 接 口 派生 自 ICollection<T> 接 口 

ISet<T> ISet<T> 接 口 由 集 实现 。 集 允许 合并 不 同 的 集 ， 获 得 两 个 集 的 交集 , 检查 两 个 集 是 否 重 蕾 。ISet<T> 
接口 派生 自 ICollection<T> 接 口 

IDictionary<TEKey, TValue> IDictionary= TKey.TValue> 接 口 由 包含 键 和 值 的 泛 型 集合 类 实现 。 使 用 这 个 接口 可 以 访问 所 有 的 键 
和 值 ， 使 用 键 类 型 的 索引 器 可 以 访问 某 些 项 ， 还 可 以 添加 或 删除 某 些 项 

ILookup<TRKey, TValue> ILookup<TKey, TValue> 接 口 类 似 于 IDictionary<TKey,TValue> 接 口 , 实现 该 接口 的 集合 有 键 和 值 ， 
且 可 以 通过 一 个 键 包含 多 个 值 


IComparer<T> 接口 IComparer<T> 由 比较 器 实现 ， 通 过 Compare0 方 法 给 集合 中 的 元 素 排序 
IEqualityComparer<T> 接口 下 qualityComparer<T> 由 一 个 比较 器 实现 ， 该 比较 器 可 用 于 字典 中 的 键 。 使 用 这 个 接口 ， 可 


10.3 列表 


.NET Framework 为 动态 列表 提供 了 泛 型 类 List<T>。 这 个 类 实现 了 IList, ICollection,\ IEnumerable, IList<T>、 
ICollection<T=> 和 IEnumerable<T> 接 口 。 

下 面 的 例子 将 Racer 类 中 的 成 员 用 作 要 添加 到 和 集合 中 的 元 素 ， 以 表示 一 级 方程 式 的 一 位 赛车 手 。 这 个 类 有 
5 个 属性 :Id、Firsthame、Lastname、Country 和 Wins 的 次 数 。 在 该 类 的 构造 国 数 中 ， 可 以 传递 赛车 手 的 姓名 
和 获胜 次 数 ， 以 设置 成 员 。 重 写 ToSstring0 方 法 是 为 了 返回 赛车 手 的 姓名 。Racer 类 也 实现 了 泛 型 接口 
IComparable<T>， 为 Racer 类 中 的 元 素 排 序 ， 还 实现 了 IFormattable 接口 (代码 文件 ListSamples/Racer.cs)。 


Public class Racer: IComparable<Racer>, IFormattable 
{ 

public int Id { get; } 

Public string FirstName { get; } 

Public string LastName { get; } 

Public string Country { get; } 

public int Wins { get; } 
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public Racerl(int id, string firstName, string lastName, string country) 
:this(id, firstName, lastName, country, wins: 0) 


{ } 
public Racerl(int id, string firstName, string lastName, string country,int wins) 
{ 

Id = id; 

FirstName = firstName; 

LastName = lastName; 


Country = country;s 
Wins = Wins; 


} 
public override string ToString() => $"{FirstName} {LastName}™; 


public string ToString (string format, IFormatProvider formatProvider) 
{ 
if tformat == null}) format = "NMN™; 
switch (format .ToUpper()})) 
{ 
case "N": // name 
return ToString(); 
Case "F": // first name 
return FirstName.: 
case "L": // last name 
Ireturn LastNamer 
case "W": // Wins 
return $"{ToString{(}}, Wins: {Wins}"™; 
case "C": // Country 
return $"{ToString{()}}, Country: {Country}"; 
case "A™: YA All 
return $"{ToString(}}, Country: {Country} Wins: {Wins}"; 
default: 
throw new FormatException (String.Format (formatProvider, 
s"Format {format} is not supported"™)); 
} 
} 


public string ToString (string format) => ToString (format, null):; 


public int CompareTo (Racer other) 


| 
int compare = LastName?.CompareTo (other?.LastName) 22 -1; 
if (compare == 0) 
{ 
return FirstName? .CompareTo (other?.FirstName) ?2 -1; 
} 
return compare; 
} 


10.3.1 创建 列表 


调用 默认 的 构造 函数 ， 就 可 以 创建 列表 对 象 。 在 泛 型 类 List<T> 中 ， 必 须 为 声明 为 列表 的 值 指定 类 型 。 下 
面 的 代码 说 明了 如 何 声明 一 个 包含 int 的 List<T> 泛 型 类 和 一 个 包含 Racer 元 素 的 列表 。ArrayList 是 一 个 非 泛 型 
列表 ， 它 可 以 将 任意 Object 类 型 作为 其 元 素 。 

使 用 默认 的 构造 函数 创建 一 个 空 列表 。 元 素 添加 到 列表 中 后 ， 列 表 的 容量 就 会 扩大 为 可 接纳 4 个 元 素 。 如 
果 添加 了 第 5 个 元 素 ， 列 表 的 大 小 就 重新 设置 为 包含 8 个 元 素 。 如 果 8 个 元 素 还 不 够 ， 列 表 的 大 小 就 重新 设置 
为 包含 16 个 元 素 。 每 次 都 会 将 列表 的 容量 重新 设置 为 原来 的 2 倍 。 


var intList = new List<int>():; 
Var IaCErS = new List<Racer>().: 


如 果 列 表 的 容量 改变 了 ， 整 个 集合 就 要 重新 分 配 到 一 个 新 的 内 存 块 中 。 在 List<T> 泛 型 类 的 实现 代码 中 ， 
使 用 了 一 个 T 类 型 的 数组 通过 重新 分 配 内 存 , 创建 一 个 新 数组 ，Array.Copy0 方 法 将 旧 数 组 中 的 元 素 复 制 到 新 
数组 中 。 为 节省 时 间 ， 如 果 事 先知 道 列表 中 元 素 的 个 数 ， 就 可 以 用 构造 函数 定义 其 容量 。 下 面 创建 了 一 个 容量 
为 10 个 元 素 的 集合 。 如 果 该 容量 不 足以 容纳 要 添加 的 元 素 ， 就 把 集合 的 大 小 重新 设置 为 包含 20 或 40 个 元 素 ， 
每 次 都 是 原来 的 2 倍 。 
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List<int> intList = new LI1LS<1Int>(1L0) : 

使 用 Capacity 属性 可 以 获取 和 设置 集合 的 容量 。 

intList.Capacity = 20; 

容量 与 集合 中 元 素 的 个 数 不 同 。 集 合 中 的 元 素 个 数 可 以 用 Count 属性 读 取 。 当 然 ， 容 量 总 是 大 于 或 等 于 元 
系 个 数 。 只 要 不 把 元 系 添 加 到 列表 中 ， 元 素 个 数 束 是 0。 

Console .WriteLine (i1ntList.cCount).; 

如 果 已 经 将 元 系 添 加 到 列表 中 ， 且 不 希望 添加 更 多 的 元 素 ， 就 可 以 调用 TrimExcess0 方 法 ， 去 除 不 需要 的 
容量 。 但 是 ， 因 为 重新 定位 需要 时 间 ， 所 以 如 果 元 素 个 数 超过 了 容量 的 90%，TrimExcess0 方 法 就 什么 也 不 做 。 


intList.TrimExcess (});} 

1. 集合 初始 值 设 定 项 

还 可 以 使 用 集合 初始 值 设 定 项 给 集合 赋值 。 和 集合 初始 化 器 的 语法 类 似 于 数组 初始 化 器 (参见 第 7 章 )。 使 用 
集合 初始 值 设 定 项 ， 可 以 在 初始 化 集合 时 ， 在 花 括号 中 给 集合 赋值 : 


Var intList = new List<int>({() {1, 2}; 
var stringList = new List<string>() { "one™, "two™ }; 


注意 : 

集合 初始 值 设 定 项 没有 反映 在 已 编译 的 程序 集 的 工 代码 中 。 编译 器 会 把 集合 初始 值 设 定 项 转换 成 对 初始 值 
设 定 项 列表 中 的 每 一 项 调用 Add() 方 法 。 

2. 添加 元 素 

使 用 Add0 方 法 可 以 给 列表 添加 元 素 ， 如 下 所 示 。 实 例 化 的 泛 型 类 型 定义 了 Add0 方 法 的 参数 类 型 : 

var jntList = new List<int>().; 

intList.Add (1}).: 

intList.Add (2): 

var stringList = new List<string> (); 


stringList.Add ("one™),; 
stringList.Add ("two™"); 


把 racers 变量 定义 为 List<Racer> 类 型 。 使 用 new 运算 和 从 创建 相同 类 型 的 一 个 新 对 象 。 因 为 类 List<T> 用 具 
体 类 Racer 来 实例 化 ， 所 以 现在 只 有 Racer 对 象 可 以 用 Add0 方 法 添加 。 在 下 面 的 示例 代码 中 ,创建 了 5 个 一 级 
方程 式 赛 车 手 ， 并 把 它们 添加 到 集合 中 。 前 3 个 用 集合 初始 值 设 定 项 添加 ， 后 两 个 通过 显 式 调用 Add0 方 法 来 
添加 (代码 文件 ListSamples/Program.cs)。 


Var graham = new Racer(7, "Graham™", "Hill"™", "UK", 14); 


VarI emerson = new Racer(l13, "Emerson™, "Fittipaldi™, “Brazil™", 14); 
var mario = new Racer(16, "Mario™, "Andretti"™"™, "USA™", 12); 
Var Iacers = new List<Racer>(20) {graham, emerson, mariol}; 


racers.Add (new Racer(24, "Michael™., "Schumacher", "Germany™", 91)); 
racers.Add (new Racer(27, "Mika™, "Hakkinen™., "Finland™", 20)); 


使 用 List<T> 类 的 AddRange0 方 法 ， 可 以 一 次 给 集合 添加 多 个 元 素 。 因 为 AddRange0 方 法 的 参数 是 
IEnumerable<T> 类 型 的 对 象 ， 所 以 也 可 以 传递 一 个 数组 ， 如 下 所 示 ( 代 码 文件 ListSamples/Program.cs): 
racers.AddRange (new Racer[] 1 


new Racer (14, "Niki"™", "Lauda™., "Austria™, 25), 
new Racer (21, "Alain™"., "Prost", "France™, 51)1}); 


注意 : 
集合 初始 值 设 定 项 只 能 在 声明 集合 时 使 用 。AddRange0 方 法 则 可 以 在 初始 化 集合 后 调用 。 如 果 在 创建 集合 
后 动态 获取 数据 ， 就 需要 调用 AddRange0)。 


如 果 在 实例 化 列表 时 知道 集合 的 元 素 个 数 ， 就 也 可 以 将 实现 IEnumerable<T> 类 型 的 任意 对 象 传递 给 类 的 构 
造 函 数 。 这 非 滑 类 似 于 AddRange0 方 法 (代码 文件 ListSamples/Program.cs): 


206 | 第 | 部 分 C# 语言 


Var Iacers = new LIL1St<RaceIr> 
new Racer[] 1 
new Racer (12, "Jochen™, "Rindt", "Austria", 6) ， 
new Racer (22, "Ayrton™"., "Senna", "Brazil", 41) 1}}); 


3. 插入 元 素 

使 用 Insert0 方 法 可 以 在 指定 位 置 插入 元 素 ( 代 码 文 件 ListSamples/Program.cs): 
racers.Insert(3, new Racer(6, "Phil"™", "Hill™, “USA™", 3)); 

方法 InsertRange0 提 供 了 插入 大 量 元 素 的 功能 ， 类 似 于 前 面 的 AddRange0 方 法 。 

如 果 索 引 集 大 于 集合 中 的 元 素 个 数 ， 就 抛 出 ArgeumentOutOfRangeException 类 型 的 异常 。 


4. 访问 元 素 

实现 了 IList 和 IIList<T> 接 口 的 所 有 类 都 提供 了 一 个 索引 器 ， 所 以 可 以 使 用 索引 器 ,通过 传递 元 素 号 来 访问 
元 素 。 第 一 个 元 素 可 以 用 索引 值 0 来 访问 。 指 定 racers[3]， 可 以 访问 列表 中 的 第 4 个 元 素 : 

Racer IT = TaCeITSs [3] :; 

可 以 使 用 Count 属性 确定 元 素 个 数 ， 再 使 用 for 循环 通 历 集合 中 的 每 个 元 素 ， 并 使 用 索引 器 访问 每 一 项 ( 代 
码 文 件 ListSamples/Program.cs): 

for (int i = 0; i < racers.Count; i++) 


Console .WriteLine (racers[1i]):; 


} 


注意 : 

可 以 通过 索引 访问 的 集合 类 有 ArrayList、StringCollection 和 List<T>，。 

因为 List<T> 集 合 类 实现 了 IEnumerable 接口 ， 所 以 也 可 以 使 用 foreach 语句 遍历 集合 中 的 元 素 ( 代 码 文件 
LlstSamples/Prosgram.cs)。 

foreach (var TI in racers) 


Console .WriteLine (r); 


} 


注意 : 
编译 器 解析 foreach 语句 时 ， 利 用 了 IEnumerable 和 IEnumerator 接口 ， 参 见 第 7 章 。 


5. 删除 元 素 

删除 元 素 时 ， 可 以 利用 索引 ， 也 可 以 传递 要 删除 的 元 素 。 下 面 的 代码 把 3 传递 给 RemoveAtO 方 法 ， 删 除 第 

racers.Removent (3); 

也 可 以 直接 将 Racer 对 象 传送 给 Remove0 方 法 ， 来 删除 这 个 元 素 。 按 索引 删除 比较 快 ， 因 为 必须 在 集合 中 
搜索 要 删除 的 元 素 。 Remove0 方 法 先 在 集合 中 搜索 , 用 IndexOf0 方 法 获取 元 素 的 索引 , 再 使 用 该 索引 删除 元 素 。 
IndexO 负 方法 先 检查 元 系 类 型 是 否 实 现 了 IEquatable<T> 接 口 。 如 果 是 ， 就 调用 这 个 接口 的 Equals0 方 法 ， 确 定 
集合 中 的 元 素 是 否 等 于 传递 给 Equals(0 方 法 的 元 素 。 如 果 没 有 实现 这 个 接口 , 就 使 用 Object 类 的 Equals0 方 法 比 
较 这 些 元 素 。Object 类 中 Equals0 方 法 的 默认 实现 代码 对 值 类 型 进行 按 位 比较 ， 对 引用 类 型 只 比较 其 引用 。 


第 8 章 介 绍 了 如 何 重 写 Equals0 方 法 。 
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这 里 从 集合 中 删除 了 变量 graham 引用 的 赛车 手 。 变 量 graham 是 前 面 在 填充 集合 时 创建 的 。 因 为 
IEquatable<T> 接 口 和 Object.Equals0 方 法 都 没有 在 Racer 类 中 重 写 , 所 以 不 能 用 要 删除 元 素 的 相同 内 容 创建 一 个 
新 对 象 ， 再 把 它 传 递 给 Remove0 方 法 (代码 文件 ListSamples/Program.cs)。 

if (!racers.Remove (graham)) 


| 


Console.WriteLine ("object not found in collection™); 


RemoveRange0 方 法 可 以 从 集合 中 删除 许多 元 素 。 它 的 第 一 个 参数 指定 了 开始 删除 的 元 素 罕 引 ， 第 二 个 参 
数 指定 了 要 删除 的 元 紊 个 数 。 
int index = 3; 


int count = Ss; 
racers.RemoveRange (index, count).; 


要 从 集合 中 删除 有 指定 特性 的 所 有 元 素 ， 可 以 使 用 RemoveAll0 方 法 。 这 个 方法 在 搜索 元 素 时 使 用 下 面 将 
讨论 的 Predicate<T> 人 参数 。 要 删除 集合 中 的 所 有 元 素 ， 可 以 使 用 ICollection<T> 接 口 定 义 的 Clear0 方 法 。 

6. 搜索 

有 不 同 的 方式 在 集合 中 搜索 元 素 。 可 以 获得 要 查找 的 元 素 的 索引 ， 或 者 搜索 元 素 本 身 。 可 以 使 用 的 方法 有 
IndexoOf0、LastmdexofO0、FindmdexO0、FindLastmdex0、Find0 和 FindLastO0。 如 果 只 检查 元 素 是 否 存在 ，List<T> 
类 就 提供 了 Exists0 方 法 。 

IndexOfi 方 法 需要 将 一 个 对 象 作为 参数 ， 如 果 在 集合 中 找到 该 元 素 ， 这 个 方法 就 返回 该 元 素 的 索引 。 如 果 没 
有 找到 该 元 素 ， 就 返回 -1。IndexOf0 方 法 使 用 IEquatable<T> 接 口 来 比较 元 素 (代码 文件 ListSamples/Prosgram .cs)。 

int indexl] = racers.Indexof (mario); 

使 用 mmdexOf0 方 法 ， 还 可 以 指定 不 需要 搜索 整个 集合 ， 但 必须 指定 从 哪个 索引 开始 搜索 以 及 比较 时 要 迭代 
的 元 素 个 数 。 

除了 使 用 IndexOf0 方 法 搜索 指定 的 元 素 之 外 ， 还 可 以 搜索 有 某 个 特性 的 元 素 ， 该 特性 可 以 用 FindImdex0 
方法 来 定义 。FindIndex0 方 法 需要 一 个 Predicate 类 型 的 参数 ; 

public int FindIindex (Predicate<T> match).; 

Predicate<T> 头 型 是 一 个 委托 ， 该 委托 返回 一 个 布尔 值 ， 并 且 需 要 把 类 型 T 作为 参数 。 如 果 Predicate<T> 委 
托 返回 tue， 就 表示 有 一 个 匹配 元 素 ， 并 且 找 到 了 相应 的 元 素 。 如 果 它 返回 包 lse， 就 表示 没有 找到 元 素 ， 搜 索 

public delegate bool Predicate<T> (T ob]j):; 

在 List<T> 类 中 , 把 Racer 对 象 作为 类 型 T， 所 以 可 以 将 一 个 方法 (该 方法 将 类 型 Racer 定义 为 一 个 参数 且 返 
回 一 个 布尔 值 ) 的 地 址 传递 给 FindIndex0 方 法 。 查 找 指定 国家 的 第 一 个 赛车 手 时 ， 可 以 创建 如 下 所 示 的 
FindCountry 类 。FindCountryPredicate0 方 法 的 签名 和 返回 类 型 通过 Predicate<T> 委 托 定 义 。Find0 方 法 使 用 变量 
country 搜索 用 FindCountry 类 的 构造 函数 定义 的 某 个 国家 (代码 文件 ListSamples/FindCountry.cs)。 


Public class FindCountry 


Public FindCountry(string country) => country = country; 
private string country; 
Public bool FindCountryPredicate (Racer racer) 三 > 


racer?.Country == country; 


} 

使 用 FindIndex0 方 法 可 以 创建 FindCountry 类 的 一 个 新 实例 ， 把 表示 一 个 国家 的 字符 串 传递 给 构造 函数 ， 
再 传递 Find0 方 法 的 地 址 , 在 下 面 的 示例 中 , FindIndex0 方 法 成 功 完 成 后 , index2 就 包含 集合 中 赛车 手 的 Country 
属性 设置 为 Finland 的 第 一 项 的 案 引 (代码 文件 ListSamples/Program .cs)。 


int index2 = racers.FindIndex (new FindCountry("Finland") .FindCountryPredicate).; 
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除了 用 处 理 程序 方法 创建 类 之 外 ， 还 可 以 在 这 里 创建 lambda 表达 式 。 结 果 与 前 面 完 全 相同 。 现 在 lambda 表 
达 式 定义 了 实现 代码 ， 来 搜索 Country 属性 设置 为 Finland 的 元 素 。 

int index3 = racers.FindIindex(r => Ir.Country == "FInland") ; 

与 IndexOf0 方 法 类 似 ,使 用 FindIndex0 方 法 也 可 以 指定 搜索 开始 的 索引 和 要 遍历 的 元 素 个 数 。 为 了 从 集合 
中 的 最 后 一 个 元 素 开 始 同 前 搜索 某 个 索引 ， 可 以 使 用 FindLastIndex( 方 法 。 

FindIndex0 方 法 返回 所 查找 元 素 的 索引 。 除 了 获得 索引 之 外 ， 还 可 以 直接 获得 集合 中 的 元 素 。Find0 方 法 需 
要 一 个 Predicate<T> 类 型 的 参数 ， 这 与 FindIndex0 方 法 类 似 。 下 面 的 Find0 方 法 搜索 列表 中 FirstName 属性 设置 
为 Niki 的 第 一 个 赛车 手 。 当 然 ， 也 可 以 实现 FindLast0 方 法 ， 查 找 与 Predicate<T> 类 型 匹配 的 最 后 一 项 。 

Racer racer = racers.Findi{r => Ir.FirstName == "Niki"™); 

要 获得 与 Predicate<T> 类 型 匹配 的 所 有 项 ， 而 不 是 一 项 ， 可 以 使 用 FindAll0 方 法 。FindAll0 方 法 使 用 的 
Predicate<T> 委 托 与 Find0 和 FindImndex0 方 法 相同 。FindAl10 方 法 在 找到 第 一 项 后 ， 不 会 停止 搜索 ， 而 是 继续 迭 
代 集 合 中 的 每 一 项 ， 并 返回 Predicate<T> 类 型 是 true 的 所 有 项 。 

这 里 调用 了 FindAll0 方 法 ， 返 回 Wins 属性 设置 为 大 于 20 的 整数 的 所 有 racer 项 。 从 bigWinners 列表 中 引 
用 所 有 赢得 超过 20 场 比 赛 的 赛车 手 。 

List<Racer> bigWinners = Tacers-Findall(T => r.Wins > 20) ; 

用 foreach 语句 遍历 bigWinners 变量 ， 结 果 如 下 : 

foreach (Racer Ir in bigWinners) 


Console .WriteLine (S$"{r:A}"):; 
} 
Michael Schumacher, Germany Wins: 91 
Niki Lauda, Austria Wins: 25 
Alain Prost, France Wins: 51 


这 个 结果 没有 排序 ， 但 这 是 下 一 步 要 做 的 工作 。 


注意 : 

格式 修饰 符 和 IFormattable 接口 参见 第 9 章 。 

7. 排序 

List<T> 类 可 以 使 用 Sort0 方 法 对 元 素 排序 。Sort0 方 法 使 用 快速 排序 算法 ， 比 较 所 有 的 元 素 ， 直 到 整个 列表 
排 好 序 为 止 。 

Sort0 方 法 使 用 了 几 个 重 载 的 方法 。 可 以 传递 给 它 的 参数 有 泛 型 委托 Comparison<T> 和 泛 型 接口 
IComparer<T>， 以 及 一 个 范围 值 和 泛 型 接口 IComparer<T>。 

public void List<T>.Sort(); 

PUublic void List<T>.Sort (Compar1Ison<T>) ; 


Pupblic wvoid List<T>.Sort(IComparer<T>); 
Public void List<T>.Sort (Int32, Int32, IComparer<T>); 


只 有 集合 中 的 元 素 实 现 了 IComparable 接口 ， 才 能 使 用 不 带 参数 的 Sort0 方 法 。 

Racer 类 实现 了 IComparable<T> 接 口 ， 可 以 按 姓 氏 对 赛车 手 排序 : 

racers.Sort({}); 

如 果 需 要 按照 元 素 类 型 不 默认 支持 的 方式 排序 ， 就 应 使 用 其 他 技术 , 例如， 传递 一 个 实现 了 IComparer<T> 
接口 的 对 象 。 

RacerComparer 类 为 Racer 类 型 实现 了 接口 IComparer<T>。 这 个 类 人 允许 按 名 字 、 姓 氏 、 国 籍 或 获胜 次 数 
排序 。 排 序 的 种 类 用 内 部 枚 举 类 型 CompareType 定义 。CompareType 枚 举 类 型 用 RacerComparer 类 的 构造 函 
数 设置 。IComparer<Racer> 接 口 定义 了 排序 所 需 的 Compare0 方 法 。 在 这 个 方法 的 实现 代码 中 ， 使 用 了 string 
和 int 类 型 的 CompareTo0 方 法 (代码 文件 ListSamples/RacerComparer.cs)。 

public class RacerComparer : IComparer<Racer> 


{ 
public enum CompareType 
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FirstName, 
LastName, 
Country, 
Wins 
} 站 
private CompareType compareTyper 
Public RacerComparer (CompareType compareType) 
{ 
_CompareType = CompPareTYpPer 


} 


Public int Compare (Racer XxX, Racer Y) 


{ 


if {x == null && Y == null) return 0; 
if (KK == null)y return 一 1: 
IE (yy == null) return 1; 


int result:; 
switch ( compareType) 
{ 
case CompareType.FirstName: 
return string.Compare (x.FirstName, Yy.FirstName),; 
Case ComareTyYpe .LastName: 
return string.Ccompare (x.LastName, Yy.LastName); 
Case CompareType.Country: 
result = string.Compare (x.Country, Yy.Country); 


if result == 0}) 
return string.Compare (x.LastName, Yy.LastName).; 
lse 


return results; 

Case CompareType.Wins: 
return XxX.Wins.CcompareTo(y.Wins); 

default: 
throw new ArgumentException("Invalid Compare Type"™); 

} 
} 
} 


注意 : 

如 果 传 递 给 Compare 方法 的 两 个 元 素 的 顺序 相同 ， 该 方法 则 返回 0。 如 果 返 回 值 小 于 0， 说 明 第 一 个 参数 
小 于 第 二 个 参数 ; 如 果 返 回 值 大 于 0， 则 第 一 个 参数 大 于 第 二 个 参数 。 传递 null 作为 参数 时 ，Compare 方法 并 
不 会 抛 出 一 个 NullReferenceException 异常 。 相 反 ， 因 为 null 的 位 置 在 其 他 任何 元 素 之 前 ， 所 以 如 果 第 一 个 参数 
为 null， 该 方法 返回 -1， 如 果 第 二 个 参数 为 null， 则 返回 +1。 


现在 ,可 以 对 RacerComparer 类 的 一 个 实例 使 用 Sort0 方 法 ,传递 枚 举 RacerComparer CompareType.Country， 
按 属性 Country 对 集合 排序 : 

racers.Sort (new RacerComparer (RacerCcomparer.CompareType.Country)); 

排序 的 另 一 种 方式 是 使 用 重 载 的 Sort0 方 法 ， 该 方法 需要 一 个 Comparison<T> 委 托 : 

public void List<T>.Sort (Comparison<T>) ; 

Comparison<T> 是 一 个 方法 的 委托 ， 该 方法 有 两 个 T 类 型 的 参数 ， 返 回 类 型 为 int。 如 果 参 数值 相等 ， 该 
方法 就 必须 返回 0。 如 果 第 一 个 参数 比 第 二 个 小 ， 它 就 必须 返回 一 个 小 于 0 的 值 ， 否则 ， 必 须 返 回 一 个 大 于 
0 的 值 。 

public delegate int Comparison<T>(T x, T y); 

现在 可 以 把 一 个 lambda 表达 式 传递 给 Sort0 方 法 ， 按 获胜 次 数 排序 。 两 个 参数 的 类 型 是 Racer， 在 其 实现 
代码 中 ， 使 用 int 类 型 的 CompareTo0 方 法 比较 Wins 属性 。 在 实现 代码 中 ， 因 为 以 逆序 方式 使 用 r2 和 rl1， 所 以 
获胜 次 数 以 降序 方式 排序 。 调 用 方法 之 后 ， 完 整 的 赛车 手 列 表 就 按 竟 车 手 的 获胜 次 数 排序 。 

racers.Sort( (rl, r2) => r2.Wins.CompareTo (rl.Wins)); 


也 可 以 调用 Reverse0 方 法 ， 逆 转 整 个 集合 的 顺序 。 
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10.3.2 ”只 读 集 合 


创建 集合 后 ， 它 们 就 是 可 读 写 的 ， 否 则 就 不 能 给 它们 填充 值 了。 但 是 ， 在 填充 完 集 合 后 ， 可 以 创建 只 读 集合 。 
List<T> 集 合 的 AsReadOnly0 方 法 返回 ReadOnlyCollection<T> 类 型 的 对 象 。ReadOnlyCollection<T> 类 实现 的 接口 与 
List<T> 集 合 相同 ， 但 所 有 修改 集合 的 方法 和 属性 都 抛 出 NotSupportedException 异常 。 除 了 List<T> 的 接口 之 外 ， 
ReadOnlyCollection<T> 还 实现 了 IReadOnlyCollection<T> 和 IReadOnlyList<T> 接 口 。 因 为 这 些 接口 的 成 员 , 集合 不 


10.4 ”队列 


队列 是 其 元 素 以 先进 先 出 (FirstIn, FirstOut, FIFO) 的 方式 来 处 理 的 集合 。 先 放 入 队列 中 的 元 素 会 先 读 取 。 队 
列 的 例子 有 在 机 场 排 的 队列 、 人 力 资 源 部 中 等 竺 处 理 求 职 信 的 队列 和 打印 队列 中 等 待 处理 的 打印 任务 ， 以 及 按 
循环 方式 等 待 CPU 处 理 的 线程 。 另 外 ， 还 常常 有 元 素 根 据 其 优先 级 来 处 理 的 队列 。 

例如 ， 在 机 场 的 队列 中 ， 商 务 舱 乘客 的 处 理 要 优先 于 经 济 舱 的 乘客 。 这 里 可 以 使 用 多 个 队列 ， 一 个 队列 对 
应 一 个 优先 级 。 在 机 场 ， 这 很 常见 ， 因 为 商务 舱 乘 客 和 经 济 舱 乘客 有 不 同 的 登记 队列 。 打 印 队列 和 线程 也 是 这 
样 。 可 以 为 一 组 队列 建立 一 个 数组 , 数组 中 的 一 项 代表 一 个 优先 级 ,在 每 个 数组 项 中 都 有 一 个 队列 , 其 中 按照 FIFO 
的 方式 进行 处 理 。 


注意 : 

本 章 的 后 面 将 使 用 链表 的 另 一 种 实现 方式 来 定义 优先 级 列表 。 

队列 使 用 System.Collections.Genelic 名 称 空间 中 的 泛 型 类 Queue<T> 实 现 。 在 内 部 ，Queue<T> 类 使 用 T 类 
型 的 数组 , 这 类 似 于 List<T=> 类 型 。 它 实现 ICollection 和 IEnumerable<T> 接 口 , 但 没有 实现 ICollection<T= 接 口 ， 
为 这 个 接口 定义 的 Add0 和 Remove0 方 法 不 能 用 于 队列 。 

因为 Queue<T> 类 没有 实现 IList<T> 接 口 ， 所 以 不 能 用 索引 器 访问 队列 。 队 列 只 允许 在 队列 中 添加 元 素 ， 
该 元 条 会 放 在 队列 的 尾部 (使 用 Enqueue0 方 法 )， 从 队列 的 头 部 获取 元 素 ( 使 用 Dequeue0 方 法 )。 

图 10-1 显示 了 队列 的 元 素 。Enqueue0 方 法 在 队列 的 一 端 添 加 元 率 ，Dequeue0 方 法 在 队列 的 另 一 端 读 取 和 
删除 元 素 。 再 次 调用 Dequeue0 方 法 ， 会 删除 队列 中 的 下 一 项 。 


Enqueue Dequeue 


图 10-1 
Queue<T> 类 的 方法 如 表 10-2 所 示 。 


表 10-2 
Queue<T> 类 的 成 员 说 明 
Count Count 属性 返回 队列 中 的 元 素 个 数 
Enqueue0 方 法 在 队列 一 端 添 加 一 个 元 素 
Dequeue Dequeue0) 方 法 在 队列 的 头 部 读 取 和 删除 元 素 。 如 果 在 调用 Dequeue0 方 法 时 ， 队 列 中 不 再 有 
元 素 ， 就 抛 出 一 个 InvalidOperationException 类 型 的 异常 
Peek Peek0 方 法 从 队列 的 头 部 读 取 一 个 元 素 ， 但 不 删除 它 
TrimEXcess TrimExcess0 方 法 重新 设置 队列 的 容量 。Dequeue0 方 法 从 队列 中 删除 元 素 ， 但 它 不 会 重新 设 


置 队列 的 容量 。 要 从 队列 的 头 部 去 除 空 元 素 ， 应 使 用 TrimExcess0 方 法 
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在 创建 队列 时 ， 可 以 使 用 与 List<T> 类 型 类 似 的 构造 函数 。 虽 然 默认 的 构造 函数 会 创建 一 个 空 队 列 ， 但 也 可 
以 使 用 构造 函数 指定 容量 。 在 把 元 素 添加 到 队列 中 时 ， 如 果 没 有 定义 容量 ， 容 量 就 会 递增 ， 从 而 包含 4、8、16 
和 32 个 元 素 。 类 似 于 List<T> 类 ， 队 列 的 容量 也 总 是 根据 需要 成 倍增 加 。 非 泛 型 类 Queue 的 默认 构造 函数 与 此 
不 同 ， 它 会 创建 一 个 包含 32 项 空 的 初始 数组 。 使 用 构造 函数 的 重 载 版 本 ， 还 可 以 将 实现 了 IEnumerable<T> 接 
口 的 其 他 集合 复制 到 队列 中 。 
下 面 的 文档 管理 应 用 程序 示例 说 明了 Queue<T> 类 的 用 法 。 使 用 一 个 线程 将 文档 添加 到 队列 中 ， 用 另 一 个 
线程 从 队列 中 读 取 文档 ， 并 处 理 它们 。 
存储 在 队列 中 的 项 是 Document 类 型 .Document 类 定义 了 标题 和 内 容 ( 代 码 文 件 QueueSample/Document.cs): 
public class Document 
| public string Title { get; } 
public string Content { get; } | : 
public Document (string title, string content) 
0 = title; 


} 
} 


DocumentManager 类 是 Queue<T> 类 外 面 的 一 层 。DocumentManager 类 定义 了 如 何 处 理 文档 : 用 
AddDocument0 方 法 将 文档 添加 到 队列 中 ， 用 GetDocumentO 方 法 从 队列 中 获得 文档 。 

在 AddDocument0 方 法 中 ,用 Enqueue0 方 法 把 文档 添加 到 队列 的 尾部 。 在 GetDocument0 方 法 中 ,用 Dequeue0 
方法 从 队列 中 读 取 第 一 个 文档 。 因 为 多 个 线程 可 以 同时 访问 DocumentManager 类 ,所 以 用 lock 语句 锁定 对 队列 
的 访问 。 


注意 : 
线程 和 lock 语句 参见 第 21 章 。 


IsDocumentAvailable 是 一 个 只 读 类 型 的 布尔 属性 ， 如 果 队 列 中 还 有 文档 ， 它 就 返回 bue， 否 则 返回 false( 代 
人 码 文 件 QueueSample/DocumentManager.cs)。 


Public class DocumentManager 
{ 
private readonly object syncQueue = new DOb]ect () : 
private readonly Queue<Document> documentQueue = new Queue<Document> (}); 


Public void AddDocument (Document doc) 
{ 
lock ( syncQueue) 
{ 
documentQueue .Enqueue (Goc) / 
} 
} 


public Document GetDocument () 


Document doc = null: 
lock ( syncQueue) 


{ 
doc = documentQueue.Dequeue () ; 
} 
return docs 
} 


Public bool IsDocumentAvalilable => documentQueue.Count > 0; 


ProcessDocuments 类 在 一 个 单独 的 任务 中 处 理 队 列 中 的 文档 。 能 从 外 部 访问 的 唯一 方法 是 Start0。 在 Start0 
方法 中 ， 实 例 化 了 一 个 新 任务 。 创 建 一 个 ProcessDocuments 对 象 ， 来 启动 任务 ， 定 义 Run0) 方 法 作为 任务 的 启 
动 方 法 。TaskFactory( 通 过 Task 类 的 静态 属性 Factory 访问 ) 的 StartNew 方法 需要 一 个 Action 委托 作为 参数 ， 用 
于 接受 Run 方法 传递 的 地 址 。TaskFactory 的 StartNew 方法 会 立即 启动 任务 。 

使 用 ProcessDocuments 类 的 Run0 方 法 定义 一 个 无 限 循环 。 在 这 个 循环 中 ， 使 用 属性 IsDocumentAvailable 


212 | 第 1 部 分 C# 语 言 


确定 队列 中 是 否 还 有 文档 。 如 果 队 列 中 还 有 文档 ， 就 从 DocumentManager 类 中 提取 文档 并 处 理 。 这 里 的 处 理 仅 
是 把 信息 写 入 控制 台 。 在 真正 的 应 用 程序 中 ， 文 档 可 以 写 入 文件 、 数 据 库 ， 或 通过 网 络 发送 ( 代 码 文 件 
QueueSample/ProcessDocuments.cs).。 


Public class ProcessDocuments 
{ 
public static Task Start (DocumentManager dm) 三 > 
Task.Run(new ProcessDocuments (dm) .Run); 


protected ProcessDocuments (DocumentManager dm} 一 > 
documentManager = dm 2? throw new ArgumentNullExcption (nameof (dm) }); 


private DocumentManager documentManager; 


protected asvync Task Runt) 
{ 
while (true) 
{ 
if ( documentManager.IsDocumentAvailable) 
{ 
Document doc = documentManager.GetDocument (}; 
Console.WriteLine ("Processing document {0}", doc.Title}); 
} 
await Task.Delay (lnew Random() .Next (20)); 
} 
} 
} 


在 应 用 程序 的 Main0 方 法 中 ， 实 例 化 一 个 DocumentManager 对 象 ， 启 动 文档 处 理 任务 。 接 着 创建 1000 个 
文档 ， 并 添加 到 DocumentManager 对 象 中 (代码 文件 QueueSample/Program.cs): 


Public class Program 

{ 
public static async Task Main() 
{ 


Var dm = new DocumentManager (}}; 
Task processDocuments = ProcessDocuments.Sstart (dm); 


// Create documents and add them to the DocumentManager 
for {int 1 = 0; 1 < 1000; I++) 
{ 
Var doc = new Document ($"Doc {i.ToString()}", "content™),; 
dm.AddDocument (doc}); 
Console .WriteLine{($"Added document {doc.Title}"™").; 
awalit Task.Delay (new Random() .Next (20)); 
} 
awalt processDocuments; 
Console.ReadLine{().; 


注意 : 
使 用 QueueSample， 可 以 声明 Main0 方 法 来 返回 一 个 任务 。 该 特性 至 少 需要 C# 7.1。 异 步 的 Main0 方 法 详 
见 第 15 章 。 


在 局 动 应 用 程序 时 ， 会 在 队列 中 添加 和 删除 文档 ， 输 出 如 下 所 示 : 


Added document Doc 279 
Processing document Doc 236 
Added document Doc 280 
Processing document Doc 237 
Added document Doc 281 
Processing document Doc 238 
Processing document Doc 239 
Processing document Doc 240 
Processing document Doc 241 
Added document Doc 282 
Processing document Doc 242 
Added document Doc 283 
Processing document Doc 243 
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完成 示例 应 用 程序 中 描述 的 任务 的 真实 程序 可 以 处 理 用 Web 服务 接收 到 的 文档 。 
10.5 栈 


栈 是 与 队列 非常 类 似 的 男 一 个 容器 ， 只 是 要 使 用 不 同 的 方法 访问 栈 。 最 后 添加 到 栈 中 的 元 素 会 最 先 读 取 。 
栈 是 一 个 后 进 先 出 (LastIn, FirstOut, LIFO) 的 容器 。 
图 10-2 表示 一 个 栈 ， 用 Push0 方 法 在 栈 中 添加 元 素 ， 用 Pop0 方 法 获取 最 近 添 加 的 元 素 。 


Push Pop 


图 10-2 


与 Queue<T> 类 相似 ，Stack<T=> 类 实现 IEnumerable<T> 和 ICollection 接口 。 
Stack<T> 类 的 成 员 如 表 10-3 所 示 。 


表 10-3 
Stack<T> 类 的 成 员 说 有明 
Count 返回 栈 中 的 元 素 个 数 
Push 在 栈 顶 添 加 一 个 元 素 
Pop 从 栈 顶 删除 一 个 元 素 ， 并 返回 该 元 素 。 如 果 栈 是 空 的 ， 就 抛 出 InvalidOperationException 异常 
Peek 返回 栈 顶 的 元 素 ， 但 不 删除 它 
Contains 确定 某 个 元 素 是 否 在 栈 中 ， 如 果 是 ， 就 返回 te 


在 下 面 的 例子 中 ， 使 用 Push0 方 法 把 3 个 元 素 添 加 到 栈 中。 在 foreach 方法 中 ， 使 用 IEnumerable 接口 运 代 
所 有 的 元 素 。 栈 的 枚 举 器 不 会 删除 元 素 ， 它 只 会 逐个 返回 元 素 ( 代 码 文件 StackSample/Program.cs)。 

var alphabet = new Stack<char> (); 

alphabet.Push('A'}); 

alphabet .Push{('B')}); 

alphabet.Push(c"'); 

foreach (char item in alphabet) 

{ 

Console.Write (item); 
} 


Console .WriteLine (); 

因为 元 素 的 读 取 顺 序 是 从 最 后 一 个 添加 到 栈 中 的 元 素 开始 到 第 一 个 元 素 ， 所 以 得 到 的 结果 如 下 : 

用 枚 举 器 读 取 元 素 不 会 改变 元 素 的 状态 。 使 用 Pop0 方 法 会 从 栈 中 读 取 每 个 元 素 ， 然后 删除 它们 。 这 样 ， 就 
可 以 使 用 while 循环 人 迭 代 和 集合 ， 检 查 Count 属性 ， 确 定 栈 中 是 否 还 有 元 素 : 


var alphabet = new Stack<char> (); 
alphabet.Push("'A')}); 
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alphabet .PuSsSh('B'); 
alphabet .Push(C"); 
Console .Write ("First iteration: ™).; 
foreach (char item in alphabet) 
Console .Write (item).; 
} 
Console.WriteLine (}); 
Console.Write ("Second iteration: ™); 
while (alphabet.Count > 0) 
Console .Write (alphabet .Pop () ) ; 
} 
Console .WriteLine (}); 


结果 是 两 个 CBA, 每 次 迭代 对 应 一 个 CBA。 在 第 二 次 迭代 后 ， 栈 变 空 ， 因 为 第 二 次 迭代 使 用 了 Pop0 方 法 : 


First iteration: CBA 
Second iteration: CEA 


10.6 ”链表 
LinkedList<T> 是 一 个 双向 链表 ， 其 元 素 指向 它 前 面 和 后 面 的 元 素 ， 如 图 10-3 所 示 。 这 样 一 来 ， 通 过 移 
动 到 下 一 个 元 素 可 以 正 向 遍历 整个 链表 ， 通 过 移动 到 前 一 个 元 素 可 以 反 向 遍历 整个 链表 。 


Mext Mext Mext 


Previous Previous Previous Previous 


图 10-3 


链表 的 优点 是 ， 如 果 将 元 素 插入 列表 的 中 间 位 置 ， 使 用 链表 就 会 非 沼 快 。 在 插入 一 个 元 素 时 ， 只 需要 修改 
上 一 个 元 系 的 Next 引用 和 下 一 个 元 娟 的 Previous 引用 ， 使 它们 引用 所 插入 的 元 素 。 在 List<T> 类 中 ， 插入 一 个 
元 素 时 ， 需 要 移动 该 元 素 后 面 的 所 有 元 素 。 

当然 ， 链 表 也 有 缺点 。 链 表 的 元 素 只 能 一 个 接 一 个 地 访问 ， 这 需要 较 长 的 时 间 来 得 找 位 于 链表 中 间或 尾部 
的 元 素 。 

链表 不 能 在 列表 中 仅 存 储 元 素 。 存 储 元 素 时 ， 链 表 还 必须 存储 每 个 元 素 的 下 一 个 元 素 和 上 一 个 元 素 的 信息 。 
这 就 是 LinkedList<T> 包 含 LinkedListNode<T> 类 型 的 元 素 的 原因 。 使 用 LinkedListNode<T> 类 ， 可 以 获得 列表 中 
的 下 一 个 元 素 和 上 一 个 元 素 。LinkedListNode<T> 定 义 了 属性 List、Next、Previous 和 Value。List 属性 返回 与 节 
点 相关 的 LinkedList<T> 对 象 ，Next 和 Previous 属性 用 于 遍历 链表 ， 访 问 当 前 节点 之 后 和 之 前 的 节操 。Value 返 
回 与 节点 相关 的 元 素 ， 其 类 型 是 工 。 

LinkedList<T> 类 定义 的 成 员 可 以 访问 链表 中 的 第 一 个 和 最 后 一 个 元 素 (First 和 Last)、 在 指定 位 置 插入 元 系 
(AddAfter0、AddBefore0 、AddFirst0 和 AddLast0 方 法 )， 删 除 指定 位 置 的 元 素 (Remove0 、RemoveFirstO 和 
RemoveLast() 方 法 )、 从 链表 的 开头 (Find0 方 法 ) 或 结尾 (FindLast0 方 法 ) 开 始 搜 索 元 素 。 

示例 应 用 程序 使 用 了 一 个 链表 和 一 个 列表 。 链 表 包 含 文档 ， 这 与 上 一 个 队列 例子 相同 ， 但 文档 有 一 个 额外 
的 优先 级 。 在 链表 中 ， 文 档 按照 优先 级 来 排序 。 如 果 多 个 文档 的 优先 级 相同 ， 这 些 元 素 就 按照 文档 的 插入 时 间 
来 排序 。 

图 10-4 描述 了 示例 应 用 程序 中 的 集合 。LinkedList<Document> 是 一 个 包含 所 有 Document 对 象 的 链表 ， 该 
图 显示 了 文档 的 标题 和 优先 级 。 标 题 指出 了 文档 添加 到 链表 中 的 时 间 。 第 一 个 添加 的 文档 的 标题 是 “One”。 第 
二 个 添加 的 文档 的 标题 是 “Two”， 依 此 类 推 。 可 以 看 出 , 文档 One 和 Four 有 相同 的 优先 级 8， 因 为 One 在 Four 
之 前 添加 ， 所 以 One 放 在 链表 的 前 面 。 

在 链表 中 添加 新 文档 时 ， 它 们 应 放 在 优先 级 相同 的 最 后 一 个 文档 后 面 。 集 合 LinkedList<Documen 亿 包含 
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LinkedListrNode<Document> 类 型 的 元 素 。LinkedListNode<T> 类 添加 Next 和 Previous 属性 ， 使 搜索 过 程 能 从 一 
个 节点 移动 到 下 一 个 节点 上 。 要 引用 这 类 元 素 ， 应 把 List<T> 定 义 为 List<LinkedListNode<Document>>。 为 了 快 
速 访问 每 个 优先 级 的 最 后 一 个 文档 ,集合 List<LinkedList Node> 应 最 多 包含 10 个 元 素 ， 每 个 元 素 分 别 引 用 每 个 
优先 级 的 最 后 一 个 文档 。 在 后 面 的 讨论 中 ， 对 每 个 优先 级 的 最 后 一 个 文档 的 引用 称 为 优先 级 节点 。 


LinkedList<Document> 


List<LinkedListMode<Document>> 


-| | 3 多 
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图 10-4 


在 上 面 的 例子 中 , Document 类 扩展 为 包含 优先 级 ,优先 级 用 类 的 构造 函数 设置 (代码 文件 LinkedListSample/ 
Document.cs): 


public class Document 
{ 
PUublic string Title { get; } 
PUublic string Content { get; } 
Public byte Priority { get; } 
Public Document (string title, string content, byte priority) 


{ 


Title = title; 

Content = content,; 

Priority = priority; 
} 


} 

解决 方案 的 核心 是 PriorityDocumentManager 类 。 这 个 类 很 容易 使 用 。 在 这 个 类 的 公共 接口 中 ， 可 以 把 新 的 
Document 元 素 添 加 到 链表 中 ， 可 以 检索 第 一 个 文档 ， 为 了 便于 测试 ， 它 还 提供 了 一 个 方法 ， 在 元 素 链 接 到 链表 
中 时 ， 该 方法 可 以 显示 集合 中 的 所 有 元 素 。 

PriorityDocumentManager 类 包含 两 个 集合 。LinkedList<Document> 类 型 的 集合 包含 所 有 的 文档 。 
List<LinkedListNode<Document>> 类 型 的 集合 包含 最 多 10 个 元 素 的 引用 ， 它 们 是 添加 指定 优先 级 的 新 文档 的 入 
口 点 。 这 两 个 集合 变量 都 用 PriorityDocumentManager 类 的 构造 国 数 来 初始 化 。 列 表 集 合 也 用 null 初始 化 (代码 
文件 LinkedListSample/PriorityDocumentManager.cs): 


public class PriorityDocumentManager 


| 
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private readonly LinkedList<Document> documentList; 
// priorities 0.9 
private readonly List<LinkedListNode<Document>> priorityNodes; 
public PriorityDocumentManager () 
| 
documentList = new LinkedList<Document> ().; 
priorityNodes = new List<LinkedListNode<Document>> (101) :; 
for (int i = 0; i < 10; I++) 
{ 
_PriorityNodes.Add (new LinkedListNode<Document> (null)); 
} 
} 


在 类 的 公共 接口 中 ， 有 一 个 AddDocument0O 方法 。AddpDpocument0O 方法 只 调用 私有 方法 
AddDocumentIoPriorityNode0。 把 实现 代码 放 在 另 一 个 方法 中 的 原因 是 ，AddDocumentToPriorityNode0) 方 法 可 
以 递归 调用 ， 如 后 面 所 示 。 

public void addpocument (Document d) 

(d == null) throw new ArgumentNullException (nameof (d)); 


AddDocumentToPriorityNode (d, d.Priority); 
} 


在 AddDocumentIoPriorityNode0 方 法 的 实现 代码 中 , 第 一 个 操作 是 检查 优先 级 是 否 在 允许 的 优先 级 范围 内 。 
这 里 允许 的 范围 是 0~9。 如 果 传 送 了 错误 的 值 ， 束 会 抛 出 一 个 ArgumentException 类 型 的 异常 。 

接着 检查 是 否 已 经 有 一 个 优先 级 节点 与 所 传送 的 优先 级 相同 。 如 果 在 列表 集合 中 没有 这 样 的 优先 级 节点 ， 
就 递归 调用 AddDocumentIoPriorityNode0 方 法 ， 递 减 优 先 级 值 ， 检 查 是 否 有 低 一 级 的 优先 级 节点 。 

如 果 优 先 级 节点 的 优先 级 值 与 所 传送 的 优先 级 值 不 同 ， 也 没有 比 该 优先 级 值 更 低 的 优先 级 节点 ， 就 可 以 调 
用 AddLast0 方 法 , 将 文档 安全 地 添加 到 链表 的 末尾 。 另 外 , 链表 节点 由 负责 指定 文档 优先 级 的 优先 级 节点 引用 。 

如 果 存 在 这 样 的 优先 级 节点 ， 就 可 以 在 链表 中 找到 插入 文档 的 位 置 。 这 里 必须 区 分 是 存在 指定 优先 级 值 的 
优先 级 节点 ， 还 是 存在 以 较 低 的 优先 级 值 引 用 文档 的 优先 级 节点 。 对 于 第 一 种 情况 ， 可 以 把 新 文档 插入 由 优先 
级 节点 引用 的 位 置 后 面 。 因 为 优先 级 节点 总 是 引用 指定 优先 级 值 的 最 后 一 个 文档 ， 所 以 必须 设置 优先 级 节点 的 
引用 。 如 果 引 用 文档 的 优先 级 节点 有 较 低 的 优先 级 值 ， 情 况 就 会 比较 复杂 。 这 里 新 文档 必须 插入 优先 级 值 与 优 
先 级 节点 相同 的 所 有 文档 的 前 面 。 为 了 找到 优先 级 值 相同 的 第 一 个 文档 ， 要 通过 一 个 while 循环 ,使 用 Previous 
属性 遍历 所 有 的 链表 记 点 ， 直 到 找到 一 个 优先 级 值 不 同 的 链表 节点 为 止 。 这 样 ， 就 找到 了 必须 插入 文档 的 位 置 ， 
并 可 以 设置 优先 级 节点 。 

private void AddDocumentToPriorityNode (Document doc, int priority) 

if (priority > 9 || priority < 0) 

throw new ArgumentException ("Priority must be between 0 and 9"); 
i ( priorityNodes [priority] .Value == null) 


——prliority; 
if {priority <= 0) 


// check for the next lower priority 
AddDocumentToPIriorityNode (doc, priority); 

} 

else // now no priority node exists with the same priority or lower 
// add the new document to the end 

{ 
documentList.AddLast (doc)}); 
_PriorityNodes[doc.Priority] = documentList.Last; 

} 


returns; 


else // a priority node exists 


{ 
LinkedListNode<Document> prioNode = priorityNodes[priority]; 
if (priority == doc.Priority) 
// priority node with the same priority exists 
{ 


documentList.AddAfter (prioNode, doc); 
// set the priority node to the last document with the same priority 
_PriorityNodes[doc.Priority] = prioNode .Next; 


} 
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Else // only priority node with a lower priority exists 
{ 
// get the first node of the lower priority 
LinkedListNode<Document> firstPrioNode = prioNode; 
While (firstPrioNode.Previous ‘= null && 
firstPrioNode.Previous.Value.Priority == prioNode.Value.Priority) 
{ 
firstPrioNode = prioNode.Previous; 
prioNode = firstPrioNode; 
} 
_ documentList.AddBefore (firstPrioNode, doc)}); 
/i set the priority node to the new value 
_ priorityNodes [doc.Priority] = firstPrioNode.Previous; 
} 
} 
} 


现在 还 剩 下 几 个 简单 的 方法 没有 讨论 。DisplayAllINodes0 方 法 只 是 在 一 个 foreach 循环 中 ， 把 每 个 文档 的 优 
先 级 和 标题 显示 在 控制 全 上。 
GetDocument0 方 法 从 链表 中 返回 第 一 个 文档 (优先 级 最 噩 的 文档 )， 并 从 链表 中 删除 它 : 


public void DisplayAllNodes () 


{ 
foreach (Document doc in documentList) 
{ 
Console.WriteLine($"priority: {doc.Priority}, title {doc.Title}"); 
} 
} 


i: returns the document with the highest priority 
/i (that's first in the linked 1ist) 
Public Document GetDocument () 
{ 
Document doc = documentList.First.Value; 
documentList.RemoveFirst (); 
return doc: 


} 
在 Main0 方 法 中 ，PriorityDocumentManager 类 用 于 说 明 其 功能 。 在 链表 中 添加 8 个 优先 级 不 同 的 新 文档 ， 
再 显示 整个 链表 (代码 文件 LinkedListSample/Program .cs): 


public static vold Main'() 

{ 
Var pdm = new PriorityDocumentManager (); 
pdm.AddDocument (new Document ("one", "Sample™", 8)).; 
pdm.AddDocument (new Document ("two", "Sample™, 3)).; 
pdm.AddDocument (new Document ("three™", "Sample™, 4)); 
pdm.AddDocument (new Document ("four™”, "Samle™, 8)}); 
pdm.AddDocument (new Document ("five™", "Sample™, 1)); 
pdm.AddDocument (new Document ("six", "Sample™", 9)); 
pdm.AddDocument (new Document ("seven", "Sample™, 1)})); 
pdm.AddDocument (new Document ("eight", "Sample™, 1));} 
pdm.DisplayAllNodes (); 


} 

在 处 理 好 的 结果 中 ， 文 档 先 按 优先 级 排序 ， 再 按 添加 文档 的 时 间 排 序 : 
Priority: 9, title six 

Priority: 8, title one 

priority: 8, title four 

priority: 4, title three 

priority: 3, title two 

Priority: 1, title fijve 

Priority: 1, title seven 

priority: 1, title eight 


10.7 有 序列 表 


如 果 需 要 基于 键 对 所 需 集合 排序 ， 就 可 以 使 用 SortedList<TKey, TValue> 类 。 这 个 类 按照 键 给 元 素 排序 。 这 
个 集合 中 的 值 和 键 都 可 以 使 用 任意 类 型 。 
下 面 的 例子 创建 了 一 个 有 序列 表 ， 其 中 键 和 值 都 是 string 类 型 。 默 认 的 构造 函数 创建 了 一 个 空 列表 ， 再 用 
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Add0 方 法 添加 两 本 书 , 使 用 重 载 的 构造 函数 , 可 以 定义 列表 的 容量 , 传递 实现 了 IComparer<TKey> 接 口 的 对 象 ， 
该 接口 用 于 给 列表 中 的 元 际 排 序 。 

Add0 方 法 的 第 一 个 参数 是 键 ( 书 名 )， 第 二 个 参数 是 值 [ISBN 号 )。 除 了 使 用 Add0 方 法 之 外 ， 还 可 以 使 用 索引 器 
将 元 素 添加 到 列表 中 。 索 引 器 需要 把 键 作为 索引 参数 。 如 果 键 已 存在 ，Add0 方 法 就 抛 出 一 个 ArgumentException 类 
型 的 异常 。 如 果 索 引 器 使 用 相同 的 键 ， 就 用 新 值 蔡 代 旧 值 (代码 文件 SortedListSample/Program.cs)。 

Var books = new SortedList<string, string>(); 


books.Add ("Professional WEPF Programming", "978-—0-470-04180-2"); 
books.Add ("Professional ASP.NET MVC 5", "978-—1-118—79475-3"); 


books["Beginning C# 6 Programming"] = "978-1-119-09668—9"™"; 
books["Professional C# 6 and NET Core 1.0"] = "978-1-119-09660—3". 


注意 : 
SortedList<TKey,，TValue> 类 只 允许 每 个 键 有 一 个 对 应 的 值 ， 如 果 需 要 每 个 键 对 应 多 个 值 ， 就 可 以 使 用 
Lookup<TKey, TElement> 类 。 


可 以 使 用 foreach 语句 过 有 历 该 列表 。 枚 举 器 返回 的 元 素 是 KeyValuePair<TKey, TValue> 类 型 ， 其 中 包含 了 键 
和 值 。 键 可 以 用 Key 属性 访问 ， 值 可 以 用 Value 属性 访问 。 

foreach (KeyValuePair<string, string> book in books) 

{ 


Console.WriteLine($"{book.Key}, {book.vVvalue}"); 
} 


从 代 语句 会 按键 的 顺序 显示 书 名 和 ISBN 号 : 


Beginning C# 6 Programing, 978-1-119-09668-9 
Professional ASP.NET MVC 5, 978-1-118-79475-3 
Professional C# 6 and .NET Core 1.0, 978-1-119-09660-—3 
Professional WPF Programming, 978-0-470-04180-2 


也 可 以 使 用 Values 和 Keys 属性 访问 值 和 键 。 因 为 Values 属性 返回 IList<TValue>，Keys 属性 返回 
IList<TKey>， 所 以 可 以 通过 foreach 语句 使 用 这 些 属 性 : 


foreach (string isbn in books.Values) 
: Console .WriteLine (isbn):; 
1 (string title in books.Keys) 
Console .WriteLine (title); 


} 
第 一 个 循环 显示 值 ， 第 二 个 循环 显示 键 : 


978-1-119-09668-9 

918-1-118-794795—3 

978-1-119-09660-3 

978-0-470-04180-2 

Beginning C# 6 Programming 
Professional ASP.NET MVC 5 
Professional C# 6 and .NET Core 1.0 
Professional WPF Programming 


如 果 尝 试 使 用 索引 器 访问 一 个 元 素 ， 但 所 传递 的 键 不 存在 ， 就 会 抛 出 一 个 KeyNotFoundException 类 型 的 异 滑 。 为 
了 避免 这 个 蜡 前 ， 可 以 使 用 ContainsKey0 方 法 ， 如 果 所 传递 的 键 存 在 于 集合 中 ， 这 个 方法 就 返回 tue， 也 可 以 调用 
TyGetValue0 方 法 ， 如 果 指 定 键 对 应 的 值 不 仔 人 在， 该 方法 就 会 尝试 获得 指定 键 的 值 ， 而 不 会 抛 出 异常 。 


string title = "Professional C# 8"; 
if (!Ibooks.TryGetValue (title, out string isbn)) 
{ 


Console .WriteLine ($"{titlel} not found™); 
} 
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10.8 ”字典 


字典 表示 一 种 非常 复杂 的 数据 结构 , 这 种 数据 结构 允许 按照 某 个 键 来 访问 元 素 。 字典 也 称 为 映射 或 散 列表 。 
字典 的 主要 特性 是 能 根据 键 快速 查找 值 。 也 可 以 目 由 地 添加 和 删除 元 素 ， 这 有 点 像 List<T> 类 ， 但 没有 在 内 存 
中 移动 后 续 元 素 的 性 能 开销 。 

图 10-5 是 字典 的 一 个 简化 表示 。 其 中 employee-id( 如 B4711) 是 添加 到 字典 中 的 键 。 键 会 转换 为 一 个 散 列 。 
利用 散 列 创建 一 个 数字 ， 它 将 索引 和 值 关 联 起 来 。 然 后 索引 包含 一 个 到 值 的 链接 。 该 图 做 了 简化 处 理 ， 因 为 一 
个 索引 项 可 以 关联 多 个 值 ， 索 引 可 以 存储 为 一 个 树 型 结构 。 


键 索引 什 


BA71 lJimmie Johnson 


.NET Framework 提供 了 几 个 字典 类 。 可 以 使 用 的 最 主要 的 类 是 Dictionary<TKey, TValue>。 
10.8.1 字典 初始 化 器 
C# 提供 了 一 个 语法 ， 在 声明 时 初始 化 字典 。 带 有 int 键 和 string 值 的 字典 可 以 初始 化 如 下 : 


var dict = new Dictionary<int, string>() 
{ 

[3]1] = "three™, 

[7] = "seven™ 


}s 


这 里 把 两 个 元 素 添加 到 字典 中 。 第 一 个 元 素 的 键 是 3， 字 符 串 值 是 three; 第 二 个 元 素 的 键 是 7， 字 符 串 值 
是 seven。 这 个 初始 化 语法 易于 阅读 ， 使 用 的 语法 与 访问 字典 中 的 元 素 相 同 。 


10.8.2” 键 的 类 型 


用 作 字 典 中 键 的 类 型 必须 重 写 Object 类 的 GetHashCode0 方 法 。 只 要 字典 类 需要 确定 元 素 的 位 置 ， 它 就 要 
调用 GetHashCode0 方 法 。GetHashCode0 方 法 返回 的 int 由 字典 用 于 计算 在 对 应 位 置 放置 元 素 的 索引 。 这 里 不 介 
绍 这 个 算法 。 我 们 只 需要 知道 ， 它 涉及 素数 ， 所 以 字典 的 容量 是 一 个 素数 。 

ee 实现 代码 必须 满足 如 下 要 求 : 

相同 的 对 象 应 总 是 返回 相同 的 值 。 

不 同 的 对 象 可 以 返回 相同 的 值 。 

它 不 能 抛 出 异常 。 

它 应 至 少 使 用 一 个 实例 字段 。 

散 列 代码 最 好 在 对 象 的 生存 期 中 不 发 生变 化 。 

除了 GetHashCode0 方 法 的 实现 代码 必须 满足 的 要 求 之 外 ， 最 好 还 满足 如 下 要 求 : 


220 | 第 | 部 分 C# 语言 


® 它 应 执行 得 比较 快 ， 计 算 的 开销 不 大 。 
e 散 列 代码 值 应 平均 分 布 在 int 可 以 存储 的 整个 数字 范围 上 。 


注意 : 
字典 的 性 能 取决 于 GetHashCode0 方 法 的 实现 代码 ， 


为 什么 要 使 散 列 代码 值 平均 分 布 在 整数 的 取 值 范围 内 ? 如 果 两 个 键 返 回 的 散 列 代码 值 会 得 到 相同 的 索引 ， 
字典 类 就 必须 寻找 最 近 的 可 用 空闲 位 置 来 存储 第 二 个 数据 项 ， 这 需要 进行 一 定 的 搜索 ， 以 便 以 后 检索 这 一 项 。 
显然 这 会 降低 性 能 ， 如 果 在 排序 时 许多 键 都 有 相同 的 索引 ， 这 类 冲突 就 更 可 能 出 现 。 根据 Microsoft 的 算法 的 工 
作 方 式 ， 当 计算 出 来 的 散 列 代码 值 平均 分 布 在 intMinValue 和 int.MaxValue 之 间 时 ， 这 种 风险 会 降低 到 最 小 。 

除了 实现 GetHashCode0 方 法 之 外 , 键 类 型 还 必须 实现 正 quatable<T>.Equals0 方 法 ,或 重 写 Object 类 的 Equals0) 
方法 。 因 为 不 同 的 键 对 象 可 能 返回 相同 的 散 列 代码 ， 所 以 字典 使 用 Equals0 方 法 来 比较 键 。 字 典 检查 两 个 键 A 和 
B 是 否 相 等 ， 并 调用 A.Equals(B) 方 法 。 这 表示 必须 确保 下 述 条 件 总 是 成 立 ; 

如 果 A.Equals(B) 方 法 返回 true, 则 A.GetHashCode0 和 B.GetHashCode() 方 法 必须 总 是 返回 相同 的 散 列 
代码 。 

这 似乎 有 后 奇怪 ， 但 它 非常 重要 。 如 果 设 计 出 某 种 重 写 这 些 方法 的 方式 ， 使 上 面 的 条 件 并 不 总 是 成 立 ， 那 
么 把 这 个 类 的 实例 用 作 键 的 字典 就 不 能 正常 工作 ， 而 是 会 发 生 有 趣 的 事情 。 例 如 ， 把 一 个 对 象 放 在 字典 中 后 ， 
就 再 也 检索 不 到 它 ， 或 者 试图 检索 某 项 ， 却 返回 了 错误 的 项 。 


注意 : 
如 果 为 Equals( 方 法 提供 了 重 写 版 本 , 但 没有 提供 GetHashCode0 方 法 的 重 写 版 本 ，C# 编 译 器 就 会 显示 一 个 
编译 警告 。 


对 于 System.Object， 这 个 条 件 为 tue， 因 为 Equals0) 方 法 只 是 比较 引用 ，GetHashCode0 方 法 实际 上 返回 一 
个 仅 基 于 对 象 地 址 的 散 列 代码 。 这 说 明 ， 如 果 散 列表 基于 一 个 键 ， 而 该 键 没 有 重 写 这 些 方法 ， 这 个 散 列 表 就 能 
正 党 工作。 但是， 这 么 做 的 问题 是 ， 只 有 对 象 完 全 相同 ， 键 才 被 认为 是 相等 的 。 也 就 是 说 ， 把 一 个 对 象 放 在 字 
典 中 时 , 必须 将 它 与 该 键 的 引用 关联 起 来 。 也 不 能 在 以 后 用 相同 的 值 实例 化 另 一 个 键 对 象 . 如 果 没 有 重 写 EqualsO 
方法 和 GetHashCode0 方 法 ， 在 字典 中 使 用 类 型 时 就 不 太 方便 。 

另外 ，System.String 实现 了 IEquatable 接口 ， 并 重 载 了 GetHashCode0 方 法 。Equals0) 方 法 提供 了 值 的 比较 ， 
GetHashCode0 方 法 根据 字符 串 的 值 返回 一 个 散 列 代码 。 因 此 ， 在 字典 中 把 字符 串 用 作 键 非常 方便 。 

数字 类 型 (如 Int32) 也 实现 下 quatable 接口 ， 并 重 载 GetHashCode(0) 方 法 。 但 是 这 些 类 型 返回 的 散 列 代码 只 映 
射 到 值 上 。 如 果 希 望 用 作 键 的 数字 本 身 没 有 分 布 在 可 能 的 整数 值 范 围 内 ， 把 整数 用 作 键 就 不 能 满足 键 值 的 平均 
分 布 规则 ， 于 是 不 能 获得 最 佳 的 性 能 。Int32 并 不 适合 在 字典 中 使 用 。 

如 果 需 要 使 用 的 键 类 型 没有 实现 下 quatable 接 口 ,也 没有 根据 存储 在 字典 中 的 键 值 重 载 GetHashCode0 方 法 ， 
就 可 以 创建 一 个 实现 下 qualityComparer<T> 接 口 的 比较 器 。IEqualityComparer<T> 接 口 定义 了 GetHashCode0 和 
Equals(0 方 法 ， 并 将 传递 的 对 象 作 为 参数 ， 因 此 可 以 提供 与 对 象 类 型 不 同 的 实现 方式 。Dictionary<TKey, TValue> 
构造 函数 的 一 个 重 载 版 本 允许 传递 一 个 实现 了 IEqualityComparer <T> 接 口 的 对 象 。 如 果 把 这 个 对 象 赋予 字典 ， 
该 类 就 用 于 生成 散 列 代码 并 比较 键 。 

10.8.3 ”字典 示例 

本 节 的 字典 示例 程序 建立 了 一 个 员工 字典 。 该 字典 用 EmployeeId 对 象 来 索引 ， 存 储 在 字典 中 的 每 个 数据 项 

都 是 一 个 Employee 对 象 ， 访 对象 存储 员工 的 详细 数据 。 


实现 Employeeld 结构 是 为 了 定义 在 字典 中 使 用 的 键 ， 访 结构 的 成 员 是 表示 员工 的 一 个 前 缀 字符 和 一 个 数字 。 
这 两 个 变量 都 是 只 读 的 ， 只 能 在 构造 函数 中 初始 化 。 字 典 中 的 键 不 应 改变 ， 这 是 必须 保证 的 。 在 构造 函数 中 填充 字 
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段 。 重 载 ToString(0 方 法 是 为 了 获得 员工 ID 的 字符 串 表示 .与 键 类 型 的 要 求 一 样 ,Employeeld 结构 也 要 实现 IEquatable 
接口 ， 并 重 载 GetHashCode0 方 法 (代码 文件 DictionarySample/Employeeld.cs)。 


public class EmployeeIdException : Exception 
{ 
Public EmployeelIdException(string message) : base (message) ({ } 


} 


Public struct EmployeeId : IEquatable<EmployeeId> 
{ 
private readonly char prefix; 
private readonly int number; 
Public EmployeeId(string id) 
{ 
IE (id == null) throw new ArgumentNullException (nameof (1d) ) ， 
Prefix = (id.ToUpper(}})} [0]; 
int numLength = id.Length 一 1; 


{ 
number = int.Parse(id.Substring(]l, numLength > 6 ?3 6 : numLength)); 
} 
catch (FormatException) 
{ 
throw new EmployeeIdException ("Invalid Employeeld format™); 
} 


} 
Public override string ToString()} => prefix.ToString()} + 
s"{number,6:000000}"™; 


public override int GetHashCode() => {number ^ number << 16) * Oxl5051505; 


Public bool Equals (EmPployeeld other) 三 > 
(prefix == other?.prefix && number == other?.number); 


Public override bool Equals (object ob]) => Equals ( (EmployeeId) opb]) ; 


Public static bool operator == (EmployeelId left, EmployeeId right) => 
left.Equals (right}).; 


Public static bool operator !=(Employeeld left, EmployeeId right) 三 > 


! (left == right); 
} 


由 正 quatable<T> 接 口 定义 的 Equals0 方 法 比较 两 个 EmployeeId 对 象 的 值 ,如 果 这 两 个 值 相同 , 它 就 返回 true。 
除了 实现 IEquatable<T> 接 口中 的 Equals(0) 方 法 之 外 ， 还 可 以 重 写 Object 类 中 的 Equals0 方 法 。 


Public bool Equals (EmpLoyeeIQG other) => 
prefix == other.prefix && number == other.number; 


由 于 数字 是 可 变 的 , 因此 员工 可 以 取 1 一 190 000 的 一 个 值 。 这 并 没有 填 满 整数 取 值 范围 。 GetHashCode() 
方法 使 用 的 算法 将 数字 同 左 移动 16 位 ， 再 与 原来 的 数字 进行 异 或 操作 ， 最 后 将 结果 乘 以 十 六 进 制 数 15051505。 
散 列 代码 在 整数 取 值 区 域 上 的 分 布 相当 均 色 : 


Public override int GetHashcode () => {number ~ number << 16) * Oxl1l505 1505; 


注意 : 
在 Internet 上 ， 有 许多 更 复杂 的 算法 ， 它 们 能 使 散 列 代码 在 整数 取 值 范围 上 更 好 地 分 布 。 也 可 以 使 用 字符 
串 的 GetHashCode0 方 法 来 返回 一 个 散 列 。 


Employee 类 是 一 个 简单 的 实体 类 , 该 实体 类 包含 员工 的 姓名 、 薪水 和 了 D,。 构 造 函 数 初 始 化 所 有 值 , ToString0 
方法 返回 一 个 实例 的 字符 串 表 示 。ToString0 方 法 的 实现 代码 使 用 格式 化 字符 串 创建 字符 串 表 示 ， 以 提高 性 能 ( 代 
码 文 件 DictionarySample/Employee.cs)。 

public class Employee 

private string name; 


private decimal salary; 
private readonly Employeeld 1d; 
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public Emplovee(EmployeeIdq id, string name, decimal salary) 


{ 
1d = id;s 
name = name; 
salary = Salaryr 
} 


public override string ToString() => 
$s"{id.ToString(})}: {name, -20} {salary:C}"s 
} 


在 示例 应 用 程序 的 Main0 方 法 中 , 创建 一 个 新 的 Dictionary<TKey, TValue> 实 例 ， 其 中 键 是 EmployeelId 类 型 ， 值 
是 Employee 类 型 。 构 造 函 数 指定 了 31 个 元 素 的 容量 。 注 意 容 量 一 般 是 系数 。 但 如 果 指 定 了 一 个 不 是 系数 的 值 ， 也 
不 需要 担心 。Dictionary<TKey, TValue> 类 会 使 用 传递 给 构造 函数 的 整数 后 面 紧 接 着 的 一 个 素数 来 指定 容量 。 创 建 员 
工 对 象 和 ID 后 ， 就 使 用 新 的 字典 初始 化 语法 把 它们 添加 到 新 建 的 字典 中 。 当 然 ， 也 可 以 调用 字典 的 Add0 方 法 添加 
对 象 ( 代 码 文件 DictionarySample/Prosgranmlcs): 


static void Mailnl() 
{ 
var idJimmie = new EmployeeId ("C48"); 
Var Jimmie = new Employee (1dJimmie, "Jimmie Johnson™., 150926.00m); 


Var lidJoey = new EmployeeId("F22"); 
Var Joey = new Employee (idJoey, "Joey Logano™"., 45125.00m); 


Var ldEyle = new EmPloyeelId("T18"); 
Var kyle = new Employee (1dREyle, "Kyle Bush", 78728.00m); 


var idCarl = new EmployeeId("T19"); 
Var Carl = new Employee (ldCarl, "Carl Edwards™", 80473.00m).; 


Var idMatt = new EmployeeId("T20"); 
Var matt = new Employee (idMatt, "Matt Kenseth", 113970.00m); 


Var employees = new Dictijonary<EmpPloyeeId, Employee> (31) 
| 

[idJimmie] = jimmie, 

[idJoey] = JjJoey, 

[idRyle] = kyle, 

[idCarl] = carl., 

[idMatt] = matt 
} 7 


foreach (var employee in employees.Values) 
{ 


Console.WriteLine (employee) ; 
11 
将 数据 项 添加 到 字典 中 后 ， 在 while 循环 中 读 取 字典 中 的 员工 。 让 用 户 输入 一 个 员工 号 ， 把 该 号 码 存储 在 
变量 userInput 中 。 用 户 和 输入 和 X 即 可 退出 应 用 程序 。 如 果 输 入 的 键 在 字典 中 ， 就 使 用 Dictionary<TKey, TValue> 
类 的 TryGetValue0 方 法 检查 它 。 如 果 找 到 了 该 键 ，TryGetValue0 方 法 就 返回 tue; 否则 返回 锯 lse。 如 果 找 到 了 
与 键 关 联 的 值 ， 该 值 就 存储 在 employee 变量 中 ， 并 把 该 值 写 人 控制 合 。 


注意 ;: 
也 可 以 使 用 Dictionary<TKey, TValue> 类 的 索引 器 替代 TryGetValue() 方 法 ， 来 访问 存储 在 字典 中 的 值 。 但 
是 ， 如 果 没 有 找到 键 ， 索 引 器 会 抛 出 一 个 KeyNotFoundException 类 型 的 异常 。 


while (true) 
{ 
Console.Write("Enter employee id (X to exit})> "™); 
Var usSerInput =ReadLine (); 
userInput = userInput.ToUpper(}; 
if (userInput == "X") break; 
EmPloyeeId id; 
try 
{ 
id = new EmployeeId (userIinput); 
IE (!employees.TryGetValue (id, out Employee employee)) 


{ 


Console .WriteLine (23"Emplovyvee with id {id} aoes not exist"); 


} 


忆 ] SEe 


{ 


Console .WriteLine (employee); 


} 
} 


catch (EmployeeIdException ex) 


{ 


Console.WriteLine (ex.Message); 


} 
} 


运行 应 用 程序 ， 得 到 如 下 输出 : 


CO00048: Jimmie Johnson 


$150, 926-00 


FOO00022: Joey Logano $45,125.00 
T000018: Eyle Bush $78,728.00 
T000019: Carl Edwards $80,473.00 


TOO00020: Matt Eenseth 
Enter employee id (X to 
TOO00018: 及 YE Bush 
Enter employee id (X to 
CO00048: Jimmie Johnson 
Enter employee id (X to 


$113,970.00 
eXxlit}> T18 

$78,728.00 
exit)> CA48 

$150, 926.00 
忆 下 1] 七 > 下 
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Press any key to continue . . - 
10.8.4 Lookup 类 


Dictionary<TKey，TValue> 类 支持 每 个 键 关联 一 个 值 。Lookup<TKey，TElement> 类 非常 类 似 于 
Dictionary<TKey, TValue> 类 , 但 把 键 映 射 到 一 个 值 集合 上 。 这 个 类 在 程序 集 System.Core 中 实现 , 用 System.Linq 
名 称 空 间 定义 。 

Lookup<TKey，TElemen 人 > 类 不 能 像 一 般 的 字典 那样 创建 ， 而 必须 调用 ToLookup0 方 法 ， 该 方法 返回 一 个 
Lookup<TKey, TElement> 对 象 。ToLookup0 方 法 是 一 个 扩展 方法 , 它 可 以 用 于 实现 IEnumerable<T> 接 口 的 所 有 类 。 
在 下 面 的 例子 中 ， 填 充 了 一 个 Racer 对 象 列表 。 因 为 List<T> 类 实现 了 IEnumerable<T> 接 口 ， 所 以 可 以 在 赛车 手 
列表 上 调用 ToLookup0 方 法 。 这 个 方法 需要 一 个 Func<TSource, TKey> 类 型 的 委托 ，Func<TSource, TKEey> 类 型 定义 
了 键 的 选择 器 。 这 里 使 用 lambda 表达 式 T 一 ”ICounhy， 根 据 国家 来 选择 赛车 手 。foreach 循环 只 使 用 索引 器 访问 
来 和 目 澳大利亚 的 赛车 手 (代码 文件 LookupSample/Program cs)。 

Var Iacers = new List<Racer>(); 

racers.Add (new Racer("Jacques", "Villeneuve", "Canada™", 11)):; 

racers.Add (new Racer("Alan™"., "Jones™", "Australia™., 12)); 

racers.Add (new Racer("Jackie", "Stewart"™", "United Kingdom™", 27)); 

racers.Add (new Racer ("James™", "Hunt™, "United Kingdom™", 10)); 

racers.Add (new Racer("Jack", "Brabham", "Australia™", 14)); 

Var lookupRacers = racers.ToLookEUup (IT => I.Country):; 

foreach (Racer TI in lookupRacers["Australia™]) 

{ 


Console .WriteLine (r); 


} 


注意 : 
扩展 方法 详 见 第 12 章 ，lambda 表达 式 参 见 第 8 章 。 
结果 显示 了 来 自 澳 大 利 亚 的 赛车 手 : 


Blan Jones 
Jack Brabham 


10.8.5 有 序 字 暴 
SortedDictionary<TKey，TValue> 是 一 个 二 叉 搜 索 树 ， 其 中 的 元 素 根 据 键 排序 。 该 键 类 型 必须 实现 
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IComparable<TKey> 接 口 。 如 果 键 的 类 型 不 能 排序 ， 则 还 可 以 创建 一 个 实现 了 IComparer <ITKey> 接 口 的 比较 器 ， 
将 比较 器 用 作 有 序 字典 的 构造 函数 的 一 个 参数 。 

如 前 所 述 , SortedDictionary<TKey, TValue> 和 SortedList<TKey, TValue> 的 功能 类 似 。 但 因为 SortedList <TKey, 
TValue> 实 现 为 一 个 基于 数组 的 列表 ， 而 SortedDictionary<TKey, TValue> 类 实现 为 一 个 字典 ， 所 以 它们 有 不 同 的 
特征 。 

e SortedList<TKey, TValue> 使 用 的 内 存 比 SortedDictionary<TKey, TValue> 少 。 

e SortedDictionary<TKey, TValue> 的 元 素 插 入 和 删除 操作 比较 快 。 

e 在 用 已 排 好 序 的 数据 填充 集合 时 ， 者 不 需要 修改 容量 ，SortedList<TKey, TValue> 就 比较 快 。 


注意 : 
SortedList 使 用 的 内 存 比 SortedDictionary 少 ， 但 SortedDictionary 在 插入 和 删除 未 排序 的 数据 时 比较 快 。 


10.9 集 


包含 不 重复 元 素 的 集合 称 为 “ 集 (seb”。.NET Core 包含 两 个 集 (HashSet<T> 和 SortedSet<T>)， 它 们 都 实现 
ISet<T> 接 口 。HashSet<T> 集 包含 不 重复 元 素 的 无 序列 表 ，SortedSet<T> 集 包含 不 重复 元 紊 的 有 序列 表 。 

ISet<T> 接 口 提供 的 方法 可 以 创建 合集 、 交 集 ， 或 者 给 出 一 个 集 是 男 一 个 集 的 超 集 或 子 集 的 信息 。 

在 下 面 的 示例 代码 中 ， 创 建 了 3 个 字符 串 类 型 的 新 集 ， 并 用 一 级 方程 式 汽车 填充 它们 。HashSet<T> 集 实现 
ICollection<T> 接 口 。 但 是 在 该 类 中 ，Add0 方 法 是 显 式 实现 的 ， 还 提供 了 男 一 个 Add0 方 法 。Add0 方 法 的 区 别 
是 返回 类 型 ， 它 返回 一 个 布尔 值 ， 说 明 是 否 添 加 了 了 元素。 如 果 该 元 素 已 经 在 集中 ， 就 不 添加 它 ， 并 返回 false( 代 
码 文 件 SetSample/Program.cs)。 

var companyTeams = new HashSet<string>{) 

{ "Ferrari", "McLaren", "Mercedes"™ }; 

var traditionalTeams = new HashSet<string>() { "Ferrari™"™, "McLaren™ }; 

Var privateTeams = new HashSset<string>() 


{ "Red Bull™, "Toro ROSsso™, "Force India™", "Sauber™ }; 


if (privateTeams.Add ("Williams")) 
{ 


Console .WriteLine ("Williams added™).: 


} 


IE (!companyTeams .Add ("McLaren"™)) 
{ 


Console .WriteLine ("McLaren WaS already in this set™); 


} 
两 个 Add0 方 法 的 输出 写 到 控制 合 上 : 


而 1111ams added 
McLaren Was already in this set 


IsSubsetOfQ 和 IsSupersetOf0 方 法 比较 集 和 实现 了 IEnumerable<T> 接 口 的 集合 , 并 返回 一 个 布尔 结果 。 这 里 ， 
IsSubsetOf0 方 法 验证 traditionalTeams 集合 中 的 每 个 元 素 是 否 都 包含 在 companyTeams 集合 方法 中 ，IsSupersetOf0 
方法 验证 traditionalTeams 集合 是 否 有 companyTeams 集合 没有 的 额外 元 台 。 


if (traditionalTeams.IsSubsetof (companyTeams)) 


Console .WriteLine("traditionalTeams is subset of companyTeams") : 
(companyTeams.IsSupersetof (traditionalTeams)) 

Console.WriteLine ("companyTeams is a superset of traditionalTeams"); 
} 

这 个 验证 的 结果 如 下 : 


traditionalTeams is a subset of companyTeams 
companyTeams is a superset of traditionalTeams 
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Williams 也 是 一 个 传统 队 ， 因 此 这 个 队 添加 到 traditionalTeams 集合 中 : 


traditionalTeams .Add ("Williams"™y).: 
if (privateTeams .Overlaps (traditionalTeams)) 
{ 
Console.WriteLine ("At least one team is3 the same with traditional ™ 十 
"and private teams"™"); 


} 
因为 有 一 个 重合 ， 所 以 结果 如 下 : 
At least one team is the same with traditional and private teams. 


调用 UnionWithO 方 法 ， 把 引用 新 SortedSet<string> 的 变量 allTeams 填充 为 companyTeams、privateTeams 和 
traditionalTeams 的 合集 : 


var allTeams = new SortedSset<string> (companyTeams); 
allTeams .UnionWith (privateTeams).,; 
allTeams .UnionWith (traditionalTeams); 
Console .WriteLine ():; 
Console .WriteLine("all teams™); 
foreach (var team in allTeams) 
{ 
Console.WriteLine (team); 


这 里 返回 所 有 队 ， 但 每 个 队 都 只 列 出 一 次 ， 因 为 集 只 包含 唯一 值 。 因 为 容器 是 SortedSet<string>， 所 以 结 
果 是 有 序 的 : 


Ferrarl 
Force India 
Lotus 
McLaren 
Mercedes 
Red Bull 
Sauber 

Toro Rosso 
Williams 


ExceptWithO 方 法 从 allTeams 集中 删除 所 有 私有 队 : 


allTeams .ExceptWith (privateTeams); 
WriteLiner(y). 
WriteLine ("no private team left"™),; 
foreach (var team in allTeams) 
{ 

Console .WIriteLine (team).: 


| 
集合 中 的 其 他 元 系 不 包含 私有 队 : 


McLaren 
Mercedes 


10.10 ”性 能 


许多 集合 类 都 提供 了 相同 的 功能 ， 例 如 ，SortedList 类 与 SortedDictionary 类 的 功能 几乎 完全 相同 。 但 是 ， 
其 性 能 常常 有 很 大 区 别 。 一 个 集合 使 用 的 内 存 少 ， 另 一 个 集合 的 元 素 检 索 速 度 快 。 在 MSDN 文档 中 ， 集 合 的 方法 
常常 有 性 能 提示 ， 给 出 了 以 大 写 O 记号 表示 的 操作 时 间 : 


® O(l) 
® O(logn) 
e O(n) 


O(1) 表 示 无 论 集 合 中 有 多 少数 据 项 ， 这 个 操作 需要 的 时 间 都 不 变 。 例 如 ，ArrayList 类 的 Add0 方 法 就 具有 
O(1) 行 为 。 无 论 列表 中 有 多 少 个 元 素 ， 在 列表 末尾 添加 一 个 新 元 素 的 时 间 都 相同 。Count 属性 会 给 出 元 素 个 数 ， 
所 以 很 容易 找到 列表 末尾 。 
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O(n) 表 示 对 于 集合 执行 一 个 操作 需要 的 时 间 在 最 坏 情况 时 是 N。 如 果 需 要 重新 给 集合 分 配 内 存 ，ArrayList 
类 的 Add0 方 法 就 是 一 个 O(n) 操 作 。 改 变 容 量 ， 需 要 复制 列表 ， 复 制 的 时 间 随 元 素 的 增加 而 线性 增加 。 

O(log n) 表 示 操 作 需 要 的 时 间 随 集合 中 元 系 的 增加 而 增加 , 但 每 个 元 素 需 要 增加 的 时 间 不 是 线性 的 , 而 是 呈 
对 数 曲 线 。 在 集合 中 执行 插入 操作 时 ，SortedDictionary<TKey,TValue> 集 合 类 具有 O(log 冲 行 为 ， 而 
SortedList<TKey.TValue> 集 合 类 具有 O(n) 行 为 。 这 里 SortedDictionary <TKey,TValue> 集 合 类 要 快 得 多 ， 因 为 它 
在 树 型 结构 中 插入 元 素 的 效率 比 列表 噩 得 多 。 

表 10-4 列 出 了 集合 类 及 其 执行 不 同 操作 的 性 能 ， 例 如 ， 添 加 、 插 入 和 删除 元 素 。 使 用 这 个 表 可 以 选择 性 能 最 
佳 的 集合 类 。 左 列 是 集合 类 ，Add 列 给 出 了 在 集合 中 添加 元 素 所 需 的 时 间 。List<T> 和 HashSet<T> 类 把 Add 方法 
定义 为 在 集合 中 添加 元 素 。 其 他 集合 类 用 不 同 的 方法 把 元 素 添 加 到 集合 中 。 例如 ，Stack<T> 类 定义 了 Push() 
方法 ，Queue<T> 类 定义 了 Enqueue0 方 法 。 这 些 信息 也 列 在 表 中 。 

如 果 单 元 格 中 有 多 个 大 O 值 ， 表 示 夺 集合 需要 重 置 大 小 ， 该 操作 就 需要 一 定 的 时 间 。 例 如 ， 在 List<T> 类 
中 ， 添 加 元 素 的 时 间 是 O(1)。 如 果 集 合 的 容量 不 够 大 ， 需 要 重 置 大 小 ， 则 重 置 大 小 需要 的 时 间 长 度 就 是 O(n)。 
集合 越 大 ， 重 置 大 小 操作 的 时 间 就 越 长 。 最 好 避免 重 置 集合 的 大 小 ， 而 应 把 集合 的 容量 设置 为 一 个 可 以 包含 所 
有 元 素 的 值 。 

如 果 表 单元 格 的 内 容 是 na( 代 表 not applicable)， 就 表示 这 个 操作 不 能 应 用 于 这 种 集合 类 型 。 

表 10-4 


集合 Add Insert | Remove | lem | so | Fin 


List<T> 如 果 集合 必须 重 置 大 小 ， 就 是 | OQ@m) Ol@mlog), 最 | OO) 
0(0) 或 0 坏 的 情况 是 
O (n^2) 
Stack<T> PushO， 如 果 栈 必须 重 置 大 小 ,| Pop. O(1) 
就 是 O(1) 或 O(n) 
Queue<T> Enqueue0， 如 果 队 列 必 须 重 置 | 
大 小 ， 就 是 O(1) 或 O(n) 
HashSet<T> 如 果 集 必须 重 置 大 小 ， 就 是 
0(0) 或 om 
SortedSet<T> 如 果 集 必须 重 置 大 小 ， 就 是 
00) 或 om 
LinkedList<T> AddLastO(1) 


Dictionary OU) 或 OO O(1) Of(1) 
<TEKey, TValue> 


SortedDictionary O(log n) O(log n) 
<TEKey, TValue> 
SortedList 无 序数 据 为 O(n);， 如 果 必 须 重 | wa 读 / 写 是 O(log n); | ni/: 


如 果 键 在 列表 中 ， 


<TEKey, TValue> 置 大 小 ， 就 是 OA; 到 列表 的 
尾部 ， 就 是 O(log n) 
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10.11 小结 


本 章 介 绍 了 如 何 处 理 不 同类 型 的 泛 型 集合 。 数 组 的 大 小 是 固定 的 , 但 可 以 使 用 列表 作为 动态 增长 的 集合 。 队 列 
以 先进 先 出 的 方式 访问 元 素 , 栈 以 后 进 先 出 的 方式 访问 元 素 。 链表 可 以 快速 地 插入 和 删除 元 素 , 但 搜索 操作 比较 慢 。 
通过 键 和 值 可 以 使 用 字典 ， 它 的 搜索 和 插入 操作 比较 快 。 集 (seb 用 于 唯一 项 ， 可 以 是 无 序 的 (HashSet<T>)， 也 可 以 是 
有 序 的 (SortedSet<T>)。 

第 11 章 将 介绍 一 些 特 殊 的 集合 类 。 


EE 


特殊 的 集合 


本 草 要 所 

e ”使 用 位 数组 和 位 矢量 
使 用 可 观察 的 集合 
使 用 不 可 变 的 集合 
使 用 并 发 的 集合 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 SpecialCollections 目录 
的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
e 位 数组 示例 
位 矢量 示例 
可 观察 的 集合 示例 
不 可 变 的 集合 示例 
管道 示例 


11.1 概述 


第 10 章 介 绍 了 列表 、 队 列 、 堆 栈 、 字 典 和 链表 。 本 章 继续 介绍 特殊 的 集合 ， 例 如， 处 理 位 的 集合 、 改 变 时 
可 以 观察 的 集合 、 不 能 改变 的 集合 ， 以 及 可 以 在 多 个 线程 中 同时 访问 的 集合 。 


11.2 ”处理 位 


如 果 需 要 处 理 的 数字 有 许多 位 ，C# 7 为 此 提供 了 二 进 制 字面 量 和 数字 分 隔 符 ， 参 见 第 2 章 和 第 6 章 。 处 理 
二 进 制 数据 时 ， 还 可 以 使 用 BitAmay 类 和 BitVector32 结构 。BitArray 类 位 于 名 称 空间 System.Collections 中 ， 
BitVector32 结构 位 于 名 称 空间 System.Collections.Specialized 中 。 这 两 种 类 型 最 重要 的 区 别 是 ，BitArray 类 可 以 
重新 设置 大 小 ， 如 果 事 先 不 知道 需要 的 位 数 ， 就 可 以 使 用 BitArray 类 ， 它 可 以 包含 非常 多 的 位 。BitVector32 结 
构 是 基于 栈 的 ， 因 此 比较 快 。BitVector32 结构 仅 包 含 32 位 ， 它 们 存储 在 一 个 整数 中 。 
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11.2.1 ” BitArray 类 
BitArray 类 是 一 个 引用 类 型 ， 它 包含 一 个 int 数组 ， 其 中 每 32 位 使 用 一 个 新 整数 。 这 个 类 的 成 员 如 表 11-1 


所 示 。 
表 11-1 
BitArray 类 的 成 员 说 明 
Count Count 和 Length 属性 的 get 访问 器 返回 数组 中 的 位 数 。 使 用 Length 属性 还 可 以 定义 新 的 数组 大 小 ， 
Length 重新 设置 集合 的 大 小 
Item 可 以 使 用 索引 器 读 写 数组 中 的 位 。 索 引 器 是 布尔 类 型 。 除 了 使 用 索引 器 之 外 ， 还 可 以 使 用 Get0 
Get 和 Set0 方 法 访问 数组 中 的 位 
Set 
SetAll 根据 传送 给 该 方法 的 参数 ，SetAll0 方 法 设置 所 有 位 的 值 
Not Not0 方 法 对 数组 中 所 有 位 的 值 取 反 
And 使 用 And0、Or0 和 Xor0 方 法 ， 可 以 合并 两 个 BitArray 对 象 。And0 方 法 执行 二 元 AND， 只 有 两 
Or 个 输入 数组 的 位 都 设置 为 1， 结 果 位 才 是 1。Or0 方 法 执行 二 元 OR， 只 要 有 一 个 输入 数组 的 位 设 
Xor 置 为 1， 结果 位 就 是 1。Xor0 方 法 是 异 或 操作 ， 只 有 一 个 输入 数组 的 位 设置 为 1， 结果 位 才 是 1 
注意 : 


第 6 章 中 介绍 了 按 位 运算 符 ， 它 可 以 用 于 数字 类 型 (如 byte、short、int 和 long)。BitArray 类 具有 类 似 的 功 
能 ， 但 是 可 以 用 于 不 同 数量 的 位 ， 而 不 是 用 于 C# 类 型 。 


BitArraySample 使 用 如 下 名 称 空间 : 
System 
System.Collections 


System.Text 


扩展 方法 GetBitsFormatO 通 历 BitArray， 根 据 位 的 设置 情况 , 在 控制 台 上 显示 1 或 0。 为 了 获得 更 好 的 可 读 
性 ， 每 4 位 添加 了 一 个 分 隔 符 (代码 文件 BitArraySample/Program.cs): 


public static class BitArrayExtensions 
{ 
Public static string GetBitsFormat (this BitArray bits) 


Var sb = new StringBuilder'(); 
for (Int 1 = bits.Length — 1; 1 >= 0; 1——) 
{ 
sb.Append (bits[i] ? 1 : 0); 
if (i != 0 && 1 名 4 == 0) 
{ 
sb.Append(™ "); 
} 
} 
return sb.ToString(); 
} 
} 


说 明 BitArray 类 的 示例 创建 了 一 个 包含 9 位 的 数组 ， 其 索引 是 0-8。SetAll0 方 法 把 这 9 位 都 设置 为 true。 
接着 Set0 方 法 把 对 应 于 1 的 位 设置 为 false。 除 了 Set0 方 法 之 外 ， 还 可 以 使 用 索引 器 ,例如 ,下面 的 第 5 个 和 第 
7 个 索引 (代码 文件 BitArraySample/Program.cs): 

Var bitsl = new BitArray (9); 


bits1.SetaAll (true); 
bitsl.sSet(1, false); 
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bitsl1[5] falses 

bitsi[7] = false;s 
Console .Write ("initialized: ") 7 
Console.WriteLine (bitsl1.GetBitsFormat () ) 7 


这 是 初始 化 位 的 显示 结果 : 


initialized: 1 0101 1101 


Not0 方 法 会 对 BitArray 类 的 位 取 反 : 


Console.Write ("not ™); 

Console .Write (bitsl .GetBitsFormat()).- 
bitsl.Not(); 

Console.Write(™ = ™}; 

Console .WriteLine (bitsl .GetBitsFormat (}); 


Not0 方 法 的 结果 是 对 所 有 的 位 取 反 。 如 果 某 位 是 tme， 则 执行 Not0 方 法 的 结果 就 是 fse， 反 之 亦 然 。 

not 1 0101 1101 = 0 1010 0010 

这 里 创建 了 一 个 新 的 BitArray 类 。 在 构造 国 数 中 ， 因 为 使 用 变量 bitsl 初始 化 数组 ， 所 以 新 数组 与 旧 数 组 有 
相同 的 值 。 接 着 把 第 0、1 和 4 位 的 值 设置 为 不 同 的 值 。 在 使 用 Or0 方 法 之 前 ， 显 示 位 数组 bitsl 和 bits2。Or0 
方法 将 改变 bitsl 的 值 : 

var bits2 = new BitArray (bits]1); 

bits2[0] = true:; 

bits2[1] = false; 

bits2[4] = true; 

Console .Write ($"{bitsl .GetBitsFormat()}} OR {bits2.GetBitsFormat () }"); 

Console.Write(™ = m) 

bitsl1.or (bits2).- 

Console .WriteLine (bitsl.GetBitsFormat (}}; 


使 用 Or0 方 法 时 ， 从 两 个 输入 数组 中 提取 设置 位 。 结 果 是 ， 如 果 某 位 在 第 一 个 或 第 二 个 数组 中 设置 为 true， 
该 位 在 执行 Or0 方 法 后 就 是 tue: 

0 1010 0010 oR 0 1011 0001 = 0 1011 0011 

下 面 使 用 And0 方 法 作用 于 位 数组 bitsl 和 bits2: 


Console.Write($"{bits2.GetBitsFormat()} AND {bitsl.GetBitsFormat(})}"); 
Console.Write(™ = ™}s; 

bits2.And {bitsi1); 

Console .WriteLine (bits2.GetBitsFormat (}}).; 


And0 方 法 只 把 在 两 个 输入 数组 中 都 设置 为 tue 的 位 设置 为 true: 

0 1011 0001 AND 0 1011 0011 = 0 1011 0001 

最 后 使 用 Xor0 方 法 进行 异 或 操作 : 
Console.Write ($"{bitsl .GetBitsFormat()} XoR {bits2.GetBitsFormat ()}}"); 
bitsl .Xor (bits2); 


Console.Write(™ = ™ys; 
Console .WriteLine (bitsl .GetBitsFormat (}}).; 


使 用 Xor0 方 法 ， 只 有 一 个 (不 能 是 两 个 ) 输 入 数组 的 位 设置 为 1， 结果 位 才 是 1。 


0 1011 0011 XoR 0 1011 0001 = 0 0000 0010 


11.22 ”BitVector32 结构 


如 果 事 先知 道 需要 的 位 数 ， 就 可 以 使 用 BitVector32 结构 替代 BitArray 类 。BitVector32 结构 效率 较 高 ， 因 为 
它 是 一 个 值 类 型 ,在 整数 栈 上 和 存储 位 ,一 个 整数 可 以 存储 32 位 。 如 果 需 要 更 多 的 位 , 就 可 以 使 用 多 个 BitVector32 
值 或 BitArray 类 。BitArray 类 可 以 根据 需要 增 大 ， 但 BitVector32 结构 不 能 。 

表 11-2 列 出 了 BitVector32 结构 中 与 BitArray 类 完全 不 同 的 成 员 。 
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表 11-2 
BitVector32 结构 的 成 员 说 明 
Data Data 属性 把 BitVector32 结构 中 的 数据 返回 为 整数 
Item BitVector32 的 值 可 以 使 用 索引 器 设置 。 索 引 器 是 重 载 的 一 一 可 以 使 用 掩 码 或 BitVector32. Section 
类 型 的 片段 来 获取 和 设置 值 
CreateMask 这 是 一 个 静态 方法 ， 用 于 为 访问 BitVector32 结构 中 的 特定 位 创建 掩 码 
CreateSection 这 是 一 个 静态 方法 ， 用 于 创建 32 位 中 的 几 个 片段 


BitVectorSample 使 用 如 下 名 称 空间 : 
System 
System.Collections.Speclalized 
System.Ling 


示例 代码 用 默认 构造 函数 创建 了 一 个 BitVector32 结构 ,其 中 所 有 的 32 位 都 初始 化 为 false。 接 着 创建 掩 码 ， 
以 访问 位 天 量 中 的 位 。 对 CreateMask0 方 法 的 第 一 个 调用 创建 了 用 来 访问 第 一 位 的 一 个 掩 码 。 调 用 CreateMaskO 
方法 后 ，bitl 被 设置 为 1。 再 次 调用 CreateMask0 方 法 ， 把 第 一 个 掩 码 作为 参数 传递 给 CreateMask0 方 法， 返回 
用 来 访问 第 二 位 ( 它 是 2) 的 一 个 掩 码 。 接 看 ,将 bit3 设置 为 4， 以 访问 位 编号 3。bit4 的 值 是 8， 以 访问 位 编号 4。 

然后 ， 使 用 掩 码 和 索引 器 访问 位 天 量 中 的 位 ， 并 相应 地 设置 字段 (代码 文件 BitArraySample/Program.cs): 


var bitsl = new BitVvector32().; 

int bitl = BitVector32.CreateMask(}.; 

int bit2 = BitVector32.CcreateMask (bitl1):; 
int bit3 = BitVector32.CcreateMask (bit2):-; 
int bit4 = BitVector32.createMask (bit3).; 
int bit5 = BitVector32.CreateMask (bit4); 
bitsi[Bit1] = true; 


bitsli[lbit2] = false:; 
bitsli[lbit3] = true; 
bits1i[lbit4] = true; 


bitsi[bitS] = true; 
Console .WriteLine (bitsl1y.: 


BitVector32 结构 有 一 个 重 写 的 ToString0 方 法 ， 它 不 仅 显 示 类 名 ， 还 显示 1 或 0， 来 说 明 位 是 否 设 置 了 ， 如 
下 所 示 : 

BitYector32{000000000000000000000000000111011 

除了 用 CreateMask0 〇 方法 创建 掩 码 之 外 ， 还 可 以 自己 定义 掩 码 ， 也 可 以 一 次 设置 多 位 。 十 六 进 制 值 abcdef 
与 二 进 制 值 1010 1011 1100 1101 1110 1111 相同 。 用 这 个 值 定 义 的 所 有 位 都 设置 了 : 


bitsl[0Oxabcdef] = true; 
Console .WriteLine (bitsl1).; 


在 输出 中 可 以 验证 设置 的 位 : 

BitVector32{00000000101010111100110111101111)} 

把 32 位 分 别 放 在 不 同 的 片段 中 非常 有 用 。 例 如 ，IPv4 地 址 定义 为 一 个 4 字 节 的 数 ， 该 数 存储 在 一 个 整数 
中 。 可 以 定义 4 个 片段 ， 把 这 个 整数 拆 分 开 。 在 多 播 卫 消息 中 ， 使 用 了 几 个 32 位 的 值 。 其 中 一 个 32 位 的 值 放 
在 这 些 片段 中 ; 16 位 表示 源 号 , 8 位 表示 查询 器 的 查询 内 部 码 , 3 位 表示 查询 器 的 健壮 变量 , 1 位 表示 抑制 标志 ， 
还 有 4 个 保留 位 。 也 可 以 定义 自己 的 位 含义 ， 以 节省 内 存 。 

下 面 的 例子 模拟 接收 到 值 0x79abcdef， 把 这 个 值 传送 给 BitVector32 结构 的 构造 函数 ， 从 而 相应 地 设置 位 : 

int recelived = 0x79abcdef. 


BitVector32 bits2 = new BitVvector32 (received).: 
Console .WriteLine (bits2).: 


在 控制 台 上 显示 了 初始 化 的 位 : 


BILVector32{011110011010101111001101111011111] 
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接着 创建 6 个 片段 。 第 一 个 片段 需要 11 位 ， 由 十 六 进 制 值 O0xff 定 义 ( 设 置 了 11 位 )。 片 段 B 需 要 8 位 ， 片 段 C 需 
要 4 位 ， 片 段 D 和 E 需 要 3 位 ， 片 段 F 需 要 两 位 。 第 一 次 调用 CreateSection0) 方 法 只 是 接收 0xfff， 为 最 前 面 的 11 位 分 
配 内 存 。 第 二 次 调用 CreateSection0 方 法 时 ， 将 第 一 个 片段 作为 参数 传递 ， 从 而 使 下 一 个 片段 从 第 一 个 片段 的 结 
尾 处 开始 。CreateSection0 方 法 返回 一 个 BitVector32. Section 类 型 的 值 ， 该 类 型 包含 了 该 片段 的 偏 移 量 和 掩 人 码 。 


1/ sections: FF EEE DDD CCCC BBBBBBEBB 
i 
BitVector32.Section sectiona 
BitVector32.Section sectionB 
BitVector32.Section sectionc 
BitVector32.Section sectionD 
BitVector32.Section sectionE 
BitVector32.Section sectionF 


把 一 个 BitVector32.Section 类 型 的 值 传递 给 BitVector32 结构 的 索引 器 ， 会 返回 一 个 int， 它 映射 到 位 矢量 的 
片段 上 。 这 里 使 用 一 个 帮助 方法 ntIoBinaryString0， 获 得 该 int 数 的 字符 串 表 示 : 


Console.WriteLine ($"Section A: {blIts2[sectIona]l .TOBInarYyStIInG() ]") ， 
Console.WriteLine ($"Section B: {bits2[sectionB] .ToBinarySstring(})}"); 
Console.WriteLine ($"Section C: {bits2[sectioncC] .ToBinaryString(}}"); 
Console .WriteLine ($"Section D: {bits2[sectionD] .ToBinarySstring(}) }").; 

E }"); 
区 : 


BitVector32.CreatesSection (0xfff}):; 
BitVector32.CreateSection (0xff, sectionaA); 
BitVector32.CreateSection (0xf, sectionB); 
BitVector32.CreateSection (0x7, sectioncC); 
BitVector32.CreateSection (0x7, sectionD); 
BitVector32.CreateSection (0x3, sectionE); 


Console .WriteLine ($"Section E: {bits2[sectionE] .ToBinarySstring() 
Console .WriteLine (S$"Section {bits2[sectionF] .ToBinarySsString()}"); 


IntToBinaryString0 方 法 接收 整数 中 的 位 ， 并 返回 一 个 包含 0 和 1 的 字符 串 表示 。 在 实现 代码 中 ， 
Convert.IoString 方法 使 用 toBase 参数 值 2 创建 一 个 二 进 制 表 示 。 在 AddSeparators 扩展 方法 中 ,利用 string.Join 
方法 在 每 4 位 之 后 插入 一 个 分 隔 符 ， 并 使 用 LINQ 方法 将 数组 与 字符 串 组 合 。 下 一 章 将 详细 介绍 LINQ( 代 码 文 
件 BitVectorSample/BinaryExtensions.cs): 


Public static class BinaryExtensions 
{ 
public static string AddSseparators (this string number) => 
number.Length <= 4 2? number : 
string.Join(™ ™, 
Enumerable .Range (0, number.Length / 4) 
.Select (1 => number.Substring(i * 4, 4)) .ToArravy())}).; 


public static string ToBinarySstring (this int number) => 
Convert.ToString (number, toBase: 2) .AddSeparators (); 


} 

结果 显示 了 片段 A~F 的 位 表示 ， 现 在 可 以 用 传递 给 位 矢量 的 值 来 验证 : 
Section A: 1101 1110 1111 

Section B: 1011 1100 

Section C: 1010 

Section D: 1 

Section E: 111 

Section F: 1 


11.3 ”可 观察 的 集合 


如 果 需 要 集合 中 的 元 素 何 时 删除 或 添加 的 信息 ， 就 可 以 使 用 ObservableCollection<T> 类 。 这 个 类 最 急 是 为 
WPF 定义 的 ， 这 样 UI 就 可 以 得 知 集合 的 变化 ， 通 用 Windows 应 用 程序 使 用 它 的 方式 相同 。 这 个 类 的 名 称 空间 
是 System_.Collections. ObjectModel。 

ObservableCollection<T> 类 派生 目 Collection<T> 基 类 , 该 基 类 可 用 于 创建 目 定 义 集合 , 并 在 内 部 使 用 List<T> 
类 。 重 写 基 类 中 的 虚 方 法 Setttem0 和 RemoveItem0， 以 触发 CollectionChanged 事件 。 这 个 类 的 用 户 可 以 使 用 
INotifyCollectionChanged 接口 注册 这 个 事件 。 

ObservableCollectionSample 使 用 如 下 名 称 空间 : 

System 
System.Collections.ObjectModel 
System.Collections.Speclalized 
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下 面 的 示例 说 明了 ObservableCollection<string>0 方 法 的 用 法 ， 其 中 给 CollectionChanged 事件 注册 了 
Data CollectionChanged0 方法 。 把 两 项 添加 到 末尾 ， 再 插入 一 项 ， 并 删除 一 项 (代码 文件 
ObservableCollectionSample/Proeram.cs): 


var data = new ObservableCollection<string> (); 
data.CcollectionChanged += Data CollectionChanged; 
data .Add ("One™). 

data .Add ("TwoO™}.:; 

data.Insert(l1l, "Three™}s 

data .Remove ("OnNne™).; 


Data CollectionChanged0 方 法 接收 NotifyCollectionChangedEventArgs， 其 中 包含 了 集合 的 变化 信息 。Action 
属性 给 出 了 是 否 添加 或 删除 一 项 的 信息 。 对 于 删除 的 项 , 会 设置 OldItems 属性 ， 列 出 删除 的 项 。 对 于 添加 的 项 ， 
则 设置 NewItems 属性 ， 列 出 新 增 的 项 。 


Public static voild Data CollectionChanged (object sender., 
NotifyCollectionChangedEventArgs e) 
{ 
Console.WriteLine ($"action: {e.Action.ToSsString(})}"); 
1if (e-DOLdItems != null) 
{ 
Console.WriteLine($"starting index for old item(s}: {e.0ldstartingIndex}"); 
Console.WriteLine("old item{(s):").- 
foreach (var item in e.0ldItems) 
{ 
Console .WriteLine (item) ; 
} 
} 
IE (le.NewItems != null) 
{ 
Console.WriteLine($"starting index for new item(s}): {e.NewStartingIndex}"™"); 
Console.WriteLine("new item(s): "™):; 
foreach (var item in e.NewItems) 
{ 
Console .WriteLine (item) ; 
} 
} 
Console.WriteLine (}); 
} 
运行 应 用 程序 ， 输 出 如 下 所 示 。 先 在 集合 中 添加 One 和 Two 项 ， 显 示 的 Add 动作 的 索引 是 0 和 1。 第 3 
项 Three 插入 在 位 置 1 上 ， 所 以 显示 的 Add 动作 的 索引 是 1。 最 后 删除 One 项 ， 显 示 的 Remove 动作 的 索引 
是 0: 
action: Add 
starting index for new item(s): 0 
new liteml(s): 
One 
action: Add 
starting index for new item(s): 1 
new liteml(s): 
TWO 
action: Add 
starting jndex for new item(s): 1 
new liteml(s): 
Three 
actlion: Remove 
starting index for old item(s): 0 
old item(s): 
OnNne 


11.4 不 变 的 集合 


如 果 对 象 可 以 改变 其 状态 ， 就 很 难 在 多 个 同时 运行 的 任务 中 使 用 。 这 些 集 合 必须 同步 。 如 果 对 象 不 能 改变 
其 状态 ， 就 很 容易 在 多 个 线程 中 使 用 。 不 能 改变 的 对 象 称 为 不 变 的 对 象 。 不 能 改变 的 集合 称 为 不 变 的 集合 。 
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注意 : 
使 用 多 个 任务 和 线程 ， 以 及 用 异步 方法 编程 的 主题 详 见 第 21 章 和 第 15 章 。 
比较 前 一 草 讨 论 的 只 读 集合 与 不 可 变 的 集合 ， 它 们 有 一 个 很 大 的 差别 : 只 读 集合 利用 可 变 集合 的 接口 。 使 
用 这 个 接口 ， 不 能 改变 集合 。 然 而 ， 如 果 有 人 仍然 引用 可 变 的 集合 ， 它 就 仍然 可 以 改变 。 对 于 不 可 变 的 集合 ， 
没有 人 可 以 改变 这 个 集合 。 
ImmutableCollectionSample 利用 下 面 的 名 称 空间 ; 
System 
System.Collections.Generic 
System.Collections.Immutable 


下 面 是 一 个 简单 的 不 变 字符 串 数组 , 可 以 用 静态 的 Create0 方 法 创建 该 数组 , 如 下 所 示 。Create 方法 被 重 载 ， 
这 个 方法 的 其 他 变 体 允 许 传 送 任 意 数量 的 元 紊 。 注意， 这 里 使 用 两 种 不 同 的 类 型 ， 非 泛 型 类 ImmutableArray 的 
Create 静态 方法 和 Create0 方法 返回 的 泛 型 ImmutableArray 结构 。 在 下 面 的 代码 中 (代码 文件 
ImmutableCollectionSample/Program.cs)， 创 建 了 一 个 空 数组 : 

ImmutableArray<string> al = ImmutableArray.Create<string> (); 

空 数组 没有 什么 用 .ImmutableArray<T> 类 型 提供 了 添加 元 素 的 Add0 方 法 。 但 是 , 与 其 他 集合 类 相反 , Add0 
方法 不 会 改变 不 变 集 合 本 身 ， 而 是 返回 一 个 新 的 不 变 集合 。 因 此 在 调用 Add0 方 法 之 后 ，al 仍 是 一 个 空 集合 ， 
a2 是 包含 一 个 元 素 的 不 变 集合 。Add0 方 法 返回 新 的 不 变 集合 : 

ImmutableArray<string> a2 = al.Add ("Williams"); 

之 后 ， 就 可 以 以 流畅 的 方式 使 用 这 个 API, 一 个 接 一 个 地 调用 Add0 方 法 。 变量 a3 现在 引用 一 个 不 变 集合 ， 
它 包 含 4 个 元 素 : 


ImmutableArray<string> a3 = 
a2 .Badd ("Ferrari"™) .Add ("Mercedes") .Add ("Red Bull Racing"™); 


在 使 用 不 变数 组 的 每 个 阶段 ， 都 没有 复制 完整 的 集合 。 相 反 ， 不 变 类 型 使 用 了 共享 状态 ， 仅 在 需要 时 复制 
集合 。 
但 是 ， 先 填充 集合 ， 再 将 它 变 成 不 变 的 数组 会 更 高 效 。 需 要 进行 一 些 处 理 时 ， 可 以 再 次 使 用 可 变 的 集合 。 
此 时 可 以 使 用 不 变 集合 提供 的 构建 器 类 。 

为 了 说 明 其 操作 ， 先 创建 一 个 Account 类 ， 将 此 类 放 在 集合 中 。 这 种 类 型 本 喘 是 不 可 变 的 ， 不 能 使 用 只 读 
自动 属性 来 改变 (代码 文件 InmutableCollectionSample/Account.cs); 


Public Class Account 
{ 
Public Account (string name, decimal amount) 
{ 
Name = namer 
Amount = amount; 


} 


public string Name { get; } 
public decimal Amount { get; } 


} 

接着 创建 List<Accoun 人 > 集合 ， 用 示例 账户 填充 (代码 文件 InmutableCollectionSample/Program.cs): 
Var accounts = new List<Account> ( ) 

{ 


new Account ("Scrooge McDuck™, 6673716171876om)., 
new Account ("Donald Duck™”, 200m) 
new Account ("Ludwig Von Drake™", 20000m) 


}i 
有 了 账户 集合 ， 可 以 使 用 ToImmutableList 扩展 方法 创建 一 个 不 变 的 集合 。 只 要 打开 名 称 空间 
System.Collections.Immutable， 就 可 以 使 用 这 个 扩展 方法 : 


ImmutableList<Account> immutableAccounts = accounts.ToImmutableList().: 
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变量 immutableAccounts 可 以 像 其 他 集合 那样 枚 举 ， 它 只 是 不 能 改变 。 
foreach (var account in immutableAccounts) 


Console.WriteLine ($"{account.Name} {account.Amount}"™).; 


不 使 用 foreach 语句 迭代 不 变 的 列表 ， 可 以 使 用 用 ImmutableList<T> 定 义 的 ForEach0 方 法 。 这 个 方法 需要 
一 个 Action<T > 委托 作为 参数 ， 因 此 可 以 分 配 lambda 表达 式 : 

immutableAccounts.ForEachl(a => Console.WriteLine($"{a.Name} {a.Amount}")); 

为 了 处 理 这 些 集合 ， 可 以 使 用 Contains、FindAll、FindLast、IndexOf 等 方法 。 因 为 这 些 方法 类 似 于 第 10 章 
讨论 的 其 他 集合 类 中 的 方法 ， 所 以 这 里 不 讨论 它们 。 

如 果 需 要 更 改 不 变 集合 的 内 容 ， 集 合 提 供 了 Add、AddRange、Remove、RemoveAt、RemoveRange、Replace 
以 及 Sort 方法 。 这 些 方法 非常 不 同 于 正 弟 的 集合 类 ， 因 为 用 于 调用 方法 的 不 可 变 集合 永远 不 会 改变 ， 但 是 这 些 
方法 返回 一 个 新 的 不 可 变 集 合 。 


11.4.1 使 用 构建 器 和 不 变 的 集合 


从 现 有 的 集合 中 创建 新 的 不 变 集 合 ， 很 容易 使 用 前 述 的 Add、Remove 和 Replace 方法 完成 。 然 而 ， 如 果 需 
要 进行 多 个 修改 ， 如 在 新 集合 中 添加 和 删除 元 素 ， 这 就 不 是 非常 高 效 。 为 了 通过 进行 更 多 的 修改 来 创建 新 的 不 
变 集 合 ， 可 以 创建 一 个 构建 器 。 

下 面 继续 前 面 的 示例 代码 ， 对 集合 中 的 账户 对 象 进行 多 个 更 改 。 为 此 ， 可 以 调用 ToBuilder 方法 创建 一 个 
构建 器 。 该 方法 返回 一 个 可 以 改变 的 集合 。 在 示例 代码 中 ， 移 除 金额 大 于 0 的 所 有 账户 。 原 来 的 不 变 集 合 没 有 
改变 。 用 构建 器 进行 的 改变 完成 后 ， 调 用 Builder 的 ToImmutable 方法 ,创建 一 个 新 的 不 可 变 集合 。 下 面 使 用 这 
个 集合 输出 所 有 透支 账户 : 


ImmutableList<Account>.Builder builder = immutableAccounts.ToBuilder'().: 
for (Int 1 = 0; 1 > builder.Count; 1++) 
{ 

Account a = builder[il]:; 

if (a.Amount < 0) 

{ 

builder.Remove (a}); 

} 
} 
ImmutableList<Account> overdrawnAccounts = builder.ToImmutablel().: 
overdrawnAccounts.ForEach (a =< WriteLine($"{Ia.Name} {a.Amount}"™")):; 


除了 使 用 Remove 方 法 删除 元 素 之 外 , Builder 类 型 还 提供 了 方法 Add、AddRange、Insert、,RemoveAt、RemoveAll、 
Reverse 以 及 Sort， 来 改变 可 变 的 集合 。 完 成 可 变 的 操作 后 ， 调 用 ToImmutable， 再 次 得 到 不 变 的 集合 。 
11.4.2 不 变 集合 类 型 和 接口 


除了 ImmutableArray 和 ImmutableList 之 外 , NuGet 包 System.Collections.Immutable 还 提供 了 一 些 不 变 的 集 
合 类 型 ， 如 表 11-3 所 示 。 


表 11-3 
不 变 的 集合 类 型 说 明 

ImmutableArray=T> ImmutableArray < 了 > 是 一 个 结构 ,， 它 在 内 部 使 用 数组 类 型 ,但 不 允许 更 改 底层 类 型 。 这 
个 结构 实现 了 接口 [ImmutableList< 工 > 

ImmutableList<T> ImmmutableList < > 在 内 部 使 用 一 个 二 叉 树 来 映射 对 象 ， 以 实现 接口 ImmutableList= 工 > 

ImmutableQueue<T> IImmutableQueue < 了 > 实现 了 接口 ImmmutableQueue < T>， 人 允许 用 Enqueue、Dequeue 和 
Peek 以 先进 先 出 的 方式 访问 元 素 

ImmutableStack<T> ImmutableStack<T> 实 现 了 接口 ImmutableStack<T>， 人 多 许 用 Push、Pop 和 Peek 以 先进 


后 出 的 方式 访问 元 素 
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( 续 表 ) 
不 变 的 集合 类 型 说 明 
ImmutableDictionary<TKey.TValue> ImmutableDictionary < TKey, TValue > 是 一 个 不 可 变 的 集合 ， 其 无 序 的 键 / 值 对 元 素 实现 
了 接口 TmmutableDictionary < TKey, TValue > 
ImmutableSortedDictionary<TEKey. ImmutableSortedDictionary < TKey, TValue > 是 一 个 不 可 变 的 集合 ， 其 有 序 的 键 / 值 对 元 
TValue> 素 实 现 了 接口 TmmutableDictionary < TKey, TValue > 
ImmnutableHashSet<T> ImmnutableHashset< 工 > 是 一 个 不 可 变 的 无 序 散 列 集 ， 实 现 了 接口 ImmutableSet< 工 >。 该 
接口 提供 了 第 10 章 讨论 的 功能 
ImmnutableSortedSet<T> ImmutableSortedSet < 工 > 是 一 个 不 可 变 的 有 序 集 台 ， 实 现 了 接口 ImmutableSet< 工 > 


与 正常 的 集合 类 一 样 ， 不 变 的 集合 也 实现 了 接口 ， 例 如 ，IImmutableQueue<T>、IImmutableList<T> 以 及 
ImmutableStack<T>。 这 些 不 变 接口 的 最 大 区 别 是 所 有 改变 集合 的 方法 都 返回 一 个 新 的 集合 。 


11.4.3 ”使 用 LINQ 和 不 变 的 数组 


为 了 使 用 LINQ 和 不 变 的 数组 ， 类 ImmutableArrayExtensions 定义 了 LINQ 方法 的 优化 版 本 , 例如 ，Where、 
Aggregate、All、First、Last、Select 和 SelectMany。 要 使 用 优化 的 版 本 ， 只 需要 直接 使 用 ImmutableArray 类 型 ， 
打开 System.Ling 名 称 空间 。 

使 用 ImmutableArrayExtensions 类 型 定义 的 Where 方法 如 下 所 示 ， 扩 展 了 ImmutableArray=<T> 类 型 ， 


Public static IEnumerable<T> Where<T> ( 
this ImmutableArray<T> immutableArray, FUunNnc<T, bool> predicate); 


正常 的 LINQ 扩展 方法 扩展 了 IEnumerable <T>。 因 为 ImmutableArray <T> 是 一 个 更 好 的 匹配 ， 所 以 使 用 优 
化 版 本 调用 LINQ 方法 。 


LINQ 参见 第 12 章 。 


11.5 ”并 发 集合 


不 变 的 集合 很 容易 在 多 个 线程 中 使 用 , 因为 它们 不 能 改变 。 如 果 和 希望 使 用 应 在 多 个 线程 中 改变 的 集合 , NET 
在 名 称 空 间 System.Collections.Concurent 中 提供 了 几 个 线程 安全 的 集合 类 。 线 程 安全 的 集合 可 防止 多 个 线程 以 
相互 冲突 的 方式 访问 集合 。 

为 了 对 集合 进行 线程 安全 的 访问 ， 定 义 了 IProducerConsumerCollection<T> 接 口 。 这 个 接口 中 最 重要 的 方法 是 
TyAdd0 和 TyTake0。TyAdd0 方 法 和 尝试 给 集合 添加 一 项 ， 但 如 果 集 合 茶 止 添加 项 ， 这 个 操作 就 可 能 失败 。 为 了 给 
出 相关 信息 ，TryAdd0 方 法 返回 一 个 布尔 值 ， 以 说 明 操 作 是 成 功 还 是 失败 。TryTake0 方 法 也 以 这 种 方式 工作 ， 以 通 
知 调用 者 操作 是 成 功 还 是 失败 ， 并 在 操作 成 功 时 返回 集合 中 的 项 。 下 面 列 出 了 System.Collections.Concurrent 名 称 空 
间 中 的 类 及 其 功能 。 

e ConcurrentQueue<T> 一 一 这 个 集合 类 用 一 种 免 锁定 的 算法 实现 ， 使 用 在 内 部 合并 到 一 个 链表 中 的 32 项 
数组 。 访 问 队列 元 素 的 方法 有 Enqueue0、TryDequeue0 和 TryPeek0。 这 些 方法 的 命名 非常 类 似 于 前 面 
Queue<T> 类 的 方法 ， 只 是 给 可 能 调用 失败 的 方法 加 上 了 前 级 Try 。 因 为 这 个 类 实现 了 
IProducerConsumerCollection<T> 接 口 ， 所 以 TryAdd0 和 TryTake0 方 法 仅 调 用 Enqueue0 和 TryDequeueO) 

e ConcurrentStack<T> 一 一 非常 类 似 于 ConcurrentQueue<T> 类， 只 是 带 有 另外 的 元 率 访 问 方法 。 
ConcurrentStack<T> 类 定义 了 PushO0、PushRange0、TryPeek0、TryPop0 以 及 TryPopRange0 方 法 。 在 内 
部 这 个 类 使 用 其 元 素 的 链表 。 


第 11 章 ”特殊 的 集合 | 237 


e ConcurrentBag<T> 一 一 该 类 没有 定义 添加 或 提取 项 的 任何 顺序 。 这 个 类 使 用 一 个 把 线程 映射 到 内 部 使 用 
的 数组 上 的 概念 ， 因 此 党 试 减少 锁定 。 访 问 元 率 的 方法 有 Add0、TryPeek0 和 TryTake0。 
ee ConcurentDictionary<TKey,，TValue> 一 一 这 是 一 个 线程 安全 的 键 值 集合 。TryAdd()、TryGetValue(、 
TryRemove() 和 TryUpdate0 方法 以 非 阻 塞 的 方式 访问 成 员 。 因 为 元 素 基 于 键 和 值 ， 所 以 
ConcurrentDictionary<TKey, TValue> 没 有 实现 IProducerConsumerCollection<T>。 
e BlockingCollection<T 一 一 这 个 集合 在 可 以 添加 或 提取 元 束 之 前 ， 会 阻塞 线程 并 一 直 等 待 。 
BlockingCollection<T> 集 合 提供 了 一 个 接口 ， 以 使 用 Add0 和 Take0 方 法 来 添加 和 删除 元 素 。 这 些 方 法 
会 阻塞 线程 ， 一 直 等 到 任务 可 以 执行 为 止 。 Add0 方 法 有 一 个 重 载 版 本 , 其 中 可 以 给 该 重 载 版 本 传递 一 
个 CancellationToken 令 牌 。 这 个 令 牌 允许 取消 被 阻塞 的 调用 。 如 果 不 希 望 线程 无 限期 地 等 等 下 去 ， 且 
不 希望 从 外 部 取消 调用 ， 就 可 以 使 用 TryAdd0 和 TryTake0 方 法 ， 在 这 些 方法 中 ， 也 可 以 指定 一 个 超时 
值 ， 它 表示 在 调用 失败 之 前 应 阻塞 线程 和 等 竺 的 最 长 时 间 。 
ConcurrentXXX 集合 是 线程 安全 的 ， 如 果 某 个 动作 不 适用 于 线程 的 当前 状态 ， 它 们 就 返回 false。 在 继续 之 
前 ， 总 是 需要 确认 添加 或 提取 元 率 是 否 成 功 。 不 能 相信 集合 会 完成 任务 。 
BlockingCollection<T> 是 对 实现 了 IProducerConsumerCollection<T> 接 口 的 任意 类 的 修饰 器 , 它 默 认 使 用 
ConcurrentQueue<T> 类 。 还 可 以 给 构造 函数 传递 任何 其 他 实现 了 IProducerConsumer Collection<T> 接 口 的 类 ， 例 
如 ，ConcurrentBag<T> 和 ConcurrentStack<T>。 


11.5.1 创建 管道 


将 这 些 并 发 集合 类 用 于 管道 是 一 种 很 好 的 应 用 。 一 个 任务 加 一 个 集合 类 写 入 一 些 内 容 ， 同 时 另 一 个 任务 从 
该 集合 中 读 取 内 容 。 
下 面 的 示例 应 用 程序 演示 了 BlockingCollection<T> 类 的 用 法 ， 使 用 多 个 任务 形成 一 个 管道 。 第 一 个 管道 如 
图 11-1 所 示 。 第 一 阶段 的 任务 读 取 文 件 名 ， 并 把 它们 添加 到 队列 中 。 在 这 个 任务 运行 的 同时 ， 第 二 阶段 的 任务 
己 经 开始 从 队列 中 读 取 文件 名 并 加 载 它们 的 内 容 。 结 果 被 写 入 男 一 个 队列 。 第 三 阶段 可 以 同时 启动 ， 读 取 并 处 
理 第 二 个 队列 的 内 容 。 结 果 被 写 入 一 个 字典 。 
在 这 个 场景 中 ， 只 有 第 三 阶段 完成 ， 并 且 内 容 已 被 最 终 处 理 ， 在 字典 中 得 到 了 完整 的 结果 时 ， 下 一 个 阶段 
才 会 开始 。 图 11-2 显示 了 接 下 来 的 步骤 。 第 四 阶段 从 字典 中 读 取 内 容 ， 转 换 数 据 ， 然 后 将 其 写 入 队列 中 。 第 五 
阶段 在 项 中 添加 了 颜色 信息 ， 然 后 把 它们 添加 到 男 一 个 队列 中 。 最 后 一 个 阶段 显示 了 信息 。 第 四 阶段 到 第 六 阶 
段 也 可 以 并 发 运行 。 
Info 类 代表 由 管道 维护 的 项 (代码 文件 PipelineSample/Info.cs ): 
public class Info 
| public Info(string word, int count) 
Word = word; 
, Count = count; 
public string Word { get; } 
public int Count { get; } 


public string Color { get; set; } 


Public override string ToString{() => $"{Count} times: {Word}™s; 


} 

PipelineSample 使 用 如 下 名 称 空间 : 
System 
System.Collections.Generic 
System.Collections.Concurrent 
System.IO 
System.Ling 
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System.Threadine.Tasks 
阶段 1 


读 取 文件 名 


加 载 内 容 


处 理 内 容 


六 
py Li 


| 
| 
上 
图 11-1 


看 看 这 个 示例 应 用 程序 的 代码 可 知 ， 完 整 的 管道 是 在 StartPipeline() 方 法 中 管理 的 。 该 方法 实例 化 了 集合 ， 
并 把 集合 传递 到 管道 的 各 个 阶段 。 第 1 阶段 用 ReadFilenamesAsync 处 理 ， 第 2 和 第 3 阶段 分 别 由 同时 运行 的 
LoadContentAsync 和 ProcessContentAsync 处 理 。 但 是 ， 只 有 当前 3 个 阶段 完成 后 ， 第 4 个 阶段 才能 局 动 (代码 
文件 PipelineSample/Program.cs)。 


| 
| 
| 转换 内 容 
| 
| 


1 
本 
睛 


阶段 5 


添加 颜色 


阶段 6 


显示 内 容 


图 11-2 


Public static async Task StartPipelineAsync'!() 

{ 
Var fileNames = new BlockingCollection<string>().; 
Var lines = new BlockingCollection<string>().; 
Var Words = new ConcurrentDictionary<string, int2>().; 
Var items = new BlockingCollection<Info>().; 
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Var Coloredltems = new BlockingCollection<Info>().; 

Task tl1 = PipelineStages.ReadFilenamesAsync (8"../../..", fileNames).:; 
ColoredCconsole .WriteLine ("started stage 1"™);) 

Task t2 = PipelineStages.LoadContentAsync (fileNames, lines).; 
ConsoleHelper.WriteLine("started stage 2"); 

Task t3 = PipelineStages.ProcessContentAsvync (lines, words).; 
awalit Task.WhenAll({(tl, t2, tT3); 
ConsoleHelper.WriteLine("stages 1, 2, 3 completed™).,;} 

Task t4 = PipelineStages.TransferContentAsync (words, items).; 
Task 七 5 PipelineStages .AddColorAsync (items, coloredItems).; 
Task té6 PipelineStages .ShowContentAsvync (coloredItems); 
ColoredCconsole .WriteLine ("stages 4, 5, 6 started"™); 

await Task.WhenAll(t4, tS5, t6); 
ColoredCconsole.WriteLine ("all stages finished"™).; 


注意 : 
这 个 示例 应 用 程序 使 用 了 任务 以 及 async 和 await 关键 字 ， 第 15 章 将 介绍 它们 。 第 21 章 将 详细 介绍 线程 、 
任务 和 同步 。 第 22 章 将 讨论 文件 IO。 


本 例 用 ColoredConsole 类 同 控 制 台 写 入 信息 。 该 类 可 以 方便 地 改变 控制 台 输 出 的 颜色 ， 并 使 用 同步 来 避免 
返回 颜色 错误 的 输出 (代码 文件 PipelineSample/ConsoleHelper.cs): 

public static class ColoredConsole 
Private static object syncOutpPut = new object() :; 

public static void WriteLine(string message) 

lock (syncoutput) 

Console .WriteLine (message); 
} 


Public static void WriteLine(string message, string color) 
{ 
lock (syncoutput) 
{ 
Console.ForegroundColor = (ConsoleColor) Enum. Parsel 
typeof (ConsoleColor), color).; 
Console .WriteLine (message).; 
Console.ResetColor().:; 
} 
} 
} 


11.5.2 ”使 用 BlockingCollection 


现在 介绍 管道 的 第 一 阶段 。ReadFilenamesAsync 接收 BlockingCollection<T> 为 参数 ， 在 其 中 写 入 输出 。 该 
方法 的 实现 使 用 枚 举 器 来 迭代 指定 目录 及 其 子 目录 中 的 C# 文 件 。 这 些 文件 的 文件 名 用 Add 方法 添加 到 
BlockingCollection<T> 中 。 完 成 添加 文件 名 的 操作 后 ， 调 用 CompleteAdding 方法 ， 以 通知 所 有 读 取 器 不 应 再 等 
待 集合 中 的 任何 额外 项 (代码 文件 PipelineSample/PipelineStages.cs): 


Public static class PipelineSsStages 
{ 
Public static Task ReadFilenamesAsync (string path, 
Blockingcollection<string> output) 
{ 


return Task.Factory.StartNewt(} => 


foreach (string filename in Directory.EnumerateFiles (path, "*.cs"™, 
SearchOption.AllDirectories)})) 
{ 
output.Add (filename) : 
ColoredConsole.WriteLine(s$"stage 1: added {filename}"); 
} 
output.CompleteAdding (); 
}, TaskCreationOptions.LongRunning); 
} 
/1 - 
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注意 : 
如 果 在 写 入 器 添加 项 的 同时 ， 读 取 器 从 BlockingCollection<T> 中 读 取 ， 那么 调用 CompleteAdding 方法 是 很 
重要 的 。 否 则 ， 读 取 器 会 在 foreach 循环 中 等 待 更 多 的 项 被 添加 。 


下 一 个 阶段 是 读 取 文件 并 将 其 内 容 添 加 到 男 一 个 集合 中 ， 这 由 LoadContentAsync 方 法 完成 。 该 方法 使 用 
了 输入 集合 传递 的 文件 名 ， 打 开 文 件 ， 然 后 把 文件 中 的 所 有 行 添加 到 输出 集合 中 。 在 foreach 循 环 中 ， 用 输入 
阻塞 集合 调用 GetConsumingEnumerable， 以 友 代 各 项 。 直 接 使 用 input 变量 而 不 调用 GetConsumingEnumerable 
是 可 以 的 ， 但 是 这 只 会 从 代 当 前 状态 的 集合 ， 而 不 会 达 代 以 后 添加 的 项 。 


Public static async Task LoadCcontentasYyYnec (BLOCKkInocolLlLectIon<stIInog> input, 
BlockingCcollection<string> output) 


{ 
foreach (var filename in input.GetConsumingEnumerable()) 
{ 
using (FileStream stream = File.OQpenRead (filename)) 
{ 
var reader = new StreamReader (stream); 
string line = null; 
while ((line = await reader.ReadLineAsync(}) != null) 
{ 
output .Add (line).; 
ColoredCconsole.WriteLine($"stage 2: added {line}"™); 
} 
} 
} 
output .CompleteAdding(); 
} 
注意 : 


如 果 在 填充 集合 的 同时 ， 使 用 读 取 器 读 取 集 合 ， 则 需要 使 用 GetConsumingEnumerable 方法 获取 阻塞 集合 的 
枚 举 器 ， 而 不 是 直接 迭代 集合 。 


11.5.3 ”使 用 ConcurrentDictionary 


ProcessContentAsync 方法 实现 了 第 三 阶段 。 这 个 方法 获取 输入 集合 中 的 行 ， 然 后 拆 分 它们 ， 将 各 个 词 科 选 
到 输出 字典 中 。AddOrUpdate 是 ConcurrentDictionary 类 型 的 一 个 方法 。 如 果 键 没有 添加 到 字典 中 ， 第 二 个 参数 
就 定义 应 该 设置 的 值 。 如 果 键 已 存在 于 字典 中 ，updateValueFactory 参数 就 定义 值 的 改变 方式 。 在 这 种 情况 下 ， 
现 有 的 值 只 是 递增 1: 


Public static Task ProcessContentAsync (BlockingCollection<string> input, 
ConcurrentDictionary<string, int> output) 


{ 
return Task.Factory.StartNew(()} => 
{ 
foreach (war line in input.GetConsumingEnumerable()) 
{ 
string[] words = line.Split({” ", "2", Vt”, {A 
a oe 
foreach (var word in words.Where(w => I!Istring.IsNullorEmpty (w))) 
{ 
output .AddOrUpdate (key: word, addValue: 1, 
updateValueFactory: (s, i) 三 > ++1); 
ColoredCconsole.WriteLine($"stage 3: added {word}"); 
} 
} 
}, TaskCreationoptions.LongRunning)}); 
} 


运行 前 3 个 阶段 的 应 用 程序 ， 得 到 的 输出 如 下 所 示 ， 各 个 阶段 的 操作 交织 在 一 起 : 


stage 3: added DisplayBits 

stage 3: added bits2 

stage 3: added Write 

stage 3: added = 

stage 3: added bitsl .or 

stage 2: added DisplayBits (bits2); 
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stage 2: added Writel(™ and ") ; 
stage 2: added DisplayBits (bits]1); 
stage 2: added WriteLine(); 

stage 2: added DisplayBits (bits2); 


11.5.4 ”完成 管道 


在 完成 前 3 个 阶段 后 ， 接 下 来 的 3 个 阶段 也 可 以 并 行 运行 。TransferContentAsync 从 字典 中 获取 数据 ， 将 


其 转换 为 Info 类 型 ， 然 后 放 到 输出 BlockingCollecion<T> 中 (代码 文件 PipelineSample/PipelineStages.cs): 


Public static Task TransferCcontentAsync!l 
ConcurrentDictionary<string, int> input, 
BlockingCollection<Info> output) 


{ 
return Task.Factory.SsStartNew((} => 
{ 
foreach (Var word in input .Keys) 
{ 
if (input.TryGetValue (word, out int Valuel ) 
{ 
Var info = new Info { Word = word, Count = Value }; 
output.Add (info); 
ColoredCconsole .WriteLine ($"stage 4: added {info}™); 
} 
} 


output .CompleteAdding (}); 
}, TaskCreationOptions.LongRunning); 
} 
管道 阶段 AddColorAsync 根据 Count 属性 的 值 设置 Info 类 型 的 Color 属性 : 
Public static Task AddColorAsync (BlockingCcollection<Info> input, 
BlockingCcollection<Info> output) 


{ 
return Task.Factory.StartNewt{ (}) => 


{ 
foreach (var item in input.GetConsumingEnumerable ()) 
{ 
If (item.Count > 40) 
{ 
item.Color = "Red"™s; 
} 
else if (item.Count > 20) 
{ 
item.Color = "Yellow"; 
} 
全 二 Se 
{ 
item.Color = "Green"™, 
} 
output .Add (item)}.; 
ColoredConsole .WriteLine($"stage 5: addeqd color {item.Color} to {item}"); 
} 


output .CompleteAdding(}); 
}, TaskCreationOoptions .LongRunning),;} 


| 
最 后 一 个 阶段 用 指定 的 颜色 在 控制 台中 输出 结果 : 


public static Task ShowCcontentAsync (BlockingCcollection<Info> input) 
{ 


return Task.Factory.StartNewt (})} => 


{ 
foreach (var item in input.GetConsumingEnumerable (})) 
{ 
ColoredConsole .WriteLine($"stage 6: {item}", item.Color); 
} 


}, TaskCreationOptions.LongRunning)}; 


} 


运行 应 用 程序 ， 得 到 的 结果 如 下 所 示 ， 它 是 彩色 的 。 


stage 6: 20 times: static 

stage 6: 3 times: Count 

stage 6: 2 times: 七 2 

stage 6: 1 times: bits2[sectionD] 
stadge 6: 3 times: Set 
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stage 6: 2 times: Console.ReadLine 
stage 6: 3 times: started 

stage 6: 1 times: bullder.Remove 
stage 6: 1 times: reader 

stage 6: 2 times: bitd4d 

stage 6: 1 times: ForegroundColor 
stage 6: 1 times: all 

all stages finished 


11.6 ”小 结 


本 章 探 讨 了 一 些 特殊 的 集合 ， 如 BitArray 和 BitVector32， 它 们 为 处 理 带 有 位 的 集合 进行 了 优化 。 

ObservableCollection < T > 类 不 仅 存 储 了 位 ， 列 表 中 的 项 改变 时 ， 这 个 类 还 会 触发 事件 。 第 33 一 37 章 把 这 
个 类 用 于 Windows 应 用 程序 和 Xamarin 应 用 程序 。 

本 章 还 解释 了 ， 不 变 的 集合 可 以 保证 集合 从 来 不 会 改变 ， 因 此 可 以 很 容易 用 于 多 线程 应 用 程序 。 

本 章 的 最 后 一 部 分 讨论 了 并 发 集合 ， 即 可 以 使 用 一 个 线程 填充 集合 ， 而 另 一 个 线程 同时 从 相同 的 集合 中 检 
索 项 。 

第 12 章 详细 讨论 语言 集成 查询 (Language Integrated Query，LINQ)。 


十 节 具 


LINO 


本 章 要 点 
用 列表 在 对 象 上 执行 传统 查询 
扩展 方法 
LINQ 碍 询 操作 符 
并 行 LINQ 
表达 式 树 
本 章 源 代 码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 LINQ 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 ; 
e LINQ Intro 
® Enumerable Sample 
® Parallel LINOQ 


Expression Trees 


12.1 LINQ 概述 


LINQ(Laneuage Integrated Query, 语言 集成 查询 ) 在 C# 编 程 语 言 中 集成 了 查询 语法 , 可 以 用 相同 的 语法 访问 
不 同 的 数据 源 。LINQ 提供 了 不 同 数据 源 的 抽象 层 ， 所 以 可 以 使 用 相同 的 语法 。 

本 章 介绍 LINQ 的 核心 原理 和 C# 中 支持 C# LINQ Query 的 语言 扩展 。 

读 完 本 章 后 ， 在 数据 库 中 使 用 LINQ 的 内 容 可 查阅 第 26 章 ， 阅 读本 章 的 内 容 后 ， 查 询 XML 数据 的 内 容 可 
参见 网 上 附加 第 2 章 。 

在 介绍 LINQ 的 特性 之 前 ， 本 节 先 介绍 一 个 简单 的 LINQ 查询 。C# 提 供 了 转换 为 方法 调用 的 集成 查询 语言 。 本 
节 会 说 明 这 个 转换 的 过 程 ， 以 便 用 户 使 用 LINQ 的 全 部 功能 。 
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12.1.1 列表 和 实体 


本 章 的 LINQ 查询 在 一 个 包含 1950 一 2016 年 一 级 方程 式 锦 标 赛 的 集合 上 进行 。 这 些 数据 需要 使 用 NET 标 
准 库 中 的 类 和 列表 来 准备 。 
这 个 库 使 用 了 如 下 名 称 空间 : 
System 


System.Collections.Generic 


对 于 实体 ， 定 义 类 型 Racer。Racer 定义 了 几 个 属性 和 一 个 重 载 的 ToString0 方 法 ， 该 方法 以 字符 串 格 式 显 
示 赛 车 手 . 这 个 类 实现 了 Formattable 接口 , 以 文 持 格式 字符 串 的 不 同 变 体 , 这 个 类 还 实现 了 IComparable<Racer> 
接口 ， 它 根据 Lastmame 为 一 组 赛车 手 排序 。 为 了 执行 更 高 级 的 查询 ，Racer 类 不 仅 包 含 单 值 属性 ， 如 Firstname、 
Lastname、Wins、Country 和 Starts， 还 包含 多 值 属 性 ， 如 Cars 和 Years。Years 属性 列 出 了 赛车 手 获 得 冠军 的 年 
份 。 一 些 赛 车 手 曾 多 次 获得 冠军 。Cars 属性 用 于 列 出 赛车 手 在 获得 冠军 的 年 份 中 使 用 的 所 有 车 型 (代码 文件 
DataLib/Racer.cs)。 


Public class Racer: 
{ 
public Racer(string firstName, 
int starts, int wins) 
: this (firstName, lastName, 


IComparable<Racer>, IFormattable 


string lastName, string country, 


country, starts, wins, null, null) { } 
public Racer(string firstName, 
int starts, int wins, 
{ 
FirstName = firstName; 
LastName = lastName; 
Country = countrys 
starts = starts; 
Wins = Wins; 
Years = Years != null ? new List<int> (years) 
Cars = cars != null ? new List<string> (cars) 


} 


string lastName, 
IEnumerable<int> Years， 


string country, 
IEnumerable<string> cars) 


: new List<int>():; 
: new List<string> (); 


public string FirstName { get; } 


public 
public 
public 
public 
public 
public 


public 
public 
public 


public 
{ 


string LastName 1{ get; } 

int Wins { get; } 

string Country { get; } 

int Starts { get; } 
IEnumerable<string> Cars { get; |】 
IEnumerable<int> Years { get; } 


override string ToString() => $"{FirstName} {LastName}™"; 


int CompareTo (Racer other) => LastName.Compare (other?.LastName); 
string ToString {string format) => ToString (format, null):; 


string Tostring (string format, IFormatProvider formatProvider) 


switch (format) 


{ 


Case null: 


全 可 号 已 


mi" 


return ToString(); 


二 


Bd Th : 


return FirstName:; 


信和 异 写 它 


eo 六 


return LastName; 


人 可 与 局 


lal 本 中 


Ireturn Country; 


全 可 号 个 


星 续 机 可 


return Starts.ToString(); 


人 时 全 


wT 本 


return Wins.ToString'(); 


CaSse 
return S$"{FirstName} {LastName}., 


mT 
{Country}: starts: 


default: 


{Starts}, wins: 


{Wins}":; 
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throw new FormatException($"Format {format} not supported"™); 
} 
} 


} 
第 二 个 实体 类 是 Team。 这 个 类 仅 包含 车 队 冠 军 的 名 字 和 获得 冠军 的 年 份 。 与 赛车 手 冠 军 类 似 ， 针 对 一 年 中 
最 好 的 车 队 也 有 一 个 冠军 奖项 (代码 文件 DataLib/Team.cs): 


Public class Team 
{ 
Public Team{(string name, params int[] vears) 
{ 
Name = namer 
Years = Years != null ? new List<int> (years) : new List<int>(); 
} 
Public string Name { get; } 
Public IEnumerable<int> Years { get; } 
} 


Formulal 类 在 GetChampions() 方 法 中 返回 一 组 赛车 手 。 这 个 列表 包含 了 1950 一 2016 年 之 间 的 所 有 一 级 方 
程式 冠军 (代码 文件 DataLib/Formulal.cs)。 


public static class Formulal 
{ 
private static List<Racer> s racers; 
Public static IList<Racer> GetChampions() => s racers ?2 
(s racers = InitalizeRacers ()); 


private static List<Racer> InitializeRacers 三 > 
new List<Racer> 
{ 
new Racer ("Nino", "Farina™", "Italy™", 33, 5, new int[] { 1950 }, 
new string[] { "Alfa Romeo™ }) ， 
new Racer ("Alberto™", "Ascari™"™, "Italy™", 32, 10, new int[] { 1952, 1953 }, 
new string[] { "Ferrari™ }) ， 
new Racer(" Juan Manuel™., "Fangio™", "Argentina™", 51, 24, 
new int[] { 1951, 1954, 1955, 1956, 1957 }, 
new string[] { "Alfa Romeo", "Maserati", "Mercedes"™", "Ferrari™ }) ， 
new Racer ("Mike", "Hawthorn™., "UE", 45, 3, new int[] { 1958 }, 
new string[] { "Ferrari™ }) ， 
new Racer ("Phil", "Hill", "USA™", 48, 3, new int[] { 1961 }, 
new string[] { "Ferrari™ }) ， 
new Racer("John", "Surtees"™, "UK™"., 111, 6, new int[] { 1964 }, 
new string[] { "Ferrari™ }) ， 
new Racer ("Jim", "Clark™"™, "URE™, 72, 25, new int[] { 1963, 1965 }, 
new string[] { "Lotus™ }) ， 
new Racer ("Jack", "Brabham™", "Australia™", 125, 14, 
new int[] { 1959, 1960, 1966 }, new string[] { "Cooper™", "Brabham"™ }) ， 
new Racer("Denny", "Hulme", "New Zealand™", 112, 8, new int[] { 1967 }, 
new string[] 1{ "Brabham™ }) ， 
new Racer("Graham™, "Hill"™", "UK", 176, 14, new int[] { 1962, 1968 1 ， 
new string[] { "BRM", "Lotus™ }) ， 
new Racer(" Jochen™, "Rindt"™"™, "Austria™, 60, 6, new int[] { 1970 }, 
new string[] { "Lotus™ }) ， 
new Racer("Jackie", "Stewart™, "UK™", 99, 27, 
new int[] { 1969, 1971, 1973 }, new string[] { "Matra™.™, "Tyrrell™ }) ， 
ek 


jf 
} 


对 于 后 面 在 多 个 列表 中 执行 的 查询 ，GetConstructorChampions0 方 法 返回 所 有 的 车 队 冠 军 的 列表 。 车 队 冠 军 
是 从 1958 年 开始 设立 的 。 


private static List<Team> S teams; 
Public static ILijst<Team> GetContructorchamplions () 
{ 
if (s teams == null) 
{ 
s teams = new List<Team> () 
{ 
new Team{("Vanwall™", 1958}), 
new Team("Cooper™, 1959, 1960)., 
new Team{("Ferrari", 1961, 1964, 1975, 1976, 1977, 1979, 1982, 1983, 1999, 
2000, 2001, 2002, 2003, 2004, 2007, 2008}), 
new Team{("BRM", 1962)., 
new Team("Lotus", 1963, 1965, 1968, 1970, 1972, 1973, 1978), 
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new Teaml("Brabham™”, 1966, 1967), 
new Teaml("Matra™", 1969)., 
new Team("Tyrrell™", 1971}. 
new Teaml("McLaren™, l1974, 19384, 1385, 1988, 1989, 19390, 1991, 1998), 
new Team("Williams™", 1980, 1981, 1986, 1987, 1992, 1993, 1994, 1996, 
1997)., 
new Team("Benetton™, 1995)., 
new Team("Renault™, 2005, 2006}),， 
new Teaml("Brawn GE™, 2009), 
new Team{("Red Bull Racing", 2010, 2011, 2012, 1013), 
new Teaml("Mercedes™, 2014, 2015, 2016, 2017) 
上 
} 
Ieturn S teams; 


} 
12.1.2 LINQ 查询 
演示 LINQ 的 示例 应 用 程序 是 一 个 控制 台 应 用 程序 ， 使 用 了 如 下 名 称 空间 : 


System 
System.Collections.Generic 


System.LInq 


在 以 前 创建 的 库 中 ， 使 用 这 些 准备 好 的 列表 和 实体 ， 进 行 LINQ 查询 ， 例 如 ， 查 询 来 自 巴 西 的 所 有 世界 冠 
军 ， 并 按照 夺冠 次 数 排序 。 为 此 可 以 使 用 List<T> 类 的 方法 ， 如 FindAl10 和 Sort0 方 法 。 而 使 用 LINQ 的 语法 非 
笛 简 单 (代码 文件 LINQIntro/Program.cs): 


static void LINQODuUeIY () 
{ 

Var uery = from r in Formulal .GetChampions () 
where rr.Country = "Brazil" 
orderby r.Wins descending 
Select rr; 


foreach (Racer T in query) 
{ 
Console.WriteLine ($"{r:A}").; 
} 
} 


这 个 查询 的 结果 显示 了 来 目 巴 西 的 所 有 世界 冠军 ， 并 排 好 序 : 
Ayrton Senna, Brazil; starts: 161, wins: 41 


Nelson Piquet, Brazil; starts: 204, wins: 23 
Emerson Fittipaldi, Brazil; starts: 143, wins: 14 


表达 式 
from r in Formulal.GetcCchampions  () 
where I.Country == "Brazil" 


orderby Ir.Wins descending 
Select Ir; 


是 一 个 LINQ 查询 。 子 句 from、where、orderby、descending 和 select 都 是 这 个 查询 中 预定 义 的 关键 字 。 
查询 表达 式 必须 以 fom 子 句 开头 , 以 select 或 group 子 句 结束 ,在 这 两 个 子 句 之 间 , 可 以 使 用 where、orderby、 
join、let 和 其 他 from 子 句 。 


注意 : 
变量 query 只 指定 了 LINQ 查询 。 该 查询 不 是 通过 这 个 赋值 语句 执行 的 ， 只 要 使 用 foreach 循环 访问 查询 ， 
该 查询 就 会 执行 。 


12.1.3 扩展 方法 


编 诺 器 会 转换 LINQ 碍 询 ， 以 调用 方法 而 不 是 LINQ 查询 。LINQ 为 IEnumerable<T> 接 口 提 供 了 各 种 扩展 
方法 ， 以 便 用 户 在 实现 了 该 接口 的 任意 集合 上 使 用 LINQ 查询 。 扩 展 方法 在 静态 类 中 声明 ， 定 义 为 一 个 静态 方 
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法 ， 其 中 第 一 个 参数 定义 了 它 扩展 的 类 型 。 

扩展 方法 可 以 将 方法 写 入 最 初 没有 提供 该 方法 的 类 中 。 还 可 以 把 方法 添加 到 实现 某 个 特定 接口 的 任何 类 中 ， 
这 样 多 个 类 就 可 以 使 用 相同 的 实现 代码 。 

例如 ，String 类 没有 Foo0 方 法 。Sting 类 是 密封 的 ， 所 以 不 能 从 这 个 类 中 继承 。 但 可 以 创建 一 个 扩展 方法 ， 
如 下 所 示 : 

public static class StringExtension 

public static void Foo (this string s) 


Console.WriteLine (S$"Foo invoked for {s}"™); 
} 
} 


Foo0 方 法 扩展 了 String 类 , 因为 它 的 第 一 个 参数 定义 为 String 类 型 。 为 了 区 分 扩展 方法 和 一 般 的 静态 方法 ， 
扩展 方法 还 需要 对 第 一 个 参数 使 用 this 关键 字 。 现 在 就 可 以 使 用 带 string 类 型 的 Foo0 方 法 了 : 


string s = "Hello™; 
S5.FoOO(); 


结果 在 控制 台 上 显示 “Foo invoked for Hello”， 因 为 Hello 是 传递 给 Foo0 方 法 的 字符 串 。 

也 许 这 看 起 来 违反 了 面 癌 对 象 的 规则 ,因为 给 一 个 类 型 定义 了 新 方法 , 但 没有 改变 该 类 型 或 派生 上 自 它 的 类 型 。 
但 实际 上 并 非 如 此 。 扩展 方法 不 能 访问 它 扩展 的 类 型 的 私有 成 员 。 调 用 扩展 方法 只 是 调用 静态 方法 的 一 种 新 语法 。 
对 于 字符 串 ， 可 以 用 如 下 方式 调用 Foo0 方 法 ， 获 得 相同 的 结果 ; 


string s = "Hello"™s; 
StringExtension.Foo(s); 


要 调用 静态 方法 ， 应 在 类 名 的 后 面 加 上 方法 名 。 扩 展 方法 是 调用 静态 方法 的 另 一 种 方式 。 不 必 提 供 定 义 了 
静态 方法 的 类 名 ， 相 反 ， 编 译 器 调用 静态 方法 是 因为 它 带 的 参数 类 型 。 只 需要 导入 包含 该 类 的 名 称 空间 ， 就 可 
以 将 Foo0 扩 展 方 法 放 在 String 类 的 作用 域 中 。 

定义 LINQ 扩展 方法 的 一 个 类 是 System.Linq 名 称 空间 中 的 Enumerable。 只 需要 导入 这 个 名 称 空间 ， 就 可 
以 打开 这 个 类 的 扩展 方法 的 作用 域 。 下 面 列 出 了 Where0 扩 展 方法 的 实现 代码 。Where0 扩 展 方法 的 第 一 个 参数 
包含 了 this 关键 字 ， 其 类 型 是 IEnumerable<T>。 这 样 ，Where0 方 法 就 可 以 用 于 实现 下 Enumerable<T> 的 每 个 类 
型 。 例 如 ， 数 组 和 List<T> 类 实现 了 IEnumerable<T> 接 口 。 第 二 个 参数 是 一 个 Func<T,bool> 委 托 ， 它 引用 了 一 
个 返回 布尔 值 、 参 数 类 型 为 工 的 方法 。 这 个 谓词 在 实现 代码 中 调用 ， 检 查 IEnumerable<T> 源 中 的 项 是 否 应 放 在 
目标 集合 中 。 如 果 委 托 引 用 了 该 方法 ，yield return 语句 就 将 源 中 的 项 返回 给 目标 。 

public static IEnumerable<TSource> Where<TSource>( 

this IEnumerable<TSource> source, 
FUuNnc<TSource, bool> predicate) 
foreach (TSource item in source) 
{ 
工 主 (predicate (Item) ) 
Vlield return item; 


} 
} 


因为 Where0 作 为 一 个 泛 型 方法 实现 ， 所 以 它 可 以 用 于 包含 在 集合 中 的 任意 类 型 。 实 现 了 IEnumerable<T> 
接口 的 任意 集合 都 文 持 它 。 


注意 : 

这 里 的 扩展 方法 在 System.Core 程序 集 的 System.Linq 名 称 空间 中 定义 。 

现在 就 可 以 使 用 Enumerable 类 中 的 扩展 方法 Where0 、OrderByDescending0 和 SelectD0。 这 些 方 法 都 返回 
IEnumerable<TSource>， 所 以 可 以 使 用 前 面 的 结果 依次 调用 这 些 方 法 。 通 过 扩展 方法 的 参数 ， 使 用 定义 了 委托 
参数 的 实现 代码 的 匿名 方法 (代码 文件 LINQIntro/Program.cs)。 


static volid ExtensionMethods () 


| 
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Var champions = new List<Racer> (Formulal.GetcCchampions () ) ; 
IEnumerable<Racer> brazilChampions = 
champions .Where(I =< r.Country == "Brazil") 
-OrderByDescending(r =< Ir.Wins) 
-Select (rr =< 工 ) ; 


foreach (Racer IT in brazilChampions) 
{ 
Console.WriteLine ($s$"{r:A}"™).; 


} 
12.1.4 推迟 查询 的 执行 


在 运行 期 间 定 义 碍 询 表 达 式 时 ， 碍 询 就 不 会 运行 。 碍 询 会 在 途 代 数据 项 时 运行 。 
再 看 看 扩展 方法 Where 〇 。 它 使 用 yield retum 语句 返回 谓词 为 rue 的 元 素 。 因 为 使 用 了 yield retum 语句 ， 
所 以 编译 器 会 创建 一 个 枚 举 器 ， 在 访问 枚 举 中 的 项 后 ， 就 返回 它们 。 


Public static IEnumerable<T> Where<T> (this IEnumerable<T> source, 
FUNC<T, bool> predicate) 
{ 
foreach ({T item in sourcey 
{ 
if (predicate (i1tem)) 
{ 
Yield return item; 
} 
} 
} 
} 


这 是 一 个 非常 有 趣 也 非常 重要 的 结果 。 在 下 面 的 例子 中 ,创建 了 String 元 素 的 一 个 集合 ， 用 名 称 填 充 它 。 
接着 定义 一 个 查询 ， 从 集合 中 找 出 以 字母 了 开头 的 所 有 名 称 。 和 集合 也 应 是 排 好 序 的 。 在 定义 查询 时 ， 不 会 进行 
迁 代 。 相 反 ， 连 代 在 foreach 语句 中 进行 ， 在 其 中 迁 代 所 有 的 项 。 集 合 中 只 有 一 个 元 系 Juan 满足 where 表达 式 
的 要 求 ， 即 以 字母 J 开 头 。 迁 代 完 成 后 ， 将 Juan 写 入 控制 合 。 之 后 在 集合 中 诡 加 4 个 新 名 称 ， 再 次 进行 迁 代 ( 代 
码 文 件 LINQIntro/Program.cs)。 


static void DeferredQuery!() 
{ 
Var names = new List<string> { "Nino™"™, "Alberto"™, "Juan™, "Mike™, “Phil™ }; 
Var namesWithyJ = from n in names 
Where n.startsWith ("J") 
orderby n 
select ns; 


Console .WriteLine ("First iteration™):; 
foreach (string name in namesWithyJ) 
{ 
Console.WriteLine (name}); 
} 


Console .WriteLine().; 


names.BAdd ("John™).; 

names.Add ("Jim"™"); 

names .Bdd("Jack™).: 

names.Add ("Dennvy™); 

Console .WriteLine{({"Second iteration™).; 


foreach (string name in namesWithyJ) 
{ 
Console.WriteLine (name).; 


} 
因为 迭代 在 查询 定义 时 不 会 进行 ， 而 是 在 执行 每 个 foreach 语句 时 进行 ， 所 以 可 以 看 到 其 中 的 变化 ， 如 应 用 
程序 的 结果 所 示 : 


First iteration 
Juan 

Second iteration 
Jack 

Jim 

John 

Juan 
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当然 ， 还 必须 注意 ， 每 次 在 和 迭代 中 使 用 查询 时 ， 都 会 调用 扩展 方法 。 大 多 数 情况 下 ， 这 是 非常 有 效 的 ， 因 
为 我 们 可 以 检测 出 源 数 据 中 的 变化 。 但 在 一 些 情况 下 ， 这 是 不 可 行 的 。 调 用 扩展 方法 ToAray0、TIoList0 等 可 
以 改变 这 个 操作 。 在 示例 中 ，ToList 过 历 集合 ， 返 回 一 个 实现 了 IList<string> 的 集合 。 之 后 对 返回 的 列表 遍历 两 
次 ， 在 两 次 迭代 之 间 ， 数 据 源 得 到 了 新 名 称 。 


var names = new List<string> { "Nino™"™, "Alberto"™"., "Juan™, "Mike™, "Phil™ }; 
Var namesWithy = (Erom n In names 

where n.startsWith ("J") 

orderby n 


select ny) .ToList().; 


Console .WriteLine ("First iteration™); 
foreach (string name in namesWithyJ) 
{ 
Console .WriteLine (name).; 
} 


Console .WriteLine ():; 


names.Add ("John™),; 

names.Add ("Jim").; 

names.Add ("Jack™}); 

names.Add ("Denny™.); 

Console .WriteLine ("Second iteration™).: 
foreach (string name in namesWithyJ) 

{ 


Console .WriteLine (name).- 


在 结果 中 可 以 看 到 ， 在 两 次 磷 代 之 间 输 出 保持 不 变 ， 但 集合 中 的 值 改变 了 : 
pda iteration 


Second iteration 
Juan 


12.2 标准 的 查询 操作 符 


Where、OrderByDescending 和 Select 只 是 LINQ 定义 的 几 个 查询 操作 符 。LINQ 查询 为 最 常用 的 操作 符 定 
义 了 一 个 声明 语法 。 还 有 许多 查询 操作 符 可 用 于 Enumerable 类 。 
表 12-1 列 出 了 Enumerable 类 定义 的 标准 查询 操作 符 。 


表 12-1 
标准 查询 操作 符 说 明 
Where 筛选 操作 符 定 义 了 返回 元 素 的 条 件 。 在 Where 查询 操作 符 中 可 以 使 用 谓词 ， 例 如 ，lambda 表 
OfType<TResult> 达 式 定义 的 谓词 ， 来 返回 布尔 值 。OfType<TResult> 根 据 类 型 筛选 元 素 ， 只 返回 TResult 类 型 
的 元 素 
Select 投射 操作 符 用 于 把 对 象 转换 为 另 一 个 类 型 的 新 对 象 。Select 和 SelectMany 定义 了 根据 选择 器 函 
SelectMany 数 选 择 结果 值 的 投射 
OrderBy 排序 操作 符 改 变 所 返回 的 元 素 的 顺序 。OrderBy 按 升 序 排序 ，OrderByDescending 按 降 序 排序 。 
ThenBy 如 果 第 一 次 排序 的 结果 很 类 似 ， 束 可 以 使 用 ThenBy 和 ThenByDescending 操作 符 进行 第 二 次 排 
OrderByDescending 序 。Reverse 反 转 集合 中 元 素 的 顺序 
ThenByDescendmng 
Reverse 
Join 连接 操作 符 用 于 合并 不 直接 相关 的 集合 。 使 用 Join 操作 符 ， 可 以 根据 键 选择 器 函数 连接 两 个 集 
GroupJoin 合 ， 这 类 似 于 SQL 中 的 JOIN。GroupJoin 操作 符 连 接 两 个 集合 ， 组 合 其 结果 
GroupBy 组 合 操作 符 把 数据 放 在 组 中 。GroupBy 操作 符 组 合 有 公共 键 的 元 素 。ToLookup 通过 创建 一 个 一 


ToLookup 对 多 字典 ， 来 组 合 元 素 
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First 
FirstOrDefault 
Last 
LastOrDefault 
ElementAt 


ElementAtOrDefault 


Single 


singleOrDetfault 


Count 

SUMm 

Min 

Max 

Average 
Ageregate 
ToAIrray 
AsEnumerable 
ToList 
ToDictionary 
Cast<TResult> 
Empty 
Ranee 


Repeat 


( 续 表 ) 
说 明 

如 果 元 素 序 列 满足 指定 的 条 件 ， 限 定 符 操作 符 就 返回 布尔 值 。Any、Al 和 Contains 都 是 限定 符 
操作 符 。Any 确定 集合 中 是 否 有 满足 谓词 函数 的 元 素 ; All 确定 集合 中 的 所 有 元 素 是 否 都 满足 谓 
词 函 数 ， Contains 检查 某 个 元 素 是 否 在 集合 中 
分 区 操作 符 返 回 集合 的 一 个 子 集 。Take、Skip、TakeWhile 和 SkipWhile 都 是 分 区 操作 符 。 使 用 
它们 可 以 得 到 部 分 结果 。 使 用 Take 必须 指定 要 从 集合 中 提取 的 元 素 个 数 ，skip 跳 过 指定 的 元 素 
个 数 ， 提 取 其 他 元 素 ; TakeWhile 提取 条 件 为 真 的 元 素 ，SkipWhile 跳 过 条 件 为 真 的 元 素 


Set 操作 符 返 回 一 个 集合 。Distinct 从 集合 中 删除 重复 的 元 素 。 除 了 Distinet 之 外 ， 其 他 Set 操作 
符 都 需要 两 个 集合 。Union 返回 出 现在 其 中 一 个 集合 中 的 唯一 元 素 。Intersect 返回 两 个 集合 中 都 
有 的 元 素 。Except 返回 只 出 现在 一 个 集合 中 的 元 素 。Zip 把 两 个 集合 合并 为 一 个 


这 些 元 素 操 作 符 仅 返回 一 个 元 素 。First 返回 第 一 个 满足 条 件 的 元 素 。FirstOrDefault 类 似 于 First， 
但 如 果 没 有 找到 满足 条 件 的 元 素 ， 就 返回 类 型 的 默认 值 。Last 返回 最 后 一 个 满足 条 件 的 元 素 。 
ElementAt 指定 了 要 返回 的 元 素 的 位 置 。Single 只 返回 一 个 满足 条 件 的 元 素 。 如果 有 多 个 元 素 都 
满足 条 件 ， 就 抛 出 一 个 异常 。 所 有 的 DrDefault 方法 都 类 似 于 以 相同 前 组 开头 的 方法 ,但 如 果 
没有 找到 该 元 素 ， 它 们 就 返回 类 型 的 默认 值 


聚合 操作 符 计 算 集 合 的 一 个 值 。 利 用 这 些 聚 合 操作 符 ， 可 以 计算 所 有 值 的 总 和 、 所 有 元 素 的 个 
数 、 值 最 大 和 最 小 的 元 素 ， 以 及 平均 值 等 


这 些 转换 操作 符 将 集合 转换 为 数组 ，IEnumerable、IList、IDictionary 等 。Cast 方法 把 集合 的 每 


这 些 生 成 操作 符 返 回 一 个 新 集合 。 使 用 Empty 时 集合 是 空 的 ，Range 返回 一 系列 数字 ;Repeat 
返回 一 个 始终 重复 一 个 值 的 集合 


下 面 是 使 用 这 些 操 作 符 的 一 些 例子 。 


2 


下 面 介 绍 一 些 得 询 的 示例 。 示 例 应 用 程序 是 一 个 控制 人 台 应 用 程序 ， 使 用 了 如 下 名 称 空间 : 


System 


System.Collections.Generic 


System.LIinq 
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这 个 带 有 下 载 代码 的 示例 应 用 程序 提供 了 上 述 每 个 不 同 特 性 的 传递 命令 行 参数 ,在 Properties 页 面 的 Debug 
部 分 ， 可 以 根据 需要 配置 命令 行 参数 ， 以 运行 应 用 程序 的 不 同 部 分 。 在 命令 行 中 ， 可 以 使 用 NET Core 命令 行 
实用 程序 以 以 下 方式 调用 命令 : 

dotnet run 一 一 -ft 

其 中 将 参数 了 传递 给 应 用 程序 。 

使 用 where 子 句 ， 可 以 合并 多 个 表达 式 。 例 如 ， 找 出 赢得 至 少 15 场 比赛 的 巴西 和 奥地利 赛车 手 。 传 递 给 
where 子 句 的 表达 式 的 结果 类 型 应 是 布尔 类 型 (代码 文件 EnumerableSample/FilteringSamples.cs): 


static void Filteringl() 


{ 
Var Tacers = from r in Formlal.GetcCchampions () 
Where r.Wins > 15 区区 
(F.Country == "Brazil™” || r.Country == "Austria") 
Select rr; 


foreach (var T in racers) 


Console .WriteLine(s"{r:B}").:; 
} 
} 


用 这 个 LINQ 查询 局 动 程序 ， 会 返回 Niki Lauda、Nelson Piquet 和 Ayrton Senna， 如 下 : 


Niki Lauda, Austria, Starts: 173, Wins: 25 
Nelson Piquet, Brazil, Starts: 204, Wins: 23 
Ayrton Senna, Brazil, Starts: 161, Wins: 41 


并 不 是 所 有 的 查询 都 可 以 用 LINQ 查询 语法 完成 。 也 不 是 所 有 的 扩展 方法 都 映射 到 LINQ 查询 子 名 上。 高 
级 查询 需要 使 用 扩展 方法 。 为 了 更 好 地 理解 带 扩 展 方法 的 复杂 碍 询 ， 最 好 看 看 简单 的 查询 是 如 何 映射 的 。 使 用 
扩展 方法 Where0 和 Select0， 会 生成 与 前 面 LINQ 盘 询 非常 类 似 的 结果 (代码 文件 EnumerableSample/ 
FilterineSamples.cs): 
static void FilteringWithMethods () 
Var Iacers = Formulal .GetChampIons  () 
.Where(r => r.Wins > 15 gE&& 
{(r.Country == "Brazil™” || r.Country == "Austria")) 
-SeElect (rr = 工 ) 7 
fp 
} 


12.2.2 ”用 索引 筛选 

不 能 使 用 LINQ 查询 的 一 个 例子 是 Where0 方 法 的 重 载 ,在 Where0 方 法 的 重 载 中 , 可 以 传递 第 二 个 参数 一 一 
索引 。 宕 引 是 往 选 器 返回 的 每 个 结果 的 计数 器 。 可 以 在 表达 式 中 使 用 这 个 案 引 ， 执 行 基于 索引 的 计算 。 下 面 的 
代码 由 Where0 扩 展 方法 调用 ， 它 使 用 索引 返回 姓氏 以 A 开头、 索引 为 偶数 的 赛车 手 ( 代 码 文 件 
EnumerableSample/FiltermeSamples.cs): 

a VoOld FilteringWithIindex() 


Var Iacers = Formulal .GetChampIons () 
.Where(l(r, index) => r.LastName.StartsWith("A") g&& index $% 2 != 0).， 


foreach (var r in racers) 
Console.WriteLine (S$"{r:A}"); 
姓氏 以 A 开头 的 所 有 赛车 手 有 Alberto Ascari、Mario Andretti 和 Fernando Alonso。 因 为 Mario Andretti 的 索 
引 是 奇数 ， 所 以 他 不 在 结果 中 : 


Alberto Ascari, Italy; starts: 32, wins: 10 
Fernando Alonso, Spain; starts: 279, wins: 33 
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12.2.3 ”类 型 簿 选 


为 了 进行 基于 类 型 的 季 选 , 可 以 使 用 OfType0 扩 展 方法 。 这 里 数组 数据 包含 string 和 int 对象。 使 用 OfTypeO 
扩展 方法 ， 把 string 类 传送 给 泛 型 参数 ， 就 从 集合 中 仅 返 回 字 符 串 (代码 文件 EnumerableSample/ 


FilterineSamples.cs): 
static void TypeFiltering'() 
{ 
object[] data = { "one™, 2, 3, "four™, "five™"™, 6 }; 


Var dueryY = data.O0fType<string>(); 
foreach (var 5 in query) 


Console.WriteLine(s); 


} 


} 

运行 这 段 代 码 ， 就 会 显示 字符 串 one、four 和 five。 
Di 全 

four 

five 


12.2.4 ”复合 的 from 子 名 


如 果 需 要 根据 对 象 的 一 个 成 员 进 行 第 选 ， 而 该 成 员 本 号 是 一 个 系列 ， 就 可 以 使 用 复合 的 from 子 句 。Racer 
类 定义 了 一 个 属性 Cars， 其 中 Cars 是 一 个 字符 串 数组 。 要 筛选 轨 驶 法 拉 利 的 所 有 冠军 ， 可 以 使 用 如 下 所 示 的 
LINQ 查询 。 第 一 个 fom 子 句 访问 从 Formulal.GetChampions0 方 法 返回 的 Racer 对 象 ， 第 二 个 from 子 句 访问 
Racer 类 的 Cars 属性 ， 以 返回 所 有 string 类 型 的 赛车 。 接 着 在 where 子 句 中 使 用 这 些 赛 车 饶 选 轨 驶 法 拉 利 的 所 
有 和 冠 盏 (代码 文件 EnumerableSample/CompoundFromSamples.cs)。 


static void CompounadFTrom (1) 


{ 
var ferrariDrivers = from z in Formlal .GetChampions () 
from cc in r.Cars 
where c == "Ferrari™ 
orderby I.LastName 
select r.FirstName + " "+ Ir.LastName; 
fe 
} 


这 个 查询 的 结果 显示 了 轨 驶 法 拉 利 的 所 有 一 级 方程 式 冠 军 : 


Alberto Ascari 
Juan Manuel Fangio 
Mike Hawthorn 

Phil HL1L1 

Nik1i Lauda 

Kimi RilkkSnen 
Jody Scheckter 
Michael Schumacher 
John Surtees 


C# 编 译 器 把 复合 的 fom 子 句 和 LINQ 查询 转换 为 SelectMany0 扩 展 方法 。SelectMany0 方 法 可 用 于 迭 代 序 
列 的 序列 。 示 例 中 SelectMany0 方 法 的 重 载 版 本 如 下 所 示 : 

Public static IEnumerable<TResult> SelectMany<TSource, TCollection, TResult> ( 

this IEnumerable<TSource> source, 
ee collectionSselector, 
FUuNcC<TSOuUrce, TCollection, TResult> resultSelector); 

第 一 个 参数 是 隐 式 参数 ， 它 从 GetChampions(0 方 法 中 接收 Racer 对 象 序列 。 第 二 个 参数 是 collectionSelector 
委托 ， 其 中 定义 了 内 部 序列 。 在 lambda 表达 式 T 一 LICars 中 ， 应 返回 赛车 集合 。 第 三 个 参数 是 一 个 委托 ， 现 在 
为 每 个 赛车 调用 该 委托 ， 接 收 Racer 和 Car 对 象 。lambda 表达 式 创 建 了 一 个 匿名 类 型 ， 它 有 Racer 和 Car 属性 。 
这 个 SelectMany0 方 法 的 结果 是 摊 平 了 赛车 手 和 赛车 的 层次 结构 ， 为 每 辆 赛车 返回 匿名 类 型 的 一 个 新 对 象 集合 。 

这 个 新 集合 传递 给 Where0 方 法 ， 筛 选 出 轨 驶 法 拉 利 的 赛车 手 。 最 后 ， 调 用 OrderBy0 和 Select0 方 法 (代码 
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文件 EnumerableSample/CompoundFromSamples.cs): 


static void CompoundFromWithMethods () 


{ 
Var ferrariDrivers = Formulal .GetcCchampions () 
.SelectMany (rr => r.Cars, (rr, &) => new { Racer = rr, Car 二 }) 
.Wherel(r 一 > Ir.Car == "Ferrari™) 


.OIrderBy(r => I.Racer.LastNMame) 
.Select(r 一 > Ir.Racer.FirstName + ™ ™ 十 Ir.Racer.LastName):; 


} 
把 SelectMany0 泛 型 方法 解析 为 这 里 使 用 的 类 型 ， 所 解析 的 类 型 如 下 所 示 。 在 这 个 例子 中 ， 数 据 源 是 Racer 
类 型 ， 所 筛选 的 集合 是 一 个 string 数组 ， 当 然 所 返回 的 匿名 类 型 的 名 称 是 未 知 的 ， 这 里 显示 为 TResult: 
public static IEnumerable<TResult> SelectMany<Racer, string, TResult> ( 
this IEnumerable<Racer> source, 


Func<Racer, IEnumerable<string>> collectionselector, 
FUunc<Racer, string, TResult> resultSelector); 


因为 查询 仅 从 LINQ 查询 转换 为 扩展 方法 ， 所 以 结果 与 前 面 的 相同 。 


12.2.5 排序 


要 对 序列 排序 ， 前 面 使 用 了 orderby 子 句 。 下 面 复习 一 下 前 面 使 用 的 例子 ， 但 这 里 使 用 orderby descending 
子 句 。 其 中 赛车 手 按照 启 得 比赛 的 次 数 进行 降序 排序 ， 硫 得 比赛 的 次 数 用 关键 字 选 择 器 指定 (代码 文件 
EnumerableSsample/SortineSamples.cs): 


static void SortDescending() 


| 


Var Tacers = from T In Formlal.GetChampions () 
where Ir.Ccountry == "Brazil" 
orderby r.Wins descending 
select Ir; 

/i-.- 

} 


orderby 子 句 解析 为 OrderBy0 方 法 ，orderby descending 子 句 解析 为 OrderByYDescending0 方 法 (代码 文件 
EnumerableSample/SortineSamples.cs): 
static void SortDescendingWithMethods () 
| var racers = Formulal.GetChampions () 
.Where (IT => r.Country == "Brazil") 
.OrderByDescending (rz => r.Wins) 
-SETect( 工 => 工 ) ; 
EC 
OrderBy0 和 OrderByDescending0 方 法 返回 IOrderEnumerable<TSource>。 这 个 接口 派生 自 IEnumerable<TSource> 
接口 ， 但 包含 一 个 额外 的 方法 CreateOrderedEnumerable<TSource>0。 这 个 方法 用 于 进一步 给 序列 排序 。 如 果 根 据 关 
键 字 选 择 器 来 排序 ， 其 中 有 两 项 相同 ， 就 可 以 使 用 ThenBy0 和 ThenByDescending () 方 法 继续 排序 。 这 两 个 方法 需 
要 IOrderEnumerable<TSource> 接 口才 能 工作 ， 但 也 返回 这 个 接口 。 所 以 ， 可 以 添加 任意 多 个 ThenBy0O 和 
ThenByDescending( 方 法 ， 对 集合 排序 。 
使 用 LINQ 碍 询 时 , 只 需要 把 所 有 用 于 排序 的 不 同 关键 字 ( 用 逗号 分 隅 开 ) 添 加 到 orderby 子 句 中 。 在 下 例 中 ， 
所 有 的 赛车 手 先 按照 国家 排序 ， 再 按照 姓氏 排序 ， 最 后 按照 名 字 排 序 。 添 加 到 LINQ 查询 结果 中 的 Take0 扩 展 
方法 用 于 返回 前 10 个 结果 : 


static void SortMultiple () 
{ 
Var racers = (from T in Formlal.Getchamplions () 
orderby r.Country, r.LastName, r.FirstName 
select r) .Take (10):; 
EF 
} 
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排序 后 的 结果 如 下 : 


Argentina: Fangio, Juan Manuel 
Australia: Brabham, Jack 
Australia: Jones, Alan 
Austria: Lauda, Niki 

Austria: Rindt, Jochen 

Brazil: Fittipaldi, Emerson 
Brazil: Piquet, Nelson 

Brazil: Senna, Ayrton 

Canada: Villeneuve, Jacdques 
Finland: Hakkinen, Mika 


使 用 OrderBy0 和 ThenBy0O 扩 展 方法 可 以 执行 相同 的 操作 (代码 文件 EnumerableSample/SortingSamples.cs): 


static void SortMultijpleWithMethods () 


{ 
Var racers = Formulal .GetchampIons () 
.OrderBvyilr => r.Country) 
.ThenBy(r => r.LastName) 
.ThenByvy(r => r.FirstName) 
-Take (10).: 
Ee 
} 
12.2.6 分 组 


要 根据 一 个 关键 字 值 对 查询 结果 分 组 ， 可 以 使 用 group 子 句 。 现 在 一 级 方程 式 冠 军 应 按照 国家 分 组 ， 并 
列 出 一 个 国家 的 冠军 数 。 子 句 groupr byr.Country into g 根据 Country 属性 组 合 所 有 的 赛车 手 ， 并 定义 一 个 新 
的 标识 符 g， 它 以 后 用 于 访问 分 组 的 结果 信息 。group 子 句 的 结果 根据 应 用 到 分 组 结果 上 的 扩展 方法 Count() 
来 排序 ， 如 果 冠 军 数 相 同 ， 就 根据 关键 字 来 排序 ， 该 关键 字 是 国家 ， 因 为 这 是 分 组 所 使 用 的 关键 字 。where 
子 句 根据 至 少 有 两 项 的 分 组 来 筛选 结果 ，select 子 句 创建 一 个 带 County 和 Count 属性 的 匿名 类 型 (代码 文件 
EnumerableSample/GroupineSamples.cs)。 


static void Grouping() 
{ 
Var Countries = from IT in Formulal .GetChamplions () 

group rr by r.Country inte 可 
orderby 可 .Count () descending, g.Key 
Where gg-.count() > 一 2 
Select new 
{ 

Country = g.FKey, 

Count = g.Ccount') 

}; 


foreach (var item in countries) 
{ 
Console.WriteLine($"{item.Country, -10} {item.Count}™); 
} 
} 


结果 显示 了 带 Country 和 Count 属性 的 对 象 集合 : 


UK 
Brazil 
Finland 
Germany 
Australia 
Austria 
Italy 
USA 2 


要 用 扩展 方法 执行 相同 的 操作 ， 应 把 groupby 子 句 解析 为 GroupBy0 方 法 。 在 GroupBy0 方 法 的 声明 中 ， 注 
意 它 返回 实现 了 IGrouping 接口 的 枚 举 对 象 。IGrouping 接口 定义 了 Key 属性， 所 以 在 定义 了 对 这 个 方法 的 调用 
后 ， 可 以 访问 分 组 的 关键 字 : 


Public static IEnumerable<IGroupIng<TKeYy，TSource>> GroupBy<TSource, TRKevy>( 
this IEnumerable<TSource> source, FuNcC<TSource, TKey> keySelector).; 


把 子 句 group r by rCountry into g 解析 为 GroupBydG 一 rCountry)， 返 回 分 组 序列 。 分 组 序列 首先 用 


a 
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OrderByDescending0 方法 排序 ， 再 用 ThenBy0 方 法 排序 。 接 着 调用 Where0 和 Select0 方 法 (代码 文件 
Enumerablesample/GrouplinegSamples.cs)。 


static void GroupingWithMethods () 
{ 

Var Countries = Formulal .GetcCchampions () 
.GroupBy (rr => rr.Country) 
.OrderByDescending(g => 可 -Count () ) 
-ThenBy( => g.Key) 

-Wherel(g => g.Count(} >= 2) 
.SElect{(g => new 
{ 
Country = 可 -及 已 Y， 
Count = 可 -Count () 
}) 


12.27 LINQ 查询 中 的 变量 


在 为 分 组 编写 的 LINQ 查询 中 ，Count 方法 调用 了 多 次 。 使 用 let 子 句 可 以 改变 这 种 方式 。let 允许 在 LINQ 
查询 中 定义 变量 (代码 文件 EnumerableSample/GroupingSamples.cs); 
static void GroupingWithVariables () 
{ 
Var Countries = from r in Formulal .GetcCchampions  () 
group Ir by r.country into 可 
let count = g.Count!'() 
orderby count descending, g.Key 
Where Count >= 之 
select new 
{ 
Country = 9g.Key., 
Count = count 


上 
jis 


} 


使 用 方法 语法 ，Count 方法 也 调用 了 多 次 。 为 了 定义 传递 给 下 一 个 方法 的 额外 数据 (let 子 句 执行 的 操作 )， 
可 以 使 用 Select 方法 来 创建 匿名 类 型 。 这 里 创建 了 一 个 带 Group 和 Count 属性 的 匿名 类 型 。 带 有 这 些 属性 的 一 
组 项 传递 给 OrderByDescending 方法 ， 基 于 匿名 类 型 的 Count 属性 排序 : 
static void GroupingWithAnonymousTypes () 
{ 
var Countries = Formulal .GetChampions () 
.GIOUPBY (I => I.country) 
.Select(g 二 > new { Group = g, Count = g.Count() }) 
.OrderByDescending(g => g.Count) 
.ThenBy(g => 可 -GIOUP -KEY) 
.Wherel(g => g.Count >= 2) 
.SElect 《可 => new 
{ 
Country = 吕 -GIODOUP -及 忆 Y， 
Count = g.Count 
})s 
tf... 
} 


应 考虑 根据 let 子 句 或 Select 方法 创建 的 临时 对 象 的 数量 。 碍 询 大 列表 时 ,创建 的 大 量 对 象 需要 以 后 进行 垃 
圾 收集 ， 这 可 能 对 性 能 产生 巨大 影响。 


12.2.8 ”对 藤 套 的 对 象 分 组 


如 果 分 组 的 对 象 应 包含 嵌 套 的 序列 ， 就 可 以 改变 select 子 句 创建 的 匿名 类 型 。 在 下 面 的 例子 中 ， 所 返回 的 
国家 不 仅 应 包含 国家 名 和 赛车 手数 量 这 两 个 属性 ， 还 应 包含 赛车 手 的 名 序列 。 这 个 序列 用 一 个 赋予 Racers 属性 
的 fonyin 内 部 子 句 指定 ， 内 部 的 from 子 句 使 用 分 组 标识 符 g 获得 该 分 组 中 的 所 有 赛车 手 ， 用 姓氏 对 它们 排序 ， 
再 根据 姓名 创建 一 个 新 字符 串 ( 代 码 文件 EnumerableSample/GroupingSamples.cs): 


static void GroupingAndNestedObjects () 
{ 


Var countries = from r in Formulal.GetcCchampions() 
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group Ir by Ir.Ccountry into g 
let count = 9g.Count() 
orderby count descending, 9g.Key 
where count > 一 2 
Select new 
{ 
Country = g.EKey, 
Count = count., 
Racers = from zl in g 
orderby rl .LastName 
select rl.FirstName + " " + rl1.LastName 
}; 


foreach (var item in countries) 

{ 
Console.WriteLine($"{item.Country, -10} {item.Count}™); 
foreach (Var name in item.Racers) 
{ 

Console .Write{(s$"{name}; ™).; 

} 
Consol]le.WriteLine(}).; 

} 

} 


使 用 扩展 方法 , 内 部 Racer 对 象 是 使 用 IGrouping 类 型 的 group 变量 g 创建 的 , 其 中 Key 属性 是 分 组 的 键 (本 
例 中 的 国家 )， 可 以 使 用 Group 属性 访问 组 的 项 : 


static void GroupingAndNestedObjectsWithMethods () 
{ 
Var Countries = Formulal.GetcCchampions  () 
.GIoupBYy (I => I.Country) 
.SElect (9g => new 


-OrderByDescending (9g => g.Count) 
.ThenByl(g => g.Key) 
.Where(g => 9g.Count >= 2) 
-Select (可 => new 
{ 
Country = gg.Eey, 
Count = 9g.Count, 
Racers = g.Group.0OrderByl(r => I.LastName) 
.Select(r 一 > Ir.FirstName + mm "+ rr.LastName) 


结果 应 列 出 某 个 国家 的 所 有 冠军 : 


UK 10 
Jenson Button; Jim Clark; Lewis Hamilton; Mike Hawthorn; Graham Hill:; 
Damon Hill; James Hunt; Nigel Mansell; Jackie Stewart; John Surtees; 


Brazil 3 

Emerson Fittipaldi; Nelson Piquet; Ayrton Senna; 
Finland 3 

Mika Hakkinen; Kimi Raikkonen; Keke Rosberg; 
Germany 本 


Nico Rosberg; Michael Schumacher; Sebastian Vettel; 
Australia 2 

Jack Brabham; Alan Jones; 

Austria 2 

Niki Lauda; Jochen Rindt; 

Italy 2 

Alberto Ascari; Nino Farina; 

USA 2 

Mario Andretti; Phil Hill]l; 


12.2.9 内 连接 


使 用 join 子 句 可 以 根据 特定 的 条 件 合并 两 个 数据 源 ， 但 之 前 要 获得 两 个 要 连接 的 列表 。 在 一 级 方程 式 
比赛 中 ， 有 赛车 手 冠 军 和 车 队 冠 军 。 赛 车 手 从 GetChampions0 方 法 中 人 返回， 车 队 从 GetConstructorChampionsO) 
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方法 中 人 返回。 现在 要 获得 一 个 年 份 列表 ， 列 出 每 年 的 赛车 手 冠军 和 车 队 冠 军 。 
为 此 ， 先 定义 两 个 查询 ， 用 于 查询 赛车 手 和 车 队 ( 代 码 文件 EnumerableSample/JoinSamples.cs): 


static void InnerJoin't{) 
{ 
Var Iacers = from Ir In Formlal.GetcChampions () 
from Y in Ir.Years 
Select new 
{ 
Year = 
Name = 
} 7 


Yr 
rT.FirstName + mm ™+ rr.LastName 


var teams = from 七 In Formulal .GetContructorchamplions () 
from Y in t.Years 
SelEect new 


{ 
Year = Y, 
Name 三 七 .Name 
}s 


En 
} 


有 了 这 两 个 查询 ， 再 通过 join 子 句 ， 根 据 完 车 手 获得 冠军 的 年 份 和 车 队 获 得 冠军 的 年 份 进行 连接 。select 
子 句 定义 了 一 个 新 的 匿名 类 型 ， 它 包含 Year、Racer 和 Team 属性 。 


Var racershndTeams = (Erom T in racers 
join 七 in teams on r.Year equals t.Year 
select new 
{ 
.Year, 
Champion = r.Name., 
Constructor = 七 -Jame 
}) .Take (10}; 
Console .WriteLine ("Year World Champion\t Constructor Title™); 


foreach (var item in racersAndTeams) 
{ 

Console.WriteLine ($s$"{item.Year}: {item.Champion,—20} {item.Cconstructor}").; 
} 


当然 ， 也 可 以 把 它们 合并 为 一 个 LINQ 查询 ， 但 这 只 是 一 种 个 人 喜好 的 问题 


Var IacCcershndTeams = 
(from r in 
from rl in Formulal.GetChampions () 
from yr in rl.Years 
Select new 
{ 
Year 
Name 
} 
jein 七 in 
from tl1 in Formulal.GetContructorChampions () 
from YL in tl .Years 


= YI, 
= rl.FirstName + mn nm + ri.LastName 


Select new 
{ 
Year = Yt, 
Name = tl1 .Name 
} 


on r.Year equals t.Year 
orderby t.Year 
select new 


{ 


Year = I.Year, 

Racer = I.Name, 

Team = t.Name 
}) .Take (10); 


使 用 扩展 方法 可 以 加 入 赛车 手 和 车 队 ， 具 体操 作 是 调用 Join 方法 ， 通 过 第 一 个 参数 传递 车 队 ， 把 他 们 与 赛 
车 手 连接 起 来 ， 指 定 外 部 和 内 部 集合 的 关键 字 选 择 器 ， 并 通过 最 后 一 个 参数 定义 结果 选择 器 (代码 文件 
EnumerableSample/JomnSamples.cs): 


static wold InnerJoinWithMethods'() 


| 
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Var racers = Formulal .GetcChampions () 
-SelectMany (rr => I.Years, {Il, vear) => 
New 
{ 

Year = Year, 
Name = $"{rl.FirstName} {rl.LastName}" 
7 

Var teams = Formulal .GetConstructorCchampions () 
.SelectMany l(t => t.Years, (t, Year) => 
ne 
{ 

Year = Year, 
ame = tt .Mame 
}) 5 

Var racershAndTeams = racers.Jointl 

teams,., 


rr => I.Year, 
七 三 > t.Year, 


(rs, 七) 一 > 
New 
{ 
Year = IrI.Year, 
Champion = Ir.Name, 


Constructor = t.Name 
}) .orderBy (item => item.Year) .Take (10); 
9 
} 


结果 显示 了 在 同时 有 了 赛车 手 冠 军 和 车 队 冠 盏 的 前 10 年 中 ， 匿 名 类 型 中 的 数据 : 


Year World Champion Constructor Title 
1958: Mike Hawthorn Vanwall 
1959: Jack Brabham Cooper 
196€0: Jack Brabham Cooper 
1961: Phil Hill Ferrari 
1962: Graham Hill BRM 

1963: Jim Clark Lotus 

1964: John Surtees Ferrarl 
1965: Jim Clark Lotus 

19366: Jack Brabham Brabham 
1961: Denny Hulme Brabham 


图 12-1 是 通过 内 部 连接 结合 的 两 个 集合 的 图 形 表示 。 使 用 内 部 连接 ， 结 果 与 两 个 集合 匹配 。 


12-1 


12.2.10 左 外 连接 


上 一 个 连接 示例 的 输出 从 1958 年 开始 ， 因 为 从 这 一 年 开始 ， 才 同时 有 了 赛车 手 冠 宇和 车 队 冠 年 。 赛 车 
手 冠 军 出 现 得 更 早 一 些 ， 是 在 1950 年 。 使 用 内 连接 时 ， 只 有 找到 了 匹配 的 记录 才 人 返回 结果 。 为 了 在 结果 中 
包含 所 有 的 年 份 ， 可 以 使 用 左 外 连接 。 左 外 连接 返回 左边 序列 中 的 全 部 元 素 ， 即 使 它们 在 右边 的 序列 中 并 没有 
匹配 的 元 素 。 

下 面 修改 前 面 的 LINQ 查询 ， 使 用 左 外 连接 。 左 外 连接 用 join 子 句 和 DefaultIfEmpty 方法 定义 。 如 果 查 询 
的 左 侧 ( 赛 车 手 ) 没 有 匹配 的 车 队 冠 军 ， 就 使 用 DefaultlfEmpty 方法 定义 其 右 侧 的 默认 值 (代码 文件 
EnumerableSample/JoinSamples.cs); 


static void LeftOuterJoint{) 
{ 
FA 
VAaAr racershandTeams = 
{from Ir in racers 


/1 - 


} 


第 12 章 LINQ | 259 


join 七 in teams on r.Year edquals t.Year into rt 
from 七 in rt.DefaultIfEmpty!() 

orderby I.Year 
SeElect new 


{ 


Year = I.Year, 
Champion = 工 -Name， 
Constructor = tt == null ? "no constructor championship™" : t.Name 


1}) .Take (10); 


通过 扩展 方法 执行 相同 的 查询 时 , 使 用 GroupJoin 方法 。 前 三 个 参数 与 Join 和 GroupJoin 相似 。 但 GroupJoin 
的 结果 是 不 同 的 。Join 方法 返回 一 个 平 铺 列表 ， 而 GroupJoin 返回 一 个 列表 ， 其 中 第 一 个 列表 中 包含 的 每 个 匹 
配 项 都 包含 第 二 个 列表 中 的 一 个 匹配 列表 。 使 用 下 面 的 SelectMany 方法 ， 列 表 再 次 被 铺 平 。 如 果 没 有 匹配 的 车 
队 ， 则 Constructors 属性 就 赋予 类 型 的 默认 值 ， 对 类 二 元 ， 默 认 值 都 为 室 。 创 建 匿 名 类 型 时 ， 如 果 车 队 为 空 ， 
Constructors 属性 将 赋予 字符 串 “no constructor championship ”( 代 码 文件 EnumerableSample/JoinSamples.cs): 


static TD LeftoOuterJoinWithMethods () 


| 


po 
了 BIT IaCersAaAndTeams = 
racers.GroupJoin'l 


teams ， 


r => rr.Year, 
七 三 = t.Year, 
《 工 ， ts) 一 > new 


{ 


Year = rr. Year, 


Champiocon = r.Name, 
Constructors = ts 


rt => rt.Constructors.DefaultIfEmpty(), 


}) 

.SelectMany ( 
(rr, 七 ) => new 
{ 


Year = rr.Year, 
Champicon = rr.Champion, 
Constructor = t?.Name ?3? "no constructor championship" 


}) 5; 


FE 


} 


GroupJoin 方法 的 其 他 用 法 详 见 下 一 书 。 


用 这 个 查询 运行 应 用 程序 ， 得 到 的 输出 将 从 1950 年 开始 ， 如 下 所 示 : 


二 电工 


1950: 
了 号 > 工 : 
1992-: 
1943: 
1954: 
1955: 
1956: 
工 呈 -3 7: 
1958: 
1939- 


Champion Constructor Title 


Juan 
Juan 
Juan 
Juan 
MT ke 
Jack 


Manuel Fangio no 
Manuel Fangio no 
Manuel] Fangio no 
Manuel] Fangio no 
Hawthorn Yanwall 
Brabham Cooper 


Nino Farina no constructor championship 

Juan Manuel Fangio no constructor championship 
Alberto Ascari no constructor championship 
Alberto Ascari no constructor championship 


constructor champlilonship 


constructor championship 


constructor champlionship 
constructor championship 


图 12-2 是 两 个 集合 和 一 个 左 外 连接 的 图 形 表示 。 使 用 左 外 连接 ， 结 果 不 仅 与 集合 A 和 集合 B 匹配 ， 还 包 
括 右 集 合 B。 


图 12-2 
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0 路 


12.2.11 组 连接 


左 外 连接 使 用 了 组 连接 和 into 子 句 。 它 有 一 部 分 语法 与 组 连接 相同 ， 只 不 过 组 连接 不 使 用 DefaultfEmpty 方 法 。 

使 用 组 连接 时 ， 可 以 连接 两 个 独立 的 序列 ， 对 于 其 中 一 个 序列 中 的 某 个 元 素 ， 男 一 个 序列 中 存在 对 应 的 一 
个 项 列表 。 

下 面 的 示例 使 用 了 两 个 独立 的 序列 。 一 个 是 前 面 例子 中 已 经 看 过 的 冠军 列表 。 男 一 个 是 一 个 Championship 
类 型 的 集合 。 下 面 的 代码 段 显 示 了 Championship 类 型 。 该 类 包含 冠军 年 份 以 及 该 年 份 中 获得 第 一 名 、 第 二 名 和 
第 三 名 的 赛车 手 ， 对 应 的 属性 分 别 为 Year、First、Second 和 Third( 代 码 文件 DataLib/Championship.cs): 


public class Championship 
{ 
public Championship(int year, string first, string second, string third) 
| 
Year = Yearr' 
First = first; 
Second = second: 
Third = third: 
} 


public int Year { get; } 

public string First { get; } 

public string Second { get; } 

public string Third { get; } 
} 


GetChampionships 方法 返回 了 冠军 集合 ， 如 下 面 的 代码 段 所 示 ( 代 码 文件 DataLib/Formulal.cs): 


private static List<Champlonship> 5s championships; 
public static IEnumerable<Championship> GetChampionships () 
{ 
if (s championships == null) 
{ 
5 championships = new List<Championship> 
{ 
new Championship(1950, “Nino Farina™.™, "Juan Manuel Fangio™, 
"LUuigi Fagd1011") ， 
new CharmplIonship(1951，"UJuan Manuel Fangio", "Alberto Ascari"., 
"Froilan Gonzalez"), 
站 
} 
} 
return s championships; 


} 

冠军 列表 应 与 每 个 冠军 年 份 中 获得 前 三 名 的 赛车 手 构成 的 列表 组 合 起 来 ， 然 后 显示 每 一 年 的 结果 。 

因为 冠军 列表 中 的 每 一 项 都 包含 3 个 赛车 手 ， 所 以 首先 需要 把 这 个 列表 摊 平 。 一 种 方式 是 使 用 复合 的 fom 
子 句 。 由 于 没有 和 集合 可 用 于 单个 项 目的 属性 ， 而 是 需要 将 三 个 属性 (First、Second 和 Third) 合 并 、 挫 平 ， 因 此 创 
建 了 一 个 新 的 List<T>， 其 中 填充 了 这 些 属 性 的 信息 。 对 于 新 建 的 对 象 ， 可 以 使 用 目 定 义 类 和 匿名 类 型 ， 如 前 
所 述 。 这 次 使 用 C# 7 的 一 个 新 特性 : 创建 一 个 元 组 。 元 组 包含 不 同类 型 的 成 员 ， 可 以 使 用 带 插 号 的 元 组 字面 量 
创建 , 如 下 面 的 代码 片段 所 示 。 这 里 , 元 组 的 一 个 摊 平 列表 包含 年 份 、 冠 军 的 位 置 、 赛 车 手 的 名 字 和 姓氏 信息 ( 代 
码 文 件 EnumerableSample/JoinSamples.cs): 


static void GroupJoin() 
{ 
Var racers = from cs in Formulal.Getchampionships () 

from r in new List< 
(Int Year, int Position, string FirstName, string LastName})> () 
{ 
(cs.Year, Position: 1, FirstName: cs.First.FirstName()}), 
LastName: cs.First.LastName (})), 
(cs.Year, Position: 2, FirstName: cs.Second.FirstName{(}), 
LastName: cs.Second.LastName ()}), 
(cs.Year, Position: 3, FirstName: cs.Third.rFirstName(}, 
LastName: cs.Third.LastName (})}) 
} 
Select rr 


Ei 
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第 13 章 给 出 了 元 组 的 详细 信息 。 这 里 的 示例 代码 使 用 了 C# 7.1 中 的 元 组 增强 ， 因 此 编译 器 设置 必须 配置 
为 至 少 使 用 7.1 版 本 。 


扩展 方法 FirstName 和 LastName 使 用 空格 字符 拆 分 字符 串 (代码 文件 EnumerableSample/StringExtensions.cs): 


Public static class StringExtensions 
{ 
Public static string FirstName (this string name) => 
name .Substring (0, name.LastIndexOof(" "))}); 


Public static string LastName (this string name) 三 > 
name .Substring (name.LastIndexOf(" ") + 1); 
} 


现在 就 可 以 连接 两 个 序列 。Formulal.GetChampions 返回 一 个 Racers 列表 ，racers 变量 返回 包含 年 份 、 比 赛 
结果 和 赛车 手 姓名 的 一 个 元 组 。 仅 使 用 姓氏 比较 两 个 集合 中 的 项 是 不 够 的 。 有 时 列表 中 可 能 同时 包含 了 一 个 赛 
车 手 和 他 的 父亲 (如 Damon Hill 和 Graham Hill), 所 以 必须 同时 使 用 FirstName 和 LastName 进行 比较 。 这 是 通过 
为 两 个 列表 创建 一 个 新 的 元 组 实现 的 。 通 过 使 用 into 子 句 ， 第 二 个 集合 中 的 结果 被 添加 到 变量 yearResults 中 。 
对 于 第 一 个 集合 中 的 每 一 个 赛车 手 ， 都 创建 了 一 个 yearResults， 它 包含 了 在 第 二 个 集合 中 匹配 名 和 姓 的 结果 。 
最 后 ， 用 LINQ 查询 创建 了 一 个 包含 所 需 信 息 的 新 元 组 类 型 (代码 文件 EnumerableSample/JoinSamples.cs): 


static void GroupJoin() 
{ 
FF 
Var 可 = (Erom TI In Formulal .Getchampions () 

Join r2 in racers on 

( 
r.FirstName, 
r.LastName 

) 

全 何 U 王 号 

( 
r2.FirstName, 
r2.LastName 

) 

intoe vearResults 

select 

( 
r.FirstName, 
I.LastName,. 
r.Wins, 
r.starts, 
Results: YearResults 


二 


foreach (var IT in gq) 
console .writerine ($"{r. FirstName) {r.LastName}"); 
foreach (var results in rr.Results)} 
Console .WriteLine ($™\t{results.Year} {results.Position}™).; 
. } 
} 
下 面 显 示 了 foreach 循环 得 到 的 最 终结 果 。Jenson Button 3 次 进入 前 三 : 2004 年 是 第 三 名 ，2009 年 是 第 
一 名 ，2011 年 是 第 一 名 。Sebastian Vettel 四 次 获得 世界 冠军 ，2009 年 获得 第 二 名 ，2015 年 获得 第 三 名 。Nico 
Rosberg 获得 2016 年 世界 冠军 ，2014 年 和 2015 年 两 次 获得 第 二 名 : 


Jenson Button 
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2015 3 
Nico Rosberg 
2014 2 
2015 2 
2016 1 


使 用 GroupJoin 和 扩展 方法 ， 语 法 可 能 看 起 来 更 容易 理解 。 首 先 ， 使 用 SelectMany 方法 完成 复合 的 from 
子 句 。 这 一 部 分 没有 太 大 的 不 同 ， 并 且 再 次 使 用 了 元 组 。 调 用 GroupJoin 方法 时 ， 传 递 赛车 手 作 为 第 一 个 参 
数 ， 把 冠军 与 摊 平 的 赛车 手 连接 起 来 ， 用 第 二 个 和 第 三 个 参数 来 匹配 两 个 集合 。 第 四 个 参数 接收 第 一 个 集合 
和 第 二 个 集合 的 赛车 手 。 结 果 包 含 位 置 和 年 份 ， 被 写 入 Results 元 组 成 员 (代码 文件 EnumerableSample/ 
JoinSamples.cs): 


static void GroupJoinWithMethods () 
{ 
Var racers = Formulal .GetcChampionships() 
.SelectMany (cs => new List<(int Year, int Position, string FirstName, 
string LastName)> 
{ 
(cs.Year, Position: 1, FirstName: cs.First.FirstName (), 
LastName: cs.First.LastName()), 
(cs.Year, Position: 2, FirstName: cs.Second.FirstName (}), 
LastName: cs.Second.LastName (})})., 
(cs.Year, Position: 3, FirstName: cs.Third.FirstName (}), 
LastName: cs.Third.LastName (})) 
}); 


Var dq = Formulal .GetChampions () 
-GroupJoin (racers, 
rl => (rl.FirstName, rl1.LastName), 
r2 => (r2.FirstName, r2.LastName), 
(rl1l, r25) => (rl.FirstName, rl.LastName, rl .Wins, rl .starts, 
Results: Ir2s)).; 
fh: 
} 


12.2.12 ”集合 操作 


扩展 方法 Distinct0 站 、Union()、Intersect0 和 Except0 都 是 集合 操作 。 下 面 创建 一 个 驾驶 法 拉 利 的 一 级 方程 式 
冠军 序列 和 要 驶 迈 凯 伦 的 一 级 方程 式 冠 军 序 列 ， 然 后 确定 是 否 有 轨 驶 法 拉 利 和 迈 凯 伦 的 和 冠军。 当然， 这 里 可 以 
使 用 Intersect0 扩 展 方 法 。 

首先 获得 所 有 驾驶 法 拉 利 的 冠军 。 这 只 是 一 个 简单 的 LINQ 查询 ， 其 中 使 用 复合 的 from 子 句 访问 Cars 属 
性 ， 该 属性 返回 一 个 字符 串 对 和 象 序 列 。 


Var ferrariDrivers = from r in Formulal .GetChamplions () 
from C in Ir.Cars 
Where Cc == "Ferrari" 
orderby I.LastName 
Select I; 


现在 建立 男 一 个 基本 相同 的 查询 ， 但 where 子 句 的 参数 不 同 ， 以 获得 所 有 驾驶 迈 凯 伦 的 冠军 。 最 好 不 要 再 
次 编写 相同 的 查询 。 而 可 以 创建 一 个 方法 ， 给 它 传 递 参数 car。 如 果 在 其 他 地 方 不 需要 该 方法 ， 就 可 以 创建 一 个 
本 地 函数 ,racersByCar 是 一 个 本 地 函数 的 名 称 , 它 实现 为 包含 LINQ 查询 的 lambda 表达 式 . 本 地 函数 racersByCar 
在 方法 SetOperations 的 作用 域内 定义 , 因此 只 能 在 此 方法 中 调用 它 。LINQ Intersect 扩展 方法 用 于 获取 所 有 使 用 
法 拉 利 和 迈 凯 伦 赢 得 总 冠军 的 赛车 手 ( 代 码 文件 EnumerableSample/LinqSamples.cs): 


static void SetOperations () 
{ 
IEnumerable<Racer> racersByCar (string car) 三 > 
from r in Formulal.GetcCchampions () 
from C in Ir.Cars 
Where Cc 三 一 Car 
orderby I.LastName 
select 工 ， 


Console .WriteLine ("World champion with Ferrari and McLaren™); 
foreach (var racer 1in 
racersByCar ("Ferrari") .Intersect (racersByCar ("McLaren™))) 
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{ 


Console .WriteLine (racer).; 
] 
} 
注意 : 
本 地 函数 是 C#7 的 一 个 新 特性 ， 详 见 第 13 章 。 


结果 只 有 一 个 赛车 手 Niki Lauda: 

World champion with Ferrari and McLaren 

NIKI Lauda 

注意 : 

集合 操作 通过 调用 实体 类 的 GetHashCode0 和 Equals0 方 法 来 比较 对 象 。 对 于 自 定义 比较 ,还 可 以 传递 一 个 
实现 了 IEqualityComparer<T> 接 口 的 对 和 象 。 在 这 里 的 示例 中 ，GetChampions0) 方 法 总 是 返回 相同 的 对 象 ， 因 此 默 
认 的 比较 操作 是 有 效 的 。 如 果 不 是 这 种 情况 ， 就 可 以 重 载 集合 方法 来 自 定义 比 较 操 作 。 


12.2.13 合并 


Zip0 方 法 允许 用 一 个 谓词 函数 把 两 个 相关 的 序列 合并 为 一 个 。 

首先 ， 创 建 两 个 相关 的 序列 ， 它 们 使 用 相同 的 淀 选 (国家 意大利 ) 和 排序 方法 。 对 于 合并 ， 这 很 重要 ， 因 为 
第 一 个 集合 中 的 第 一 项 会 与 第 二 个 集合 中 的 第 一 项 合并 ， 第 一 个 集合 中 的 第 二 项 会 与 第 二 个 集合 中 的 第 二 项 合 
并 ， 以 此 类 推 。 如 果 两 个 序列 的 项 数 不 同 ，Zip0 方 法 就 在 到 达 较 小 集合 的 末尾 时 停止 。 

第 一 个 集合 中 的 元 素 有 一 个 Name 属性 ， 第 二 个 集合 中 的 元 素 有 LastName 和 Starts 两 个 属性 。 

在 racerNames 集合 上 使 用 Zip0 方 法 ， 需 要 把 第 二 个 集合 (racerNamesAndStarts) 作 为 第 一 个 参数 。 第 二 个 参 
数 的 类 型 是 Func<TFirst, TSecond, TResult>。 这 个 参数 实现 为 一 个 lambda 表达 式 ， 它 通过 参数 frst 接收 第 一 个 
集合 的 元 素 ， 通 过 参数 second 接收 第 二 个 集合 的 元 素 。 其 实现 代码 创建 并 返回 一 个 字符 串 ， 该 字符 串 包含 第 一 
个 集合 中 元 素 的 Name 属性 和 第 二 个 集合 中 元 素 的 Starts 属性 (代码 文件 EnumerableSample/LinqSamples.cs): 


static void Zipoperation() 


| 


var racerNames = from T in Formulal .GetChampions() 
where IrI.country == "Italy™" 
orderby Ir.Wins descending 
Select new 
| 
Name = 工 -FITStName + "” "+ r.LastName 
于 
var racerNamesAndstarts = from IT in Formulal.Getchampions  () 
Where Ir.Ccountry == "Italy™" 
orderby Ir.Wins descending 
Select new 
r.LastName, 
r.Starts 
}; 
Var IacCers = racerNames .2ip(lracerNamesAndstarts, 


(first, second) => first.Name + ", starts: second.starts); 


foreach (var T in racers) 
{ 
Console.WriteLine (r}):; 
} 
} 


这 个 合并 的 结果 是 : 


Alberto Ascari, starts: 32 
Nino Farina, starts: 33 
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12.2.14 分 区 


扩展 方法 Take0 和 Skip0 等 的 分 区 操作 可 用 于 分 页 ， 例 如 ， 在 第 一 个 页 面 上 只 显示 5 个 赛车 手 ， 在 下 一 个 
页 面 上 显示 接 下 来 的 5 个 赛车 手 等 。 

在 下 面 的 LINQ 查询 中 , 把 扩展 方法 Skip0 和 Take0 添 加 到 查询 的 最 后 。Skip0 方 法 先 忽 略 根 据 页 面 大 小 和 
实际 页 数 计 算出 的 项 数 ， 再 使 用 Take0 方 法 根据 页 面 大 小 提取 一 定数 量 的 项 (代码 文件 EnumerableSample/ 
LinqSamples.cs): 


static void Partitioning () 
{ 
int pageSize = 5; 
int numberPages = (int}Math.Cceiling (Formulal.GetChampions() .Count () / 
(double)pageSsize); 


for (int page = 0; Page < numberPages; paget++)} 
{ 
Console.WriteLine ($"Page {page}™);} 


Var racers = {from r in Formulal .GetcChampions  () 
orderby Ir.LastName, I.FirstName 
select r.FirstName + " "+ Ir.LastName). 
Skip (page ~* pageSize) .Take (DageSize); 


foreach (var name in racers) 
{ 
Console .WriteLine (name); 
} 
Console.WriteLine(}); 
} 
} 


下 和 面 输出 了 前 3 页 : 


Page 0 

Fernando Alonso 
Mario Andrett1i 
Alberto Ascari 
Jack Brabham 
Jenson Button 


Page 1 

Jim Clark 

Juan Manuel Fangio 
Nino Farina 
Emerson Fittijpaldi 
Mika Hakkinen 

Padge 2 

Lewis Hamilton 
Mike Hawthorn 
Damon Hill 

Graham Hill 

Phil Hill 


分 页 在 Windows 或 Web 应 用 程序 中 非常 有 用 ， 可 以 只 给 用 户 显示 一 部 分 数据 。 


注意 : 

这 个 分 页 机 制 的 一 个 要 点 是 ， 因 为 查询 会 在 每 个 页 面 上 执行 ， 所 以 改变 底层 的 数据 会 影响 结果 。 在 继续 执 
行 分 页 操作 时 ， 会 显示 新 对 象 。 根 据 不 同 的 情况 ， 这 对 于 应 用 程序 可 能 有 利 。 如 果 这 个 操作 是 不 需要 的 ， 就 可 
以 只 对 原来 的 数据 源 分 页 ， 然 后 使 用 映射 到 原始 数据 上 的 缓存 ， 


使 用 TakeWhile0 和 SkipWhile0 扩 展 方 法 ， 还 可 以 传递 一 个 谓词 ， 根 据 谓 词 的 结果 提取 或 跳 过 某 些 项 。 
12.2.15 ”聚合 操作 符 
聚合 操作 符 ( 如 Count、Sum、Min、Max、Average 和 Ageregate 操作 符 ) 不 返回 一 个 序列 ， 而 返回 一 个 值 。 
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CountO 扩 展 方 法 返回 集合 中 的 项 数 。 下 面 的 CountO 方 法 应 用 于 Racer 的 Years 属性 ， 来 痛 选 哥 车 手 ， 只 返 
回 获得 和 冠军 次 数 超过 3 次 的 赛车 手 。 因为 同一 个 查询 中 需要 使 用 同一 个 计数 超过 一 次 , 所 以 使 用 let 子 句 定义 了 


一 个 变量 numberyYears( 代 码 文 件 EnumerableSample/LinqSamples.cs): 


static void AggregateCount () 
{ 
var query = from r In Formulal .GetChampions () 
let numberYears = r.Years.Countt() 
where numberYears > 一 3 
orderby numberYears descending, I.LastName 
Select new 
{ 
Name = Ir.FirstName + "n+ r.LastName, 
TimesCchampion = numberYears 
}; 


foreach (Var IT in query) 
{ 
Console.WriteLine($"{r.Name} {Ir.TimesChampion}"); 
} 
} 


结果 如 下 : 


Michael Schumacher 7 
Juan Manuel Fangio 5 
Lewis Hamilton 4 
Blain Frost 4 
Sebastian Vettel 4 
Jack Brabham 3 

NIKI Lauda 3 

Nelson Piquet 3 
ByIton Senna 3 
Jackie Stewart 了 


Sum0 方 法 汇总 序列 中 的 所 有 数字 ， 返 回 这 些 数 字 的 和 。 下 面 的 Sum0 方 法 用 于 计算 一 个 国家 赢得 比赛 的 总 
次 数 。 首先 根据 国家 对 赛车 手 分 组 , 再 在 新 创建 的 匿名 类 型 中 , 把 Wins 属性 赋 子 某 个 国家 最 得 比 硬 的 总 次 数 ( 代 


码 文 件 EnumerableSample/LinqSamples.cs): 


static void AggregateSsum!{) 
{ 
Var countries = {from c in 
from r in Formulal .Getchampions  () 
group Ir by r.Ccountry into c 
Select new 


{ 
COUnNntry = C.KRey., 
Wins = {from rl1 in c 
select rl .Wins) .Sum() 
} 


orderby c.Wins descending, c.Country 
select c}) .Take (5); 


foreach (Var country in countries) 
{ 
Console.WriteLine("{country.Ccountry} {country.Wins}"); 
} 
} 


根据 获得 一 级 方程 式 冠 军 的 次 数 ， 最 成 功 的 国家 是 : 


UE 216 
Germany 162 
Brazil 78 


FIrance 51 
Finland 45 


方法 Min0、Max0、Average0 和 Aggregate0 的 使 用 方式 与 Count0 和 Sum0O 相 同 。Min0 方 法 返回 集合 中 的 
最 小 值 ，Max0 方 法 返回 集合 中 的 最 大 值 ，Average0) 方 法 计算 集合 中 的 平均 值 。 对 于 Aggregate0 方 法 ， 可 以 传 


递 一 个 lambda 表达 式 ， 该 表达 式 对 所 有 的 值 进行 聚合 。 
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12.2.16 ”转换 操作 符 


本 章 前 面 提 到 ， 查 询 可 以 推迟 到 访问 数据 项 时 再 执行 。 在 迭代 中 使 用 查询 时 ， 查 询 会 执行 。 而 使 用 转换 操 
作 符 会 立即 执行 查询 ， 把 查询 结果 放 在 数组 、 列 表 或 字典 中 。 

在 下 面 的 例子 中 ， 调 用 ToList0 扩 展 方 法 ， 立 即 执 行 得 询 ， 得 到 的 结果 放 在 List<T> 类 中 (代码 文件 
EnumerableSample/LinqSamples.cs): 


static void ToL1ist{) 
{ 
List<Racer> racers = (from r in Formlal.Getchampions () 
where Ir.Starts > 200 
orderby Ir.Starts descending 
select r) .ToList().:; 


foreach (var racer in racers) 
{ 
Console.WriteLine($"{racer} {racer:3}").- 
} 
} 


查询 结果 显示 ，Jenson Button 是 第 一 : 


Jenson Button 306 
Fernando Alonso 291 
Michael Schumacher 287 
Kimi RaikkSnen 271 
Nico Rosberg 207 
Nelson Piquet 204 


把 返回 的 对 象 放 在 列表 中 并 没有 这 么 简单 。 例 如 ， 对 于 集合 类 中 从 赛车 到 赛车 手 的 快速 访问 ， 可 以 使 用 新 
类 Lookup<TKey, TElement>。 


注意 : 
Dictionary<TKey，TValue> 类 只 支持 一 个 键 对 应 一 个 值 。 在 SystemLinq 名 称 空间 的 类 Lookup<TKey, 


TElement> 类 中 ， 一 个 键 可 以 对 应 多 个 值 。 这 些 类 详 见 第 10 章 。 


使 用 复合 的 from 查询 ， 可 以 摊 平 赛车 手 和 完 车 序列 ， 创 建 带 有 Car 和 Racer 属性 的 匿名 类 型 。 在 返回 的 
Lookup 对 象 中 , 键 的 类 型 应 是 表示 汽车 的 stting， 值 的 类 型 应 是 Racer。 为 了 进行 这 个 选择 ， 可 以 给 ToLookupO 
方法 的 一 个 重 载 版 本 传递 一 个 键 和 一 个 元 素 选 择 器 。 键 选择 器 引用 Car 属性 ， 元 素 选 择 器 引用 Racer 属性 (代码 
文件 EnumerableSample/LinqSamples.cs): 


static void ToLookup () 
{ 
Var racers = (from T in Formulal.GetcChampions () 
from C in r.cars 
Select new 
{ 
CAar = C, 
Racer = 工 
}) .ToLookup (cr => cr.Car, cr => cr.Racer).; 


if (racers.Contains ("Williams")) 

{ 
foreach (var williamsRacer in racers["Williams"]) 
{ 

Console .WriteLine (williamsRacer); 

} 

} 

} 


用 Lookup 类 的 索引 器 访问 的 所 有 “Williams” 冠 军 ， 结 果 如 下 : 


Alan Jones 

Keke Rosberg 

Nigel Mansell 
Alain Prost 

Damon Hill 

Jacgques Villeneuve 
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如 果 需 要 在 非 类 型 化 的 集合 上 (如 ArrayLisb 使 用 LINQ 查询 ， 就 可 以 使 用 Cast0 方 法 。 在 下 面 的 例子 中 ， 基 
于 Object 类 型 的 ArrayList 集合 用 Racer 对 象 填充 。 为 定义 强 类 型 化 的 得 询 ， 可 使 用 Cast0 方 法 (代码 文件 
EnumerableSample/LinqSamples.cs): 

static void ConvertWithCast 

{ 


var list = new System.Collections.ArrayList (Formulal .GetcChampions () 
as System.Collections.ICollection); 


Var dquery = from r in list.Cast<Racer> () 
where I.Ccountry == "USA" 
orderby Ir.Wins descending 
Select rs 


foreach (var racer in query) 


Console.WriteLine("{racer:A}", racer); 
} 
} 


结果 仅 包 含 来 自 美国 的 一 级 方程 式 冠 盏 : 


Mario Andretti, country: USA, starts: 128, wins: 12 
Phil Hill, country: USA, starts: 48, wins: 3 


12.2.17 ”生成 操作 符 


生成 操作 符 Range0、Empty0 和 Repeat0 不 是 扩展 方法 ,而 是 返回 序列 的 正常 静态 方法 。 在 LINQ to Objects 
中 ， 这 些 方法 可 用 于 Enumerable 类 。 
有 时 需要 填充 一 个 范围 的 数字 ， 此 时 就 应 使 用 Range0 方 法 。 这 个 方法 把 第 一 个 参数 作为 起 始 值 ， 把 第 二 个 
参数 作为 要 填充 的 项 数 ( 代 码 文 件 EnumerableSample/LinqSamples.cs): 
static void GenerateRange () 
Var values = Enumerable.Range (ll, 20)); 
foreach (Var item jn values) 
| Console.Write($"{item} ", item); 
} 


Console.WriteLine (}); 


} 
当然 ， 结 果 如 下 所 示 : 


1l1234556789 10 11 12 13 14 1> 16 17 18 19 20 


注意 : 
Range0 方 法 不 返回 填充 了 所 定义 值 的 集合 ， 这 个 方法 与 其 他 方法 一 样 ， 也 推迟 执行 查询 ， 并 返回 一 个 
RangeEnumerator， 其 中 只 有 一 条 yield retum 语句 ， 来 递增 值 。 


可 以 把 该 结果 与 其 他 扩展 方法 合并 起 来 ， 获 得 男 一 个 结果 ， 例 如 ， 使 用 Select0 扩 展 方法 : 

Var values = Enumerable.Range (tl, 20) .Select(n => n * 3).: 

Empty0 方 法 返回 一 个 不 返回 值 的 迭代 器 ， 它 可 以 用 于 需要 一 个 集合 的 参数 ， 其 中 可 以 给 参数 传递 空 集合 。 
Repeat(0 方 法 返回 一 个 迭代 器 ， 该 迭代 器 把 同一 个 值 重复 特定 的 次 数 。 


12.3 并行 LINO 


System.Linq 名 称 空间 中 包含 的 类 ParallelEnumerable 可 以 分 解 查 询 的 工作 ， 使 其 分 布 在 多 个 线程 上 。 尽 管 
Enumerable 类 给 IEnumerable<T> 接 口 定义 了 扩展 方法 ， 但 ParallelEnumerable 类 的 大 多 数 扩 展 方法 是 
ParallelQuery<TSource> 类 的 扩展 。 一 个 重要 的 例外 是 AsParallel0 方 法 ， 它 扩展 了 IEnumerable<TSource> 接 口 ， 
返回 ParallelQuery<TSource> 类 ， 所 以 正常 的 集合 类 可 以 以 并 行 方式 查询 。 
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12.3.1 ”并行 查询 


为 了 说 明 PLINQ (Parallel LINQ, 并 行 LINQ)， 需 要 一 个 大 型 集合 。 对 于 可 以 放 在 CPU 的 缓存 中 的 小 集合 ， 
并 行 LINQ 看 不 出 效果 。 在 下 面 的 代码 中 ， 用 随机 值 填充 一 个 大 型 的 int 集合 (代码 文件 
ParallelLinqSample/Proeram.cs): 

static IEnumerable<int> SampleData () 

const int arraySlize = 50000000 ; 
Var I = new Random(}); 


return Enumerable.Range (0, arraySize) .Select (x => Ir.Next (140)) .ToL1ist(); 
} 


现在 可 以 使 用 LINQ 查询 筛选 数据 ， 进 行 一 些 计算 ， 获 取 所 筛选 数据 的 平均 数 。 该 查询 用 where 子 句 定义 
了 一 个 第 选 器 , 仅 汇总 对 应 值 小 于 20 的 项 , 接着 调用 聚合 函数 Sum0 方 法 。 与 前 面 的 LINQ 查询 的 唯一 区 别 是 ， 


这 次 调用 了 AsParallel0 方 法 。 
static void LinqQuery (IEnumerable<int> data) 
{ 
vAar Ies = {from x in data.AsParallel () 


Where Math.Log (KX) < 4 
select Xx) .Average (}; 
FE 
} 


与 前 面 的 LINQ 查询 一 样 ， 编 译 器 会 修改 语法 ， 以 调用 AsParallel0、Where0、Select0 和 Average0 方 法 。 
AsParallel() 方 法 用 ParallelEnumerable 类 定义 ， 以 扩展 IEnumerable<T> 接 口 ， 所 以 可 以 对 简单 的 数组 调用 和 它 。 
AsParallel0 方法 返回 ParallelQuery<TSource>。 因 为 返回 的 类 型 ， 编 译 器 选择 的 Where0 方 法 是 
ParallelEnumerable.Where()， 而 不 是 Enumerable.Where0。 在 下 面 的 代码 中 ，Select0 和 Average0 方 法 也 来 自 
ParallelEnumerable 类 。 与 Enumerable 类 的 实现 代码 相反 ， 对 于 ParallelEnumerable 类 ， 查 询 是 分 区 的 ， 以 便 多 
个 线程 可 以 同时 处 理 该 得 询 。 集 合 可 以 分 为 多 个 部 分 ， 其 中 每 个 部 分 由 不 同 的 线程 处 理 ， 以 簿 选 其 余 项 。 完 成 
分 区 的 工作 后 ， 就 需要 合并 ， 获 得 所 有 部 分 的 总 和 。 


static void ExtensionMethods (IEnumerable<int> data) 
{ 
Var res = data.AsParallel () 
.Where (xX => Math.Log (xX) < 4) 
-Select (XxX 一 > XxX) .Average (); 
i 
} 


运行 这 行 代码 会 局 动 任务 管理 器 ， 这 样 就 可 以 看 出 系统 的 所 有 CPU 都 在 忙碌 。 如 果 删 除 AsParallel0 方 法 ， 
就 不 可 能 使 用 多 个 CPU。 当 然 ， 如 果 系 统 上 没有 多 个 CPU， 就 不 会 看 到 并 行 版 本 市 来 的 改进 。 


12.3.2 分 区 病 


AsParallel0 方 法 不 仅 扩 展 了 IEnumerable<T> 接 口 ,还 扩展 了 Partitioner 类 。 通 过 它 ， 可 以 影响 要 创建 的 分 区 。 

Partitioner 类 用 System.Collection.Concurrent 名 称 空 间 定 义 ， 并 且 有 不 同 的 变 体 。Create0 方 法 接受 实 
现 了 IList<T> 类 的 数组 或 对 象 。 根据 这 一 点 ， 以 及 Boolean 类 型 的 参数 loadBalance 和 该 方法 的 一 些 重 载 
版 本 ， 会 返回 一 个 不 同 的 Partitioner 类 型 。 对 于 数组 ， 使 用 派生 自 抽象 基 类 OrderablePartitioner<TSource> 
的 DynamicPartitionerForArray<TSource> 类 和 StaticPartitionerForArray<TSource> 类 。 

修改 12.3.1 小 节 中 的 代码 ， 手 工 创建 一 个 分 区 器 ， 而 不 是 使 用 默认 的 分 区 器 (代码 文件 ParallelLinqSample/ 
Program.cs): 


static void UseAPartitioner (IList<int> data) 


{ 
Var result = (from x in Partitioner.Ccreate (data, true) .AsParallel () 
where Math.Log(x) < 4 
select KX) .Average (); 
FF 


} 
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也 可 以 调用 WithExecutionMode0 和 WithDegreeOfParallelism0) 方 法 来 影响 并 行 机制 。. 对 于 WithExecutionMode0 
方法 ， 可 以 传递 ParallelExecutionMode 的 一 个 Default 值 或 者 ForceParallelism 值 。 默 认 情 况 下 ， 并 行 LINQ 避免 使 
用 系统 开销 很 高 的 并 行 机 制 。 对 于 WithDegreeOfParallelism0 方 法 ， 可 以 传递 一 个 整数 值 ， 以 指定 应 并 行 运行 的 
最 大 任务 数 。 查 询 不 应 使 用 全 部 CPU， 这 个 方法 会 很 有 用 。 


注意 : 
任务 和 线程 详 见 第 21 章 。 


12.3.3 取消 


.NET 提供 了 一 种 标准 方式 ， 来 取消 长 时 间 运 行 的 任务 ， 这 也 适用 于 并 行 LINQ。 

要 取消 长 时 间 运 行 的 查询 ， 可 以 给 查询 添加 WithCancellation0 方 法 ， 并 传递 一 个 CancellationToken 令 牌 作为 
参数 。CancellationToken 令 牌 从 CancellationTokenSource 类 中 创建 。 该 查询 在 单独 的 线程 中 运行 ， 在 该 线程 中 ， 捕 
获 一 个 OperationCanceledException 类 型 的 异常 。 如 果 取 消 了 查询 ， 就 触发 这 个 异常 。 在 主线 程 中 ， 调 用 
CancellationTokenSource 类 的 Cancel0 方 法 可 以 取消 任务 (代码 文件 ParallelLinqSample/Program.cs)。 


static volid UseCancellatlion (IEnumerable<int> data) 
{ 


Var cts = new CancellationTokenSource ().; 


Task.Run(()} 三 > 
{ 
try 
{ 
var res = (from XX in data.AsPparallel() .WithCancellation(cts.Token) 
where Math.Log (KX) < 4 
select XX) .Average (}: 


Console .WriteLine ($"query finished, sum: {res}"); 
} 
catch (OperationCanceledException ex) 
{ 


Console .WriteLine (ex.Message).,} 


Hs 
Console.WriteLine ("query started"™).; 
Console.Write{({"cancel? ™Y)- 
string input = ReadLine(});} 
if (input.ToLower() .Equals ("y")) 
{ 
// cancel! 
Cts.Cancel ().; 
} 
} 


关于 取消 和 CancellationToken 令 牌 的 内 容 详 见 第 21 章 。 


12.4 ”表达 式 树 


在 LINQ to Objects 中 ， 扩 展 方法 需要 将 一 个 委托 类 型 作为 参数 ， 这 样 就 可 以 将 lambda 表达 式 赋予 参数 。 
lambda 表达 式 也 可 以 赋予 Expression<T> 类 型 的 参数 。C# 编 译 器 根据 类 型 给 lambda 表达 式 定义 不 同 的 行为 。 如 
果 类 型 是 Expression<T>， 编 译 器 就 从 lambda 表达 式 中 创建 一 个 表达 式 树 ， 并 和 存储 在 程序 集中 。 这 样 ， 就 可 以 
在 运行 期 间 分 析 表 达 式 树 ， 并 进行 优化 ， 以 便于 得 询 数据 源 。 

下 面 看 看 前 面 使 用 的 一 个 查询 表达 式 ; 

Var brazilRacers = from r in racers 

Where Ir.Ccountry == "Brazil" 


orderby I.Wins 
3elect i; 
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这 个 查询 表达 式 使 用 了 扩展 方法 Where0、OrderByYO 和 Select0。Enumerable 类 定义 了 Where0 扩 展 方 法 ， 
并 将 委托 类 型 Func<Tbool> 作 为 参数 谓词 。 


public static IEnumerable<TSource> Where<TSouTrcCe> (人 
this IEnumerable<TSource> source, FuUNC<TSoOurce, bool> predicate); 


这 样 ， 就 把 lambda 表达 式 赋予 谓词 。 这 里 lambda 表达 式 类 似 于 前 面 介绍 的 匿名 方法 。 

FunNnc<Racer, bool> predicate = r => r.Country == "Brazil"; 

Enumerable 类 不 是 唯一 一 个 定义 了 扩展 方法 Where0 的 类 。Queryable<T> 类 也 定义 了 Where0 扩 展 方法 。 这 
个 类 对 Where0 扩 展 方法 的 定义 是 不 同 的 : 

public static IQueryable<TSource> Where<TSource>! 


this IQueryable<TSource> source, 
Expression<FuNnc<TSource, bool>> predicate); 


其 中 ， 把 lambda 表达 式 赋予 类 型 Expression<T>， 该 类 型 的 操作 是 不 同 的 : 

Expression<Func<Racer, bool>> predicate = r => r.Country == "Brazil"; 

除了 使 用 委托 之 外 ， 编 译 器 还 会 把 表达 式 树 放 在 程序 集中 。 表 达 式 树 可 以 在 运行 期 间 读 取 。 表 达 式 树 从 
派生 自 抽 象 基 类 Expression 的 类 中 构建 。Expression 类 与 Expression<T> 不 同 。 继 承 自 Expression 类 的 表达 
式 类 有 BinaryExpression、 ConstantExpression、 InvocationExpression、 lambdaExpression、 NewExpression、 
NewArrayExpression、TernaryExpression 以 及 Unary Expression 等 。 编 译 器 会 从 lambda 表达 式 中 创建 表达 式 树 。 

例如 ,lambda 表达 式 r.Country 一 "Brazil" 使 用 了 ParameterExpression、MemberExpression、ConstantExpression 
和 MethodCallExpression， 来 创建 一 个 表达 式 树 ， 并 将 该 树 存 储 在 程序 集中 。 之 后 在 运行 期 间 使 用 这 个 树 ， 创 建 
一 个 用 于 底层 数据 源 的 优化 得 询 。 

在 示例 应 用 程序 中 ,DisplayTree0 方 法 在 控制 台 上 图 形 化 地 显示 表达 式 树 。 其 中 传递 了 一 个 Expression 对 象 ， 
并 根据 表达 式 的 类 型 , 把 表达 式 的 一 些 信息 写 到 控制 台 上 ,根据 表达 式 的 类 型 , 递归 地 调用 DisplayTree0 方 法 ( 代 
码 文 件 ExpressionTreeSample/Program.cs)。 


static void DisplayTree(int indent, string message， 
Expression expression) 
{ 
string output = $"{string.Empty.PadLeft (jndent, '>'"'})}} {message} ™ + 
$s"! NodeType: {expression.NodeTypel}; Expr: {expression}"™; 


indent+t+i+-; 


switch (expression.NodeType) 
{ 
case ExpressilonType .Lambda.: 
Console .WriteLine (output),; 
LambdaExpression lambdaExpr = (LambdaExpression)expression; 
foreach (var parameter in lambdaExpr.Parameters) 
{ 


DisplayTree (indent, "Parameter™", parameter),; 


} 
DisplayTree (indent, "Body", lambdaExpr .Body); 
break; 

Case ExpressilonType.Constant: 
ConstantExpression constExpr = (ConstantExpression)expresslion; 
Console .WriteLine($"{output} Const Value: {constExpr .Value}").; 
break; 

case ExpressilonType.Parameter: 
FarameterExpression paramExpr = (ParameterExpression)expression; 
Console .WriteLine ($s"{output} Param Type: {paramExpr.Type.Name}"); 
break; 


Case ExpressionType.Equal: 
case ExpressilonType.AndAlso: 
Case ExpressionType .GreaterThan.: 


BinaryExpression binExpr = (BinaryExpression) expression; 
if (binExpr.Method != null) 
{ 
Console.WriteLine ($"{output} Method: {binExpr.Method.Name}").; 
} 
e153e 
{ 


Console.WriteLine (output); 
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} 
DisplayTree (indent, "Left", binExpr.Left); 
DisplayTree (ijndent, "Right", binExpr .Right).,; 


breaks; 
Case ExpresslilonType.MemberAccess: 
MemberExpression memberExpr = (MemberExpression)expresslon; 


Console .WriteLine($"{output} Member Name: {memberExpr.Member.Name}, ™ + 
" Type: {memberExpr.Expression}"™"); 

DisplayTree (indent, "Member Expr", memberExpr.Expression); 
break; 

default: 
Console .WriteLine (); 
Console .WriteLine ($"{expression.NodeType} {expression.Type.Name}"); 
break; 

} 
} 


注意 : 
在 方法 DisplayTree 中 ， 没 有 处 理 所 有 的 表达 式 类 型 ， 只 处 理 了 在 下 一 个 示例 表达 式 中 使 用 的 类 型 。 


前 面 已 经 介绍 了 用 于 显示 表达 式 树 的 表达 式 。 这 是 一 个 lambda 表达 式 ， 它 有 一 个 Racer 参数 ， 表 达 式 体 提 
取 赢 得 比赛 次 数 超过 6 次 的 巴西 赛车 手 : 


Expression<Func<Racer, bool>> expression = 
Ir => Ir.Country == "Brazil™" g&& IrI.Wins > 6; 


下 面 看 看 结果 。lambda 表达 式 包 含 一 个 Parameter 和 一 个 AndAlso 节点 类 型 。AndAlso 节点 类 型 的 左边 是 
一 个 Equal 节点 类 型 ， 右 边 是 一 个 GreaterThan 节点 类 型 。Equal 节点 类 型 的 左边 是 MemberAccess 节点 类 型 ， 
右边 是 Constant 节点 类 型 。 

Lambda! NodeType: Lambda; Expr: T => (({r.Ccountry == "Brazil") AndAlso (r.Wins > 6)) 

> Parameter! NodeType: Parameter; Expr: I Param TYype: Racer 

> Body! NodeType: AndnAlso; Expr: ((r.Ccountry == "Brazil") AndAlso (r.Wins > 6)) 

>> Left! NodeType: Equal; Expr: (r.Country == "Brazil") Method: op Equality 

>>> Left! NodeType: Memberhccess; Expr: Ir.country Member Name: Country, Type: String 

>>>> Member Expr! NodeType: Parameter; ExpIr: I Param Type: Racer 

>>> Right! NodeType: Constant; ExpI: "Brazil" Const Value: Brazil 

>> Right! NodeType: GreaterThan; Expr: (r.Wins > 6) 

>>> Left! NodeType: MemberAccess; Expr: r.Wins Member Name: Wins, Type: Int32 

>>>> Member EXpI! NodeType: Parameter; Expr: I Param Type: Racer 

>>> Right! NodeType: Constant; Expr: 6 Const Value: 6 

使 用 Expression<T> 类 型 的 一 个 例子 是 Entity Framework Core 和 WCF 数据 服务 的 客户 端 提供 程序 。 这 些 技 
术 用 Expression<T> 参 数 定义 了 扩展 方法 。 这 样 ， 访 问 数据 库 的 LINQ 提供 程序 就 可 以 读 取 表达 式 , 创建 一 个 运 


行 期 间 优化 的 查询 ， 从 数据 库 中 获取 数据 。 


12.5 ”LINO 提供 程序 


NET 包含 几 个 LINQ 提供 程序 。LINQ 提供 程序 为 特定 的 数据 源 实现 了 标准 的 得 询 操作 符 。LINQ 提供 
程序 也 许 会 实现 比 LINQ 定义 的 更 多 的 扩展 方法 ， 但 至 少 要 实现 标准 操作 符 。LINQ to XML 实现 了 一 些 专门 用 
于 XML 的 方法 ,例如 ,System.XmlLinq 名 称 空 间 中 的 Extensions 类 定义 的 Elements0、Descendants0 和 AncestorsO) 
Fi 

LINQ 提供 程序 的 实现 方案 是 根据 名 称 空间 和 第 一 个 参数 的 类 型 来 选择 的 。 实 现 扩 展 方法 的 类 的 名 称 空 间 
必须 是 开放 的 ， 耕 则 扩展 类 就 不 在 作用 域内 。 在 LINQ to Objects 中 定义 的 Where0 方 法 的 参数 和 在 LINQ to 
Entities 中 定义 的 Where0 方 法 的 参数 不 同 。 

LINQ to Objects 中 的 Where0 方 法 用 Enumerable 类 定义 : 


Public static IEnumerable<TSource> Where<TSource>l( 
this IEnumerable<TSource> source, Func<TSource, bool> predicate); 


在 System.Linq 名 称 空 间 中 ， 还 有 另 一 个 类 实现 了 操作 符 Where。 这 个 实现 代码 由 LINQ to Entities 使 用 。 
这 些 实现 代码 在 Queryable 类 中 可 以 找到 : 
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public static IQueryable<TSource> Where<TSource>! 

this IQueryable<TSource> source, 
Expression<Func<TSoOource, bool>> predicate); 

这 两 个 类 都 在 System.Linq 名 称 空间 的 System.Core 程序 集中 实现 。 那 么 ,编译 器 如 何 选择 使 用 哪个 方法 ? 
表达 式 类 型 有 什么 用 途 ? 无 论 是 用 Func<TSource, bool> 参 数 传 递 ， 还 是 用 Expression <Func<TSource, bool>> 参 
数 传递 ，lambda 表达 式 都 相同 。 只 是 编译 器 的 行为 不 同 ， 它 根据 source 参数 来 选择 。 编 译 器 根据 其 参数 选择 最 
匹配 的 方法 。 Entity Framework Core 的 属性 是 DbSet<TEntity> 类 型 。 DbSet<TEntity> 实 现 了 IQueryable<TEntity> 
接口 ， 因 此 Entity Framework Core 使 用 Queryable 类 的 Where 方法 。 


12.6 ”小 结 


本 章 讨 论 了 LINQ 查询 和 查询 所 基于 的 语言 结构 ， 如 扩展 方法 和 lambda 表达 式 ， 还 列 出 了 各 种 LINQ 查询 
操作 符 ， 它 们 不 仅 用 于 筛选 数据 源 ， 给 数据 源 排 序 ， 还 用 于 执行 分 区 、 分 组 、 转 换 、 连 接 等 操作 。 

使 用 并 行 LINQ 可 以 轻松 地 并 行 化 运行 时 间 较 长 的 查询 。 

另 一 个 重要 的 概念 是 表达 式 树 。 表 达 式 树 允 许 在 运行 期 间 构建 对 数据 源 的 查询 ， 因 为 表达 式 树 存储 在 程序 
集中 。 表 达 式 树 的 用 法 详 见 第 26 章 。LINQ 是 一 个 非常 深奥 的 主题 ， 更 多 的 信息 可 查阅 网 上 附加 第 2 章 。 还 可 
以 下 载 其 他 第 三 方 提供 程序 , 例如 , LINQto MySQL、 LINQ to Amazon、LINQtoFlickr、LINQtoLDAP 以 及 LINQ 
to SharePoint。 无 论 使 用 什么 数据 源 ， 都 可 以 通过 LINQ 使 用 相同 的 查询 语法 。 

第 13 章 将 介绍 函数 式 编程 。 许 多 较 新 的 C# 特 性 都 基于 这 种 编程 范式 。 


二 二 


C# 函 数 式 编程 


本 章 要 点 
表达 式 体 的 成 员 
扩展 方法 
using static 声明 
本 地 函数 
元 组 
模式 匹配 
本 章 源 代 码 下 载 : 
打开 Www.wrox.com 的 Download Code 选项 卡 可 下 载 本 音源 代码 。 源 代码 也 可 以 在 HelloWorld 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 ; 
@ ExpressionBodiedMembers 


es LocalFunctions 

® Tuples 

es PatternMatching 
13.1 概述 


C# 从 来 都 不 是 纯 面向 对 象 的 编程 语言 。 从 一 开始 ，C# 就 是 面向 组 件 的 编程 语言 。 面 向 组 件 是 什么 意思 ? 
C# 提 供 了 面 同 对 象 编程 语言 也 在 使 用 的 继承 和 多 态 性 ， 此 外 ， 它 还 通过 特性 提供 对 属性 、 事 件 和 注释 的 本 机 文 
持 。 随 后 带 有 LINQ 和 表达 式 的 版 本 也 包括 了 声明 性 编程 。 使 用 声明 式 LINQ 表达 式 ， 编 译 器 会 保存 一 个 表达 
式 树 ， 该 表达 式 树 稍 后 由 提供 程序 用 于 动态 生成 SQL 语句 。 


注意 : 
C# 的 面向 对 象 特性 在 第 4 章 中 讨论 过 ， 第 8 章 包含 了 事件 ，LINQ 在 第 12 章 中 介绍 。 
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C# 并 不 仅仅 是 单一 的 编程 语言 范例 。 相 反 ， 目 前 使 用 C# 创 建 应 用 程序 的 实用 功能 已 添加 到 C# 的 语法 中 。 
在 过 去 的 几 年 里 ， 还 添加 了 与 函数 式 编程 相关 的 更 多 特性 。 

函数 式 编程 的 基础 是 什么 ? 函数 式 编程 的 最 重要 概念 基于 两 种 方法 ， 避 免 状 态 突变 和 将 函数 作为 一 流 的 概 
含 。 接 下 来 的 两 节 将 详细 介绍 这 两 种 方法 。 


本 章 并 没有 给 出 用 纯 函 数 编程 范式 来 编写 应 用 程序 的 所 有 信息 。 这 需要 一 整 本 书 的 篇 幅 。 (如 果 想 用 这 个 范 
例 编 写 程序 ， 就 应 该 考虑 使 用 F# 编 程 语言 ， 而 不 是 使 用 C#。) 本 章 将 采用 编程 的 方式 一 一 与 C# 一 样 。 通 数 式 编 
程 使 用 的 一 些 特性 对 所 有 应 用 程序 类 型 都 很 有 用 ; 这 就 是 C# 中 提供 这 些 特性 的 原因 。 随 着 时 间 的 推移 ， 越 来 越 
多 的 函数 式 编程 功能 将 会 以 符合 C# 编 程 风格 的 方式 添加 到 C# 中 。 


13.1.1 避免 状态 突变 


编程 语言 F# 是 一 种 函数 优先 的 语言 ， 使 用 它 创 建 自 定义 类 型 时 ， 这 种 类 型 的 对 象 默认 是 不 可 变 的。 对 象 可 
以 在 构造 函数 中 初始 化 , 但 以 后 不 能 修改 。 如 果 需 要 可 变性 , 该 类 型 就 需要 显 式 地 声明 为 可 变 的 。 这 与 C# 不 同 。 

在 C# 中 ， 一 些 预 定义 类 型 是 不 可 变 的 ， 比 如 string 类 型 。 用 于 更 改 字符 串 的 方法 总 是 返回 一 个 新 字符 串 。 
集合 是 不 可 变 的 吗 ? LINQ 使 用 的 方法 不 会 更 改 集 合 。 相 反 ， 像 Where 和 OrderBy 这 样 的 方法 会 返回 一 个 已 过 
滤 的 新 集合 ， 以 及 一 个 排序 的 新 集合 。 

男 一 方面 ，List<T> 集 合 提供 了 以 可 变 方式 实现 的 排序 方法 ; 原始 集合 是 排 好 序 的 。 为 了 得 到 更 大 的 不 变 
性 ，.NET 在 名 称 空间 System.Collections.Immutable 中 提供 了 完全 不 可 变 的 集合 。 这 些 集合 不 提供 更 改 集合 的 方 
法 。 相 反 ， 总 是 返回 新 的 集合 。 

使 用 不 可 变 类 型 的 优点 是 什么 ?因为 它 保证 没有 人 可 以 更 改 实例 ， 所 以 可 以 使 用 多 个 线程 并 发 地 访问 和 它 ， 
而 不 需要 同步 。 对 于 不 可 变 的 类 型 ， 创 建 单 元 测试 也 更 容易 。 

为 了 创建 目 定 义 类 型 ， 在 C# 6 中 添加 了 一 些 特 性 ， 以 创建 不 可 变 的 类 型 。 目 从 C# 6 开始 ， 就 能 够 创建 只 
带 get、 目 动 实现 的 只 读 属性 ， 

public string FirstName { get; } 

这 样 ， 编 译 器 就 会 创建 一 个 只 读 字 段 和 一 个 属性 ， 该 字段 只 能 在 构造 函数 中 初始 化 ， 该 属性 可 以 使 用 get 
访问 器 返回 该 字段 。 


注意 : 
字符 串 在 第 9 章 中 介绍 。 不 可 变 集 合 在 第 11 章 中 介绍 . 


由 于 茶 些 库 的 需求 ， 可 以 使 用 不 可 变 类 型 的 地 方 是 有 限 的 。 在 过 去 的 几 年 里 ， 越 来 越 多 的 地 方 已 经 移 除 了 
限制 。 例 如 ，NuGet 包 Newtonsoft.Json 允许 使 用 不 可 变 类 型 进行 JSON 序列 化 和 反 序 列 化 。 这 个 库 使 用 构造 函 
数 来 匹配 创建 实例 所 需 的 参数 .Entity Framework 在 过 去 几 年 里 就 是 这 样 一 个 限制 ,然而 , 自从 Entity Framework 
Core 1.1 以 来 ， 表 列 可 以 映射 到 字段 上 ， 而 不 是 读 / 写 属性 。 


注意 : 
JSON 序列 化 包含 在 网 上 附加 第 2 章 中 . Entity Framework Core 在 第 26 章 介绍 。 线程 和 同步 在 第 21 章 中 讨论 。 


注意 : 

本 章 不 介绍 创建 不 可 变 类 型 的 C# 特 性 ， 因 为 这 已 经 在 第 3 章 中 讨论 过 了 。C# 允 许 使 用 get 访问 器 创建 自动 
实现 的 属性 ， 编 译 器 在 其 中 创建 了 一 个 只 读 字 段 和 一 个 返回 该 字段 值 的 get 访问 器 。C# 的 未 来 版 本 计划 有 更 多 
的 特性 来 创建 不 可 变 的 类 型 ， 比 如 records。 
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13.1.2 ”函数 作为 第 一 个 类 


使 用 函数 式 编程 ， 函 数 是 第 一 个 类 。 这 意味 着 函数 可 以 用 作 函 数 的 参数 ， 函 数 可 以 从 函数 中 返回 ， 函 数 可 
以 赋 给 变量 。 

这 在 C# 中 一 直 是 可 能 的 : 委托 可 以 保留 函数 的 地 址 ， 委 托 可 以 用 作 方 法 的 参数 ， 并 且 可 以 从 方法 中 返回 委 
托 。 但 需要 注意 ， 将 正常 函数 的 调用 与 委托 的 调用 进行 比较 ， 委 托 有 一 些 相 关 的 开销 。 有 了 委托 ， 就 会 创建 一 
个 委托 类 的 实例 ， 这 个 实例 包含 方法 引用 的 集合 。 调 用 委托 时 ， 会 运 代 集合 ， 来 调用 分 配给 委托 的 每 个 方法 。 


注意 : 

委托 在 第 8 章 中 介绍 。 

1. 高 阶 函 数 

函数 式 编 程 定义 了 高 阶 函 数 ， 这 种 函数 将 另 一 个 函数 作为 参数 ， 或 者 返回 一 个 函数 。 一 些 函 数 既 将 另 一 个 
函数 作为 参数 ， 又 返回 一 个 函数 。 在 C# 实 现 中 ， 委 托 用 作 方 法 的 参数 和 返回 类 型 。 

高 阶 函 数 的 例子 是 为 LINQ 定义 的 方法 ， 如 上 一 章 所 述 。 例 如 ，Where 方法 接收 Func<TSource, bool> 谓 词 : 


Public static IEnumerable<TSource> Where (this IEnumerable<TSource> source, 
FunNnc<TSource, bool> predicate); 


高 阶 函 数 既 可 以 接收 函数 作为 参数 ， 也 可 以 返回 一 个 函数 ， 参 见 本 章 后 面 的 内 容 。 

2. 纯 冰 数 

函数 式 编 程 定义 了 术语 “ 纯 函 数 "。 如 果 可 能 ， 应 该 优先 考虑 纯 函 数 。 纯 函数 满足 两 个 要 求 : 

e 纯 函 数 始 终 给 传递 的 相同 参数 返回 相同 的 结果 。 

e 纯 函 数 不 产 生 副 作用 ， 如 改变 状态 ， 或 依赖 外 部 资源 。 

当然 ， 并 不 是 所 有 的 方法 都 可 以 实现 为 纯 函数 。 纯 函数 的 优点 是 测试 很 容易 ， 没 有 外 部 依赖 。 

在 创建 访问 外 部 源 的 方法 时 ， 可 能 会 考虑 将 该 方法 分 为 两 部 分 : 一 部 分 是 纯 函 数 ， 可 能 有 复杂 的 逻辑 ， 一 
部 分 不 是 纯 函数 。 

了 解 了 函数 式 编 程 的 重要 概念 后 ， 就 该 讨论 C# 如 何 帮助 理解 这 些 概念 的 语法 细节 。 


13.2 ”表达 式 体 的 成 员 


C# 6 允许 表达 式 体 成 员 的 方法 和 属性 只 定义 get 访问 器 , 而 在 C# 7 中 , 只 要 在 实现 代码 中 只 使 用 一 条 语句 ， 
表达 式 体 成 员 就 可 以 在 任何 地 方 使 用 。 在 函数 式 编程 中 ， 许 多 方法 都 只 是 一 行 代码 ， 因 此 可 以 经 和 常 使 用 这 个 特 
性 ， 代 码 行 数 减 少 ， 是 因为 不 需要 伦 括 号 。 


注意 : 

本 书 的 其 他 章节 已 经 介绍 了 这 一 特性 ， 如 第 3 章 中 的 表达 式 体 属 性 和 表达 式 体 方 法 ， 第 8 章 中 表达 式 体 的 
事件 访问 器 ， 因 此 本 章 没 有 涉及 它们 的 每 个 方面 。 

看 看 下 面 的 代码 片段 , 其 中 , 表达 式 体 成 员 与 属性 访问 器 (get 和 set) 一 起 使 用 , 并 使 用 ToString 方法 的 实现 ， 
以 及 构造 函数 的 实现 。 构 造 函 数 定义 为 接受 name 作为 字符 串 参数 ， 并 要 求 将 该 字符 串 拆 分 为 姓 和 名 。 这 是 用 
一 条 语句 完成 的 ， 首 先 将 字符 串 分 割 成 一 个 字符 串 数 组 ， 然 后 使 用 这 个 字符 串 数 组 通过 out 参数 来 提取 两 个 字 
人 竺 串 firstName 和 lastName (代码 文件 ExpressionBodiedMembers/Person.cs): 

Public class Person 


public Personl(string name) 三 > 
name .Split(" ').Tostrings(out firstName, out lastName); 


private string firstName; 


276 | 第 | 部 分 C# 语言 


public string FirstName 
{ 
get => firstNames 
set => firstName = value; 


} 


private string lastName; 
Public string LastName 
{ 

Jet => lastName; 

set => lastName = value; 


} 


public override string ToString() => $"{FirstName} {LastName}"™; 
} 


在 下 面 的 代码 片段 中 ， 自 定义 out 参数 由 扩展 方法 ToStrings 填充 。 这 是 字符 串 数组 的 扩展 方法 ， 它 将 数组 
元 素 移 动 到 输出 参数 中 (代码 文件 ExpressionBodiedMembers/StringArrayExtensions.cs): 
public static class StringArrayExtensions 
{ 
Public static voild ToStrings (this string[] values, out string valuel, 
out string value2) 
{ 
if {values == null}) throw new ArgumentNullException (nameof (values) ) ; 
if (values.Length != 2) throw new IndexOutofRangeException 
"only arrays with 2 values allowed"™); 


valuel = Values[0Ol] ; 
valuez2 = values[l1l]:; 
} 
} 


有 了 这 些 , 就 可 以 用 包含 一 个 字符 串 的 姓名 来 创建 Person, 通过 FirstName 和 LastName 属性 访问 该 姓名 ( 代 
码 文 件 ExpressionBodiedMembers/Program.cs): 


Person p = new Person("Katharina Nagel™); 
Console .WriteLine ($"{p.FirstName} {p.LastName}"); 


13.3 ”扩展 方法 


扩展 方法 已 经 在 第 12 章 中 讨论 过 了 ,本章 的 前 一 节 实现 了 一 个 自 定义 扩展 方法 。 但 是 ,由 于 扩展 方法 对 函 
数 式 编程 概念 有 很 大 帮助 ， 因 此 这 里 展示 男 一 个 例子 。 

在 函数 式 编程 中 ,许多 方法 都 非常 短 ， 只 包含 单个 语句 ， 而 前 面 所 示 的 表达 式 体 成 员 有 助 于 减少 代码 行 数 。 
例如 ， 可 以 将 using 语句 改 为 方法 。 下 面 的 扩展 方法 名 为 Use， 它 是 所 有 实现 IDisposable 接口 的 类 的 扩展 方法 。 
using 语句 在 实现 中 使 用 ， 以 在 使 用 后 释放 该 项 。 对 于 该 项 的 用 户 ， 可 以 将 Action<T> 委 托 传递 给 Use 方法 ( 代 
码 文 件 UsingStatic/FunctionalExtensions.cs)。 

public static class FunctionalExtensions 

Public static vold Use<T> (this T item, Action<T> action) 

where T : IDisposable 
using (item) 
{ 本 项 
action (litem}):; 
} 


} 
} 


实现 接口 IDisposable 的 示例 类 是 使 用 Resource 类 定义 的 。 这 个 类 提供 了 Foo 方法 和 IDisposable 功能 (代码 
文件 UsingStatic/Resource.cs): 


class Resource : IDisposable 
{ 


public void Foo () => Console .WriteLine ("Foo™),; 


private bool disposedValue = false; 
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protected virtual void Dispose (bool disposing) 
IE (I'disposedValue) 
{ 
if (disposing) 
{ 
Console.WriteLine ("release Tesource"™). 
disposedValue = true; 
} 
} 


Public void Dispose() => Dispose (true),; 


现在 看 看 访问 这 个 Resource 对 象 的 经 典 using 语句 块 : 
USing (Var TI = new Resource()) 


r.Foo(l}):; 


} 
在 Use 方法 中 ， 可 以 在 单个 语句 中 访问 和 释放 资源 (代码 文件 UsingStatic/Program.cs): 


new Resource() .Uselr => Ir.Foo())}): 
13.4 ”using static 声明 


许多 实际 的 扩展 可 以 通过 扩展 方法 来 实现 , 比如 前 面 的 Use 扩展 方法 或 第 12 章 介绍 的 用 于 LINQ 的 许多 扩 
展 方法 。 在 本 书后 面 的 许多 章节 中 还 将 介绍 .NET 提供 的 许多 扩展 方法 。 

并 非 所 有 实际 的 扩展 都 有 可 以 扩展 的 类 型 。 对 于 茶 些 场景 ， 简 单 的 静态 方法 比较 适合 。 为 了 更 容易 调用 这 
些 方法 ， 可 以 使 用 using static 声明 除去 类 名 。 

例如 ， 如 果 打 开 了 System.Console 

USing static System.Consoles 

可 以 把 下 面 的 代码 

Console .WriteLine ("Hello World!'™); 

改 为 

WriteLine ("Hello World!™); 

在 使 用 此 声明 之 后 ， 就 可 以 使 用 类 Console 的 所 有 静态 成 员 ， 如 WriteLine、Write、ReadLine、Read、Beep 
等 ， 而 不 需要 编写 Console 类 。 只 需要 确保 在 打开 其 他 类 的 静态 成 员 时 不 要 陷入 冲突， 或 者 在 使 用 静态 方法 时 
不 要 使 用 基 类 的 方法 。 

下 面 看 一 个 实际 的 例子 。 高 阶 函数 以 函数 作为 参数 ， 或 者 返回 一 个 函数 ， 或 者 返回 两 个 函数 。 在 处 理 函 数 
时 ， 可 以 将 两 个 函数 合并 到 一 个 函数 中 。 

为 此 可 以 使 用 Compose 方法 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文件 UsingStatic/FunctionalExtensions.cs): 

public static class FunctionalExtensions 

Ff 

Public static FUunc<T1, TResult> Compose<T1, T2, TResult>( 
Func<T1，T2> f1, Func<T?2, TResult> f2) => 

a => f2 (f1 (a)); 

该 泛 型 方法 定义 了 三 个 类 型 参数 和 两 个 委托 类 型 Func 的 参数 。 请 记 住 ， 委 托 Func<T TResult> 引 用 了 一 个 
带 有 单个 参数 的 方法 ， 其 返回 类 型 可 以 是 不 同 的 类 型 。Compose 方法 接受 两 个 Func 参数 ， 把 两 个 方法 组 合 到 
一 个 方法 中 。 传递 给 Compose 的 第 一 个 方法 (f1) 可 以 有 两 个 不 同 的 类 型 , 一 个 用 于 输入 T, 男 一 个 用 于 输出 (T2)， 
而 传递 的 第 二 个 方法 (f2) 所 需要 的 输入 类 型 (T2) 与 第 一 个 方法 的 输出 类 型 (T2) 相 同 ， 并且 可 以 有 不 同 的 输出 类 型 
(TResult)。Compose 方法 本 身 返 回 一 个 Func 委托 ， 其 输入 类 型 与 第 一 个 方法 相同 (T)， 输 出 类 型 与 第 二 个 方法 
相同 (TResult)。 实 现 可 能 看 起 来 有 所 可怕 ， 因 为 后 面 跟 着 连续 两 个 lambda 操作 符 。 理 解 了 方法 返回 的 内 容 (一 
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个 方法 ) 时 ,这 个 构造 就 将 变 得 清晰 。 返 回 的 方法 是 Func<T1,TResult>。 在 第 一 个 lambda 操作 符 之 后 ,一 f2(f1(a)): 
定义 了 这 个 方法 。 变 量 的 类 型 为 T1， 返 回 的 方法 类 型 为 TResult, 与 f2 返回 的 结果 类 型 相同 ，f2 以 输入 作为 参 
数 接收 详 。 

要 使 用 Compose 方法 ， 首 先 创建 两 个 委托 入 和 f2， 在 输入 中 添加 1 或 2。 这 些 委 托 会 与 Compose 方法 相 
结合 。 由 于 usingstatic 声明 打开 了 类 FunctionalExtensions 的 静态 成 员 ， 所 以 可 以 不 使 用 类 名 来 调用 Compose 方 
法 。 在 使 用 Compose 方法 创建 f3 之 后 ， 就 调用 f3 方法 (代码 文件 UsingStatic/Program.cs): 

USslIng System; 

using static System.Console; | 

using static Usingstatic.FunctionalExtensions; 

namespace Usingstatic 

{ 

class Program 
static void Main{) 
fi, 


FUunc<int, int> fli = x => x+ 1; 
Func<int, int> f2 = xX => 和 十 27; 
Func<int, int> f3 = Compose (fl1l, f2}); 
var Xl = f3(39}). 
WriteLine (x1); 
Fs 
} 
} 
} 


写 入 控制 台 的 结果 当然 是 42。 
声明 Compose 方法 时 ， 参 数 类 型 可 以 在 输入 和 输出 之 间 有 所 不 同 。 在 下 面 的 代码 片段 中 ， 传 递 给 Compose 
方法 的 第 一 个 方法 接收 一 个 字符 串 ， 并 返回 Person 对 象 ; 第 二 个 方法 接收 Person 并 返回 一 个 字符 串 。 如 果 编 译 
器 不 能 从 变量 和 返回 类 型 中 识别 参数 类 型 ， 就 必须 指定 具体 的 委托 类 型 ， 方 法 是 接收 字符 串 并 返回 一 个 Person。 
只 有 变量 名 ， 并 不 能 帮助 编译 器 确定 它 的 类 型 。 通 过 传递 给 Compose 方法 的 第 二 个 方法 ， 显 然 ， 输 入 的 类 型 与 
第 一 个 方法 返回 的 类 型 相同 ， 因 此 不 需要 指定 类 型 。 在 调用 Compose 方法 之 后 ， 变 量 greetPerson 是 两 个 输入 方 
法 的 组 合 : 
var greetPerson = Compose ( 
new Func<string, Person> (name => new Person (name)), 
person => S$"Hello, {person.FirstName}"); 


WriteLine (greetPerson ("Mario Andretti")); 


在 WriteLine 方法 中 使 用 字符 串 Mario Andretti 调用 greetPerson 方法 ， 将 字符 串 Hello. Mario 写 入 控制 台 。 


13.5 ”本 地 函数 


C#7 的 一 个 新 特性 是 本 地 函数 ; 方法 可 以 在 方法 中 声明 。 本 地 函数 在 方法 的 作用 域 、 属 性 访问 器 、 构 造 函 
数 或 者 lambda 表达 式 内 声明 。 本 地 函数 只 能 在 包含 成 员 的 作用 域内 调用 。 可 以 使 用 本 地 函数 ， 而 不 是 使 用 仅 一 
个 地 方 需 要 的 私有 方法 。 

下 面 是 一 个 示例 ， 且 在 没有 本 地 函数 的 情况 下 启动 一 一 lambda 表达 式 将 在 下 一 个 回合 中 由 本 地 函数 替换 。 
下 面 的 代码 片段 声明 了 分 配给 委托 变量 add 的 lambda 表达 式 。 变 量 add 是 在 方法 IntroWithLambdaExpression 
的 作用 域内 ， 因 此 它 只 能 在 这 个 方法 中 调用 (代码 文件 LocalFunctions/Program.cs): 

private static void IntroWithLambdaExpression() 

Func<int, int, int> add = (x, yy) => 

return x + y; 
ee 


int result = add(37, 5}); 
Console .WriteLine (resulty).; 


第 13 章 ”C# 函 数 式 编程 | 279 


可 以 定义 本 地 函数 ， 而 不 是 声明 lambda 表达 式 。 本 地 函数 的 声明 方式 与 普通 方法 类 似 ， 都 带 有 返回 类 型 、 
名 称 和 参数 。 本 地 函数 的 调用 方式 与 前 面 显示 的 lambda 表达 式 相 同 : 
private static void IntroWithLocalFunctions () 
int add(int x, int y) 
| return x 十 vY; 
> result = add(37, 5); 


Console.WriteLine (result).; 


} 
与 lambda 表达 式 相 比 ， 本 地 函数 的 语法 更 简单 ,执行 得 也 更 出 色 。 委 托 需 要 一 个 类 的 实例 和 一 个 引用 的 集 
合 ， 而 本 地 函数 只 需要 对 函数 的 一 个 引用 ， 这 个 函数 可 以 直接 调用 。 开 销 和 其 他 方法 一 样 。 
当然 ， 如 果 本 地 函数 可 以 通过 单个 语句 来 实现 ， 则 可 以 使 用 一 个 表达 式 体 成 员 实 现 该 功能 : 
private static void IntroWithLocalFunctionsWithExpressionBodies () 
int add(int x, int y) => x + y; 
int result = add(37, 5); 


Console.WriteLine (result).; 


} 

在 方法 体 中 ， 本 地 函数 可 以 在 任何 位 置 实现 。 没 有 必要 将 它们 在 方法 体 的 顶部 实现 ; 也 可 以 在 其 他 地 方 实 
现 , 在 此 之 前 可 以 调用 本 地 函数 。 这 种 行为 与 普通 的 方法 一 样 。 但 是 , 与 普通 方法 不 同 , 本 地 函数 不 能 是 virtual、 
abstract、private， 也 不 能 使 用 其 他 修饰 符 。 唯 一 允许 使 用 的 修饰 符 是 async 和 unsafe。 

与 lambda 表达 式 一 样 ， 本 地 函数 可 以 从 外 部 作用 域 (也 称 为 财 包 ) 中 访问 变量 ， 如 下 面 的 代码 片段 所 示 ， 其 
中 本 地 函数 访问 变量 z， 这 是 在 本 地 函数 的 外 部 定义 的 : 

private static void IntroWithLocalFunctionsWithClosures () 

a z = 3; 

int result = add(37, 5); 


Console .WriteLine (result).; 


int add(int xX, int vy) => XxX + y+ 2Z; 
} 


注意 : 
.地 函数 允许 使 用 的 唯一 修饰 符 是 async 和 unsafe。 第 15 章 解释 了 async 修饰 符 ， 第 17 章 解 释 了 unsafe 
修饰 符 。 

使 用 本 地 函数 的 一 个 原因 是 ， 只 需要 在 方法 (或 属性 、 构 造 函 数 等 ) 的 作用 域内 使 用 功能 。 使 用 本 地 函数 还 
有 其 他 选择 。 性 能 是 使 用 本 地 函数 而 不 是 lambda 表达 式 的 一 个 好 理由 。 将 本 地 函数 与 普通 私有 方法 进行 比较 ， 
本 地 函数 没有 性 能 优势 。 当 然 ， 本 地 函数 可 以 使 用 闭 包 ， 而 私有 方法 不 能 。 这 是 使 用 本 地 函数 的 充分 理由 吗 ? 
要 了 解 本 地 函数 的 真正 优势 ， 需 要 看 到 一 些 有 用 的 示例 ， 如 下 一 节 所 述 。 


13.5.1 本 地 函数 与 yield 语句 


第 12 章 包 含 Where 方法 的 一 个 简单 实现 ， 其 中 使 用 了 yield 语句。 没有 讨论 的 是 参数 的 检查 。 下 面 将 其 添加 
到 Wherel 方法 的 实现 中 , 检查 source 和 predicate 参数 是 否 为 null( 代 码 文 件 LocalFunctions/EnumerableExtensions.cs); 

public static IEnumerable<T> Wherel<T> (this IEnumerable<T> source, 

FUNC<T, bool> predicate) 
{ 

if (source == null) throw new ArgumentNullException (nameof (source)); 

if (predicate == null) throw new ArgumentNullException (nameof (predicate)).; 

foreach (T item in source) 


if (predicate (1tem)) 


Yield return item; 
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} 
} 
} 


编写 代码 测试 AreumentNullException， 和 定义 预 处 理 语 句 胡 ine， 以 从 源 代 码 行 1000 开始 。 在 第 1004 行 中 没 
有 发 生 异 常 ， 其 中 null 传递 给 Where 1 方法 : 相反 ， 在 第 1006 行 中 包含 的 foreach 语句 发 生 了 异常 。 延 迟 发 现 
这 个 错误 的 原因 是 ， 在 方法 Where 1 的 实现 中 ， 延 迟 执行 了 yield 语句 (代码 文件 LocalFunctions /Program.cs): 


private static void YieldSampleSimple() 
{ 
#1line 1000 
Console .WriteLine (nameof (YieldSampleSimple)); 
try 
{ 
string[] names = { "James"™", "Niki"™, “John™"™, "Gerhard™, "Jack"™ }; 
Var gd = names.Wherel (null}; 


foreach (var n in 9q) // callstack position for exception 
{ 
Console .WriteLine (n); 
} 
} 
catch (ArgumentNullException ex) 
{ 
Console.WriteLine (ex); 
} 
Console .WriteLine(). 


} 


为 了 解决 这 个 问题 ， 并 向 调用 者 更 早 地 提供 错误 信息 ，Wherel 方法 通过 Where2 方法 在 两 个 部 分 实现 。 这 
里 ，Where2 方法 只 检查 不 正确 的 参数 ， 不 包括 yield 语句 。 使 用 yield retum 的 实现 是 在 一 个 单独 的 私有 方法 
WhereImpl 中 完成 的 。 在 检查 输入 参数 之 后 ， 从 Where2 方法 中 调用 此 方法 (代码 文件 LocalFunctions/ 
EnumerationEXtenslons.CS)。 


Public static IEnumerable<T> Where2<T> (this IEnumerable<T> source, 
FUuNC<T, bool> predicate) 
{ 
if (source == null) throw new ArgumentNullException (nameof (source));) 
if (predicate == null) throw new ArgumentNullException (nameof (predicate))}; 


return Wherez2Impl (source, predicate).; 
} 


private static IEnumerable<T> Where2Impl<T> (IEnumerable<T> source, 
FUuNnc<T, bool> predicate) 
{ 
foreach {TT Item in source) 
{ 
if (predicate (item)) 
{ 
vield return item; 
} 
| 
} 


现在 调用 该 方法 ， 堆 栈 跟踪 显示 在 第 1004 行 中 发 生 的 错误 ， 其 中 调用 了 Where 2 方法 (代码 文件 
LocalFunctions/Program.cs): 


private static void YieldSampleWithPrivateMethod{() 


{ 
#1line 1000 
Console .WriteLine (nameof (YieldSampleWithPrivateMethod))}),;} 
try 
{ 
string[] names = { "James"™, "Niki"™, “John™", "Gerhard™, "Jack™ }; 
Var a = names.Where?2 (null); // callstack position for exception 
foreach {var nm In q) 
{ 
Console .WriteLine (n); 
} 
} 


catch (ArgumentNullException ex) 
{ 
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Console .WriteLine (ex); 


Console .WriteLine (}); 


} 

这 个 问题 是 用 Where2 方法 解决 的 。 但 是 ， 现 在 有 了 一 个 仅 需 要 在 一 个 地 方 使 用 的 私有 方法 。Where2 方法 
的 主体 包括 参数 检查 和 Where2Impl 方法 的 调用 。 对 于 私有 方法 来 说 ， 这 是 一 个 很 好 的 场景 。Where3 方法 的 实 
现 包括 对 得 入 参数 的 检查 〈 与 以 前 一 样 )， 以 及 一 个 私有 函数 ， 而 不 是 以 前 的 私有 方法 Where2Impl。 本 地 函数 
可 以 有 更 简单 的 签名 ， 因 为 它 可 以 从 外 部 作用 域 访问 变量 的 源 和 谓词 (代码 文件 LocalFunctions/ 
EnumerableExtensions.cs): 


public static IEnumerable<T> Where3<T> (this IEnumerable<T> source, 
FUuNC<T, bool> predicate) 
{ 
if (source == null) throw new ArgumentNullException (nameof (source)); 
if (predicate == null) throw new ArgumentNullException (nameof (predicate))});} 


return Iterator().; 
IEnumerable<T> Iterator() 


foreach (IT item in source) 
{ 
if (predicate (item)) 
{ 
Yield return item; 
} 
} 
} 
} 


调用 Where3 方法 ， 其 结果 与 调用 Where2 方法 的 结果 相同 。 堆 栈 跟 踪 显 示 了 调用 Where3 方法 的 问题 。 
13.5.2 ”递归 本 地 函数 


另 一 个 使 用 本 地 函数 的 场景 是 递归 调用 ， 如 下 面 使 用 QuickSsort 方法 的 示例 所 示 。 这 里 ， 本 地 函数 Sort 是 
递归 调用 的 ， 直 到 集合 排 好 序 为 止 (代码 文件 LocalFunctions/Algorithms.cs): 


Public static volid QuickSort<T>(T[] elements) where T : IComparable<T> 
{ 
volid Sort (Int start, int end) 
{ 
int 1 = start, J] = end; 
Var pivot = elements[(start + end) / 2]; 


while (i <= ]) 
{ 
while (elements[i] .CompareTo (pivot) < 0) 1i++; 
while (elements[j] .CompareTo (pivot}) > 0) ] 一 一 ; 
if {1 <= jj) 
{ 
T tmp = elements[il]; 
elements[1] elements[j]; 
elements[]j] tmps 
i++; 
Te 
} 
} 
if (start < ]) Sorti{(start, J); 
IE (1 < end) Sort(1i, end); 
} 


Sort(0, elements.Length 一 1); 
} 


在 使 用 C# 时 ， 需 要 小 心 使 用 递归 调用 。 下面 的 递归 循环 在 大 约 24 000 次 迭代 之 后 ， 由 于 堆栈 溢出 而 结束 。 
C# 编 译 器 不 像 F# 编 译 器 那样 实现 尾 调 用 优化 。 而 使 用 尾 调 用 优化 ,递归 调用 会 转换 为 近代， 以 不 消耗 这 个 堆栈 


空间 。 
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public static void WhenDoesItEnd () 
{ 
Console .WriteLine (nameof (WhenDoesItEnd) ) ; 
VOL InnerLoop (int 1ix) 
{ 
Console.WriteLine (1x++).: 
InnerLoop (ix); 
} 
InnerLoop(1}; 
} 


13.6 元 组 


元 组 能 够 组 合 不 同类 型 的 对 象 。 使 用 数组 可 以 组 合 相 同类 型 的 对 象 ， 而 元 组 允许 使 用 类 型 的 不 同 组 合 。 元 
组 有 助 于 减少 以 下 两 个 需求 : 

e 定义 目 定义 类 或 结构 ， 以 返回 多 个 值 

。 定义 参数 ， 从 方法 中 返回 多 个 什 

自从 NETFramework 4.0 版 本 以 来 ， 元 组 就 以 泛 型 Tuple 类 的 形式 存在 。 然 而 ， 它 们 并 没有 得 到 广泛 使 用 ， 
因为 元 组 的 不 同 对 象 可 以 通过 Item1、Item2、Item3 等 属性 访问 ， 这 既 不 吸引 人 人 人， 也 没有 提供 任何 关于 其 含义 的 
信息 。 

这 在 C# 7 中 发 生 了 变化 ，C# 7 提供 了 在 编程 语言 中 集成 的 元 组 功能 ， 这 有 了 很 大 的 改进 ， 如 下 一 个 示例 
所 示 ， 它 使 用 了 一 个 简单 的 不 可 变 的 Person 类 (代码 文件 TuplesSample/Person.cs): 


Public class Person 
{ 


public Person(string firstName, string lastName) 


FirstName = firstName; 
LastName = lastName; 


public string FirstName { get; } 
public string LastName { get; } 


public override string ToString() => $"{FirstName} {LastName}™; 


ss 
} 


13.6.1 元 组 的 声明 和 初始 化 


可 以 使 用 圆 括号 声明 一 个 元 组 ， 并 使 用 通过 括号 创建 的 元 组 字面 量 来 初始 化 。 在 下 面 的 代码 片段 中 ， 左 侧 
声明 了 一 个 元 组 变量 tf， 其 中 包含 一 个 字符 串 、 一 个 int 和 一 个 Person。 右 边 使 用 一 个 元 组 字面 量 来 创建 一 个 元 
组 ， 它 包含 字符 串 magic、 数 字 4， 以 及 使 用 Person 类 的 构造 函数 初始 化 的 Person 对 象 。 访 问 元 组 时 ， 可 以 使 
用 变量 t 以 及 在 括号 中 声明 的 成 员 ( 本 例 中 为 s、i 和 p)。( 代 码 文件 Tuples/Program.cs): 

private static void IntroTuples {() 

(string s, int i, Person Pp) tt = ("magic", 42, new Personl 
"stephanie", "Nagel")); 

Console .WriteLine($"s: {t.s}, i: {t.1i}, p: {t.p}"); 

| 

} 

运行 应 用 程序 时 ， 输 出 显示 了 元 组 的 值 : 

s: magic, i: 42, p: Stephanie Nagel 

元 组 字面 量 也 可 以 分 配给 元 组 变量 ， 而 不 需要 声明 它 的 成 员 。 这 样 ， 元 组 的 成 员 就 可 以 使 用 ValueTuple 结 
构 的 成 员 名 称 来 访问 : Iteml、Item2 和 Item3。 


private static void IntroTuples() 
{ 
i 
Var t2 = ("magic", 42, new Person("Matthias", "Nagel"))., 
Console .WriteLine(s$"string: {t2.Iteml}, int: {t2.Item2}, 
person: {t2.Item3}™); 
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FF 
} 


可 以 通过 定义 名 称 后 跟 冒 号 ， 来 为 元 组 字面 量 中 的 元 组 指定 名 称 ， 它 与 对 象 字 面 量 的 语法 相同 : 


private static void IntroTuples () 


Var t3 = (s: "magic", i: 42, pp: new Person("Matthias", "Nagel"))., 
Console.WriteLine($"s: {t3.s}, 1: {t3.1}, p: {t3.p}"); 
a 

} 


有 了 这 些 ,， 名字 只 是 一 种 方便 的 方式 。 当 类 型 匹配 时 ,可 以 将 一 个 元 组 分 配给 男 一 个 元 组 ; 名 字 并 不 重要 : 


private static void IntroTuples() 
{ 
i... 
(string astring, int anumber, Person aperson) t4 = t3; 
Console.WriteLine($"s: {t4.astring}, i: {t4.anumber}, p: {t4.aperson}"™"); 
} 


13.6.2 元 组 解构 
还 可 以 将 元 组 分 解 为 变量 。 为 此 ， 只 需要 从 前 面 的 代码 示例 中 删除 元 组 变量 ， 并 在 括号 中 定义 变量 名 。 然 
后 可 以 直接 访问 变量 ， 其 中 包含 元 组 部 分 的 值 (代码 文件 Tuples/Program.cs): 


private static void TupleDeconstruction{() 


(string s, int i, Person p) = ("magic", 42, new Person("SsStephanie™, 
"Nagel™)}))}); 
Console.WriteLine($"s: {s}, 1: {i}, p: {p}"); 
//... 
} 


还 可 以 使 用 var 关键 字 声 明 解 构 的 变量 ， 类 型 由 元 组 字面 量 定义 。 还 可 以 在 初始 化 之 前 声明 变量 ， 并 将 元 
组 分 解 为 现 有 变量 : 

private static void TupleDeconstruction{) 

fy -- 


(var SL，Var il1, var Pl) = ("magic™", 42, new Person("stephanie™", "Nagel"™))}); 
Console .WriteLine ($"s: {si}, i: {i1}, p: {pp1}"); 
string S2; 
int 12; 
Person p2; 
(s2, i2, PpP2) = ("magic", 42, new Personl("Katharina™", "Nagel™))}); 
Console.WriteLine($"s: {s2}, i: {i2}, p: {p22}"); 
FF A 
} 
如 果 不 需 要 元 组 的 所 有 部 分 ， 可 以 使 用 忽略 该 部 分 ， 如 下 所 示 : 
private static void TupleDeconstruction() 
{ 
tf.: 
(string s3, ,; ) = ("magic", 42, new Person("Katharina", "Nagel"))}).; 
Console .WriteLine (s3); 
} 
注意 : 
在 不 需要 结果 的 情况 下 ， 使 用 out 参数 修饰 符 调用 方法 时 ， 可 能 已 经 使 用 了 。 在 这 个 场景 中 ,使 用 只 是 
一 个 命名 约定 。 给 元 组 使 用 是 不 同 的 。 不 需要 声明 类 型 ， 可 以 使 用 多 次 ; 它 是 一 个 编译 器 特性 ， 解 构 时 可 以 
忽略 这 部 分 。 


13.6.3 元 组 的 返回 


下 面 介绍 一 个 更 有 用 的 示例 : 返回 元 组 的 方法 。 在 下 面 的 代码 片段 中 ，Divide 方法 接收 两 个 参数 ， 并 返回 
一 个 由 两 个 int 值 组 成 的 元 组 。 结 果 用 一 个 元 组 字面 量 返回 (代码 文件 Tuples/Program.cs): 
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static (int result, int remainder) Dividel(lint dividend, int divisor) 
{ 

int result = dividend / divisor; 

int remainder = dividend 名 divisor; 

return (result, remainder}).; 


} 
结果 分 解 为 result 和 remainder 变量 : 


private static void ReturningTuples () 


{ 

(int result, int remainder) = Divide(7, 2); 

Console.WriteLine($"7 / 2 - result: {result}, remainder: {remainder}"); 
} 
注意 : 


使 用 元 组 ， 可 以 避免 通过 out 参数 声明 方法 签名 。out 参数 不 能 与 async 方法 一 起 使 用 ; 此 限制 不 适用 于 
元 组 。 


13.6.4 幕后 的 原理 


使 用 新 的 元 组 语法 , C# 编 译 器 在 后 台 创 建 ValueTuple 结构 , .NET 为 1 到 7 个 泛 型 参数 定义 了 多 个 ValueTuple 
结构 ,还 定义 了 男 一 个 ValueTuple 结构 ,其 中 第 8 个 参数 可 以 是 男 一 个 元 组 .使 用 元 组 字面 量 会 调用 Tuple.Create。 
Tuple 结构 定义 了 名 为 teml1、Item2、Item3 等 的 字段 ， 以 访问 所 有 项 (代码 文件 Tuples/Program.cs): 


private static void BehlinadTheScenes () 

{ 
(string s, int 1I) tlL = ("magic™, 42}); // tuple literal 
Console .WriteLine($"{tl1l.s} {tl1.1}"); 
ValueTuple<string, int> t2 = ValueTuple.Create ("magic", 42).，; 
Console .WriteLine($"{t2.Iteml}, {t2.Item2}"); 

} 


字段 的 命名 是 如 何 从 方法 返回 元 组 的 过 程 中 确定 的 ?Divide 方法 签名 如 下 所 示 ， 
Public static (Int result, int remainder) Dividel(int dividend, int divisor) 
该 方法 签名 转换 为 : 返回 ValueTuple，TupleElementNames 属性 指定 其 返回 类 型 : 


[return: TupleElementNames (new string[] {"result", "remainder™ }) ] 
public static ValueTuple<int, int> Divide(int dividend, int divisor) 


当 使 用 这 种 方式 调用 方法 时 ， 编 译 器 会 从 属性 中 读 取 信息 ， 以 将 名 称 与 TtemX 字段 匹配 。 进 行 该 调用 时 ， 
将 使 用 ItemX 字段 而 不 是 更 好 的 名 称 。 
在 TupleElementNames 属性 的 自动 用 法 中 , 返回 元 组 的 方法 可 以 在 库 中 声明 (代码 文件 TuplesLib/SimpleMath.cs): 


Public class SimpleMath 
{ 
public static {int result, int remainder)} Dividel{int dividend, int divisor) 
| 
int result = dividend / qivisor: 
int remainder = dividend % divisor:; 
return (result, remainder); 
} 
} 


该 库 是 在 控制 全 应 用 程序 中 使 用 的 ， 其 result 和 remainder 名 称 可 以 直接 使 用 : 


private static void UseALibrary () 


{ 
Var 七 = SimpleMath.Divide (5, 3); 
Console .WriteLine(s"result: {t.result}, remainder: {t.remainder}").; 


} 

旧 的 Tuple 类 型 是 一 个 类 ， 而 新 的 元 组 ValueTuple 是 一 个 结构 。 这 减少 了 把 值 类 型 存储 在 堆栈 上 时 垃圾 收 
集 器 所 需 的 工作 。 旧 的 Tuple 类 型 实现 为 一 个 具有 只 读 属性 的 不 可 变 类 。 在 新 的 ValueTuple 中 ， 成 员 是 公共 字 
段 。 公 共 字 段 使 这 种 类 型 可 变 (代码 文件 Tuples/Program.cs): 


static void Mutability!() 
{ 
/:/ old tuple is a immutable reference type 
Tuple<string, int> tl1 
/ff tli_Iteml = "new string™; 


/i not possible 


/i new tuple is a mutable value type 


(string s, int 1I) t2 = ("new tuple™", 42); 
t2.5 = "new string™; 

Li 

t2 - 工 十 十 - 

Console.WriteLine ($"new string: {t2.s5} int: 


J 


Tuple.Create ("old tuple™, 
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42)5 
with Tuple 


(E217 


微软 似乎 违反 了 ValueTuple 的 一 些 规则 : 结构 应 该 是 不 可 变 的 ， 而 字段 不 应 该 声明 为 public。 但是， 新 的 
元 组 可 以 与 简单 值 类 型 (例如 int 和 long) 相 媲美 ; 使 用 元 组 打破 规则 是 完全 可 原谅 的 , 也 可 以 获得 最 佳 性 能 优化 。 


13.6.5 ValueTuple 与 元 组 的 兼容 性 


旧 的 元 组 类 型 由 于 命名 不 太 好 而 用 得 不 太 多 。 但 是 ， 对 于 使 用 Tuple 类 型 的 程序 ， 很 容易 将 其 转换 为 


Value Tuple。 


调用 ToValueTuple 扩展 方法 可 以 将 Tuple 类 型 转换 为 ValueTuple。 由 于 旧 的 Tuple 类 型 没有 提供 更 好 的 名 
称 ， 因 此 需要 用 圆 括号 定义 名 称 (代码 文件 Tuples /Program_cs): 


static void TupleCompatibility() 
{ 
// convert Tuple to ValueTuple 
Tuple<string, 
new Person("Katharina"™, 


int, bool, Person> 七 1 
"Nagel™")); 


Tuple. 


Console.WriteLine ($"old tuple — string: {ti. 
bool: {tl.Item3}, Person: {tl1.Item4}"); 

(string s, int i, bool b, Person p) t2 = t1. 

Console.WriteLine (S$"new tuple — string: {t2. 
Person: {t2.p}"}; 

Ff 


} 


Create ("a string", 42, true, 


Iteml}, number: {ti1.Item2}, 


ToVvalueTuple(}); 


s}, number: {t2.1i}, bool: {t2.b}, 


旧 元 组 也 可 以 解构 到 特定 的 字段 。 下 例 显示 了 将 元 组 tl 解构 到 字段 s、i 和 b。 


static void TupleCompatibility() 
{ 
i 
(string s, int i, bool b, Person p) tl]s 
Console.WriteLine (S$"new tuple — string: {s}, 
Person {p}"™):; 


} 


:i/ Deconstruct 


number: {1i}, bool: {b}., 


反 过 来 也 是 可 能 的 。 新 的 值 元 组 可 以 用 ToTuple 方法 转换 成 元 组 。 当 然 ， 震 要 使 用 Iteml1、Item2、Item3 等 


指定 成 员 。 
static void TupleCompatibility() 
{ 
FF 
/:/: convert ValueTuple to Tuple 
Tuple<string, int, bool, Person> 七 3 
Console.WriteLine ($s$"old tuple 一 string: 
$s"pool: {tl.Item3}, Person: 


{七 1 . 
{ 七 工 - 工 七 emd 1 7) 


13.6.6 ”推断 出 元 组 名 称 
C#7.1 的 一 个 新 特性 是 推断 元 组 的 名 称 。 前 面 声明 


七 之 - 工 口 TUPJeT) 5 


Iteml}, number: {tl1.Item2}, ”十 


的 Divide 方法 返回 一 个 包含 名 称 result 和 remainder 的 元 


组 。 返 回 的 元 组 写 入 变量 1， 其 中 这 些 名 称 用 于 访问 元 组 字段 。 当 第 二 次 调用 Divide 方法 时 ， 将 tuple 结果 写 
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入 一 个 带 有 名 称 res 和 rem 的 元 组 。 在 返回 的 元 组 中 ，result 写 入 res，remainder 写 入 rem，t3 是 使 用 一 个 元 组 
字面 量 创建 的 ， 其 中 定义 了 res 和 rem 字段 ， 并 相应 地 分 配 元 组 tl 的 值 。 本 例 中 的 第 四 个 元 组 使 用 名 称 推断 ， 
t4 是 使 用 一 个 元 组 字面 量 创 建 的 ， 其 中 的 名 称 与 元 组 tl 的 名 称 相 同 。 在 不 给 元 组 成 员 提 供 名 称 的 情况 下 访问 
result 和 remainder， 会 使 元 组 成 员 和 tl 中 的 字段 同名 ，t4 也 有 名 称 为 result 和 remainder 的 成 员 ( 代 码 文件 
Tuples/Proeram.cs): 

A static void TupleNames () 


Var tl1 = Divide (9, 4); 
Console.WriteLine($"{tl1l.result}, {tl1.remainder}"); 


(int res, int rem) 七 2 = Divide(l1l1, 3); 
Console .WriteLine($"{t2.res}, {t2.rem}"}); 


Var 七 3 = {res: tl1.result, rem: tl1.remainder); 


/i: use inferred names 


Var t4 = (tl.result, tl1.remainder); 
Console.WriteLine($"{t4.result}, {t4.remainder}"); 
} 
注意 : 


元 组 名 称 的 推断 至 少 需要 C#7.1。 需要 在 csproj 项 目 文件 中 使 用 LangVersion 指定 这 个 版 本 , 或 者 在 Visual 
Studio 中 使 用 Project Settings 指定 它 。 


13.6.7 元 组 与 链表 


元 组 的 实际 使 用 与 链表 有 关 。 和 链表 中 的 一 项 ( 它 是 一 个 LinkedListNode) 包 含 了 这 个 项 的 值 和 对 下 一 项 的 引 
用 。 在 下 面 的 代码 片段 中 , 创建 一 个 包含 10 个 元 系 的 链表 。 然后 , 使 用 do/while 语句 人 裔 历 这 个 列表 。 在 循环 中 ， 
使 用 元 组 字面 量 访问 LinkedListNode 的 Value 和 Next 属性 。 通 过 解构 ， 将 值 写 入 变量 Value， 链 表 中 的 下 一 项 
写 入 变量 node， 该 变量 本 身 就 是 LinkedListNode( 代 码 文 件 Tuples/Program.cs): 


static void TuplesWithLinkedList () 
{ 
Console.WriteLine (nameof (TuplesWithLinkedList)); 
var list = new LinkedList<int> (Enumerable.Range (0, 10)); 


int value; 

LinkedListNode<int> node = list.First; 

do 

{ 
{value, node}) = (node.Value, node.Next). 
Console.WriteLine (value),; 

} While {node != null}:; 

Console .WriteLine():; 


} 


注意 : 
链表 在 第 10 章 中 讨论 。 


13.6.8 元 组 和 LINQ 


第 12 章 使 用 LINQ 语句 演示 了 匿名 类 型 和 元 组 ,下面 将 一 个 LINQ 查询 从 匿名 类 型 改 为 元 组 .下面 的 LINQ 
查询 创建 了 一 个 匿名 类 型 ,并 在 Select 方 法 的 参数 中 指定 了 LastName 和 Starts 属性 (代码 文件 Tuples/Program.cs); 


static void UsingaAnonymousTypes  () 
{ 
var racerNamesAndstarts = Formulal .GetChampions () 
-Wherel(r => r.country == "JItaly™) 
-OrderByDescending(r => Ir.Wins) 
.Select(r =»> new 
{ 
r.LastName, 
r.Starts 
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}); 


foreach (var I in racerNameshndstarts) 
{ 
Console.WriteLine($"{r.LastName}, starts: {r.sStarts}"); 
} 
} 


将 花 括 号 改 为 圆 括号 ， 创 建 一 个 带 有 字段 LastName 和 Starts 的 元 组 。 


static void UsingTuples () 
{ 
var racerNamesAndstarts = Formulal .GetcCchampions () 
.Wheret{r 一 > Ir.Country 一 = "ltaly™) 
.OrderByDescending(r => rr.Wins) 
. Select(r =» 
( 
r.LastName, 
r.Starts 
)); 


foreach (var T in racerNameshndstarts) 
{ 
Console.WriteLine($"{r.LastName}, starts: {r.starts}"); 
} 
} 


注意 : 
对 于 匿名 类 型 ， 创 建 一 个 类 ， 因 此 该 类 的 实例 会 分 配 到 堆 上 ， 需 要 从 垃圾 收集 器 中 收集 。 相 比较 而 言 ， 元 
组 是 值 类 型 ， 存 储 在 堆栈 上 。 元 组 具有 性 能 优势 。 


13.6.9 解构 


前 面 介绍 了 元 组 的 解构 一 一 将 元 组 写 入 简单 变量 。 解 构 也 可 以 用 任何 类 型 来 完成 : 把 类 或 结构 分 解 为 它 的 
各 个 部 分 。 
例如 ， 前 面 所 示 的 Person 类 可 以 分 解 为 姓 和 名 (代码 文件 Tuples /Program.cs): 


private static void Deconstruct () 
{ 


var pl = new Person("Katharina™", "Nagel™); 
(var first, var last) = pl.; 


Console.WriteLine ($"{first} {last}™); 
} 


只 需要 创建 Deconstruct 方法 ， 将 分 离 的 部 分 放 入 out 参数 中 (代码 文件 Tuples /Program.cs)。 


public class Person 


{ 
Public Person(string firstName, string lastName) 
{ 
FirstName = firstName; 
LastMame = lastName.; 
} 


public string FirstName { get; } 
Public string LastName { get; } 


Public override string ToString() => S$"{FirstName} {LastName}"; 


PUublic Vvoid Deconstruct (out string firstName, out string lastName) 
{ 

firstName = FirstName; 

lastMame = LastName.; 


解构 是 用 方法 名 Deconstruct 实现 的 。 该 方法 总 是 void 类 型 ， 并 用 out 参数 返回 各 个 部 分 。 为 什么 创建 元 组 
的 方法 不 能 通过 返回 元 组 来 实现 ? 原因 是 允许 重 载 。 可 以 使 用 不 同 的 参数 类 型 实现 多 个 Deconstruct 方法 。 这 在 
返回 元 组 时 是 不 可 能 的 。 在 C# 中 ， 重 载 方 法 不 能 仅 通 过 它 的 返回 类 型 来 区 分 。 
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13.6.10 ”解构 与 扩展 方法 


即使 不 给 应 解构 的 类 添加 Deconstrct 方法 , 解构 也 是 可 以 实现 的 : 使 用 扩展 方法 .。 下面 的 代码 示例 为 Racer 
类 型 定义 了 一 个 扩展 方法 ， 将 Racer 解构 为 fstName 、lastName 、starts 和 wins( 代 码 文 件 Tuples/ 
RacerExtensions.cs): 


public static class RacerExtensions 
{ 
Public static volid Deconstruct({this Racer rr, out string firstName, 
out string lastName, out int starts, out int wins) 
{ 
firstName = I.FirstName.; 
lastName = Ir.LastName; 
starts = I.Starts; 
Wlins = I.Wins; 
} 
} 
下 面 的 代码 片段 将 Racer 分 解 为 变量 frst 和 last。Starts 和 wins 被 忽略 (代码 文件 Tuples/Program.cs): 
static void DeconstructWithExtensionsMethods () 
{ 
Var racer = Formlal .GetChampions () -Where 
工 => Ir.LastName =— "Lauda™) .First():; 
(string first, string last, |, ) = racer; 
Console .WriteLine ($"{first} {last}"); 
} 


元 组 是 C# 7 中 最 重要 的 改进 之 一 (如 果 不 是 最 重要 的 话 )。 接 下 来 学 习 模 式 匹 配 ， 这 是 C# 7 的 另 一 个 重 
要 特性 。 


13.7 模式 匹配 


从 面向 对 象 的 观点 来 看 ， 最 好 总 是 使 用 具体 的 类 型 和 接口 来 解决 问题 。 然 而 ， 通 常 这 并 不 容易 做 到 。 在 数 
据 库 中 , 查询 可 能 会 给 出 与 任何 层次 结构 都 无 关 的 不 同 对 象 类 型 。 访问 API 服务 时 , 可 以 返回 一 个 列表 或 对 象 ， 
或 者 可 能 什么 也 不 返回 。 因 此 ， 方 法 通常 应 该 与 不 同 的 类 型 一 起 工作 。 这 就 是 模式 匹配 可 以 提供 帮助 的 地 方 。 

例如 ， 下 面 创建 了 一 个 不 同 对 象 的 数组 。 在 这 个 名 为 data 的 数组 中 ， 第 一 个 元 素 是 null， 其 后 是 值 为 42 的 整 
数 、 一 个 字符 串 、 一 个 Person 类 型 的 对 象 , 以 及 一 个 包含 Person 对 象 的 数组 (代码 文件 PatternMatching/Program .cs): 


static void Mainl) 


{ 
Var pl = new Person("Katharina", "Nagel"™); 
Var Pp2 = new Person("Matthias", "Nagel™); 
Var p3 = new Person("stephanie", "Nagel1"); 


object[] data = { null, 42, "astring", pl, new Person[] { p2, p3 } }; 


foreach (var item in data) 
{ 
ISOPeTrator (item); 


} 


foreach (var item in data) 
{ 
Switchstatement (1tem) ; 
} 
} 


在 C# 7 中 的 模式 匹配 中 ，is 运算 得 和 switch 语句 得 到 了 三 种 模式 的 增强 : const 模式 、type 模式 和 var 模 
式 。 下 面 从 is 运算 符 开始 详细 介绍 。 


13.7.1 模式 匹配 与 is 运算 符 
与 is 运算 符 的 简单 匹配 是 const 模式 。 在 这 个 模式 中 ， 可 以 将 对 象 与 常量 值 进行 比较 ， 比 如 null 或 42( 代 
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码 文件 PatternMatching/Program.cs): 


static void IsoOperator (ob]ect item) 
{ 
// const pattern 
1f (item is null) 
{ 
Console.WriteLine("item is null"™); 


} 


if (titem is 42) 
{ 
Console.WriteLine{("item 1is 42").: 
} 
ii... 
} 


使 用 前 面 声明 的 数组 运行 应 用 程序 时 ， 数 组 的 前 两 项 与 两 个 站 语句 相 匹 配 ， 如 下 面 的 程序 输出 所 示 : 


item is null 
item 15 42 


方法 的 参数 通常 要 检查 是 否 为 null， 一 般 是 使 用 相等 运算 符 来 比较 null。 例 如 : 
if {item = null) throw ArgumentNullException ("null™); 

现在 可 以 使 用 模式 匹配 替换 : 

if (item is null) throw ArgumentNullException ("null™); 


在 幕后 ，C# 编 译 器 生成 相同 的 中 间 语 言 (ID) 代 码 。 


最 有 趣 的 模式 匹配 是 type 模式 。 使 用 此 模式 ， 可 以 匹配 特定 的 类 型 ， 例 如 int 或 stming。 该 模式 还 允许 声 
明 变 量 ， 例 如 if(itemisinti)， 如 果 该 模式 适用 ， 则 将 变量 i 分 配给 该 项 : 


static void ISOPeTator (object item) 
{ 
AAA --- 
/tyYPe pattern 
1f (item is int) 
{ 
Console.WriteLine($"Item is of type int"); 
} 


if {item is int 工 ) 
{ 

Console.WriteLine($"Item is of type int with the Value {1}"); 
} 


1f (item is string s) 
{ 
Console.WriteLine($"Item is a string: {s}"); 
} 
ff... 
} 


对 于 前 面 的 类 型 模式 ， 这 些 匹 配 应 用 于 值 4 和 字符 串 astring。 


Item is of type int 
Item is of type int with a value 42 
Item is a string: astring 


声明 某 类 型 的 一 个 变量 允许 强 类 型 化 的 访问 。 可 以 访问 该 类 型 的 所 有 成 员 ， 而 不 需要 进行 类 型 转换 。 这 也 
允许 在 让 语 句 中 使 用 逻辑 运算 符 来 检查 其 他 约束 ， 而 不 仅仅 是 类 型 ， 比 如 FirstName 以 字符 串 Ka 开头 : 


static void IsOperator (object item) 


{ 
fi-..-.- 
if (item is Person p && p.FirstName .StartsWith("Ka")) 
{ 
Console.WriteLine($"Item is a person: {p.FirstName} {p.LastName}"); 
} 


if (item is IEnumerable<Person> people) 
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{ 
string names = string.Join(", ", 
people.Select (pl => pl.FirstName) -TOATTaYI() ) : 
Console.WriteLine($"it's a Person collection containing {names}"); 
} 
Ff 
} 


使 用 前 两 种 类 型 模式 和 应 用 的 对 象 数组 ， 这 些 匹配 应 用 于 : 


Item is a person: Katharina Nagel 
it's a Person collection containing Matthias, Stephanie 


还 需要 讨论 一 个 模式 类 型 : var 模式。 一切 都 可 以 应 用 于 var; 只 需要 得 到 具体 的 类 型 。 在 样 例 代码 中 ， 将 
调用 GetType 方法 来 获取 类 型 的 名 称 ， 并 将 具体 类 型 写 入 控制 台 。 当 值 为 nol 时 ，var 模式 也 适用 。 这 就 是 为 什 
么 every 变量 使 用 null 条 件 运算 符 的 原因 。 如 果 项 为 mull， 则 every 为 空 ， 该 项 将 字符 串 null 写 入 控制 台 : 


static void IsOperator (object item) 
{ 
FF 
// war pattern 
if (item is Var every) 
| 
Console.WriteLine($"it's Var of type {every?.GetType{() .Name 22 "null™} ™ + 
ss"with the Value {every 22 "nothing™}"); 
} 
} 


var 模式 的 应 用 程序 的 输出 表明 ， 数 组 的 所 有 项 都 与 此 模式 匹配 ; 


it's Var of type null with the value nothing 

it's Var of type Int32 with the Value 42 

it'"'s Var of type String with the Value astring 

it's Var of type Person with the Value Katharina Nagel 

it's Var of type Person[] with the Value PatternMatching.Personl] 


13.7.2 ”模式 匹配 与 switch 语句 


对 于 switch 语句 , 也 可 以 使 用 三 种 模式 类 型 .下面 的 代码 片段 显示 了 用 于 null 和 42 的 const 模式 ; 用 于 int、 
string 和 Person 的 类 型 模式 ; 以 及 var 模式 。 与 is 运算 符 的 扩展 一 样 ， 对 于 switch 语句 ， 可 以 用 类 型 模式 指定 
变量 ， 将 匹配 结果 写 入 该 变量 。 还 可 以 在 when 子 句 中 应 用 一 个 附加 的 过 滤器 。Person 类 的 第 一 个 类 型 匹配 仅 
适用 于 Person 的 FirstName 属性 值 是 Katharina 的 情形 。 在 switch 语句 中 ，case 语句 的 顺序 非常 重要 。 一 旦 应 用 
了 一 个 case, 就 不 进一步 检查 其 他 case。 如 果 通 过 when 子 句 应 用 了 第 一 个 匹配 的 Person 类 型 ,就 不 应 用 对 Person 
的 第 二 个 case。 这 就 是 为 什么 在 对 类 型 处 理 一 般 case 之 前 ， 必 须 先 进行 when 过 滤 。 用 最 后 一 个 case 中 定义 的 
var 模式 与 传递 给 switch 语句 的 每 个 对 象 匹配 。 但 是 ,只 有 没有 应 用 前 面 定 义 的 其 他 case 时 , 才 会 检查 这 个 case。 
default 子 句 可 以 在 switch 语句 的 每 个 位 置 上 ， 只 有 在 没有 匹配 的 case 时 才 适 用 。 最 好 把 这 个 子 句 放 在 最 后 ( 代 
码 文件 PattermMatching/Program.cs): 


static void Switchstatement (object item) 
{ 
switch (item) 
{ 

Case null: 

Case 42.: 
Console .WriteLine("it's a const pattern™),; 
breaks; 

case lint 1: 
Console .WriteLine ($"jt's a type pattern with int: {1}"); 
break; 

Case string s: 
Console .WriteLine($"it's a type pattern with string: {ss}"); 
break; 

case Person p When p.FirstName == "Katharina™: 
Console .WriteLine ($s"type pattern match with Person and ™ + 

$s"when clause: {p}"); 

break; 

case Person p: 
Console .WriteLine ($s$"type pattern match with Person: {p}"); 
breaks; 
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CaSe Var eVvery: 
Console .WriteLine ($"var pattern match: {every?.GetType() .Name}"); 
break; 

default: 

】 
} 


运行 应 用 程序 时 , switch 语句 的 const 模式 适用 于 null 和 42, 字符 串 模式 适用 于 字符 串 astring, 第 一 个 Person 
case 应 用 于 Person 对 象 ， 最 后 ，Person 数组 与 var 模式 匹配 ， 因 为 之 前 没有 应 用 其 他 模式 。 没 有 与 int 类 型 匹配 
的 类 型 ， 因 为 const 模式 匹配 较 早 : 

it's a const pattern 

it's a const pattern 

it's a type pattern with string: astring 

type pattern match with Person and when clause: Katharina Nagel 

var pattern match: Personll] 


13.7.3 ”模式 匹配 与 泛 型 
如 果 需 要 与 泛 型 相 匹配 的 模式 ， 则 需要 将 编译 器 配置 为 至 少 C# 7.1。C# 7.1 为 泛 型 添加 了 模式 匹配 。 使 用 
C# 7， 可 以 定义 一 个 泛 型 方法 ， 并 使 用 is 运算 符 检 查 泛 型 类 型 的 变量 ， 以 应 用 于 特定 的 类 型 (代码 文件 
PatternMatching/HttpManager.cs): 
public void send<T>(T package) 
if (package is HealthPackage hp) 
hp -CheckHealth () ; 


1/... 
} 


可 以 与 泛 型 进行 模式 匹配 ， 类 似 于 使 用 泛 型 类 的 方式 。 还 可 以 对 泛 型 使 用 模式 匹配 和 switch 语句 。 
注意 : 
第 5 章 讨论 了 泛 型 方法 和 泛 型 类 。 
13.8 小结 
本 章 介 绍 了 c# 7 的 新 特性 ， 比 如 本 地 函数 、 元 组 和 模式 匹配 。 所 有 这 些 特性 都 来 自 函 数 式 编程 范式 ， 但 是 


对 于 创建 普通 的 .NET 应 用 程序 来 说 ， 这 些 都 非常 有 用 。 本 地 函数 在 一 些 场景 中 是 有 用 的 ， 比 如 允许 使 用 yield 
语句 来 处 理 延 迟 方法 的 更 好 的 错误 处 理 方式 。 元 组 提供 了 一 种 组 合 不 同 数据 类 型 的 有 效 方法 。 不 作 总 是 为 这 样 


的 组 合 创 建 自 定 义 类 。 
本 章 还 讨论 了 在 LINQ 碍 询 中 元 组 如 何 蔡 换 匿名 类 型 。 模 式 匹 配 允 许 使 用 is 运算 符 和 switch 语句 的 增强 来 
处 理 不 同 的 类 型 。 


下 一 章 将 讨论 错误 和 异常 的 细节 。 


本 章 要 点 

异 冲 类 

使 用 try...catch...finally 捕获 异常 
创建 用 户 定 义 的 异 第 

获取 调用 者 的 信息 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 ErrorsAndExceptions 目 
录 的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 
® Simple Exceptions 
ExceptionFilters 
RethrowExceptions 
SolicitColdCall 
CallerIntormation 


14.1 简介 


错误 的 出 现 并 不 总 是 编写 应 用 程序 的 人 的 原因 ， 有 时 应 用 程序 会 因为 应 用 程序 的 最 终 用 户 引 发 的 动作 或 运 
行 代码 的 环境 而 发 生 错 误 。 无 论 如 何 ， 我 们 都 应 预测 应 用 程序 中 出 现 的 错误 ， 并 相应 地 进行 编码 。 

.NET Framework 改进 了 处 理 错误 的 方式 。C# 处 理 错误 的 机 制 可 以 为 每 种 错误 提供 目 定义 处 理 方式 ,并 把 识 
别 错误 的 代码 与 处 理 错误 的 代码 分 离开 来 。 

无 论 编码 技术 有 多 好 ， 程 序 都 必须 能 处 理 可 能 出 现 的 任何 错误 。 例 如 ， 在 一 些 复 杂 的 代码 处 理 过 程 中 ， 代 
码 没 有 读 取 文件 的 许可 ， 或 者 在 发 送 网 络 请 求 时 ， 网 络 可 能 会 中 断 。 在 这 种 异常 情况 下 ， 方 法 只 返回 相应 的 错 
误 代码 通常 是 不 够 的 一 一 可 能 方法 调用 嵌 套 了 15 级 或 者 20 级 ， 此 时 ， 程 序 需要 跳 过 所 有 的 15 或 20 级 方法 调 
用 , 才能 完全 退出 任务 , 并 采取 相应 的 应 对 措施 。C# 语 言 提 供 了 处 理 这 种 情形 的 最 佳 工 具 , 称 为 异 弟 处 理 机 制 。 

本 章 介 绍 了 在 多 种 不 同 的 场景 中 捕获 和 抛 出 异 弟 的 方式 。 讨 论 不 同名 称 空间 中 定义 的 异 闸 类 型 及 其 层次 结 
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构 ， 并 学 习 如 何 创 建 目 定义 异常 类 型 。 还 将 学 到 捕获 异 沼 的 不 同方 式 ， 例 如 ， 捕 获 特定 类 型 的 异 弟 或 者 捕获 基 
类 的 民利 。 本 章 还 会 介绍 如 何 处 理 藤 套 的 try 块 ， 以 及 如 何以 这 种 方式 捕获 异 前 。 对 于 无 论 如 何 都 要 调用 的 代 
码 一 一 即使 发 生 了 异 音 或 者 代码 带 错 运行 ， 可 以 使 用 本 章 介 绍 的 try/finally 块 。 

学 习 完 本 章 后 ， 你 将 很 好 地 和 擎 握 C# 尾 用 程序 中 的 高 级 异常 处 理 技术 。 


14.2 异常 类 


在 C# 中 ， 妆 出 现 菜 个 特殊 的 异 闸 错误 条 件 时 ， 就 会 创建 (或 抛 出 ) 一 个 异 第 对象。 这 个 对 象 包 含有 助 于 跟踪 问 
题 的 信息 。 我 们 可 以 创建 目 己 的 异常 类 ( 详 见 后 面 的 内 容 )， 但 .NET 提供 了 许多 预定 义 的 异常 类 ， 多 到 这 里 不 可 能 
提供 详尽 的 列表 。 在 图 14-1 类 的 层次 结构 图 中 显示 了 其 中 的 一 些 类 ， 它 们 给 出 了 大 致 的 模式 。 本 节 将 简要 介绍 
在 .NET 基 类 库 中 可 用 的 一 些 异 向 。 


[Serializable 
_Ex i 


ptian 


StackOverflowException ¥ 
Saaled Class 

= SytemException 

= 


ArgumenthullExceptisn ¥ | 
Class FileaLoadException | TargatinvocationExwception ChangeRejectaedException ¥ 
Class 


E 
= ArgumentException 
-a -上 
| Exception CompositionExcepticon 
| = 


| FileNatFeundException 和 
LM 

= Exception 

| 


ArgumentOutOfRangeException ¥ 
Class 


= Baumenit Ewcsptian 


EndOfstreamException ~¥ 


Class 
=* [OExceptiion 
吧 


DriveNotFoundExwception ¥ 


+ OException 
= 品 


图 14-1 


图 14-1 中 的 所 有 类 都 在 System 名 称 空间 中 ， 但 IOException 类 、CompositionException 类 和 派生 于 这 两 个 
类 的 类 除外 。IOException 类 及 其 派生 类 在 System.IO 名 称 空间 中 。System.IO 名 称 空间 处 理 文件 数据 的 读 写 。 
CompositionException 及 其 派生 类 在 System.ComponentModel.Composition 名 称 空间 中 。 该 名 称 空间 处 理 部 件 和 
组 件 的 动态 加 载 。 一 般 情 况 下 ， 异 常 没 有 特定 的 名 称 空间 ， 异 党 类 应 放 在 生成 异常 的 类 所 在 的 名 称 空间 中 ， 因 
此 与 IO 相关 的 异常 就 在 System.IO 名 称 空间 中 。 在 许多 基 类 名 称 空间 中 都 有 异常 类 。 
对 于 .NET 类 , 一 般 的 异常 类 System.Exception 派生 上 自 System.Object, 通常 不 在 代码 中 抛 出 System.Exception 
泛 型 对 象 ， 因 为 它们 无 法 确定 错误 情况 的 本 质 。 
在 该 层次 结构 中 有 两 个 重要 的 类 ， 它 们 派生 上 自 System.Exception 类 : 
e SystemException 一 一 该 类 用 于 通常 由 .NET 运行 库 抛 出 的 异常 , 或 者 由 几乎 所 有 的 应 用 程序 抛 出 的 异常。 
例如 ， 如 果 .NET 运行 库 检 测 到 栈 已 满 ， 它 就 会 抛 出 StackOverflowException 异常 。 男 一 方面 ， 如 果 检 
测 到 调用 方法 时 参数 不 正确 ， 就 可 以 在 目 己 的 代码 中 选择 抛 出 ArgumentException 异常 或 其 子 类 异 贡 。 
SystemException 异常 的 子 类 包括 表示 致命 错误 和 非 致 合 错 误 的 异常 。 
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e ApplicationException 一 一 在 NET Framework 最 初 的 设计 中 , 是 打算 把 这 个 类 作为 自 定 义 应 用 程序 异常 类 
的 基 类 的 。 不 过 ，CLR 抛 出 的 一 些 异常 类 也 派生 目 这 个 类 (例如 ，TargetInvocationException)， 应 用 程序 
抛 出 的 异常 则 派生 自 SystemException( 例 如 ，AreumentException)。 因 此 从 ApplicationException 派生 自 
定义 异 弟 类 型 没有 提供 任何 好 处 ， 所 以 不 再 是 一 种 好 做 法 。 取 而 代 之 的 是 ， 可 以 直接 从 Exception 基 关 
派生 自 定义 异常 类 。.NET Framework 中 的 许多 异常 类 直接 派生 自 Exception。 

其 他 可 能 用 到 的 异 瘦 类 包括 : 

® StackOverflowException 一 一 如 果 分 配给 栈 的 内 存 区 域 已 满 ， 就 会 抛 出 这 个 异常 。 如 果 一 个 方法 连续 地 
递归 调用 它 上 自己 , 就 可 能 发 生 栈 洲 出 。 这 一 般 是 一 个 致命 错误 ， 因 为 它 禁 止 应 用 程序 执行 除了 中 断 以 
外 的 其 他 任务 。 在 这 种 情况 下 ， 甚 至 也 不 可 能 执行 finally 块 。 通 常用 户 目 己 不 能 处 理 像 这 样 的 错误 ， 


而 应 退出 应 用 程序 。 

e EndOfSstreamException 一 一 这 个 异 彰 通 币 是 因为 读 到 文件 末尾 而 抛 出 的 。 流 表示 数据 源 之 间 的 数据 流 。 
流 详 见 第 23 草 。 

e OverflowException 一 一 如 果 要 在 checked 上 下 文中 把 包含 值 -40 的 int 类 型 数据 强制 转换 为 uint 数据 , 就 
会 抛 出 这 个 异 弟 。 


我 们 不 打算 讨论 图 14-1 中 的 其 他 异常 类 。 显 示 它 们 仅 为 了 演示 异常 类 的 层次 结构 。 

异常 类 的 层次 结构 并 不 多 见 , 因为 其 中 的 大 多 数 类 并 没有 给 它们 的 基 类 添加 任何 功能 。 但 是 在 处 理 异常 时 ， 
添加 继承 类 的 一 般 原因 是 更 准确 地 指定 错误 条 件 , 所 以 不 需要 重 写 方 法 或 添加 新 方法 (尽管 常常 要 添加 额外 的 属 
性 , 以 包含 有 关 错 误 情况 的 额外 信息 )。 例 如 , 当 传 递 了 不 正确 的 参数 值 时 , 可 给 方法 调用 使 用 ArgumentException 
基 类 ，AreumentNullException 类 派生 于 ArgumentException 异常 类 ， 它 专门 用 于 处 理 所 传 递 的 参数 值 是 Null 的 
情况 。 


14.3 ”捕获 异常 


.NET 提供 了 大 量 的 预定 义 基 类 异 各 对象， 本 节 介 绍 如 何在 代码 中 使 用 它们 捕获 错误 情况 。 为 了 在 C# 代 码 中 
处 理 可 能 的 错误 情况 ， 一 般 要 把 程序 的 相关 部 分 分 成 3 种 不 同类 型 的 代码 块 : 
e fy 块 包含 的 代码 组 成 了 程序 的 正常 操作 部 分 ， 但 这 部 分 程序 可 能 遇 到 某 些 严 重 的 错误 。 
e catch 块 包含 的 代码 处 理 各 种 错误 情况 ,这 些 错误 是 执行 ty 块 中 的 代码 时 过 到 的 。 这 个 块 还 可 以 用 于 记 
录 错 误 。 

e finally 块 包含 的 代码 清理 资源 或 执行 通常 要 在 try 块 或 catch 块 末 尾 执行 的 其 他 操作 。 无 论 是 否 抛 出 
异常 ， 都 会 执行 fnally 块 ， 理 解 这 一 点 非常 重要 。 因 为 finally 块 包含 了 应 总 是 执行 的 清理 代码 ， 如 果 
在 finally 块 中 放置 了 retum 语句 ， 编 译 器 就 会 标记 一 个 错误 。 例 如 ， 使 用 finally 块 时 ， 可 以 关闭 在 ty 
块 中 打开 的 连接 。finally 块 是 完全 可 选 的 。 如 果 不 需 要 清理 代码 (如 删除 对 象 或 关闭 已 打开 的 对 象 )， 就 
不 需要 包含 此 块 。 

下 面 的 步骤 说 明了 这 些 块 是 如 何 组 合 在 一 起 捕获 错误 情况 的 : 

(1) 执行 的 程序 流 进 入 try 块 。 

(2) 如 果 在 try 块 中 没有 错误 发 生 ， 在 块 中 就 会 正常 执行 操作 。 当 程序 流 到 达 try 块 末尾 后 ， 如 果 存 在 一 个 
finally 块 ， 程 序 流 就 会 目 动 进 入 finally 块 (第 (5) 步 )。 但 如 果 在 try 块 中 程序 流 检测 到 一 个 错误 ， 程序 流 就 会 跳 转 
到 catch 块 (第 (3) 步 )。 

(3) 在 catch 块 中 人 处理 错误 。 

(4) 在 catch 块 执 行 完 后 ， 如 果 存 在 一 个 finally 块 ， 程 序 流 就 会 自动 进入 finally 块 : 

(5) 执行 finally 块 (如 果 存 在 )。 

用 于 完成 这 些 任务 的 C# 语 法 如 下 所 示 : 


try 


/i code for normal execution 
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> 

// error handling 
0 

/i clean up 

} 


实际 上 ， 上 面 的 代码 还 有 几 种 变 体 : 

@ 可 以 省 略 finally 块 ， 因 为 它 是 可 选 的 。 

。 可 以 提供 任意 多 个 catch 块 ， 处 理 不 同类 型 的 错误 。 但 不 应 包含 过 多 的 catch 块 ， 以 防 降低 应 用 程序 的 

性 能 。 

。 可 以 定义 过 滤器 ， 其 中 包含 的 catch 块 仅 在 过 滤器 匹配 时 ， 捕 获 特 定 块 中 的 异常。 

。 可 以 省 略 catch 块 。 此 时 ， 该 语法 不 是 标识 异常 ， 而 是 一 种 确保 程序 流 在 离开 ty 块 后 执行 finally 块 中 的 

代码 的 方式 。 如 果 在 try 块 中 有 几 个 出 口 点 ， 这 很 有 用 。 

这 看 起 来 很 不 错 ， 实 际 上 是 有 问题 的 。 如 果 运 行 ty 块 中 的 代码 ， 则 程序 流 如 何在 错误 发 生 时 切换 到 catch 
块 ? 如 果 检 测 到 一 个 错误 ,代码 就 执行 一 定 的 操作 , 称 为 “ 抛 出 一 个 异常 ” 换言之 ， 它 实例 化 一 个 异常 对 象 类 ， 
并 抛 出 这 个 异常: 

throw new OverflowException(); 

这 里 实例 化 了 OverflowException 类 的 一 个 异常 对 象 。 只 要 应 用 程序 在 try 块 中 遇 到 一 条 throw 语句 ， 就 会 
立即 查找 与 这 个 ty 块 对 应 的 catch 块 。 如 果 有 多 个 与 try 块 对 应 的 catch 块 ， 应 用 程序 就 会 查找 与 catch 块 对 应 
的 异常 类 ， 确 定 正确 的 catch 块 。 例 如 ， 当 抛 出 一 个 OverflowException 异常 对 象 时 ， 执 行 的 程序 流 就 会 跳 转 到 
下 面 的 catch 块 : 

catch (OverflowException ex) 


/:/ exception handling here 


换言之 ， 应 用 程序 查找 的 catch 块 应 表示 同一 个 类 (或 基 类 ) 中 匹配 的 异常 类 实例 。 

有 了 这 些 和 额外 的 信息 ， 就 可 以 扩展 刚才 介绍 的 try 块 。 为 了 讨论 方便 ， 假定 可 能 在 try 块 中 发 生 两 个 严重 错 
误 : 洲 出 和 数组 超出 范围 。 假 定 代码 包含 两 个 布尔 变量 Overflow 和 OutOfBounds， 它 们 分 别 表 示 这 两 种 错误 情 
况 是 否 存 在 。 我 们 知道 ， 存 在 表示 洲 出 的 预定 义 洲 出 异常 类 OverflowException; 同样 ， 存 在 预定 义 的 
IndexOutOfRangeException 异常 类 ， 用 于 处 理 超出 范围 的 数组 。 
try 
{ 


/i: code for normal execution 
if (Overflow == true) 


throw new OverflowException(}); 
} 
// more processing 
if (GutoOfBounds == 七 TUE) 
{ 
throw new IndexOutofRangeException(); 
// otherwise continue normal execution 
catch (OverflowException ex) 
{ 
/:/ error handling for the overflow error condition 
} 
catch (IndexOutofRangeException ex) 
:i error handling for the index out of range error condition 


finally 


// clean up 
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这 是 因为 throw 语句 可 以 髓 套 在 try 块 的 几 个 方法 调用 中 ,甚至 在 程序 流 进入 其 他 方法 时 , 也 会 继续 执行 同 
一 个 ty 块 。 如 果 应 用 程序 遇 到 一 条 throw 语句 ， 就 会 立即 退出 栈 上 所 有 的 方法 调用 ， 查 找 try 块 的 结尾 和 合适 
的 catch 块 的 开头 ， 此 时 ， 中 国 方 法 调用 中 的 所 有 局 部 变量 都 会 超出 作用 域 。ty...catch 结构 最 适合 于 本 节 开 头 
描述 的 场合 : 错误 发 生 在 一 个 方法 调用 中 ， 而 该 方法 调用 可 能 嵌 套 了 15 或 20 级 ， 这 些 处 理 操作 会 立即 停止 。 

从 上 面 的 论述 可 以 看 出 ，try 块 在 控制 执行 的 程序 流 上 有 重要 的 作用 。 但 是 ， 异 常 是 用 于 处 理 异常 情况 的 ， 这 是 
其 名 称 的 由 来 。 不 应 该 用 异常 来 控制 退出 do...while 循环 的 时 间 。 


14.3.1 异常 和 性 能 


异常 处 理 具有 性 能 含义 。 在 常见 的 情况 下 ， 不 应 该 使 用 异常 处 理 错误 。 例 如 ， 将 字符 串 转换 为 数字 时 ， 可 
以 使 用 int 类 型 的 Parse 方法 。 如 果 传 递 给 此 方法 的 字符 串 不 能 转换 为 数字 ， 则 此 方法 抛 出 FormatException 寞 
常 ， 如 果 可 以 转换 一 个 数字 ， 但 它 不 能 放 在 int 类 型 中 ， 则 抛 出 OverflowException 异常 : 

static void NumberDemol (string n) 

| If (n is null) throw new ArgumentNullException (nameof (n})); 

try 

| int 1i = int.Parse(n).; 
Console.WriteLine{($"converted: {1}"); 

0 (FormatException ex) 

{ 


Console.WriteLine (ex.Message),; 
} 
catch (OverflowException ex) 
{ 
Console.WriteLine (ex.Message).; 
} 
} 


如 果 NumberDemol 方法 通常 只 用 于 在 字符 串 中 传递 数字 而 接收 不 到 数字 是 异常 的 , 那么 可 以 这 样 编写 它 。 
但 是 ， 如 果 在 程序 流 的 正常 情况 下 ， 捧 望 的 字符 串 不 能 转换 时 ， 可 以 使 用 TryParse 方法 。 如 打字 符 串 不 能 转换 
为 数字 ， 此 方法 不 会 抛 出 异常 。 相 反 ， 如 果 解 析 成 功 ，TyParse 返回 true; 如 果 解 析 失 败 ， 则 返回 false: 


static void NumberDemo?2 (string n) 
{ 
If (mn is null) throw new ArgumentNullException (nameof (n)); 
if (int.TryParse(n, out int result)) 
{ 
Console.WriteLine($"converted {result}"); 
} 


已 ] Se 


Console.WriteLine("not a number™): 
} 
} 


14.3.2 ”实现 多 个 catch 块 


要 了 解 try...catch...finally 块 是 如 何 工作 的 ， 最 简单 的 方式 是 用 两 个 示例 来 说 明 。 第 一 个 示例 是 
SimpleExceptions。 它 多 次 要 求 用 户 输入 一 个 数字 ， 然 后 显示 这 个 数字 。 为 了 便于 解释 这 个 示例 ， 假 定 该 数字 必 
须 在 0 到 5 之 间 ， 否 则 程序 就 不 能 对 该 数字 进行 正确 的 处 理 。 所 以 ， 如 果 用 户 输 入 超出 该 范围 的 数字 ， 程 序 就 
抛 出 一 个 异常 。 程 序 会 继续 要 求 用 户 输入 更 多 数字 ， 直 到 用 户 不 再 输入 任何 内 容 ， 按 回 车 键 为 止 。 


注意 : 

这 段 代 码 没有 说 明 何 时 使 用 异常 处 理 ， 但 是 它 显 示 了 使 用 异常 处 理 的 好 方法 。 顾 名 思 义 ， 异 常用 于 处 理 异 
常情 况 。 用 户 经 常 输入 一 些 无 聊 的 东西 ， 所 以 这 种 情况 不 会 真正 发 生 。 正 常情 况 下 ， 程 序 会 处 理 不 正确 的 用 户 
输入 ， 方 法 是 进行 即时 检查 ， 如 果 有 问题 ， 就 要 求 用 户 重 新 输入 。 但 是 ， 在 一 个 要 求 几 分 钟 内 读 懂 的 小 示例 中 
生成 异常 是 比较 困难 的 ， 为 了 描述 异常 是 如 何 工作 的 ， 后 面 将 使 用 更 真实 的 示例 。 
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SimpleExceptions 的 代码 如 下 所 示 ( 代 码 文件 SimpleExceptions/Program.cs): 
Public class Program 


| 


PUublic static void Main({) 


while (true) 
{ 
try 
{ 
string userIinput; 
Console.Write("Input a number between 0 and 5 ™ 十 
"(or JjJust hit return to exit)> "™); 
userInput = Console.ReadLine (); 


if (string.IsNullOorEmpty (userIinput)) 
{ 
break; 
} 
int index = Convert.ToInt32 (userInput)}),; 
if (index < 0 || index > 5) 
{ 
throw new IndexOutoOfRangeException($"You typed in {userInput}"); 
} 
Console.WriteLine ($"Your number Was {index}"); 
} 
catch (IndexOutofRangeException ex) 
{ 
Console.WriteLine ("Exception: ”十 
s"Number should be petween 0 and 5. {ex.Message}™); 
} 


catch (Exception ex) 


Console.WriteLine ($"An exception Was thrown. Message was: ™ 十 
$s"{ex.Message}"™.); 
} 
finally 
{ 


Console.WriteLine ("Thank you\n™"™); 
} 
} 
} 

} 

这 段 代 码 的 核心 是 一 个 while 循环 ， 它 连续 使 用 ReadLine() 方 法 以 请 求 用 户 输入 。ReadLine0 方 法 返回 
一 个 字符 串 ， 所 以 程序 首先 要 用 System.Convert.ToInt320 方 法 把 它 转 换 为 mt 型 。System.Convert 类 包含 执行 数 
据 转 换 的 各 种 有 用 方法 ， 并 提供 了 intParse(0) 方 法 的 一 个 替代 方法 。 一 般 情 况 下 ，System.Convert 类 包含 执行 各 
种 类 型 转换 的 方法 ，C# 编 译 器 把 int 解析 为 System.Int32 基 类 的 实例 。 


注意 : 
值得 注意 的 是 ,传递 给 catch 块 的 参数 只 能 用 于 该 catch 块 .这 就 是 为 什么 在 上 面 的 代码 中 ,能 在 后 续 的 catch 
块 中 使 用 相同 的 参数 各 


在 上 面 的 代码 中 ， 我 们 也 检查 一 个 空 字符 串 ， 因 为 该 空 字符 串 是 退出 while 循环 的 条 件 。 注 意 这 里 用 break 
语句 退出 try 块 和 while 循环 一 一 这 是 有 效 的 。 当 然 ， 当 程序 流 退 出 try 块 时 ， 会 执行 finally 块 中 的 
Console.WriteLine() 语 句 。 尽管 这 里 仪 显示 一 句 问 候 , 但 一 般 在 这 里 可 以 关闭 文件 句柄 , 调用 各 种 对 象 的 Dispose() 
方法 ， 以 执行 清理 工作 。 一 旦 应 用 程序 退出 了 finally 块 ， 它 就 会 继续 执行 下 一 条 语句 ， 如 果 没 有 finally 块 ， 该 
语句 也 会 执行 。 在 本 例 中 ， 我 们 返回 到 while 循环 的 开头 ， 再 次 进入 try 块 (除非 执行 while 循环 中 break 语句 的 
结果 是 进入 finally 块 ， 此 时 就 会 退出 while 循环 )。 

下 面 看 看 异 间 情况: 


if index < 0 || index > 5) 
{ 

throw new IndexOutofRangeException{($"You typed in {userInput}"),; 
} 


在 抛 出 一 个 异常 时 ， 需 要 选择 要 抛 出 的 异常 类 型 。 可 以 使 用 System.Exception 异常 类 ， 但 这 个 类 是 一 个 基 类 ， 
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最 好 不 要 把 这 个 类 的 实例 当 作 一 个 异常 抛 出 ， 因 为 它 没 有 包含 关于 错误 的 任何 信息 。 而 .NET Framework 包含 了 许 
多 派生 目 System.Exception 异常 类 的 其 他 异常 类 ， 每 个 类 都 对 应 于 一 种 特定 类 型 的 异常 情况 ， 也 可 以 定义 目 己 的 
异 闸 类 。 在 抛 出 一 个 匹配 特定 错误 情况 的 类 的 实例 时 ， 应 提供 尽 可 能 多 的 异 单 信息。 在 前 面 的 例子 中 ， 
System.IndexOutOfRaneeException 异常 类 是 最 佳 选择 。IndexOutOfRanegeException 异常 类 有 几 个 重 载 的 构造 函数 ， 
我 们 选择 的 一 个 重 载 ， 其 参数 是 一 个 描述 错误 的 字符 串 。 另 外 ， 也 可 以 选择 派生 上 自己 的 上 自 定 义 异 党 对 象 ， 它 描述 
该 应 用 程序 环境 中 的 错误 情况 。 

假定 用 户 这 次 输入 了 一 个 不 在 0 一 5 范围 内 的 数字 ，if 语句 就 会 检测 到 一 个 错误 ， 并 实例 化 和 抛 出 一 个 
IndexOutOfRangeException 异常 对 象 。 应 用 程序 会 立即 退出 try 块 , 并 查找 处 理 IndexOutOfRangeException 异常 
的 catch 块 。 它 遇 到 的 第 一 个 catch 块 如 下 所 示 : 

catch (IndexOutOfRangeException ex) 

PE (S$"Exception: Number should be between 0 and 5." + 


$s"{erx.Message}"™); 


} 

由 于 这 个 catch 块 带 合 适 类 的 一 个 参数 ， 因 此 它 会 接收 寞 音 实 例 ， 并 被 执行 。 在 本 例 中 ， 是 显示 错误 信息 和 
Exception.Message 属性 ( 它 对 应 于 传递 给 IndexOutofRangeException 的 构造 图 数 的 字符 串 )。 执 行 了 这 个 catch 块 后 ， 
控制 权 就 切换 到 finally 块 ， 就 好 像 没 有 发 生 过 任何 异常 。 

注意 ， 本 示例 还 提供 了 男 一 个 catch 块 : 

catch (Exception ex) 


Console .WriteLine($"An exception Was thrown. Message was: {ex.Message} "); 


如 果 没 有 在 前 面 的 catch 块 中 捕获 到 这 类 异 弟 ， 则 这 个 catch 块 也 能 处 理 mdexOutOfRangeException 异常 。 基 类 的 
一 个 引用 也 可 以 指 癌 派生 目 它 的 类 的 所 有 实例 ， 所 有 的 异常 都 派生 目 Exception 类 。 这 个 catch 块 没 有 执行 ， 因 
为 应 用 程序 只 执行 它 在 可 用 的 catch 块 列表 中 找到 的 第 一 个 合适 的 catch 块 .第 二 个 catch 块 捕获 派生 目 Exception 
基 类 的 其 他 异常 。 请 注意 在 try 块 中 对 方法 (Console.ReadLine、Console .Write 和 Convert.ToInt32) 的 三 个 单独 调 
用 ， 可 能 会 抛 出 其 他 异常 。 

如 果 输 入 的 内 容 不 是 数字 ， 如 a 或 hello， 则 Convert.ToInt320 方 法 就 会 抛 出 System.FormatException 类 的 一 个 异 
笛 ， 表 示 传 递 给 ToInt320 方 法 的 字符 串 对 应 的 格式 不 能 转换 为 int。 此 时 ， 应 用 程序 会 跟 踊 这 个 方法 调用 ， 查 找 
可 以 处 理 该 异常 的 处 理 程序 。 第 一 个 catch 块 带 一 个 IndexOutOfRangeException 异常 ， 不 能 处 理 这 种 异常 。 应 用 
程序 接着 查看 第 二 个 catch 块 ， 显 然 它 可 以 处 理 这 类 异常 ， 因 为 FormatException 异常 类 派生 于 Exception 异常 类 ， 
所 以 把 FormatException 异常 类 的 实例 作为 参数 传递 给 它 。 

该 示例 的 这 种 结构 是 非常 典型 的 多 catch 块 结构 。 最 先 编写 的 catch 块 用 于 处 理 非常 特殊 的 错误 情况 ， 接 着 
是 比较 一 般 的 块 ， 它 们 可 以 处 理 任何 错误 ， 我们 没有 为 它们 编写 特定 的 错误 处 理 程 序 。 实 际 上 ，catch 块 的 顺序 
很 重要 ， 如 果 以 相反 的 顺序 编写 这 两 个 块 ， 代 码 就 不 会 编译 ， 因 为 第 二 个 catch 块 是 不 会 执行 的 (Exception catch 
块 会 捕获 所 有 有 异 单 )。 因 此 ， 最 上 面 的 catch 块 应 用 于 最 特殊 的 异 背 情 况 ， 最 后 是 最 一 般 的 catch 块 。 

前 面 分 析 了 该 示例 的 代码 ， 现 在 可 以 运行 它 。 下 面 的 输出 说 明了 不 同 的 输入 会 得 到 不 同 的 结果 ， 并 说 明 抛 
出 了 IndexOutOfRangeException 异常 和 FormatException 异常 : 


SimpleExceptions 

Input a number between 0 and 5 (or ]just hit return to exit)> 4 
YOUr number was 4 

Thank YOU 

Input a number between 0 and 5 {or Just hit return to exit)> 0 
YOUT number was 0 

Thank You 

Input a number between 0 and 5 (or JjJust hit return to exit)> 10 
Exception: Number should be between 0 and 5. You typed in 10 

Thank you 

Input a number between 0 angd 5 (or JjJust hit return to exit)> hello 
An exception was thrown. Message was: Input string was not in a correct format. 
Thank YOU 

Input a number between 0 and 5 {or JjJust hit return to exit)> 

Thank you 
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14.3.3 ”在 其 他 代码 中 捕获 异常 


上 面 的 示例 说 明了 两 个 异常 的 处 理 。 一 个 是 IndexOutOfRangeException 异常 ， 它 由 我 们 自己 的 代码 抛 出 ， 
男 一 个 是 FormatException 异常 ， 它 由 一 个 基 类 抛 出 。 如 果 检 测 到 错误 , 或 者 某 个 方法 因 传 递 的 参数 有 误 而 被 错 
误 调 用 ， 库 中 的 代码 就 常常 会 抛 出 一 个 异常 。 但 库 中 的 代码 很 少 捕获 这 样 的 异常 。 应 由 客户 端 代码 来 决定 如 何 
处 理 这 些 问 题 。 

在 调试 时 ， 异 常 经 常 从 基 类 库 中 抛 出 ， 调 试 的 过 程 在 某 种 程度 上 是 确定 异常 抛 出 的 原因 ， 并 消除 导致 错误 
发 生 的 缘由 。 主 要 目标 是 确保 代码 在 发 布 后 ， 异 常 只 发 生 在 非常 少见 的 情况 下 ， 如 果 可 能 ， 应 在 代码 中 以 适当 
的 方式 处 理 它 。 


14.3.4 System.Exception 属性 


本 示例 只 使 用 了 异常 对 象 的 一 个 Message 属性 ,在 System.Exception 异常 类 中 还 有 许多 其 他 属性 , 如 表 14-1 
所 示 。 


表 14-1 
属 性 说 明 
Data 这 个 属性 可 以 给 异常 添加 键 / 值 语句 ， 以 提供 关于 异常 的 额外 信息 
HelpLink 链接 到 一 个 帮助 文件 上 ， 以 提供 关于 该 异常 的 更 多 信息 
InnerException 如 果 此 异常 是 在 catch 块 中 抛 出 的 ， 它 就 会 包 会 把 代码 发 送 到 catch 块 中 的 异常 对 象 
Message 描述 错误 情况 的 文本 
SOUICe 导致 异常 的 应 用 程序 名 或 对 象 名 
stackTrace 栈 上 方法 调用 的 详细 信息 ， 它 有 助 于 跟踪 抛 出 异常 的 方法 
HResult 分 配给 异常 的 一 个 数值 
TargetSite .NET 反射 对 象 ， 描 述 了 抛 出 异常 的 方法 


在 这 些 属 性 中 ， 如 果 可 以 进行 栈 跟踪 ， 则 StackTrace 的 属性 值 由 .NET 运行 库 自动 提供 。Source 属性 总 是 
由 .NET 运行 库 填充 为 抛 出 异常 的 程序 集 的 名 称 (但 可 以 在 代码 中 修改 该 属性 ， 提 供 更 具体 的 信息 )，Data、 
Message、HelpLink 和 InnerException 属性 必须 在 抛 出 异常 的 代码 中 填充 ， 方 法 是 在 抛 出 异常 前 设置 这 些 属性 。 
例如 ， 抛 出 异 妆 的 代码 如 下 所 示 : 
if (ErrorCcondition == true) 
{ 
var myException = new ClassMyException ("Help!l!!l!"); 
myException.Source = "MY Application Name™; 
myException.HelpLink = "MyHelpFile.txt"; 
myException.Datal["ErrorDate"] = DateTime .Now; 
myException.Data.Add ("AdditionalIinfo™", "Contact Bill from the Blue Team"™); 


throw myException; 


} 
其 中 ， ClassMyException 是 抛 出 的 异常 类 的 名 称 。 注 意 所 有 异常 类 的 名 称 通 常 以 Exception 结尾 。 男 外 ， 
Data 属性 可 以 用 两 种 方式 设置 。 


14.3.5 ”异常 过 滤器 


目 从 C# 6 开始 就 支持 异常 过 滤器 。catck 块 仪 在 过 滤器 返回 true 时 执行 。 捕 获 不 同 的 异 向 类 型 时 ， 可 以 有 
行为 不 同 的 catch 块 。 在 某 些 情 况 下 ，catch 块 基于 寞 剃 的 内 容 执 行 不 同 的 操作 。 例 如, 使 用 Windows 运行 库 时 ， 
所 有 不 同类 型 的 异常 通 弟 都 会 得 到 COM 寞 弟 ， 在 执行 网 络 调用 时 ,许多 不 同 的 场景 都 会 得 到 网 络 异 常 。 例 如 ， 
如 果 服 务 器 不 可 用 ， 或 提供 的 数据 不 符合 期 望 ， 以 不 同 的 方式 应 对 这 些 错 误 是 好 事 。 一 些 异 弟 可 以 用 不 同 的 方 
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式 恢复 ， 而 在 男 外 一 些 异常 中 ， 用 户 可 能 需要 一 些 信息 。 

下 面 的 代码 示例 抛 出 类 型 MyCustomException 的 异常 ， 设 置 这 个 异常 的 ErrorCode 属性 (代码 文件 
ExceptionFilters/Program.cs): 

public static void ThrowWithErrorCode (int code) 

throw new MyCustomException ("Error in Foo") { ErrorCode = code }; 

在 Main0 方 法 中 ，try 块 和 两 个 catch 块 保护 方法 调用 。 第 一 个 catch 块 使 用 when 关键 字 过 滤 出 ErrorCode 
属性 等 于 405 的 异常 。when 子 句 的 表达 式 需要 返回 一 个 布尔 值 。 如 果 结 果 是 tue， 这 个 catch 块 就 处 理 异常 。 
如 果 它 是 false， 就 寻找 其 他 catch 块 。 给 ThrowWithErrorCode0 方 法 传递 405， 过 滤器 就 返回 tue， 第 一 个 catch 
块 处 理 异 常 。 传 递 另 一 个 值 ， 过 滤器 就 返回 false， 第 二 个 catch 块 处 理 异 常 。 使 用 过 滤器 ， 可 以 使 用 多 个 处 理 


程序 来 处 理 相同 的 异 疝 类 型 。 
当然 也 可 以 删除 第 二 个 catch 块 ， 此 时 就 不 处 理 该 情形 下 出 现 的 异常 。 
try 
, ThrowWithErrorCode (405) ， 
} 


catch (MyCustomException ex) When (ex .ErrorCode == 405) 


Console .WriteLine (S$"Exception caught with filter {ex.Message} ™ + 
sand {ex.Errorcode}™); 
} 
catch (MyCustomException ex) 


Console.WriteLine ($"Exception caught {ex.Message} and {ex.ErrorCcode}"™); 


} 
14.3.6 ”重新 抛 出 异常 


捕获 异常 时 ， 重 新 抛 出 异 彰 也 是 非 冲 普 明 的 。 再 次 抛 出 异常 时 ， 可 以 改变 异常 的 类 型 。 这 样 ， 就 可 以 给 调 
用 程序 提供 所 发 生 的 更 多 信息 。 原 始 异 意 可 能 没有 上 下 文 的 足够 信息 。 还 可 以 记录 异常 信息 ， 并 给 调用 程序 提 
供 不 同 的 信息 。 例 如 ， 为 了 让 用 户 运 行 应 用 程序 ， 异 常 信息 并 没有 真正 的 帮助 。 阅 读 日 志文 件 的 系统 管理 员 可 
以 做 出 相应 的 反应 。 

重新 抛 出 异 弟 的 一 个 问题 是 ， 调 用 程序 往往 需要 通过 以 前 的 异 音 找 出 其 发 生 的 原因 和 地 点 。 根 据 异 第 的 抛 
出 方式 ， 堆栈 跟 踪 信 息 可 能 会 丢失 。 为 了 看 到 重新 抛 出 异 弟 的 不 同 选项 ， 示 例 程 序 RethrowExceptions 显示 了 不 
同 的 选项 。 

对 于 此 示例 ,创建 了 两 个 上 自 定 义 的 异 第 类 型 。 第 一 个 是 MyCustomException， 除 了 基 类 Exception 的 成 员 之 
外 ， 定 义 了 属性 ErorCode ， 第 二 个 是 AnotherCustomException ， 支 持 传递 一 个 内 部 异常 (代码 文件 
RethrowExceptions /MyCustomException.cs): 

public class MyCustomException : Exception 

| public MyCustomException(string message) 


: base (message) { } 


public int Errorcode { get; set; } 
} 


public class AnotherCcustomException : Exception 
{ 
public AnothercustomException (string message, Exception innerException) 
: base (message, innerException) { } 


} 

HandleAll0 方 法 调用 HandleAndThrowAsgain、HandleAndThrowWithInnerException、HandleAnd RethrowO 和 
HandleWithFilter0 方 法 。 捕 获 抛 出 的 异常 ， 把 异常 消息 和 堆栈 跟踪 写 到 控制 台 。 为 了 更 好 地 从 堆栈 跟踪 中 找到 
所 引用 的 行 号 ， 使 用 预 处 理 器 指令 砷 ine， 重 新 编号 。 这 样 ， 采 用 委托 m 调用 的 方法 就 在 114 行 (代码 文件 
RethrowEXceptions/Program.cs): 
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#1ine 100 
Public static void HandleAll() 
{ 
var methods = new Actionl[] 
{ 
HandleAndThrowAgalin, 
HandlenandThrowWithIinnerException, 
HandleAndRethrow, 
HandleWithFilter 
}s 


foreach (war m in methods) 
{ 
trv 


m(}; // line 114 
} 
catch (Exception ex) 
{ 
Console .WriteLine (ex.Message); 
Console .WriteLine (ex.StackTrace}).; 
1if (ex.InnerException != null) 
{ 
Console.WriteLine ($"\tInner Exception{ex.Message}"); 
Console.WriteLine (ex. InnerException.SstackTrace}),; 
} 


Console .WriteLine (); 
} 
} 
} 


ThrowAnException 方法 用 于 抛 出 第 一 个 异 彰 。 这 个 异 冰 在 8002 行 抛 出 。 在 开发 期 间 ， 它 有 助 于 知道 这 个 
异常 在 哪里 抛 出 : 


#1line 8000 
public static void ThrowAnException (string message) 
{ 

throw new MyCustomException (message); // line 8002 


} 


1. 重新 抛 出 异常 的 用 法 
方法 HandleAndThrowAsgain 只 是 把 异常 记录 到 控制 台 ， 并 使 用 throw ex 再 次 抛 出 它 : 


#1line 4000 
public static void HandlenAndThrowAgain() 
{ 
try 
{ 
ThrowAnException("test 1"); 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"Log exception {ex.Message} and throw again™.); 
throw ex; // you shouldn't do that - line 4009 
} 
} 


运行 应 用 程序 ， 简 化 的 输出 是 显示 堆栈 跟踪 (代码 文件 没有 名 称 空间 和 完整 的 路 径 )， 代 码 如 下 : 
LOG exception test 1 and throw again 
test 1 


at Program.HandleAndThrowAgain()} in Program.cs:line 4009 
at Program.HandleAll() in Program.cs:line 114 


堆栈 跟踪 显示 了 在 HandleAll 方法 中 调用 m0 方法 ， 进 而 调用 HandleAndThrowAgain0 方 法 。 异 常 最 初 在 哪 
里 抛 出 的 信息 完全 丢失 在 最 后 一 个 catch 的 调用 堆栈 中 。 于 是 很 难 找到 错误 的 初始 原因 。 通 常 不 要 传送 异常 对 
象 ， 使 用 throw 抛 出 同一 个 异常 。 


2. 改变 异常 
一 个 有 用 的 场景 是 改变 异常 的 类 型 ,并 添加 错误 信息 。 这 在 HandleAndThrowWithInnerException0 方 法 中 完 
成 。 记 录 错 误 之 后 ， 抛 出 一 个 新 的 寞 沼 类 型 AnotherException， 传 递 ex 作为 内 部 异 第 : 
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#line 3000 
Public static void HanadleandThrowWwithInneTrTEKXCept1Ion () 
{ 

try 

{ 

ThrowAnException{("test 2") // line 3004 

} 

catch (Exception ex) 

| 


Console.WriteLine($"Log exception {ex.Message} and throw again™); 
throw new AnotherCustomException("throw with inner exception", ex); // 3009 
} 
} 


检查 外 部 异常 的 堆栈 跟踪 , 会 看 到 行 号 3009 和 114， 与 前 面相 似 。 然而， 内 部 异常 给 出 了 错误 的 最 初 原 因 。 
它 给 出 调用 了 错误 方法 的 行 号 (3004) 和 抛 出 最 初 (内 部 ) 异 常 的 行 号 (8002): 


Log exception test 2 and throw again 

throw with inner exception 

at Program.HandleAndThrowWithIinnerException() in Program.cs:l1ine 3009 
at Program.HandleAll{() in Program.cs:line 114 

Inner Exception throw with inner exception 

at Program.ThrowAnException(sString message) in Program.cs:line 8002 
at Program.HandleAndThrowWithIinnerException() in Program.cs:line 3004 


这 样 不 会 丢失 信息 。 


注意 : 
试图 找到 错误 的 原因 时 ， 看 看 内 部 异常 是 否 存在 。 这 往往 会 提供 有 用 的 信息 。 


注意 : 

捕获 异常 时 ， 最 好 在 重新 抛 出 时 改变 异常 。 例 如 ， 捕 获 SqlException 异常 ， 可 以 导致 抛 出 与 业务 相关 的 异 
常 ， 例 如 ，InvalidIsbnException 异常 。 

3. 重新 抛 出 相同 的 异常 


如 果 不 应 该 改变 异 弟 的 类 型 ， 就 可 以 使 用 throw 语句 重新 抛 出 相同 的 异 闸 。 使 用 throw 但 不 传递 异 利 对 象 ， 
会 抛 出 catch 块 的 当前 异常 ， 并 保存 异 第 信息 : 


#line 2000 
Public static void HandleAndRethrow () 
{ 

try 

{ 

ThrowAnException("test 3"); 

} 

catch (Exception ex) 

{ 


Console.WriteLine($"Log exception {ex.Message} and rethrow"™); 
throw; // line 2009 
} 
} 


有 了 这 些 代 码 ， 堆 栈 信息 就 不 会 于 和 失 。 异 常 最 初 是 在 8002 行 抛 出 ， 在 第 2009 行 重新 抛 出 。 行 114 包含 调 
用 HandleAndRethrow 的 委托 mm 


Log exception test 3 and rethrow 

test 3 

at Program.ThrowAnException (String message) in Program.cs:1line 8002 
at Program.HandleAndRethrow() In Program.cs:line 2009 

at Program.HandleAll{() In Program.cs:line 114 


4. 使 用 过 滤器 添加 功能 

使 用 throw 语句 重新 抛 出 异常 时 ， 调 用 堆栈 包含 抛 出 的 地 址 。 使 用 异常 过 滤器 ， 可 以 根本 不 改变 调用 堆栈 。 
现在 添加 when 关键 字 , 传递 过 滤器 方法 。 这 个 过 滤器 方法 Filter 记录 消息 ， 总 是 返回 false。 这 就 是 为 什么 catch 
块 永远 不 会 被 调用 的 原因 : 
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#1line 1000 
public void HandleWithFilter() 
{ 
try 
{ 
ThrowAnException("test 4"); // line 1004 
】 
catch (Exception ex) when (Filter (ex)) 


Console.WriteLine("block never invoked™);} 
} 
} 
#1line 1500 
Public bool Filter (Exception ex) 
{ 
Console .WriteLine ($"just log {ex.Message}"); 
return false.; 
} 
现在 看 看 堆栈 跟 踊 ， 错 弟 起 源 于 HandleAll 方法 的 第 114 行 ， 它 调用 HandleWithFilter， 第 1004 行 包含 
ThrowAnException 的 调用 ， 第 8002 行 抛 出 了 异 币 : 
just log test 4 
test 4 
at Program. ThrowAnException(String message) in Program.cs:line 8002 


at Program.HandleWithFilter()} in Program.cs:line 1004 
at RethrowExceptions.Program.HandleAll() in Program.cs:line 114 


异 第 过 滤器 的 主要 用 法 是 基于 值 异 常 的 过 滤 异 常 。 异 常 过 滤器 也 可 以 用 于 其 他 效果 ， 比 如 写 入 日 志 信息 ， 
但 不 改变 调用 堆栈 。 然 而 ， 异 常 过 滤器 应 该 运行 很 快 ， 所 以 应 该 只 做 简单 的 检查 ， 避 免 副作用 。 上 日 志 记 录 是 可 
执行 异常 的 其 中 一 个 。 


14.3.7 没有 处 理 异常 时 发 生 的 情况 


有 时 抛 出 了 一 个 异常 后 ,代码 中 没有 catch 块 能 处 理 这 类 异常 前面 的 SimpleExceptions 示 例 就 说 明了 这 种 情况 。 
例如 ， 假 定 忽略 FormatException 寞 常 和 通用 的 catch 块 ， 则 只 有 捕获 IndexOutOfRangeException 异 和 常 的 块 。 此 时 ， 
如 果 抛 出 一 个 FormatException 异 第 ， 会 发 生 什么 情况 呢 ? 

答案 是 NET 运行 库 会 捕获 它 。 本 节 后 面 将 介绍 如 何 柑 套 ty 块 一 一 实际 上 在 本 示例 中 ， 就 有 一 个 在 后 台 处 
理 的 髓 套 的 try 块 。.NET 运行 库 把 整个 程序 放 在 男 一 个 更 大 的 try 块 中 ， 对 于 每 个 .NET 程序 它 都 会 这 么 做 。 这 
个 try 块 有 一 个 catch 处 理 程序 ， 它 可 以 捕获 任何 类 型 的 异常 。 如 果 出 现代 码 没有 处 理 的 寞 常 ,程序 流 就 会 退出 
程序 ， 由 .NET 运行 库 中 的 catch 块 捕获 它 。 但 是 ， 事 与 愿 违 。 代 码 的 执行 会 立即 终止 ， 并 给 用 户 显示 一 个 对 话 
框 ， 说 明代 码 没 有 处 理 异常 ， 并 给 出 .NET 运行 库 能 检索 到 的 关于 异常 的 详细 信息 。 人 至 少 异常 会 被 捕获 。 

一 般 情 况 下 ， 如 果 编 写 一 个 可 执行 程序 ， 就 应 捕获 尽 可 能 多 的 异常 ， 并 以 合理 的 方式 处 理 它们 。 如 果 编 写 
一 个 库 ， 最 好 捕获 可 以 用 有 效 方 式 处 理 的 异常 ， 或 者 在 上 下 文中 添加 额外 的 信息 ， 抛 出 其 他 异常 类 型 ， 如 上 一 
节 所 示 。 假 定 调用 代码 可 以 处 理 它 遇 到 的 任何 错误 。 


14.4 用户 定义 的 异常 类 


上 一 节 创 建 了 一 个 用 户 定义 的 异常 。 下 面 介绍 有 关 异 常 的 第 二 个 示例 ， 这 个 示例 称 为 SolicitColdCall， 它 包 
含 两 个 嵌 套 的 ty 块 ， 说 明了 如 何 定义 自 定义 异常 类 ， 再 从 try 块 中 抛 出 另 一 个 异常 。 

这 个 示例 假定 一 家 销售 公司 希望 有 更 多 的 客户 。 该 公司 的 销售 部 门 打算 给 一 些 人 打 电 话 ， 希 望 他 们 成 为 自 
己 的 客户 。 用 销售 行业 的 行 话 来 讲 ， 就 是 “陌生 电话 ”(cold-calling)。 为 此 ， 应 有 一 个 文本 文件 存储 这 些 陌生 人 
的 姓名 ， 该 文件 应 有 良好 的 格式 ， 其 中 第 一 行 包含 文件 中 的 人 数 ， 后 面 的 行 包含 这 些 人 的 姓名 。 换 言 之 ， 正 
确 的 格式 如 下 所 示 。 
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George Washington 
Benedict Arnold 
John Adams 

Thomas Jefferson 


这 个 示例 的 目的 是 在 屏幕 上 显示 这 些 人 的 姓名 (由 销售 人 员 读 取 )， 这 就 是 为 什么 只 把 姓名 放 在 文件 中 ， 但 
没有 电话 号 码 的 原因 。 

程序 要 求 用 户 输入 文件 的 名 称 ， 然 后 读 取 文 件 ， 并 显示 其 中 的 人 名 。 这 听 起 来 是 一 个 很 简单 的 任务 ， 但 也 
会 出 现 两 个 错误 ， 需 要 退出 整个 过 程 : 

es 用户 可 能 输入 不 存在 的 文件 名 。 这 作为 FileNotFound 异常 来 捕获 。 

e 艾 件 的 格式 可 能 不 正确 ， 这 里 可 能 有 两 个 问题 。 首 先 ， 文 件 的 第 一 行 不 是 整数 。 第 二 ， 文 件 中 可 能 } 

有 第 一 行 指定 的 那么 多 人 名 。 这 两 种 情况 都 需要 在 一 个 目 定 义 异 常 中 处 理 ， 我 们 已 经 专门 为 此 编写 了 
ColdCallFileFormatException 异常 。 

还 会 有 其 他 问题 ,虽然 不 至 于 退出 整个 过 程 ,但 需要 删除 某 个 人 名 ,继续 处 理 文件 中 的 下 一 个 人 名 (因此 这 
需要 在 内 层 的 try 块 中 处 理 )。 一 些 人 是 商业 间谍 ， 为 销售 公司 的 竞争 对 手工 作 ， 显 然 ， 我 们 不 希望 不 小 心 打 电 
话 给 他 们 ， 让 这 些 人 知道 我 们 要 做 的 工作 。 为 简单 起 见 ， 假 设 姓 名 以 B 开头 的 那些 人 是 商业 间谍 。 这 些 人 应 在 
第 一 次 准备 数据 文件 时 从 文件 中 删除 ， 但 为 防止 有 商业 间谍 混入 ， 需 要 检查 文件 中 的 每 个 姓名 ， 如 果 检 测 到 一 
个 商业 间谍 ， 就 应 抛 出 一 个 SalesSpyFoundException 异常 ， 当 然 ， 这 是 另 一 个 自 定 义 异 常 对 象 。 

最 后 , 编写 一 个 类 ColdCallFileReader 来 实现 这 个 示例 , 该 类 维护 与 cold-call 文件 的 连接 , 并 从 中 检索 数据 。 
我 们 将 以 非常 安全 的 方式 编写 这 个 类 ， 如 果 其 方法 调用 不 正确 ， 就 会 抛 出 异常 。 例 如 ， 如 果 在 文件 打开 前 ， 调 
用 了 读 取 文件 的 方法 ， 就 会 抛 出 一 个 异常 。 为 此 ， 我 们 编写 了 男 一 个 异常 类 UnexpectedException 。 


14.4.1 捕获 用 户 定义 的 异常 
用 户 自 定义 异常 的 代码 示例 使 用 了 如 下 名 称 空间 : 


System 
System.TO 
首先 是 SolicitColdCall 示例 的 Main0 方 法 , 它 捕获 用 户 定义 的 异常 。 注意， 下 面 要 调用 System.IO 名 称 空间 
和 System 名 称 空间 中 的 文件 处 理 类 (代码 文件 SolicitColdCall/Program.cs)。 


Public class Program 
{ 
public static void Main() 
| 
Console-WTr1Ite("P]ease type in the name of the file ™ + 
"containing the names of the People to be cold called > ™); 
string fileName = ReadLine(); 
ColdcallFileReaderLoopl (fileName),;} 
Console.WriteLine (}); 
Console.ReadLine (); 


} 


public static ColdCcallfrFrileReaderLoopl (string filename) 
{ 
Var peopleToRing = new ColdcallFileReader () ; 
try 
{ 
PeopleToRing .open (fileName); 
for {int 1 = 0; 1i < peopleToRing.NPeopleToRing; 1++) 
{ 
peopleToRing .ProcessNextPerson(});} 
} 


Console .WriteLine("All callers processed correctly"); 
} 
catch (FileNotFoundException) 
{ 
Console .WriteLine($"The file {fileName} does not exist"™):; 


} 
catch (ColdcallFileFormatException ex) 
{ 
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Console .WriteLine ($"The file {fileName} appears to have been corrupted"™),; 
Console .WriteLine ($"Details of problem are: {ex.Message}™); 
jf (ex.InnerException != null) 
{ 
Console.WriteLine($"Inner exception was: {ex.InnerException.Message}"™); 
} 
} 
catch (Exception ex) 
Console .WriteLine ($"Exception occurred: \n{ex.Message}").; 
} 
finally 
{ 
peopleToRing .Dispose(); 


} 
} 


这 段 代 码 基 本 上 只 是 一 个 循环 ， 用 来 处 理 文件 中 的 人 名 。 开 始 时 ， 先 让 用 户 输入 文件 名 ， 再 实例 化 
ColdCallFileReader 类 的 一 个 对 象 ， 这 个 类 稍 后 定义 ， 正 是 这 个 类 负责 处 理 文 件 中 数据 的 读 取 。 注 意 ， 是 在 第 一 
个 ty 块 的 外 部 读 取 文件 一 一 这 是 因为 这 里 实例 化 的 变量 需要 在 后 面 的 catch 块 和 finally 块 中 使 用 , 如 果 在 try 块 中 声 
明 它们 ， 它 们 在 ty 块 的 闭合 花 括号 处 就 超出 了 作用 域 ， 这 会 导致 异 弟 。 

在 ty 块 中 打开 文件 (使 用 ColdcallFileReaderOpen0 方法 )， 并 循环 处 理 其 中 的 所 有 人 名 。 
ColdCallFileReaderProcessNextPerson0 方法 会 读 取 并 显示 文件 中 的 下 一 个 人 名 ， 而 ColdCallFile- 
Reader.NPeopleToRing 属性 则 说 明文 件 中 应 有 多 少 个 人 名 (通过 读 取 文件 的 第 一 行 来 获得 )。 有 3 个 catch 块 ， 其 
中 两 个 分 别 用 于 处 理 FileNotFoundException 和 ColdCallFileFormatException 异常 ,第 3 个 则 用 于 处 理 任 何其 他 .NET 
异 弟 。 

在 FileNotFoundException 异常 中 ， 我 们 会 为 它 显示 一 条 消 息 ， 注 意 在 这 个 catch 块 中 ， 根 本 不 会 使 用 异 向 
实例 ， 原 因 是 这 个 catch 块 用 于 说 明 应 用 程序 的 用 户 友好 性 。 异 弟 对 象 一 般 会 包含 拉 术 信息 ， 这 些 技术 信息 对 
开发 人 员 很 有 有 用， 但 对 于 最 终 用 户 来 说 则 没有 什么 用 ， 所 以 本 例 将 创建 一 条 更 简单 的 消息 。 

对 于 ColdCallFileFormatException 异常 的 处 理 程序 ， 则 执行 相反 的 操作 ， 说 明了 如 何 获 得 更 完整 的 技术 信 
恩 ， 包 括 内 层 异 帝 的 细节 (如 果 存 在 内 层 异 音 )。 

最 后 ， 如 果 捕 获 到 其 他 一 般 异 滑 ， 就 显示 一 条 用 户 友 好 消 轧 ， 而 不 是 让 这 些 卉 利 由 NET 运行 库 处 理 。 注 
意 ， 我 们 选择 不 处 理 没 有 派生 自 System Exception 异常 类 的 异常 ， 因 为 不 直接 调用 非 .NET 的 代码 。 

finally 块 清理 资源 。 在 本 例 中 ， 这 是 指 关 闭 已 打开 的 任何 文件 。ColdCallFileReader.Dispose0 方 法 完成 了 这 
个 任务 。 


注意 : 
C# 提 供 了 一 个 using 语句 ,编译 器 自己 会 在 使 用 该 语句 的 地 方 创建 一 个 try/finally 块 , 该 块 调用 finally 块 中 
的 Dispose 方法 。 实 现 了 一 个 Dispose 方法 的 对 象 就 可 以 使 用 using 语句 。 第 17 章 详细 介绍 了 using 语句。 


14.4.2” 抛 出 用 户 定 义 的 异常 


下 面 看 看 处 理 文 件 读 取 ， 以 及 (可 能 ) 抛 出 用 户 定 义 的 异常 类 ColdCallFileReader 的 定义 。 因 为 这 个 类 维护 一 个 
外 部 文件 连接 ， 所 以 需要 确保 它 根据 第 4 章 有 关 释 放 对 象 的 规则 ， 正 确 地 释放 它 。 这 个 类 派生 目 IDisposable 类 。 
首先 声明 一 些 私 有 字段 (代码 文件 SolicitColdCall/ColdCallFileReader.cs): 
public class ColdcCcallFileReader: IDisposable 
private Filestream fs; 
private StreamReader sr; 
private uint nPeopleToRing; 
private bool 1isDisposed = false; 
private bool isOpen = false; 


FileStream 和 StreamReader 都 在 System.IO 名 称 空 间 中 ， 它 们 都 是 用 于 读 取 文件 的 基 类 。FileStream 基 类 主 
要 用 于 连接 文件 ，StreamReader 基 类 则 专门 用 于 读 取 文 本 文件 ， 并 实现 Readline0 方 法 ,该 方法 读 取 文件 中 的 一 
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行文 本 。 第 22 章 在 深入 讨论 文件 处 理 时 将 讨论 SteamReader 基 类 。 

_isDisposed 字段 表示 是 否 调用 了 Dispose0 方 法 ， 我 们 选择 实现 ColdCallFileReader 异 弟 ， 这 样 ， 一 旦 调用 
了 Dispose0 方 法 ， 就 不 能 重新 打开 文件 连接 ， 重 新 使 用 对 象 了 】。isOpen 字段 也 用 于 错误 检查 一 一 在 本 例 中 ， 检 
查 StreamReader 基 类 是 否 连 接 到 打开 的 文件 上 。 

打开 文件 和 读 取 第 一 行 的 过 程 一 一 告诉 我 们 文件 中 有 多 少 个 人 名 一 一 由 Open0 方 法 处 理 : 


public void Open(string fileName) 
{ 
if ( isDisposed) 
{ 
throw new ObjectDisposedException ("peopleToRinNng"),; 
} 
fs = new Filestream(fileName, FileMode .Open); 
_ SET = new StreamReader!( fs}; 
try 
| 


string firstLine = sr.ReadLine (}; 
_nPeopleToRing = uint.Parse (firstLine); 
isOpen = true; 


catch (FormatException ex) 
{ 
throw new ColdCallFileFormatException ( 
SS"FIrst line isn\'t an integer {ex}"™); 
} 
} 


与 ColdCallFileReader 异常 类 的 所 有 其 他 方法 一 样 , 该 方法 首先 检查 在 删除 对 象 后 , 客户 端 代码 是 否 不 正确 
地 调用 了 它 , 如果 是 , 就 抛 出 一 个 预定 义 的 ObjectDisposedException 异常 对 象 。 Open0 方 法 也 会 检查 isDisposed 
字段 ， 看 看 是 否 已 调用 Dispose0 方 法 。 因 为 调用 Dispose0 方 法 会 告诉 调用 者 现在 已 经 处 理 完 对 象 ， 所 以 ， 如 果 
已 经 调用 了 Dispose0 方 法 ， 就 说 明 有 一 个 试图 打开 新 文件 连接 的 错误 。 

接着 ， 这 个 方法 包含 前 两 个 内 层 的 try 块 ， 其 目的 是 捕获 因为 文件 的 第 一 行 没 有 包含 一 个 整数 而 抛 出 的 任 
何 错误 。 如 果 出 现 这 个 问题 ，.NET 运行 库 就 抛 出 一 个 FormatException 异常 ， 该 异常 捕获 并 转换 为 一 个 更 有 意 
义 的 异常 ， 这 个 更 有 意义 的 异 帝 表示 cold-call 文件 的 格式 有 问题 。 注 意 System.FormatException 异常 表示 与 基 
本 数据 类 型 相关 的 格式 问题 ， 而 不 是 与 文件 有 关 , 所 以 在 本 例 中 它 不 是 传递 回 主 调 例 程 的 一 个 特别 有 用 的 异常 。 
新 抛 出 的 异常 会 被 最 外 层 的 try 块 捕获 。 因 为 这 里 不 需要 清理 资源 ， 所 以 不 需要 finally 块 。 

如 果 一 切 正常 ， 就 把 isOpen 字段 设置 为 tue， 表 示 现 在 有 一 个 有 效 的 文件 连接 ， 可 以 从 中 读 取 数据 。 

ProcessNextPerson0) 方 法 也 包含 一 个 内 层 try 块 : 


public void ProcessNeXxtPerscon 1l) 
if ( isDisposed) 
| throw new ObjectDisposedException ("peopleToRI1Nng").; 
二 (! isopen) 
throw new UnexpectedException'l 
"Attempted to access coldcall file that is not open™);} 


try 

{ 
string name = sr.ReadLine (); 
IE (name == null) 
{ 


throw new ColdCcallFileFormatException ("Not enough mames") ， 
} 
if (name[0] == 'B") 
{ 


throw new SalesSpyFoundException (name); 
} 
Console.WriteLine (name').- 


} 
catch (SalesSpyFoundException ex) 


Console.WriteLine (ex.Message).; 


} 
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finally 
{ 
} 

} 

这 里 可 能 存在 两 个 与 文件 相关 的 错误 (假定 实际 上 有 一 个 打开 的 文件 连接 ，ProcessNextPerson0 方 法 会 先进 
行 检查 )。 第 一 ， 读 取 下 一 个 人 名 时 ， 可 能 发 现 这 是 一 个 商业 间谍 。 如 果 发 生 这 种 情况 ， 在 这 个 方法 中 就 使 用 第 
一 个 catch 块 捕获 异常 。 因 为 这 个 异 沼 已 经 在 循环 中 被 捕获 ， 所 以 程序 流 会 继续 在 程序 的 Main0 方 法 中 执行 ， 
处 理 文件 中 的 下 一 个 人 名 。 

如 果 读 取 下 一 个 人 名 ， 发 现 已 经 到 达 文 件 的 末尾 ， 就 会 发 生 错误 。StreamReader 对 象 的 ReadLine0 方 法 的 
工作 方式 是 : 如 果 到 达 文 件 末尾 ， 它 就 会 返回 一 个 null， 而 不 是 抛 出 一 个 异常 。 所 以 ， 如 果 找 到 一 个 null 字符 
串 ， 就 说 明文 件 的 格式 不 正确 ， 因 为 文件 的 第 一 行 中 的 数字 要 比 文件 中 的 实际 人 数 多 。 如 果 发 生 这 种 错误 ， 就 
抛 出 一 个 ColdCallFileFormatException 异常 ， 它 由 外 层 的 异常 处 理 程序 捕获 (使 程序 终止 执行 )。 

同样 ， 这 里 不 需要 finally 块 ， 因 为 没有 要 清理 的 资源 ， 但 这 软 要 放置 一 个 空 的 finally 块 ， 表 示 在 这 里 可 以 
完成 用 户 和 希望 完成 的 任务 。 

这 个 示例 就 要 完成 了 。ColdCallFileReader 异常 类 还 有 男 外 两 个 成 员 NPeopleToRing 属性 返回 文件 中 应 
有 的 人 数 ，Dispose0 方 法 可 以 关闭 已 打开 的 文件 。 注 意 Dispose0 方 法 仅 返 回 它 是 否 被 调用 一 一 这 是 实现 该 方 
法 的 推荐 方式 。 它 还 检查 在 关闭 前 是 否 有 一 个 文件 流 要 关闭 。 这 个 例子 说 明了 防御 编码 技术 : 

Public uint NPeopleToRing 

{ 

1 
1f ( isDisposed) 
| throw new ObjectDisposedException ("peopleToRing"); 
i (! isopen) 
throw new UnexpectedExcept1ion (人 
: "Attempted to access cold-call file that is not open™).; 
0 _nPeopleTOoORing; 
} 
} 


public void Dispose{() 
{ 
if ( isDisposed) 
{ 
returns 
} 
_1isDisposed = true; 
isopen = false; 
fs?.Dispose(); 


fs = null: 


} 
14.4.3 ”定义 用 户 定 义 的 异常 类 


最 后 ， 需 要 定义 3 个 异 单 类。 定义 目 己 的 异 瘦 非 弟 简单 ， 因 为 几乎 不 需要 添加 任何 额外 的 方法 。 只 需要 实 
现 构 造 函 数 ， 确 保 基 类 的 构造 函数 正确 调用 即 可 。 下 面 是 实现 SalesSpyFoundException 异常 类 的 完整 代码 (代码 
文件 SolicitColdCall/SalesSpyFoundException.cs): 


public class SalesSpyFoundException: Exception 
{ 
Public SalesSpyFoundException (string spyNMame) 
: base($"Sales spy found, with name {spyName}") 
{ 
} 


Public SalesSspyFoundException (string spyName, Exception jnnerExceptlion) 
: base($"Sales spy found with name {spyName}", innerException) 
{ 
} 
} 
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注意 ， 这 个 类 派生 自 Exception 异常 类 ， 正 是 我 们 期 望 的 自 定义 异常 。 实 际 上 ， 如 果 要 更 正式 地 创建 它 ， 
可 以 把 它 放 在 一 个 中 间 类 中 ， 例 如 ，ColdCallFileException 异常 类 ， 让 它 派生 于 Exception 异常 类 ， 再 从 这 个 类 
派生 出 两 个 异常 类 ， 并 确保 处 理 代码 可 以 很 好 地 控制 哪个 异常 处 理 程 序 处 理 哪个 异常 即 可 。 但 为 了 使 这 个 示例 
比较 简单 ， 就 不 这 么 操作 了 。 

在 SalesSpyFoundException 异 冲 关中， 处 理 的 内 容 要 多 一 些 。 假 定 传送 给 它 的 构造 函数 的 信息 仅 是 找到 的 
间谍 名 ， 从 而 把 这 个 字符 串 转 换 为 含义 更 明确 的 错误 人 信息。 我们 还 提供 了 两 个 构造 函数 ， 其 中 一 个 构造 函数 的 
参数 只 是 一 条 消 忠 ， 男 一 个 构造 函数 的 参数 是 一 个 内 层 异 温 。 在 定义 目 己 的 异常 类 时 ， 至 少 把 这 两 个 构造 函数 
都 包括 进来 (尽管 以 后 将 不 能 在 示例 中 使 用 SalesSpyFoundException 异常 类 的 第 2 个 构造 函数 )。 

对 于 ColdCallFileFormatException 异 第 类 ， 规 则 是 一 样 的 ， 但 不 必 对 消息 进行 任何 处 理 ( 代 三文 件 
SolicitColdCall/ColdCallFileFormatException.cs): 


Public class ColdCcallFileFormatException: Exception 
{ 
public ColdcallFileFormatException(string message) 
: hbase (message) 
{ 
} 


public ColdcCcallFileFormatException(string message, ExCception innerException) 
: base (message, innerException) 
{ 
} 
} 


最 后 是 UnexpectedException 异常 类 ， 它 看 起 来 与 ColdCallFileFormatException 异常 类 是 一 样 的 (代码 文件 
SolicitColdCall/UnexpectedException.cs): 


Public class UnexpectedException: Exception 
{ 
public UnexpectedException (string message) 
: base (message) 
{ 
} 


Public UnexpectedException (string message, Exception innerException) 
: base (message, innerException) 


{ 
} 
} 
下 面 准 备 测试 该 程序 。 首 先 ， 使 用 people.txt 文件 ， 其 内 容 已 经 在 前 面 列 出 了 。 
4 


George Washington 
Benedict Arnold 
John Adams 

Thomas Jefferson 


它 有 4 个 名 字 ( 与 文件 中 第 一 行 给 出 的 数字 匹配 )， 包 括 一 个 间谍 。 接 着 ， 使 用 下 面 的 people2.txt 文件 ， 它 
有 一 个 明显 的 格式 错误 : 


49 

George Washington 
Benedict Arnold 
John Adams 

Thomas Jefferson 


最 后 ， 尝 试 执行 该 例子 ， 但 指定 一 个 不 存在 的 文件 名 people3 txt， 对 这 3 个 文件 名 运行 程序 3 次 ， 得 到 的 
结果 如 下 : 


SOl1C1itColdcall 

Please type in the name of the file containing the names of the people to be cold 
called > people.txt 

George Washington 

Sales spy found, with name Benedict Arnold 

John Adams 

Thomas Jefferson 

All callers processed correctly 

SOl1C1itColdcall 
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Please type in the name of the file containing the names of the People to be cold 
called > people2.txt 

George Washington 

Sales spy found, with name Benedict Arnold 

John Adams 

Thomas Jefferson 

The file people?2.txt appears to have been corrupted. 

Detalls of the problem are: Not enough names 

SOl1citColdCall 

Please type in the name of the file containing the names of the people to be cold 
called > people3.txt 

The file people3.txt does not exist. 


最 后 ， 这 个 应 用 程序 说 明了 处 理 程序 中 可 能 存在 的 错误 和 异 沼 的 许多 不 同方 式 。 


14.5 ”调用 者 信息 


在 处 理 错误 时 ， 获 得 错误 发 生 位 置 的 信息 常常 是 有 帮助 的 。 本 章 全 面 介绍 的 #ine 预 处 理 器 指令 用 于 改变 代 
码 的 行 号 ， 获 得 调用 堆栈 的 更 好 信息 。 为 了 从 代码 中 获得 行 号 、 文 件 名 和 成 员 名 ， 可 以 使 用 C# 编译 器 直接 文 
持 的 特性 和 可 选 参 数 。 这 些 特性 包括 CallerLineNumber、CallerFilePath 和 CallerMemberName， 它 们 定义 在 
System.Runtime.CompilerServices 名 称 空间 中 ， 可 以 应 用 到 参数 上 。 对 于 可 选 参数 ， 当 没有 提供 调用 信息 时 ， 编 
译 器 会 在 调用 方法 时 为 它们 使 用 默认 值 。 有 了 调用 者 信息 特性 ， 编 译 器 不 会 填 入 默认 值 ， 而 是 填 和 信行 号 、 文 件 
路 径 和 成 员 名 称 。 
代码 示例 CallerInformation 使 用 如 下 名 称 空间 : 
System 
System.Runtime.CompllerServices 
下 面 代码 段 中 的 Log 方法 演示 了 这 些 特性 的 用 法 。 这 段 代 码 将 信息 写 入 控制 台中 (代码 文件 
CallerInformation/Proeram.cs): 


Public void Log([CallerLineNumber] int line = -1, 

[CallerFilePath] string path = null, 

[CallerMemberName] String name = null) 

{ 

Console.WriteLine({line < 0) 3 "No line™ : "Line ™ + line}).; 
Console.WriteLine(({path == null}) 2? "No file path™" : path).; 
Console.WriteLine{{(name == null} 2 "No member name™ : name).: 
Console.WriteLine(); 

} 

下 面 在 几 种 不 同 的 场景 中 调用 该 方法 。 在 下 面 的 Main0 方 法 中 , 分 别 使 用 Program 类 的 一 个 实例 来 调用 Log0 
方法 ， 在 属性 的 set 访问 器 中 调用 Log0 方 法 ， 以 及 在 一 个 lambda 表达 式 中 调用 Log0 方 法 。 这 里 没有 为 该 方法 
提供 参数 值 ， 所 以 编译 器 会 为 其 填 入 值 : 

public static void Main'() 

{ 

Var Pp = new Programl().; 
P-Log()}; 

Dp-SomeProperty = 33; 
Action al = (人 () => p.Log(}; 
al (); 

} 


private int someProperty; 
Public int SomePproperty 
{ 
get => somePropertys 
Set 
{ 
Log 全 
SomeProperty = value; 
} 
} 


运行 此 程序 的 结果 如 下 所 示 。 在 调用 Log0 方 法 的 地 方 ， 可 以 看 到 行 号 、 文 件 名 和 调用 者 的 成 员 名 。 对 于 
Main0 方 法 中 调用 的 Log0 方 法 ， 成 员 名 为 Main。 对 于 属性 SomeProperty 的 set 访问 器 中 调用 的 Log0 方 法 ， 成 
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员 名 为 SomeProperty。lambda 表达 式 中 的 Log0 方 法 没有 显示 生成 的 方法 名 ， 而 是 显示 了 调用 该 lambda 表达 式 
的 方法 的 名 称 (Main)， 这 当然 更 加 有 用 。 
Line 12 
CcC:\Procsharp\ErrorsAndExceptions\CallerIinformation\Program.cs 
Main 
Line 26 
CcC:\Procsharp\ErrorsAndExceptions\CallerIinformation\Program.cs 
SomeProperty 
Line 14 
CcC:\ProcSsharp\ErrorsAndExceptions\CallerIinformation\Program.cs 
Main 


在 构造 函数 中 使 用 Log0 方 法 时 ， 调 用 者 成 员 名 显示 为 ctor。 在 析 构 函数 中 ， 调 用 者 成 员 名 为 Finalize， 
为 它 是 生成 的 方法 的 名 称 。 


注意 : 
析 构 函数 和 终结 器 参见 第 17 章 。 


注意 : 
CallerMemberName 属性 的 一 个 很 好 的 用 途 是 用 在 INotifyPropertyChanged 接口 的 实现 中 。 该 接口 要 求 在 方 
法 的 实现 中 传递 属性 的 名 称 。 在 本 书 的 几 个 章节 中 都 可 以 看 到 这 个 接口 的 实现 ， 例 如 第 34 章 。 


14.6 “小 结 


本 章 介 绍 了 C# 通 过 异常 处 理 错误 情况 的 多 种 机 制 , 我 们 不 仅 可 以 输出 代码 中 的 一 般 错误 代码 , 还 可 以 用 指 
定 的 方式 处 理 最 特殊 的 错误 情况 。 有 时 一 些 错误 情况 是 通过 NET Framework 本 喘 提 供 的 ， 有 时 则 需要 编写 目 己 
的 错误 情况 ， 如 本 章 的 例子 所 示 。 在 这 两 种 情况 下 ， 都 可 以 采用 许多 方式 来 保护 应 用 程序 的 工作 流 ， 使 之 不 出 
现 不 必要 和 人 危险 的 错误 。 

第 15 章 将 学 习 异 步 编程 的 重要 关键 字 async 和 await。 


本 章 要 点 

e 异步 编程 的 重要 性 

e 异步 模式 

异步 编程 的 基础 
异步 方法 的 错误 处 理 
Windows 应 用 程序 的 异步 编程 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Async 目录 的 
https://github.comy/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

® AsyncHistory 

® Foundations 

® EIiror Handline 

® AsyncWindowsApp 


15.1 异步 编程 的 重要 性 


.NET Framework 4.5 将 任务 并 行 库 (Task Para uel Library, TPL) 添 加 到 .NET 中 , 以 使 并 行 编程 更 容易 。C# 5.0 
增加 了 两 个 关键 字 来 简化 异步 编程 ，async 和 await。 这 两 个 关键 字 将 是 本 章 的 重点 。 

使 用 异步 编程 ， 方 法 调用 是 在 后 台 运 行 ( 通 彰 在 线程 或 任务 的 帮助 下 )， 并 且 不 会 阻塞 调用 线程 。 

本 章 将 学 习 3 种 不 同 模式 的 异步 编程 ， 异步 模式 、 基 于 事件 的 异步 模式 和 基于 任务 的 异步 模式 (Task-based 
Asynchronous Patterm，TAP)。TAP 是 利用 async 和 await 关键 字 来 实现 的 。 通 过 这 里 的 比较 ， 将 认识 到 异步 编程 
新 模式 的 真正 优势 。 

讨论 过 不 同 的 模式 之 后 ， 通 过 创建 任务 和 使 用 异步 方法 ， 来 介绍 异步 编程 的 基础 知识 。 还 会 论述 延续 任务 
和 同步 上 下 文 的 相关 内 容 。 

与 异步 任务 一 样 ， 错 误 处 理 也 需要 特别 重视 。 有 些 错误 要 采用 不 同 的 处 理 方 式 。 

本 章 的 最 后 一 部 分 讨论 了 通用 Windows 应 用 程序 的 特定 场景 ， 学 习 异 步 编 程 所 需要 了 解 的 内 容 。 
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注意 : 
第 21 章 介 绍 了 并 行 编程 的 相关 内 容 。 


如 果 应 用 程序 没有 立刻 啊 应 用 户 的 请 求 ， 会 让 用 户 反感 。 用 鼠标 操作 ， 我 们 习惯 了 出 现 延 迟 ， 过 去 几 十 年 
都 是 这 样 操作 的 。 有 了 触摸 UI， 应 用 程序 要 求 立 刻 啊 应 用 户 的 请 求 。 否 则 ， 用 户 就 会 不 断 重 复 同一 个 动作 。 

因为 在 旧版 本 的 .NET Framework 中 用 异步 编程 非常 不 方便 ， 所 以 并 没有 总 是 这 样 做 。Visual Studio 旧版 本 
是 经 常 阻 塞 UI 线程 的 应 用 程序 之 一 。 例 如 , 在 Visual Studio 的 旧版 本 中 , 打开 一 个 包含 数 百 个 项 目的 解决 方案 ， 
这 意味 可 能 需要 等 待 很 长 的 时 间 。Visual Studio 2017 提供 了 轻 量 级 的 解决 方案 加 载 (Lightweight Solution Load) 
特性 ， 它 只 在 需要 时 加 载 项 目 ， 且 先 加 载 选 定 的 项 目 。 从 Visual Studio 2015 开始 ，NuGet 包 管 理 器 不 再 实现 为 
模式 对 话 框 。 新 的 NuGet 包 管 理 器 可 以 异步 加 载 包 的 信息 ,同时 做 其 他 工作 。 这 是 异步 编程 内 置 到 Visual Studio 
2015 中 带 来 的 重要 变化 之 一 。 

很 多 .NET Framework 的 API 都 提供 了 同步 版 本 和 异步 版 本 。 因 为 同步 版 本 的 API 用 起 来 更 为 简单 ， 所 以 
常常 在 不 适合 使 用 时 也 用 了 同步 版 本 的 API。 在 新 的 Windows Runtime(WinRT) 中 ， 如 果 一 个 API 调用 时 间 超 过 
40ms， 就 只 能 使 用 其 异步 版 本 。 目 从 C# 5.0 开始 ， 寞 步 编 程 和 同步 编程 一 样 简 单 ， 所 以 用 异步 API 应 该 不 会 有 
任何 的 障碍 。 


15.2 “异步 编程 的 .NET 历史 


在 学 习 新 的 async 和 await 关键 字 之 前 ， 先 看 看 .NET Framework 的 异步 模式 。 从 .NET Framework 1.0 开始 
就 提供 了 异步 特性 ， 而 且 .NET Framework 的 许多 类 都 实现 了 一 个 或 者 多 个 异步 模式 。 

下 面 开 始 执行 同步 网 络 调用 ， 然 后 介绍 不 同 的 异步 模式 : 

e 异步 模式 

e 基于 事件 的 异步 模式 

e 基于 任务 的 异步 模式 

异步 模式 是 处 理 异步 特性 的 第 一 种 方式 ， 它 不 仅 可 以 使 用 几 个 API， 还 可 以 使 用 基本 功能 (如 委托 类 型 )。 

因为 在 Windows Forms 和 WPF 中 , 用 异步 模式 更 新 界面 非常 复杂 ,所 以 NET Framework 2.0 推出 了 基于 事 
件 的 异步 模式 。 在 这 种 模式 中 ， 事 件 处 理 程 序 是 被 拥有 同步 上 下 文 的 线程 调用 ， 所 以 更 新 界面 很 容易 用 这 种 模 
式 处 理 。 在 此 之 前 ， 这 种 模式 也 称 为 异步 组 件 模式 。 

在 NET Framework 4.5 中 ， 推 出 了 另外 一 种 方式 来 实现 异步 编程 : 基于 任务 的 异步 模式 (TAP)。 这 种 模式 是 
基于 Task 类 型 ， 并 通过 async 和 await 关键 字 使 用 编译 器 功能 。 

HistorySample 的 示例 代码 至 少 使 用 C# 7.1 和 以 下 名 称 空间 : 


System 

System.IO 

System.Net 
System.Threading.Tasks 


发 出 HTTP 请 求 的 示例 应 用 程序 是 System Net API 提供 同步 和 异步 API 中 的 一 个 好 例子 。 


15.2.1 同步 调用 

下 面 从 使 用 WebClient 类 的 同步 版 本 开始 。 这 个 类 提供 了 几 个 同步 的 API 如 DownloadString、 DownloadFile 
和 DownloadData。 在 下 面 的 代码 片段 中 ，DownloadString 发 出 一 个 HTTP 请 求 并 在 字符 串 内 容 中 写 入 响应 。 访 
字符 串 的 子 字符 串 被 写 入 控制 全 (代码 文件 AsyncHistory/Program.cs): 

private const string url = "http://www.cninnovation.com"; 


private static void SynchronizedaPI() 
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Console.WriteLine (nameof (SynchronizedAPI)); 
using (var client = new WebcClient ()) 
string content = client.DownloadSstring (url).; 
Console.WriteLine (content.Ssubstring (0, 100)); 
} 
Console.WriteLine(); 


} 
方法 DownloadString 阻塞 调用 线程 ， 直 到 返回 结果 。 从 客户 端 应 用 程序 的 用 户 界面 线程 中 调用 这 个 方法 并 
不 好 ， 因 为 它 会 阻塞 用 户 界 面 。 等 待 对 用 户 来 说 是 不 愉快 的 ， 因 为 在 这 个 网 络 调用 中 应 用 程序 没有 啊 应 。 


15.2.2 ”异步 模式 


异步 调用 的 一 种 方式 是 使 用 异步 模式 。.NET 的 许多 API 都 提供 异步 模式 。 对 于 .NET Framework， 委 托 类 
型 也 支持 这 种 模式 。 请 注意 ， 使 用 .NET Core 调用 委托 的 这 些 方法 时 ， 会 抛 出 一 个 异常 ， 其 中 包含 平台 不 文 持 
的 信息 。 

异步 模式 定义 了 BeginXXX 方法 和 EndXXX 方法 。 例 如 ， 如 果 有 一 个 同步 方法 DownloadSting， 其 异步 
版 本 就 是 BeginDownloadString 和 EndDownloadString 方法 。BeginXXX 方法 接受 其 同步 方法 的 所 有 输入 参数 ， 
EndXXX 方法 使 用 同步 方法 的 所 有 输出 参数 ， 并 按照 同步 方法 的 返回 类 型 来 返回 结果 。 使 用 异步 模式 时 ， 
BeginXXX 方法 还 定义 了 一 个 AsyncCallback 参数 ， 用 于 接受 在 异步 方法 执行 完成 后 调用 的 委托 。BeginXXX 方 
法 返回 IAsyncResult， 用 于 验证 调用 是 否 已 经 完成 ， 并 且 一 直 等 到 方法 的 执行 结束 。 

WebClient 类 没有 提供 异步 模式 的 实现 方式 ， 但 是 可 以 用 WebRequest 类 来 蔡 代 ， 因 为 该 类 通过 
BeginGetResponse 和 EndGetResponse 方法 提供 这 种 模式 (GetResponse 是 这 个 API 的 同步 版 本 )。 

在 下 面 的 代码 片段 中 , 使 用 WebRequest 类 的 Create 方 法 创建 WebRequest。 使 用 这 个 请 求 对 象 , BeginGetResponse 
方法 将 异步 HTTP GET 请 求 发 到 服务 器 。 调 用 线程 没有 被 阳 塞 。 该 方法 的 第 一 个 参数 是 AsyncCallback。 这 是 一 
个 通过 IAsyncResult 参 数 引用 void 方法 的 委托 。 实 现代 码 是 使 用 本 地 函数 ReadResponse 完 成 的 。 一 旦 网 络 请 求 完 
成 ， 就 会 调用 该 方法 。 在 实现 代码 中 ， 再 次 通过 request 对 象 使 用 GetResponseStream 检 索 结 果 。 在 代码 示例 中 ， 
Stream 和 StreamReader 用 于 访问 返回 的 字符 串 内 容 (代码 文件 AsyncHistory/Program.cs): 

private static void AsynchronousPattern 1) 

ComsoD1le -而 TIteLInme (nameof (AsynchronousPattern)}))}); 
WebRequest request = WebRequest.Create (url); 
IAsyncResult result = request .BeginGetResponse (ReadResponse, null); 
void ReadResponse (IAsyncResult ar) 
using (WebResponse response = request.EndGetResponse (ar)) 
ye 
var reader = new StreamReader (stream); 
string content = reader-ReadToEnd() ; 
Console WriteLine (content .substring (0, 100)); 
Console .WriteLine (); 
} 


} 
} 


由 于 在 实现 代码 中 使 用 了 本 地 函数 ,因此 从 外 部 作用 域 的 请 求 变量 可 以 通过 本 地 函数 的 闭 包 功 能 直接 访问 。 
lambda 表达 式 也 具有 类 似 的 行为 。 如 果 要 使 用 单独 的 方法 ， 则 必须 将 请 求 对 象 传递 给 此 方法 。 为 此 需要 将 请 求 
对 象 传递 为 BeginGetResponse 方法 的 第 二 个 参数 。 可 以 使 用 IAsyncResult 的 AsyncState 属性 在 被 调用 的 方法 中 


注意 : 
本 地 函数 参见 第 13 章 。 


在 UI 应 用 程序 中 使 用 异步 模式 有 一 个 问题 : 从 AsyncCallback 调用 的 方法 没有 在 UI 线程 中 运行 ， 因 此 如 
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果 不 切 换 到 UI 线程 ， 就 不 能 访问 UI 元 素 的 成 员 ， 而 是 抛 出 一 个 异 音 The calling thread cannot access this object 
because a different thread owns it.( 调 用 线程 不 能 访问 这 个 对 象 , 因为 另 一 个 线程 拥有 它 )。 为 了 简化 这 一 过 程 , NET 
Framework 2.0 引入 了 基于 事件 的 异步 模式 ， 这 更 易于 处 理 UI 更 新 。 接 下 来 将 讨论 此 模式 。 


15.2.3 ”基于 事件 的 异步 模式 


EventBasedAsyncPattern 方法 使 用 了 基于 事件 的 异步 模式 。 这 个 模式 定义 了 一 个 带 有 “Async” 后 缀 的 方法 。 
示例 代码 再 次 使 用 了 WebClient 类 。 对 于 同步 方法 DownloadString，WebClient 类 提供 了 一 个 异步 变 体 方法 
DownloadStringAsync。 当 请 求 完 成 时 ， 会 触发 DownloadStrineCompleted 事件 。 使 用 此 事件 的 事件 处 理 程序 ， 
可 以 检索 结果 。DownloadSstringCompleted 事件 类 型 为 DownloadStrineCompletedEventHandler。 第 二 个 参数 是 
DownloadStrineCompletedEventAres 类 型 。 这 个 参数 通过 Result 属性 返回 结果 字符 串 ( 代 码 文件 
AsyncHistory/Program.cs): 


private static void EVentBaseadasyncPEatteIrn 1 ) 


ConSso1leE-.WrIteLIne(nameof (EventBaseaasYnCcPatteIrn) ) ，; 


USing (Var client = new WebClient ()) 

{ 
client.DownloadstringCompleted += (sender, ee) 三 > 
{ 


Console .WriteLine(e.Result.sSubstring (0, 100)); 
}s 
client.DownloadstringAsync (new Uri (url)); 
Consol]le.WriteLine(}).; 
} 
} 


使 用 DownloadStringCompleted 事件 ， 事 件 处 理 程序 将 通过 保存 同步 上 下 文 的 线程 来 调用 。 在 Windows 窗 
体 、WPF 和 UWP 中 ， 这 就 是 UI 线程 。 因 此 ， 可 以 直接 从 事件 处 理 程 序 中 访问 UI 元素。 与 异步 模式 相 比 ， 这 
是 该 模式 的 一 大 优点 。 

基于 事件 的 异步 模式 和 同步 编程 之 间 的 区 别 在 于 方法 调用 的 顺序 ; 与 同步 方法 调用 相 比 ， 顺 序 题 倒 了 。 调 用 
异步 方法 之 前 ， 需 要 定义 这 个 方法 完成 时 发 生 什么 。15.2.4 小 节 将 进入 异步 编程 的 新 世界 ; 利用 async 和 await 
关键 字 。 


15.2.4 基于 任务 的 异步 模式 


在 .NET Framework 4.5 中 ， 更 新 了 WebClient 类 ， 还 提供 了 基于 任务 的 异步 模式 (TAP)。 该 模式 定义 了 一 个 
市 有 “Async” 后 缀 的 方法 ， 并 返回 一 个 Task 类 型 。 由 于 WebClient 类 已 经 提供 了 一 个 市 Async 后 缀 的 方法 来 
实现 基于 任务 的 异步 模式 ， 因 此 新 方法 名 为 DownloadStringTaskAsync。 

DownloadStringTaskAsync 方法 声明 为 返回 Task<string>。 但 是 , 不 需要 声明 一 个 Task<string> 类 型 的 变量 来 
设置 DownloadStringTaskAsync 方法 返回 的 结果 。 只 要 声明 一 个 String 类 型 的 变量 ， 并 使 用 await 关键 字 。await 
关键 字 会 解除 线程 (这 里 是 UI 线程 ) 的 阻塞 ， 完 成 其 他 任务 。 当 DownloadStringTaskAsynec 方法 完成 其 后 台 处 理 
后 , UI 线程 就 可 以 继续 , 从 后 台 任 务 中 获得 结果 , 赋值 给 字符 串 变 量 resp。 然 后 执行 await 关键 字 后 面 的 代码 ( 代 
码 文 件 AsyncHistory/Prosram.cs): 

private static asYnc Task TaskBasedAsyncPatternAsync() 

Console.WriteLine (nameof (TaskBasedAsyncPatternAsync)).; 

USing (Var client = new WebClient ()) 

| string content = await client.DownloadStringTaskAsync (ur1) : 
Console.WriteLine (Content .substring(0, 1001 ) ， 
Console.WriteLine()}; 


} 
} 
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注意 : 

async 关键 字 创 建 了 一 个 状态 机 ， 类 似 于 yield retum 语句 。 参 见 第 7 章 。 

现在 ， 代 码 就 简单 多 了 。 没 有 阻塞 ， 也 不 需要 切换 回 UI 线程 ， 这 些 都 是 自动 实现 的 。 代 码 顺 序 也 和 惯用 
的 同步 编程 一 样 。 


注意 : 
更 现代 的 HTTP 客户 端 是 用 类 HttpClient 实现 的 。 这 个 类 提供 的 异步 方法 支持 基于 任务 的 异步 模式 。 如 何 
使 用 这 个 类 在 第 23 章 中 解释 。 


15.2.5 异步 Main() 方 法 


控制 台 应 用 程序 的 入 口 点 是 Main 0 方法 , 它 应 用 async 修饰 符 人 允许 在 实现 中 使 用 await 关键 字 。 使 用 Main0 
方法 的 这 个 声明 返回 一 个 任务 需要 C# 7.1( 代 码 文件 AsyncHistory/Program.cs): 
static async Task Main{) 
{ 
SynchronizedaAPI (); 
AsynchronousPattern(}); 
EventBasedAsyncPatternt(); 
await TaskBasednsyncPatternAsync(); 
Console .ReaadLIne(1) ; 


} 


注意 : 
要 指定 C# 编 译 器 的 7.1 版 本 ,需要 将 LaneVersion 元 素 添加 到 csproj 项 目 文件 中 ,或 者 可 以 在 Advanced Build 
Project Settings 中 对 Visual Studio 进行 更 改 。 


认识 到 async 和 await 关键 字 的 优势 后 ，15.3 节 将 讨论 异步 编程 的 基础 。 


15.3 ”异步 编程 的 基础 


async 和 await 关键 字 只 是 编译 器 功能 。 编 译 器 会 用 Task 类 创建 代码 。 如 果 不 使 用 这 两 个 关键 字 ， 也 可 以 
用 C# 4.0 和 Task 类 的 方法 来 实现 同样 的 功能 ， 只 是 没有 那么 方便 。 
本 节 介 绍 了 编译 器 用 async 和 await 关键 字 能 做 什么 , 如 何 采 用 简单 的 方式 创建 异步 方法 , 如何 并 行 调用 多 
个 异步 方法 ， 以 及 如 何 修改 已 经 实现 异步 模式 的 类 ， 以 使 用 新 的 关键 字 。 
所 有 Foundations 的 示例 代码 都 使 用 了 如 下 名 称 空间 : 
System 
System.Collections.Generic 
System.IO 
System.Linqg 
System.Net 
System.Runtime.CompllerServices 
System.Threadine 
System.Threadine. Tasks 


这 个 可 下 载 的 示例 应 用 程序 使 用 了 命令 行 参 数 ， 因 此 可 以 轻松 地 验证 每 个 场景 。 例 如 ， 使 用 dotnet CLL， 
可 以 通过 命令 : dotnet run ---async 传递 -async 命令 行 参数 。 使 用 Visual Sdio， 还 可 以 在 Debug Project Settings 
中 配置 应 用 程序 的 参数 。 
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为 了 更 好 地 理解 发 生 了 什么 , 创建 TraceThreadAndTask 方 法 ,将 线程 和 任务 信息 写 入 控制 台 。Task.CurentId 返 回 
任务 的 标识 他。Thread.CurrentThread.ManagedThreadId 返 回 当 前 线程 的 标识 符 ( 代 码 文 件 Foundations/Program.cs): 


Public static void TraceThreadAndTask (string info) 
{ 
string taskInfo = Task.CurrentId == null ? "no task™ : "task ™ + 
Task.CurrentId; 


Console .WriteLine{($"{info} in thread {Thread.CurrentThread.ManagedThreadId}"™ + 
s"and {taskIinfo}™). 
} 


15.3.1 创建 任务 
下 面 从 同步 方法 Greeting 开始 ,该 方法 等 待 一 段 时 间 后 ,返回 一 个 字符 串 (代码 文件 Foundations/Program.cs): 


static string Greeting (string name) 


TraceThreadAndTask($"running {nameof (Greeting) }"); 
Task.Delay (3000) .Wait (); 
return $"Hello, {name}™; 


} 

定义 方法 GreetingAsync, 可 以 使 方法 异步 化 。 基于 任务 的 异步 模式 指定 , 在 异步 方法 名 后 加 上 Async 后 组 ， 
并 返回 一 个 任务 。 异 步 方法 GreetingAsync 和 同步 方法 Greetine 具有 相同 的 输入 参数 ， 但 是 它 返 回 的 是 
Task<string>。Task<string> 定 义 了 一 个 返回 字符 串 的 任务 。 一 个 比较 简单 的 做 法 是 用 Task.Run 方法 返回 一 个 任 
务 。 泛 型 版 本 的 Task.Run<string>0 创 建 一 个 返回 字符 串 的 任务 。 由 于 编译 器 已 经 知道 实现 的 返回 类 型 (Greeting 
返回 字符 串 )， 因 此 还 可 以 使 用 Task.Run0 来 简化 实现 代码 : 


static Task<string> GreetingAsync(string name) 三 > 
Task.Run<string>(({() 三 > 
{ 
TraceThreadAndTask ($"running {nameof (GTeetIngasYnc) }"); 
return Greeting (name).; 


}}s 


15.3.2 调用 异步 方法 


可 以 使 用 await 关键 字 来 调用 返回 任务 的 异步 方法 GreetingAsync。 使 用 await 关键 字 需 要 有 用 async 修饰 符 
声明 的 方法 。 在 GreetingAsync 方法 完成 前 ， 该 方法 内 的 其 他 代码 不 会 继续 执行 。 但 是 ， 启 动 CallerWithAsync 
方法 的 线程 可 以 被 重用 。 该 线程 没有 被 阻塞 (代码 文件 Foundations/Program.cs): 


private async static void CalLlLerwlIthasync () 
{ 
TraceThreadAndTask ($"started {nameof (Cal lerWithAsync)}) }"); 
string result = await GreetingAsync ("Stephanie"™).; 
Console .WriteLine (resulty).: 
TraceThreadAndTask ($"ended {nameof (CallerWithAsync) }"); 
} 


运行 应 用 程序 时 ， 可 以 从 第 一 个 输出 中 看 到 没有 任务 。GreetingAsyuc 方法 在 一 个 任务 中 运行 ， 这 个 任务 使 
用 的 线程 与 调用 者 不 同 。 然 后 ， 同 步 Greeting 方法 在 此 任务 中 运行 。 当 Greeting 方法 返回 时 ，GreetingAsync 方 
法 返回 ， 在 等 待 之后， 作用 域 返 回 到 CallerWithAsynec 方法 中 。 现 在 ，CallerWithAsynec 方法 在 不 同 的 线程 中 运 
行 。 不 再 有 任务 了 ， 但 是 尽管 这 个 方法 是 从 线程 2 开始 的 ， 但 是 在 使 用 了 await 线程 3 之 后 。await 确保 在 任务 
完成 后 继续 执行 ， 但 现在 它 使 用 了 男 一 个 线程 。 这 种 行为 在 控制 台 应 用 程序 和 具有 同步 上 下 文 的 应 用 程序 之 间 
是 不 同 的 : 

started CallerWithAsync in thread 2 and no task 

running Greetingasync in thread 3 and task 1 

running Greeting in thread 3 and task 1 


Hello, Stephanie 
ended CallerWithAsync in thread 3 and no task 


如 条 异步 方法 的 结果 不 传递 给 变量 ， 也 可 以 直接 在 参数 中 使 用 await 关键 字 。 在 这 里 ，GreetingAsynec 方法 
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返回 的 结果 将 像 前 面 的 代码 片段 一 样 等 待 ， 但 是 这 一 次 的 结果 会 直接 传 给 Console.WiriteLine 方法 : 


private async static void CallerWithAsync2() 

{ 
TraceThreadAndTask ($"started {nameof (CallerWithAsync2)}"); 
Console.WriteLine (await GreetingAsync ("Stephanie")); 
TraceThreadandTask($"ended {nameof (CallerWithAsync2)}").; 

} 


注意 : 
在 C#7 中 ,async 修饰 符 可 以 用 于 返回 void 的 方法 , 或 者 用 于 返回 一 个 提供 GetAwaiter 方法 的 对 象 。.NET 
提供 Task 和 ValueTask 类 型 。 通 过 Windows 运行 库 ， 还 可 以 使 用 IAsyncOperation。 应 该 避免 给 带 有 void 的 方 


15.3.3 小 节 会 介绍 是 什么 驱动 了 await 关键 字 ， 在 后 台 使 用 了 延续 任务 。 


15.3.3 使 用 Awaiter 


可 以 对 任何 提供 GetAwaiter 方法 并 返回 awaiter 的 对 象 使 用 async 关键 字 。awaiter 用 OnCompleted 方法 实 
现 INotifyCompletion 接口 。 此 方法 在 任务 完成 时 调用 。 下 面 的 代码 片段 不 是 在 任务 中 使 用 await， 而 是 使 用 任 
务 的 GetAwaiter 方法 。Task 类 的 GetAwaiter 返回 一 个 TaskAwaiter。 使 用 OnCompleted 方法 ， 分 配 一 个 在 任务 
完成 时 调用 的 本 地 函数 (代码 文件 Foundations/Program.cs): 


private static void CallerWithAwaiter() 


{ 
TraceThreadAndTask ($"starting {nameof (CallerWithAwaiter}) }"); 
TaskAwaiter<string> awalter = GreetingAsync ("Matthias") .GetAwaliter(); 
awaliter.onCcompleted (OnCompletenAwaiter); 


Volad OnCcompleteRwaiter() 
{ 
Console.WriteLine (awaiter.GetResult'()).: 
TraceThreadhindTask ($"ended {nameof (CallerWithaAwaijter) }").; 
} 
} 


运行 应 用 程序 时 ， 结 果 类 似 于 你 使 用 wait 关键 字 的 情形 : 


starting CallerWithAwaiter in thread 2 and no task 
running GreetingAsync in thread 3 and task 1 
Iunning Greeting in thread 3 and task 1 

Hello, Matthias 

ended CallerWithAwaiter in thread 3 and no task 


编译 器 把 await 关键 字 后 的 所 有 代码 放 进 OnCompleted 方法 的 代码 块 中 来 转换 await 关键 字 。 


15.3.4 延续 任务 


还 可 以 使 用 Task 对 象 的 特性 来 处 理 任 务 的 延续 。GreetingAsync 方法 返回 一 个 Task<string> 对 象 。 该 
Task<string> 对 象 包含 任务 创建 的 信息 ， 并 保存 到 任务 完成 。Task 类 的 ContinueWith 方法 定义 了 任务 完成 后 就 调 
用 的 代码 。 指 派 给 ContinueWith 方法 的 委托 接收 将 已 完成 的 任务 作为 参数 传 入 ， 使 用 Result 属性 可 以 访问 任务 
返回 的 结果 (代码 文件 Foundations/Program.cs): 


private static void CallerWithContinuationTask() 


{ 
TraceThreadandTask{("started CallerWithcCcontinuationTask™); 


var 七 1 = GreetingAsync("stephanile"™),; 


tl1 .ContinueWith (七 “一 > 

{ 
string result = t.Result; 
Console.WriteLine (result). 


TraceThreadAndTask ("ended CallerWithcContinuationTask"™}).; 
}}s 
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} 


15.3.5 同步 上 下 文 


如 果 验 证 方法 中 使 用 的 线程 , 会 发 现 CallerWithAsync 方法 、CallerWithAwaiter 方法 和 CallerWithContinuationTask 
方法 ， 在 方法 的 不 同 生命 阶段 使 用 了 不 同 的 线程 。 一 个 线程 用 于 调用 GreetingAsync 方法 ， 另 外 一 个 线程 执行 await 
关键 字 后 面 的 代码 ， 或 者 继续 执行 ContinueWith 方法 内 的 代码 块 。 

使 用 一 个 控制 台 应 用 程序 ， 通 党 不 会 有 什么 问题 。 但 是 ， 必 须 保证 在 所 有 应 该 完成 的 后 台 任 务 完成 之 前 ， 
至 少 有 一 个 前 台 线 程 仍然 在 运行 。 示 例 应 用 程序 调用 Console.ReadLine 来 保证 主线 程 一 直 在 运行 ， 直 到 按 下 返 
回 键 。 

为 了 执行 某 些 动作 ， 有 些 应 用 程序 会 绑 定 到 指定 的 线程 上 (例如 ， 在 WPF 或 Windows 应 用 程序 中 ， 只 有 
UI 线程 才能 访问 UI 元 素 )， 这 将 会 是 一 个 问题 。 

如 果 使 用 async 和 await 关 键 字 ， 当 await 完 成 之 后 ， 不 需要 进行 任何 特别 处 理 ， 就 能 访问 UI 线程 。 默 认 情 况 
下 , 生成 的 代码 会 把 线程 转换 到 拥有 同步 上 下 文 的 线程 中 。 WPF 应 用 程序 设置 了 DispatcherSynchronizationContext 
属性 ，Windows Forms 应 用 程序 设置 了 WindowsFormsSynchronizationContext 属 性 。Windows 应 用 程序 使 用 
WinRTSynchronizationContext。 如 果 调 用 异步 方法 的 线程 分 配给 了 同步 上 下 文 ，await 完 成 之 后 将 继续 执行 。 
默认 情况 下 ， 使 用 了 同步 上 下 文 。 如 果 不 使 用 相同 的 同步 上 上下文， 则 必须 调用 Task 方 法 ConfigureAwait 
(continueOnCapturedContext: false)。 例 如 ,一 个 Windows 应 用 程序 ， 其 await 后 面 的 代码 没有 用 到 任何 的 UI 元 素 。 
在 这 种 情况 下 ， 避 免 切 换 到 同步 上 下 文 会 执行 得 更 快 。 


15.3.6 ”使 用 多 个 异步 方法 


在 一 个 异步 方法 中 ， 可 以 调用 一 个 或 多 个 异步 方法 。 如 何 编写 代码 ， 取 决 于 一 个 异步 方法 的 结果 是 否 依赖 
于 另 一 个 异步 方法 。 


1. 按 顺 序 调用 异步 方法 
使 用 await 关键 字 可 以 调用 每 个 异步 方法 。 在 有 些 情况 下 ， 如 果 一 个 异步 方法 依赖 男 一 个 异步 方法 的 结果 ， 
await 关键 字 就 非常 有 用 。 在 这 里 ，GreetingAsync 异步 方法 的 第 二 次 调用 完全 独立 于 其 第 一 次 调用 的 结果 。 这 
样 ， 如 果 每 个 异步 方法 都 不 使 用 await， 那 么 整个 MultipleAsyncMethods 异步 方法 将 更 快 地 返回 结果 ， 如 下 所 示 
(代码 文件 Foundations/Program.cs): 
private async static void MultipleAsyncMethods () 
string sl = await GreetingAsync ("Stephanie"); 
string s2 = await GreetingAsync ("Matthias").; 
Console .WriteLine($"Finished both methods. {Environment.NewLine} ™ + 


s"Result 1: {sl}{Environment.NewLine} Result 2: {S21}"); 
} 


2. 使 用 组 合 器 
如 果 异 步 方法 不 依赖 于 其 他 异步 方法 , 则 每 个 异步 方法 都 不 使 用 await, 而 是 把 每 个 异步 方法 的 返回 结果 赋 
值 给 Task 变量 ， 就 会 运行 得 更 快 。GreetingAsync 方法 返回 Task<string>。 这 些 方 法 现在 可 以 并 行 运行 了 。 组 合 
器 可 以 帮助 实现 这 一 点 。 一 个 组 合 器 可 以 接受 多 个 同一 类 型 的 参数 ， 并 返回 同一 类 型 的 值 。 多 个 同一 类 型 的 参 
数 被 组 合成 一 个 参数 来 传递 。Task 组 合 器 接受 多 个 Task 对 象 作为 参数 ， 并 返回 一 个 Task。 
示例 代码 调用 Task WhenAll 组 合 器 方法 , 它 可 以 等 待 , 直到 两 个 任务 都 完成 (代码 文件 Foundations/Programu.cs)。 
private async static void MultipleAsyncMethodsWithCombinatorsl () 
Task<string> 七 = GreetingAsync("Stephanie™); 
Task<string> 七 2 = GreetingAsync("Matthias"™).; 
await Task.WhenAll (tl, t2); 
Console .WriteLine($"Finished both methods. {Environment.NewLine} ”十 


Ss"Result 1: {tli.Resultl} {Environment.NewLine} Result 2: {t2.Result}").; 
} 
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Task 类 定义 了 WhenAll 和 WhenAny 组 合 器 。 从 WhenAll 方法 返回 的 Task， 是 在 所 有 传 入 方法 的 任务 都 完 
成 了 才 会 返回 Task。 从 WhenAny 方法 返回 的 Task， 是 在 其 中 一 个 传 入 方法 的 任务 完成 了 就 会 返回 Task。 
Task 类 型 的 WhenAl 方法 定义 了 几 个 重 载 版 本 。 如 果 所 有 的 任务 返回 相同 的 类 型 ， 那 么 该 类 型 的 数组 可 用 
于 await 返回 的 结果 。GreetingAsync 方法 返回 一 个 Task<string>， 等 待 返回 的 结果 是 一 个 字符 串 (string) 形 式 。 因 
此 ，Task.WhenAll 可 用 于 返回 一 个 字符 串 数 组 : 
private async static void MultipleAsyncMethodsWithCombinators2 () 
Task<string> tl1 = GreetingAsync ("stephanie™); 
Task<string> t2 = GreetingAsync("Matthias™),; 
string[] result = await Task.WhenAll({tl1l, t2); 
Console .WriteLine ($s$"Finished both methods. {Environment.NewLine} ™ + 


s"Result 1: {result[0]} {Enviornment.NewLine} Result 2: {result[1]}"):; 
} 


只 有 等 待 的 所 有 任务 都 完成 时 某 个 任务 才能 继续 ，WhenAll 方法 就 有 实际 用 途 。 当 调用 任务 在 等 待 完 成 的 
任何 任务 都 完成 才能 执行 操作 时 ， 可 以 使 用 WhenAny 方法 。 它 可 以 使 用 任务 的 结果 继续 。 


15.3.7 使 用 ValueTasks 


C# 7 带 有 更 灵活 的 await 关键 字 ， 它 现在 可 以 等 竺 任何 提供 GetAwaiter 方法 的 对 象 。 一 种 可 用 于 等 待 的 新 
类 型 是 ValueTask。 与 Task 类 相反 ，ValueTask 是 一 个 结构 。 这 具有 性 能 优势 ， 因 为 ValueTask 在 堆 上 没有 对 象 。 

与 异步 方法 调用 相 比 , Task 对 象 的 实际 开销 是 多 少 ? 需要 异步 调用 的 方法 通常 比 堆 上 的 对 象 有 更 多 的 开销 。 
大 多 数 时 候 ， 堆 上 Task 对 象 的 开销 是 可 以 忽略 的 ， 但 并 不 总 是 这 样 。 例 如 ， 茶 方法 可 以 有 一 个 路 笃 ， 其 中 数据 
是 从 一 个 具有 异步 API 的 服务 中 检索 出 来 的 。 通 过 这 种 数据 检索 ， 数 据 就 写 入 到 本 地 缓存 中 。 第 二 次 调用 该 方 
法 时 ， 可 以 以 快速 的 方式 检索 数据 ， 而 不 需要 创建 Task 对 象 。 

示例 方法 GreetingValueTaskAsync 正 是 这 样 做 的 。 如 果 该 名 称 已 存在 于 字典 中 ， 则 结果 返回 为 ValueTask。 
如 果 名 称 不 在 字典 中 ， 将 调用 GreetingAsync 方法 ， 该 方法 返回 一 个 Task。 在 此 任务 中 等 待 检索 结果 时 ， 将 再 
次 返回 ValueTask( 代 码 文 件 Foundations/Program.cs): 

private readonly static Dictionary<string, string> names = new Dictionary<string, string>(); 


static async ValueTask<string> GreetingValueTaskAsync (string name) 
{ 

IE (names.TryGetValue (name, out string result)) 

{ 


return result.; 


el1se 
{ 
result = await GreetingAsync (name); 
names.Add (name, result); 
Ireturn result; 
} 
} 


UseValueTask 方法 使 用 相同 的 名 称 调用 GreetineValueTaskAsync 方法 两 次 。 第 一 次 使 用 GreetingAsynec 方法 
检索 数据 ， 第 二 次 ， 数 据 在 字典 中 找到 并 从 那里 返回 : 


private static async void UseVvalueTask() 

{ 
string result = await GreetingValueTaskAsync ("Katharina"™); 
Console .WriteLine (result).; 
string result2 = await GreetingVvalueTaskAsync ("Katharina™.).; 
Console .WriteLine (result2). 


} 

如 果 方 法 不 使 用 async 修饰 符 ， 而 需要 返回 ValueTask， 就 可 以 使 用 传递 结果 或 者 传递 Task 对 象 的 构造 函 
数 创 建 ValueTask 对 象 : 

static ValueTask<string> GTeetlInodValueTask2aASsYnC (StTInOI name) 

{ 


if (names.TryGetValue (name, cout string result)) 


{ 
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return new ValueTask<string> (result); 
} 
全 ] se 
{ 
Task<string> tl = GreetingAsync (name); 


TaskAwaiter<string> awalter = 七 L .Getawalter (); 
awaliter.oncompleted (OnCcompletion); 
return new ValueTask<string> (t1); 


VOld OnCcompletion'() 
{ 
names.Add (name, awaiter.GetResult()); 
} 
} 
} 


15.3.8 ”转换 异步 模式 


并 非 .NET Framework 的 所 有 类 都 引入 了 新 的 异步 方法 。 在 使 用 框架 中 的 不 同类 时 会 发 现 ， 还 有 许多 类 只 提 
供 了 BeginXXX 方法 和 EndXXX 方法 的 异步 模式 , 没有 提供 基于 任务 的 异步 模式 ,但 是 ,可 以 把 异步 模式 转换 
为 基于 任务 的 异步 模式 。 

这 个 示例 使 用 HttpWebRequest 类 和 BeginGetResponse 方法 将 该 方法 转换 为 基于 任务 的 异步 模式 。 
Task.Factory.FromAsync 是 一 个 泛 型 方法 ， 它 提供 了 一 些 重 载 版 本 ,将 异步 模式 转换 为 基于 任务 的 异步 模式 。 对 
于 示例 应 用 程序 ， 当 调用 HttpWebRequest 的 BeginGetResponse 方法 时 , 将 发 出 异步 网 络 请 求 。 这 个 方法 返回 一 
个 IAsyncResult， 它 是 FromAsync 方法 的 第 一 个 参数 。 第 二 个 参数 是 对 EndGetResponse 方法 的 引用 ， 它 需要 一 
个 带 有 LAsyncResult 参数 ( 即 EndGetResponse 方法) 的 委托 ,第 二 个 参数 还 需要 返回 WebResponse, 由 FromAsync 
方法 的 泛 型 参数 决定 。 当 IAsyncResult 信号 完成 时 ， 任 务 助手 功能 会 调用 EndGetResponse 方法 (代码 文件 
Foundations/Proeram.cs): 

private static async void ConvertingAsyncPattern!) 


HttpWebRequest request = WebRequest.Create ("http:/ /www.microsoft -comn ) 
as HttpWebRequest: 


USing (WebResponse response = await Task.Factory.Fromhsync<WebResponse>( 
request.BeginGetResponse (null, null), request.EndGetResponse)) 
{ 
stream stream = Iesponse.GetResponsestream().; 
US1ing (Var reader = new StreamReader (stream)) 
string content = reader.ReadToEnd (1) ; 
Console .WriteLine (content .Substring (0, 100)}); 
} 


} 
} 


警告 : 
在 旧 应 用 程序 中 ， 通 常 在 使 用 异步 模式 时 使 用 委托 的 BeginInvoke0 方 法 。 在 NET Core 应 用 程序 中 使 用 此 
方法 时 ， 编 译 器 不 会 报错 。 但 是 ， 在 运行 时 ， 将 抛 出 一 个 平台 不 支持 的 异常。 


15.4 ”错误 处 理 


第 14 章 详细 介绍 了 错误 和 腊 和 靖 处理。 但是， 在 使 用 异步 方法 时 ， 应 该 知道 错误 的 一 些 特 殊 处 理 方式 。 
所 有 ErrorHandling 示例 的 代码 都 使 用 了 如 下 名 称 空间 : 

System 

System.Threading.Tasks 
从 一 个 简单 的 方法 开始 ， 它 在 延迟 后 抛 出 一 个 异常 (代码 文件 ErrorHandling/Program.cs): 
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static async Task ThrowhAfterl(int ms, string message) 
{ 

await Task.Delay (ms)} 

throw new Exception (message); 


} 

如 果 调 用 异步 方法 ， 并 且 没 有 等 待 ， 可 以 将 异步 方法 放 在 try/catch 块 中 ， 就 会 捕获 不 到 异常 。 这 是 因为 
DontHandle 方法 在 ThrowAfter 抛 出 异 第 之前 ， 己 经 执行 完毕 。 需 要 等 竺 ThrowAfter 方法 ， 如 下 一 节 的 示例 所 示 。 
注意 这 个 代码 片段 不 会 抛 出 异常 : 


private static void DontHandle () 
{ 
tryY 
{ 
ThrowAfter (200, "first"); 
// exception is not caught because this method is finished 
/i before the exception is thrown 
} 
catch (Exception ex) 
Console.WriteLine (ex.Message); 
} 
} 


警告 : 
返回 void 的 异步 方法 不 会 等 待 。 这 是 因为 从 async void 方法 抛 出 的 异常 无 法 捕获 。 因 此 ， 异 步 方法 最 好 返 
回 一 个 Task 类 型 。 处 理 程序 方法 或 重 写 的 基 类 方法 不 受 此 规则 限制 。 


15.4.1 异步 方法 的 异常 处 理 


异步 方法 异常 的 一 个 较 好 处 理 方式 是 使 用 await 关键 字 ， 将 其 放 在 try/catch 语句 中 ， 如 以 下 代码 块 所 示 。 
异步 调用 ThrowAfter 方法 后 ，HandleOneError 方法 就 会 释放 线程 ， 但 它 会 在 任务 完成 时 保持 任务 的 引用 。 此 时 
(Cs 后 ， 抛 出 异常 )， 会 调用 匹配 的 catch 块 内 的 代码 (代码 文件 ErrorHandling/Program.cs)。 


private static async void HandleOneError () 
{ 
tryY 
{ 
awalit ThrowAfter (2000, "first"); 


catch (Exception ex) 
{ 
Console.WriteLine($"handled {ex.Message}"™"); 
} 
} 


15.4.2 ”多 个 异步 方法 的 异常 处 理 


如 果 调 用 两 个 异步 方法 ， 每 个 都 会 抛 出 异常 ， 该 如 何 处 理 呢 ? 在 下 面 的 示例 中 ， 第 一 个 ThrowAfter 方法 被 
调用 ，2s 后 抛 出 异常 ( 含 消息 frst)。 该 方法 结束 后 ， 男 一 个 ThrowAfter 方法 也 被 调用 ，1s 后 也 抛 出 异常 。 事 实 
并 非 如 此 ， 因 为 对 第 一 个 ThrowAfter 方法 的 调用 已 经 抛 出 了 异常 ，try 块 内 的 代码 没有 继续 调用 第 二 个 
ThrowAfter 方法 ， 而 是 在 catch 块 内 对 第 一 个 异常 进行 处 理 ( 代 码 文件 ErrorHandling/Program.cs)。 


private static async void StartTwoTasks () 
{ 
try 
{ 
awalit ThrowAfter (2000, "first"); 
await ThrowAfter(1000, "second"™); // the second call is not invoked 
/i because the first method throws 
// an exception 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"handled {ex.Message}"™"); 
} 
} 
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现在 ， 并 行 调 用 这 两 个 ThrowAfter 方法 。 第 一 个 ThrowAfter 方法 2s 后 抛 出 异常 ，1s 后 第 二 个 ThrowAfter 
方法 也 抛 出 异常 。 使 用 Task.WhenAll， 不 管 任务 是 否 抛 出 异常 ， 都 会 等 到 两 个 任务 完成 。 因 此 ， 等 待 2s 后 ， 
Task.WhenAll 结束 ， 异 常 被 catch 语句 捕获 到 。 但 是 ， 只 能 看 见 传递 给 WhenAl 方法 的 第 一 个 任务 的 异常 信息 。 
没有 显示 先 抛 出 异常 的 任务 (第 二 个 任务 )， 但 该 任务 也 在 列表 中 : 
private async static void startTwoTasksParallel () 
try 


Task tl1 = ThrowAfter(2000, "vfirst"); 
Task t2 = ThrowaAfter (lO000, "secongd™}.; 
await Task.WhenAlll(tl1l, t2); 

} 

catch (Exception ex) 

{ 
/:/ just display the exception information of the first task 
fy/ that is awaited within WhenAll 
Console.WriteLine($"handled {ex.Message}"™); 

} 

} 


有 一 种 方式 可 以 获取 所 有 任务 的 异常 信息 , 就 是 在 try 块 外 声明 任务 变量 t 和 忆 , 使 它们 可 以 在 catch 块 内 
访问 。 在 这 里 ， 可 以 使 用 IsFaulted 属性 检查 任务 的 状态 ， 以 确认 它们 是 否 为 出 错 状态 。 大 出 现 异 常 ，IsFaulted 
属性 会 返回 tue。 可 以 使 用 Task 类 的 Exception.InnerException 访问 异常 信息 本 身 。 另 一 种 获取 所 有 任务 的 异常 
信息 的 更 好 方式 如 下 所 述 。 


15.4.3 ”使 用 AggregateException 信息 


为 了 得 到 所 有 失败 任务 的 异常 信息 ， 可 以 将 Task WhenAll 返回 的 结果 写 到 一 个 Task 变量 中 。 这 个 任务 会 
一 直 等 到 所 有 任务 都 结束 。 否 则 ， 仍 然 可 能 错过 抛 出 的 异常 。 上 一 小 节 中 ，catch 语句 只 检索 到 第 一 个 任务 的 异 
意 。 不 过 ， 现 在 可 以 访问 外 部 任务 的 Exception 属性 了 。Exception 属性 是 AggregateException 类 型 的 。 这 个 异 
常 类 型 定义 了 InnerExceptions 属性 (不 只 是 InnerException)， 它 包含 了 等 待 中 的 所 有 异常 的 列表 。 现 在 ， 可 以 轻 
松 遍 历 所 有 异常 了 (代码 文件 ErrorHandling/Program.cs)。 


private static async void ShowaggregatedExCceptIon () 
{ 


Task taskResult = null:; 
try 
{ 
Task tl1 = ThrowhAfter(2000, "first"); 
Task t2 = ThrowAfter(l1l000, "second™}. 
await (taskResult = Task.WhenAll (tl1l, t2)); 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"handled {ex.Message}"™); 
foreach (Var exl in taskResult.Exception.InnerExceptions) 
{ 
Console .WriteLine ($"jnner exception {exl .Message}"™); 
} 
} 
} 


15.5 ”异步 与 Windows 应 用 程序 


把 async 关键 字 用 于 UWP 应 用 程序 与 本 章 前 面 的 相同 。 但 需要 注意 ， 在 UI 线程 中 调用 await 之 后 ， 当 异 
步 方法 返回 时 ， 将 默认 返回 到 UI 线程 中 。 这 便于 在 异步 方法 完成 后 更 新 UI 元 素 。 


注意 : 
为 了 创建 UWP 应 用 程序 ， 需 要 Windows 10，Windows 系统 必须 在 “开发 人 员 模 式 ” 下 配置 。 启 用 “开发 
人 员 模 式 ” 时 ， 需 要 打开 Windows 设置 ， 选 择 Update & Security 磁 贴 ， 选 择 For developers 类 别 ， 并 单 击 单 选 
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按钮 Developer mode,。 这 样 系统 就 可 以 运行 党 路 的 应 用 程序 了 (未 从 Windows Store 中 安装 的 应 用 程序 ), 并 为 “ 开 
发 人 员 模 式 ” 添 加 一 个 Windows 包 。 


为 了 理解 功能 和 问题 ， 创 建 一 个 通用 Windows 应 用 程序 。 这 个 应 用 程序 包含 5 个 按钮 和 一 个 TextBlock 元 
素 ， 来 演示 不 同 的 场景 (代码 文件 AsyncWindowsApps/MainPage.xaml): 
<StackPanel> 
<Button Content="Sstart Asvync™" Click="OnstartAsync" Margin="4"™ /> 
<Button Content="Start Async with Config”" Click="OnstartAsyncConfigureAwait™ 
Margin="4" /> 
<Button Content="Start Async with Thread Switch" 
Click="onstartAsyncWithThreadSwitch™" Margin="4" /> 
<Button Content="Use IAsyncOperation™" Click="OnIAsyncOperation™" Margin="4" /> 
<Button Content="Deadlock™ Click="OnStartDeadlock™" Margin="4"™ /> 
<TextBlock x:Name="textl" Margin="4" /> 
</sStackPanel> 


注意 : 
UWP 应 用 程序 在 第 33 章 到 第 36 章 详细 介绍 。 
在 OnStartAsync 方法 中 ，UI 线程 的 线程 ID 写 入 TextBlock 元 素 。 接 下 来 调用 异步 方法 Task Delay， 它 不 阻 
塞 UI 线程 ， 在 此 方法 完成 后 ， 线 程 ID 将 再 次 写 入 TextBlock( 代 码 文 件 AsyncWindowsApps/MainPage.xaml.cs): 
private async volid OnstartAsync (object sender, RoutedEventArgs e) 
textl1.Text = $"UI thread: {GetThread() }"; 
await Task.Delay (1000); 


textl1l .Text 十 一 S$"\n after await: {GetThread {() }"™; 
} 


为 了 访问 线程 DD， 可 以 使 用 Environment 类 。 在 UWP 应 用 程序 中 ，Thread 类 是 无 效 的 一 一 至 少 在 构建 版 
本 15063 之 前 是 这 样 的 : 

private string GetThread() => S$"thread: {Environment.CurrentManagedThreadId}™; 

运行 应 用 程序 时 ,可 以 在 文本 元 素 中 看 到 类 似 的 输出 。 与 控制 台 应 用 程序 相反 ,UWP 应 用 程序 定义 了 一 个 
同步 上 下 文 ， 在 等 待 之 后 ， 可 以 看 到 与 以 前 相同 的 线程 。 这 允许 直接 访问 UI 元素: 


UI thread: thread 3 
after await: thread 3 


15.5.1 配置 await 


如 果 不 需 要 访问 UI 元素， 就 可 以 配置 await， 以 避免 使 用 同步 上 下 文 。 下 面 的 代码 片段 演示 了 配置 ， 并 说 
明 为 什么 不 应 该 从 后 台 线 程 上 访问 UI 元 素 。 

使 用 OnsStartAsyncConfigureAwait 方法 ,在 将 UI 线 程 的 ID 写 入 文本 输入 后 ,将 调用 本 地 函数 AsyncFunction。 
在 这 个 本 地 函数 中 ， 启 动 线程 是 在 调用 异步 方法 Task.Delay 之 前 写 入 的 。 使 用 此 方法 返回 的 任务 ， 将 调用 
ConfigureAwait。 在 这 个 方法 中 ， 任 务 的 配置 是 通过 传递 设置 为 false 的 continueOnCapturedContext 参数 来 完成 
的 。 通过 这 种 上 下 文 配置 , 会 发 现 等 待 之 后 的 线程 不 再 是 UI 线程 。 使 用 不 同 的 线程 将 结果 写 入 result 变量 即 可 。 
如 ty 块 所 示 ， 干 万 不 要 从 非 UI 线程 中 访问 UI 元素。 得 到 的 异常 包含 HRESULT 值 ， 如 when 子 句 所 示 。 只 有 
这 个 异常 在 catch 中 捕获 : 结果 返回 给 调用 者 。 对 于 调用 方 ， 也 调用 了 ConfigureAwait， 但 是 这 次 ， 
continueOnCapturedContext 设置 为 tue。 在 这 里 ， 在 等 待 之 前 和 之 后 ， 方 法 都 在 UI 线程 中 运行 (代码 文件 
AsyncWindowsApp/MainWindow. xaml.cs): 

-0 async void OnstartAsyncConfigureAwait (object sender, RoutedEventArgs e) 


textl1 .Text = $"UI thread: {GetThread() }"™; 


string 5s = await AsyncFunction() .configqureAwait ( 
continueOnCapturedContext: true); 


// after await, with continueOnCapturedContext true we are back in the UI thread 
textl1.Text += S$S"™\n{s}\nafter await: {GetThread(} }"™: 
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async Task<string> AsyncFunction{() 
{ 
string result = $"\nasync function: {GetThread(} }\n"™; 
await Task.Delay (1000) .configureAwait (continueOnCcapturedCcontext: false); 


result += $"\nasync function after await : {GetThread (}}"; 

try 

{ 
textl1 .Text = "this is a call from 七 he wrong thread"™s 
return "not reached™. 

} 

catch (Exception ex) When (ex.HResult == -2147417842) 

{ 


return result; 
// we Know it's the wrong thread 
// don't access UI elements from the previous try block 
} 
} 
} 


注意 : 
异常 处 理 和 过 滤 在 第 14 章 中 解释 。 


运行 应 用 程序 时 ， 可 以 看 到 如 下 输出 。 在 等 待 后 的 异步 本 地 函数 中 ， 使 用 了 另 一 个 线程 。 文 本 not reached 
从 来 没有 写 过 ， 因 为 抛 出 了 异 帝 : 

UI thread: thread 3 

async function: thread 3 


async function after await: thread 6 
after await: thread 3 


警告 : 
在 本 书后 面 的 UWP 章节 中 ， 使 用 了 数据 绑 定 ， 而 不 是 直接 访问 UI 元 素 的 属性 。 但 是 ， 在 UWP 中， 也 不 
能 在 非 UI 线程 中 编写 绑 定 到 UI 元 素 的 属性 。 


15.5.2 ”切换 到 UI 线程 


在 茶 些 情况 下 ， 使 用 后 台 线 程 访问 UI 元 素 并 不 容易 。 在 这 里 ， 可 以 使 用 从 Dispatcher 属性 返回 的 
CoreDispatcher 对 象 切换 到 UI 线程 。Dispatcher 属性 在 DependencyObject 类 中 定义 。DependencyObject 是 UI 元 
素 的 基 类 。 调 用 CoreDispatcher 对 象 的 RunAsync 方法 会 在 UI 线程 中 再 次 运行 传递 进来 的 lambda 表达 式 ( 代 码 
文件 AsyncWindowsApp/MainWindow.xaml.cs): 

private async volid OnstartAsyncWithThreadSswitch (object sender, RoutedEventArgs e) 


{ 
textl1 .Text = S$"UI thread: {GetThread(}}": 


string S = await AsyncFunction(); 
textl1 -TeXt += $"\nafter await: {GetThread(}) }"; 


async Task<string> AsyncFunction{() 

{ 
string result = $"\nasync function: {GetThread(}}\n"; 
awalt Task.Delay (1000) .configureBAwait (continueOnCapturedContext: false); 
result += $"\nasync function after await : {GetThread (}}"; 


await Dispatcher.RunAsync (CoreDispatcherPriority.Normal, {() =»> 
{ 
textl] .Text += 
$s"\nasync function switch back to the UI thread: {GetThread(}) }"; 
上 
return result:; 
} 
} 


运行 应 用 程序 时 ， 可 以 看 到 在 使 用 RunAsync 时 总 是 使 用 的 UI 线程 。 


UI Thread: thread 3 
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async function switch back to the UI thread: thread 3 
async function: thread 3 

async function after await: thread 5 

after await: thread 3 


15.5.3 使 用 IAsyncOperation 


异步 方法 由 Windows 运行 库 定 义 ， 不 返回 Task 或 ValueTask。Task 和 ValueTask 不 是 Windows 运行 库 的 一 
部 分 。 相 反 ， 这 些 方法 返回 一 个 实现 接口 IAsyncOperation 的 对 象 ， IAsyncOperation 并 没有 根据 需要 通过 await 
关键 字 来 定义 方法 GetAwaiter。 但 是 使 用 await 关键 字 时 ,LAsyncOperation 会 自动 转换 为 Task。 还 可 以 使 用 AsTask 
扩展 方法 将 IAsyncOperation 对 象 转换 为 任务 。 

在 示例 应 用 程序 的 方法 OnLAsyncOperation 中 ， 调 用 MessageDialog 的 ShowAsync 方法 。 该 方法 返回 一 个 
IAsyncOperation， 可 以 简单 地 使 用 await 关键 字 获 取 结 果 ( 代 码 文 件 AsyncWindowsApp/MainWindow.xaml.cs): 

Es async void OnIAsyncOperation (object sender, RoutedEventArgs e) 


Var dlg = new MessageDialog ("Select One, Two, Or Three™", "Sample"™); 


dlg.commands.Add (new UICommand ("one™, null, 1})); 
dlog.commands.Add (new UICommand ("Two", null, 2)); 
dlog.commands.Add {new UICommand ("Three™, null, 3)); 
IUICommand command = await dlg.showAsync(); 


textl1 .Text = $"Command {command.Id} with the label {command.Label} ijnvoked"™; 
} 


15.5.4 避免 阻塞 情况 


在 Task 上 一 起 使 用 Wait 和 async 关键 字 是 很 危险 的 。 在 使 用 同步 化 上 下 文 的 应 用 程序 中 ， 这 很 容易 导致 

死 锁 。 
在 方法 OnStartDeadlock 中 ， 调 用 本 地 函数 DelayAsync。DelayAsync 等 待 Task.Delay 的 完成 ， 之 后 在 前 台 线 

程 中 继续 执行 。 但 是 ， 调 用 者 在 DelayAsync 返回 的 任务 上 调用 Wait0 方 法 。Wait0 方 法 阻塞 调用 线程 ， 直 到 任务 

完成 。 在 这 种 情况 下 ，Wait0 是 从 前 台 线 程 上 调用 的 ， 因 此 Wait0 会 阻塞 前 台 线 程 。Task Delay 上 的 Wait0 永 远 无 

法 完成 ， 因 为 前 台 线 程 不 可 用 。 这 是 一 个 经 典 的 死 锁 场 景 (代码 文件 AsyncWindowsApps/MainWindow.xaml.cs): 
private void OnstartDeadlock (object sender, RoutedEventArgs e) 


DelayAsync() .Wait (); 
} 
private async Task DelayAsync() 
{ 
await Task.Delay (1000); 
} 


警告 : 
避免 在 使 用 同步 化 上 下 文 的 应 用 程序 中 同时 使 用 Wait 和 await。 


15.6 ”小 结 


本 章 介 绍 了 async 和 await 关键 字 。 通 过 几 个 示例 ， 介 绍 了 基于 任务 的 异步 模式 ， 比 .NET 早期 版 本 中 的 异 
步 模式 和 基于 事件 的 异步 模式 更 具 优势 。 

本 草 也 讨论 了 在 Task 类 的 辅助 下 ， 创 建 异步 方法 是 非常 容易 的 。 同 时 ， 学 会 了 如 何 使 用 async 和 await 天 
键 字 等 待 这 些 方法 ， 而 不 会 阻塞 线程 。 最 后 ， 介 绍 了 腊 步 方法 的 错误 处 理 。 

厦 想 了 解 更 多 关于 并 行 编程 、 线 程 和 任务 的 详细 信息 ， 请 参考 第 21 章 。 

第 16 章 将 继续 关注 C# 和 .NET 的 核心 功能 ， 详 细 介 绍 了 反射 、 元 数据 和 动态 编程 。 


第 


反射 、 元 数据 和 动态 编程 


10. 


本 草 要 氮 
e 使 用 目 定 义 特性 
e 在 运行 期 间 使 用 反射 检查 元 数据 


从 文 持 反 射 的 类 中 构建 访问 点 
用 DynamicObject 和 ExpandoObject 创建 动态 对 象 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代 码 。 源 代码 也 可 以 在 ReflectionAndDynamic 目 
录 的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 


LookupWhatsNew 
TypeView 
VectorClass 
WhatsNewAttributes 
Dynamic 
DynamicFlleReader 


16.1 在 运行 期 则 检查 代码 和 动态 编程 


本 章 讨 论 目 定义 特性 、 反 射 和 动态 编程 。 自 定义 特性 允许 把 自 定 义 元 数据 与 程序 元 素 关 联 起 来 。 这 些 元 数 
据 是 在 编译 过 程 中 创建 的 ， 并 退 入 到 程序 集中 。 反 射 是 一 个 普通 术语 ， 它 描述 了 在 运行 过 程 中 检查 和 处 理 程 序 
元 素 的 功能 。 例 如 ， 反 射 允 许 完 成 以 下 任务 : 


实例 化 新 对 象 
执行 对 象 的 成 员 
查找 类 型 的 信息 
查找 程序 集 的 信息 
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e 检查 应 用 于 某 种 类 型 的 自 定义 特性 

e 创建 和 编译 新 程序 集 

这 个 列表 列 出 了 许多 功能 ， 包 括 NET Framework 类 库 提供 的 一 些 最 强大 、 最 复杂 的 功能 。 但 本 章 不 可 能 介 
绍 反 射 的 所 有 功能 ， 仅 讨论 最 和 帝 

为 了 说 明 自 定义 特性 和 反射 ， 我 们 将 开发 一 个 示例 ， 说 明 公司 如 何 定期 升级 软件 ， 目 动 记 录 升 级 的 信息 。 
在 这 个 示例 中 ， 要 定义 几 个 目 定 义 特性 ， 表 示 程 序 元 素 最 后 修改 的 日 期 ， 以 及 发 生 了 什么 变化 。 然 后 使 用 反射 
开发 一 个 应 用 程序 ， 它 在 程序 集中 查找 这 些 特性 ， 自 动 显示 软件 自 某 个 给 定 日 期 以 来 升级 的 所 有 信息 。 

本 章 要 讨论 的 另 一 个 示例 是 一 个 应 用 程序 ， 该 程序 从 数据 库 中 读 取信 息 或 把 信息 写 入 数据 库 ， 并 使 用 目 定 
义 特 性 ， 把 类 和 属性 标记 为 对 应 的 数据 库 表 和 列 。 然 后 在 运行 期 间 从 程序 集中 读 取 这 些 特 性 ， 使 程序 可 以 目 动 
从 数据 库 的 相应 位 置 检索 或 写 入 数据 ， 不 需要 为 每 个 表 或 每 一 列 编写 特定 的 逻辑 。 

本 章 的 第 二 部 分 是 动态 编程 ，C# 自 从 第 4 版 添加 了 dynamic 类 型 后 ， 动 态 编程 就 成 为 C# 的 一 部 分 。 随 着 
Ruby、Python 等 语言 的 成 长 ， 以 及 JavaScript 的 使 用 更 加 广泛 ， 动 态 编程 引起 了 人 们 越 来 越 多 的 兴趣 。 尽 管 C# 
仍 是 一 种 静态 的 类 型 化 语言 ， 但 这 些 新 增 内 容 给 它 提 供 了 一 些 开 发 人 员 期 望 的 动态 功能 。 使 用 动态 语言 功能 ， 
允许 在 C# 中 调用 脚本 函数 ， 简 化 COM 交互 操作 。 

本 章 介 绍 dynamic 类 型 及 其 使 用 规则 ， 并 讨论 DynamicObject 的 实现 方式 和 使 用 方式 。 另 外 ， 还 将 介绍 
DynamicObject 的 框架 实现 方式 ， 即 ExpandoObject。 


16.2 自 定义 特性 


前 面 介绍 了 如 何在 程序 的 各 个 数据 项 上 定义 特性 。 这些 特性 都 是 Microsoft 定义 好 的 , 作为 .NET Framework 
类 库 的 一 部 分 ， 许多 特性 都 得 到 了 C# 编 译 器 的 支持 。 对 于 这 些 特殊 的 特性 ,编译 器 可 以 以 特殊 的 方式 定制 编译 
过 程 ， 例 如 ， 可 以 根据 StuctLayout 特性 中 的 信息 在 内 存 中 布置 结构 。 

.NET Framework 也 人 允许 用 户 定 义 目 己 的 特性 。 显 然 ， 这 些 特 性 不 会 影响 编译 过 程 ， 因 为 编译 器 不 能 识别 它 
们 ， 但 这 些 特性 在 应 用 于 程序 元 素 时 ， 可 以 在 编译 好 的 程序 集中 用 作 元 数据 。 

这 些 元 数据 在 文档 说 明 中 非常 有 用 。 但 是 ， 使 目 定 义 特 性 非常 强大 的 因素 是 使 用 反射 ， 代 码 可 以 读 取 这 些 
元 数据 ， 使 用 它们 在 运行 期 间 做 出 决策 。 也 就 是 说 ， 目 定义 特性 可 以 直接 影响 代码 运行 的 方式 。 例 如 ， 目 定义 
特性 可 以 用 于 文 持 对 目 定义 许可 类 进行 声明 性 的 代码 访问 安全 检查 ， 把 信息 与 程序 元 素 关 联 起 来 ， 程 序 元 素 由 
测试 工具 使 用 ， 或 者 在 开发 可 扩展 的 架构 时 ， 人 允许 加 载 插件 或 模块 。 


16.2.1 编写 自 定义 特性 


为 了 理解 编写 目 定义 特性 的 方式 ， 应 了 解 一 下 在 编译 器 遇 到 代码 中 某 个 应 用 了 目 定 义 特性 的 元 素 时 ， 该 如 
何 处 理 。 以 数据 库 为 例 ， 假 定 有 一 个 C# 属 性 声明 ， 如 下 所 示 。 

[FieldName ("SocialSecurityNumber")] 

public string SocialSecurityNumber 

{ 


get { 
Esas 


当 C# 编 译 器 发 现 这 个 属性 (property) 应 用 了 一 个 FieldName 特性 时 ， 首 先 会 把 字符 串 Attibute 追加 到 这 个 名 称 
的 后 面 ， 形 成 一 个 组 合 名 称 FieldNameAttribute， 然 后 在 其 搜索 路 径 的 所 有 名 称 空间 ( 即 在 using 语句 中 提 及 的 名 
称 空 间 ) 中 搜索 有 指定 名 称 的 类 。 但 要 注意 ， 如 果 用 一 个 特性 标记 数据 项 ， 而 该 特性 的 名 称 以 字符 串 Attribute 
结尾 ， 编 译 融 就 不 会 把 该 字符 串 加 到 组 合 名 称 中 ， 而 是 不 修改 该 特性 名 。 因 此 ， 上 面 的 代码 等 价 于 : 

[FieldNameAttribute ("SocialSecurityNumber")] 

-a string SocialSecurityNumber 


get { 
fa 


编译 占 会 找到 含有 该 名 称 的 类 ， 且 这 个 类 直接 或 间接 派生 目 System Attribute。 编 译 器 还 认为 这 个 类 包含 控 


328 | 第 1 部 分 C# 语 言 


制 特性 用 法 的 信息 。 特 别 是 属性 类 需要 指定 : 
e 特性 可 以 应 用 到 哪些 类 型 的 程序 元 素 上 (类 、 结 构 、 属 性 和 方法 等 ) 
e 和 瑟 是 否 可 以 多 次 应 用 到 同一 个 程序 元 素 上 
e 特性 在 应 用 到 类 或 接口 上 时 ， 是 否 由 派生 类 和 接口 继承 
e 这 个 特性 有 哪些 必 选 和 可 选 参数 
如 果 编 译 器 找 不 到 对 应 的 特性 类 ， 或 者 找到 一 个 特性 类 ， 但 使 用 特性 的 方式 与 特性 类 中 的 信息 不 匹配 ， 编 
译 器 就 会 产生 一 个 编译 错误 。 例 如， 如 果 特 性 类 指定 该 特性 只 能 应 用 于 类 ,但 我 们 把 它 应 用 到 结构 定义 上 ， 就 
会 产生 一 个 编译 错误 。 
继续 上 面 的 示例 ， 假 定 定 义 了 一 个 FieldName 特性 : 
[AttributeUsage (AttributeTargets.Property, 
AllowMultiple=false, Inherited=false)] 
Public class FieldNamehttribute: Attribute 
0 string name; 
public FieldNameAttribute (string name) 
{ 
name = name; 
} 


下 面 几 节 讨论 这 个 定义 中 的 每 个 元 系 。 

1. 指定 AttributeUsage 特性 

要 注意 的 第 一 个 问题 是 特性 (attribute) 类 本 身 用 一 个 特性 一 一 System.AttributeUsage 特性 来 标记 。 这 是 
Microsoft 定义 的 一 个 特性 ，C# 编 译 器 为 它 提供 了 特殊 的 文 持 (你 可 能 认为 AttributeUsage 根本 不 是 一 个 特性 ， 它 
更 像 一 个 元 特性 ， 因 为 它 只 能 应 用 到 其 他 特性 上 ， 不 能 应 用 到 类 上 )。AttributeUsage 主要 用 于 标识 目 定义 特性 
可 以 应 用 到 哪些 类 型 的 程序 元 素 上 。 这 些 信 息 由 它 的 第 一 个 参数 给 出 ， 该 参数 是 必 选 的 ， 其 类 型 是 枚 举 类 型 
AttributeTargets。 在 上 面 的 示例 中 , 指定 FieldName 特性 只 能 应 用 到 属性 (property) 上 一 一 这 是 因为 在 前 面 的 代码 
段 中 把 它 应 用 到 属性 上 。AttributeTargets 枚 举 的 成 员 如 下 : 

® All 
Assembly 
Class 
Constructor 
Delegate 


Enum 
Event 
Field 
GenericParameter 
Interface 
Method 
Module 
Parameter 
Property 
ReturnValue 
® Struct 
这 个 列表 列 出 了 可 以 应 用 该 特性 的 所 有 程序 元 素 。 注 意 在 把 特性 应 用 到 程序 元 素 上 时 ， 应 把 特性 放 在 元 如 
前 面 的 方 括号 中 。 但 是 ， 在 上 面 的 列表 中 ， 有 两 个 值 不 对 应 于 任何 程序 元 素 : Assembly 和 Module。 特 性 可 以 
应 用 到 整个 程序 集 或 模块 中 ， 而 不 是 应 用 到 代码 中 的 一 个 元 素 上 ， 在 这 种 情况 下 ， 这 个 特性 可 以 放 在 源 代码 的 
任何 地 方 ， 但 需要 用 关键 字 Assembly 或 Module 作为 前 组 : 
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[assembly:SomeAssemblyAttribute (Parameters)] 
[module:SomeAssemblyAttribute (Parameters)] 


在 指定 目 定 义 特性 的 有 效 目标 元 素 时 ， 可 以 使 用 按 位 OR 运算 符 把 这 些 值 组 合 起 来 。 例 如 ， 如 果 指 定 
FieldName 特性 可 以 同时 应 用 到 属性 和 字段 上 ， 可 以 编写 下 面 的 代码 : 

[AttributeUsage (AttributeTargets.Property | AttributeTargets.Field, 

AllowMultiple=false, Inherited=false)] 

Public class FieldNameAttribute: Attribute 

也 可 以 使 用 AttributeTargets.All 指定 自 定 义 特 性 可 以 应 用 到 所 有 类 型 的 程序 元 素 上 。AttributeUsage 特性 还 
包含 男 外 两 个 参数 ; AllowMultiple 和 Inherited。 它 们 用 不 同 的 语法 来 指定 :<ParameterName>==<ParameterValue>， 
而 不 是 只 给 出 这 些 参 数 的 值 。 这 些 参 数 是 可 选 的 ， 根 据 需 要 ， 可 以 忽略 它们 。 

AllowMnultiple 参数 表示 一 个 特性 是 否 可 以 多 次 应 用 到 同一 项 上 ， 这 里 把 它 设置 为 false， 表示 如 果 编 译 器 通 
到 下 述 代 码 ， 就 会 产生 一 个 错误 : 

[FieldName ("SocialSecurityNumber™")] 

[FieldName ("NationallInsuranceNumber™})] 

public string SocialSecurityNumber 


lL 
ifs 


如 果 把 Inherited 参数 设置 为 re， 就 表示 应 用 到 类 或 接口 上 的 特性 也 可 以 自动 应 用 到 所 有 派生 的 类 或 接口 
上 。 如 果 特 性 应 用 到 方法 或 属性 上 ， 它 就 可 以 目 动 应 用 到 该 方法 或 属性 等 的 重 写 版 本 上 。 


2. 指定 特性 参数 
下 面 介 绍 如 何 指定 自 定义 特性 接受 的 参数 。 在 编译 器 遇 到 下 述 语 句 时 ; 


[FieldName ("SocialSecurityNumber™")] 

public string SocialsecurityNumber 

/1 -.- 
编译 器 会 检查 传递 给 特性 的 参数 (在 本 例 中 ， 是 一 个 字符 串 )， 并 查找 该 特性 中 带 这 些 参数 的 构造 函数 。 如 果 编 
译 器 找到 一 个 这 样 的 构造 函数 ， 编 译 器 就 会 把 指定 的 元 数据 传递 给 程序 集 。 如 果 编 译 器 找 不 到 ， 就 生成 一 个 纺 
译 错误 。 如 后 面 所 述 ， 反 射 会 从 程序 集中 读 取 元 数据 (特性 )， 并 实例 化 它们 表示 的 特性 类 。 因 此 ， 编 译 右 需要 
确保 存在 这 样 的 构造 函数 ， 才 能 在 运行 期 间 实 例 化 指定 的 特性 。 

在 本 例 中 ， 仅 为 FieldNameAttribute 类 提供 一 个 构造 函数 ， 而 这 个 构造 函数 有 一 个 字符 串 参 数 。 因 此 ， 在 
把 FieldName 特性 应 用 到 一 个 属性 上 时 ， 必 须 为 它 提 供 一 个 字符 串 作 为 参数 ， 如 上 面 的 代码 所 示 。 

如 果 可 以 选择 特性 提供 的 参数 类 型 ， 束 可 以 提供 构造 函数 的 不 同 重 载 方法 ， 尽 管 一 般 是 仅 提 供 一 个 构造 函 
数 ， 使 用 属性 来 定义 任何 其 他 可 选 参数 ， 下 面 将 介绍 可 选 参数 。 

3. 指定 特性 的 可 选 参数 

在 AttributeUsage 特性 中 ， 可 以 使 用 另 一 种 语法 ， 把 可 选 参数 添加 到 特性 中 。 这 种 语法 指定 可 选 参数 的 名 
称 和 值 ， 它 通过 特性 类 中 的 公共 属性 或 字段 起 作用 。 例 如 ， 假 定 修改 SocialSecurityNumber 属性 的 定义 ， 如 下 
所 示 : 

[FieldName ("SocialSsecurityNumber", Comment="This is the primary key field")] 

public string SocialSecurityNumber { get; set; } 

77--- 

在 本 例 中 ， 编 译 器 识别 第 二 个 参数 的 语法 <ParameterName>==-ParameterValue>， 并 且 不 会 把 这 个 参数 传递 
给 FieldNameAttribute 类 的 构造 函数 ， 而 是 查找 一 个 有 该 名 称 的 公共 属性 或 字段 (最 好 不 要 使 用 公共 字段 ， 所 以 
一 般 情况 下 要 使 用 特性 )， 编 译 占 可 以 用 这 个 属性 设置 第 二 个 参数 的 值 。 如 果 希 望 上 面 的 代码 工作 ， 就 必须 给 
FieldNameAttribute 类 添加 一 些 代码 : 

[AttributeUsage (AttributeTargets.Property, 

AllowMultiple=false, Inherited=false)] 
0 class FieldNameAttribute : Attribute 
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public string Comment { getr set; } 
private string fieldName; 
Public FieldNameAttribute (string fieldName) 
{ 

fieldName = fieldname; 


} 
和 
} 


16.2.2” 自 定义 特性 示例 : WhatsNewAttributes 


本 节 开 始 编写 前 面 描述 过 的 示例 WhatsNewAttributes， 该 示例 提供 了 一 个 特性 ， 表 示 最 后 一 次 修改 程序 元 
素 的 时 间 。 这 个 示例 比 前 面 所 有 的 示例 都 复杂 ， 因 为 它 包 含 3 个 不 同 的 程序 集 : 

e WhatsNewAttributes 程序 集 一 一 它 包 含 特性 的 定义 。 

e VectorClass 程序 集 一 一 它 包 含 所 应 用 的 特性 的 代码 。 

e LookUpWhatsNew 程序 集 一 一 它 包 含 显示 已 改变 的 数据 项 详细 信息 的 项 目 。 

其 中 ， 只 有 LookUpWhatsNew 程序 集 是 目前 为 止 使 用 的 一 个 控制 台 应 用 程序 ， 其 余 两 个 程序 集 都 是 库 ， 它 
们 都 包含 类 的 定义 ， 但 都 没有 程序 的 入 口 点 。 


1. WhatsNewAttributes 库 程序 集 


首先 从 .NET 标准 库 的 核心 WhatsNewAttributes 程序 集 开始 。 其 源 代码 包含 在 WhatsNewAttributes.cs 文件 中 ， 
该 文件 位 于 本 章 示例 代码 中 WhatsNewAttributes 解决 方案 的 WhatsNewAttributes 项 目 中 。 
WhatsNewAttributes.cs 文件 定义 了 两 个 特性 类 : LastModifiedAttribute 和 SupportsWhatsNewAttribute 。 
LastModifiedAttribute 特性 可 以 用 于 标记 最 后 一 次 修改 数据 项 的 时 间 ， 它 有 两 个 必 选 参数 (这 两 个 参数 传递 给 构 
造 函 数 ); 修改 的 日 期 和 包含 描述 修改 信息 的 字符 串 。 它 还 有 一 个 可 选 参数 issues (表示 存在 一 个 公共 属性 )， 它 
可 以 用 来 描述 该 数据 项 的 任何 重要 问题 。 
在 现实 生活 中 ， 或 许 想 把 特性 应 用 到 任何 对 象 上 。 为 了 使 代码 比较 简单 ， 这 里 仅 允 许 将 它 应 用 于 类 、 方 法 
和 构造 函数 ， 并 人 允许 它 多 次 应 用 到 同一 项 上 (AllowMultiple=tue)， 因 为 可 以 多 次 修改 某 一 项 ， 每 次 修改 都 需要 
用 一 个 不 同 的 特性 实例 来 标记 。 
SupportsWhatsNew 是 一 个 较 小 的 类 ， 它 表示 不 带 任何 参数 的 特性 。 这 个 特性 是 一 个 程序 集 的 特性 ， 它 用 于 
把 程序 集 标记 为 通过 LastModifiedAttribute 维护 的 文档 。 这 样 ， 以 后 查看 这 个 程序 集 的 程序 会 知道 ， 它 读 取 的 
程序 集 是 我 们 使 用 目 动 文档 过 程 生 成 的 那个 程序 集 。 这 部 分 示例 的 完整 源 代 码 如 下 所 示 ( 代 码 文 件 
WhatsNewAttrnbutes/WhatsNewAttributes.cs): 
[AttributeUsage (AttributeTargets.Class | AttributeTargets .Method | 
LAttributeTargets.Constructor, AllowMultiple=true, Inherited=false)] 
Public class LastModifiedAttribute: Attribute 
ss readonly DateTime dateModified; 
private readonly string _changes; 
Public LastModifiedAttribute (string dateModified, string changes) 
dateModified = DateTime.Parse (dateModified); 
Changes = changes. 
} 
public DateTime DateModified => dateModified; 


public string Changes => changes; 


public string Issues { get; set; } 
} 
[AttributeUsage (AttributeTargets .Assembly)] 
Public class SupportsWhatsNewhAttribute: Attribute 


{ 
} 


根据 前 面 的 讨论 ， 这 段 代 码 应 该 相当 清楚 。 不 过 请 注意 ， 属 性 DateModified 和 Changes 是 只 读 的 。 使 用 表 
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达 式 语法 ， 编 译 器 会 创建 get 访问 器 。 不 需要 set 访问 器 ， 因 为 必须 在 构造 函数 中 把 这 些 参 数 设 置 为 必 选 参数 。 
需要 get 访问 器 ， 以 便 可 以 读 取 这 些 特性 的 值 。 


2. VectorClass 库 


.NET 标准 库 VectorClass 引用 了 WhatsNewAttributes 库 ， 添 加 using 声明 后 ， 全 局 程序 集 特性 标记 程序 集 ， 
以 支持 WhatsNew 特性 (代码 文件 VectorClass/Vector.cs): 
[assembly: SupportsWhatsNew] 
VectorClass 示例 代码 使 用 如 下 名 称 空间 : 
System 
System.Collections 
System.Collections.Generic 
WhatsNewAttributes 
下 面 是 Vector 类 的 代码 。 给 类 添加 了 一 些 LastModified 特性 ， 以 标记 更 改 : 


[LastModified("19 Jul 2017", "updated for C# 7 angd .NET Core 2"™)] 

[LastModified("6 Jun 2015", "updated for C# 6 and .NET Core") ] 

[LastModified("14 Deb 2010"™, "IEnumerable interface implemented: ™ + 
Wector can be treated as a collection"™)] 

[LastModified("10 Feb 2010", "IFormattable interface jmplemented ™ 十 
"Vector accepts N and VE format specifiers"™")] 

Public class Vector : IFormattable, IEnumerable<double> 

{ 
Public Vector (double x, double y, double z) 


{ 
六 二 瑞 六 
Ls 
.二 工 ; 
} 


[LastModified({("19 Jul 2017", "Reduced the number of code lines")] 
Public Vector (Vector vector) 
: this (vector.X, vector.Y, vector.2 { } 


public double X { get; } 
Public double Y { get; } 
Public double 2 { get; } 


Public string ToString (string format, IFormatProvider formatProvider) 
{ 
fe 
还 标记 了 被 包含 的 VectorEnumerator 类 : 


[LastModified("™6 Jun 2015", 

"Changed to implement the generic interface IEnumerator<T>")] 
[LastModified("l14 Feb 2010"™, 

"Class created as part of collection support for Vector") ] 
private class VectorEnumerator : IEnumerator<double> 


{ 
该 库 的 版 本 号 在 csproj 项 目 文件 中 定义 (项 目 文件 VectorClass/VectorClass.csproj): 
PropertyGroup> 
<TargetFramework>netstandard?2 .0</TargetFramework> 
<Version>2.1.0</Versiony> 
</PropertyGroup> 
上 面 是 这 个 示例 的 代码 。 目 前 还 不 能 运行 它 ， 因 为 我 们 只 有 两 个 库 。 在 描述 了 反射 的 工作 原理 后 ， 就 介绍 
这 个 示例 的 最 后 一 部 分 ， 从 中 可 以 查看 和 显示 这 些 特性 。 


16.3 反射 


本 节 先 介绍 System.Type 类 ,通过 这 个 类 可 以 访问 关于 任何 数据 类 型 的 信息 。 然 后 简要 介绍 System .Reflection. 
Assembly 类 ， 它 可 以 用 于 访问 给 定 程 序 集 的 相关 信息 ， 或 者 把 这 个 程序 集 加 载 到 程序 中 。 最 后 把 本 节 的 代码 和 
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上 一 节 的 代码 结合 起 来 ， 完 成 WhatsNewAttributes 示例 。 
16.3.1 System.Type 类 
这 里 使 用 Type 类 只 为 了 存储 类 型 的 引用 : 


Type t = typeof (double); 

我 们 以 前 把 Type 看 作 一 个 类 ， 但 它 实 际 上 是 一 个 抽象 的 基 类 。 只 要 实例 化 了 一 个 Type 对 象 ， 实 际 上 就 实 
例 化 了 Type 的 一 个 派生 类 。 尽 管 一 般 情 况 下 派生 类 只 提供 各 种 Type 方法 和 属性 的 不 同 重 载 ， 但 是 这 些 方 法 和 
属性 返回 对 应 数据 类 型 的 正确 数据 ，Type 有 与 每 种 数据 类 型 对 应 的 派生 类 。 它 们 一 般 不 添加 新 的 方法 或 属性 。 
通常 ， 获 取 指 向 任何 给 定 类 型 的 Type 引用 有 3 种 常用 方式 : 

e 使 用 C# 的 typeof 运算 符 ， 如 上 述 代 码 所 示 。 这 个 运算 符 的 参数 是 类 型 的 名 称 (但 不 放 在 引号 中 )。 

e 使 用 GetType0 方 法 ， 所 有 的 类 都 会 从 System.Object 继承 这 个 方法 。 


double d = 10; 
TYPe t = d.cetType (}); 


在 一 个 变量 上 调用 GetType0 方 法 ， 而 不 是 把 类 型 的 名 称 作为 其 参数 。 但 要 注意 ， 返 回 的 Type 对 象 仍 只 与 
该 数据 类 型 相关 : 它 不 包含 与 该 类 型 的 实例 相关 的 任何 信息 。 如 果 引 用 了 一 个 对 象 ， 但 不 能 确保 该 对 象 实 际 上 
是 哪个 类 的 实例 ，GetType 方法 就 很 有 用 。 
e 还 可 以 调用 Type 类 的 静态 方法 GetType0: 
TYPe 七 = Type.GetType ("System.Double"™).; 
Type 是 许多 反射 功能 的 入 口 。 它 实现 许多 方法 和 属性 ， 这 里 不 可 能 列 出 所 有 的 方法 和 属性 ， 而 主要 介绍 如 
何 使 用 这 个 类 。 注意 , 可 用 的 属性 都 是 只 读 的 : 可 以 使 用 Type 确定 数据 的 类 型 , 但 不 能 使 用 它 修改 该 类 型 ! 


1. Type 的 属性 


由 Type 实现 的 属性 可 以 分 为 下 述 三 类 。 首 先 ， 许 多 属性 都 可 以 获取 包含 与 类 相关 的 各 种 名 称 的 字符 串 ， 如 
表 16-1 所 示 。 


表 16-1 
属 性 返回 值 
Name 数据 类 型 名 
FullName 数据 类 型 的 完全 限定 名 (包括 名 称 空间 名 ) 
Namespace 在 其 中 定义 数据 类 型 的 名 称 空间 名 


其 次 ， 属 性 还 可 以 进一步 获取 Type 对 象 的 引用 ， 这 些 引 用 表示 相关 的 类 ， 如 表 16-2 所 示 。 


表 16-2 
属 性 返回 对 应 的 Type 引用 
BaseType 该 Type 的 直接 基本 类 型 
UnderlyingSystemType 该 Type 在 NET 运 行 库 中 映射 到 的 类 型 ( 某 些 NET 基 类 实际 上 映射 到 由 工 识别 的 特定 预定 


义 类 型 )。 这 个 成 员 只 能 在 完整 的 框架 中 使 用 


许多 布尔 属性 表示 这 种 类 型 是 一 个 类 , 还 是 一 个 枚 举 等 。 这 些 特性 包括 Abstract\ IsArray、 IsClass、 IsEnum、 
IsInterface、IsPointer、IsPrimitive( 一 种 预定 义 的 基 元 数据 类 型 )、IsPublic、IsSealed 以 及 IsValueType。 例 如 ， 使 
用 一 种 基 元 数据 类 型 : 

Type intType = typeof (Int) ; 

Console.WriteLine (intType.IshAbstract); // writes false 


Console.WriteLine (intType.IsClass}); // writes false 
Console.WriteLine (intType.IsEnum); // writes false 
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Console -WriteLine (intType.IsPrimitive); // writes true 
Console .WriteLine (intType.IsValueType)}); // writes true 


或 者 使 用 Vector 类 : 

TYPe vecType = typeof (Vector):; 

Console .WriteLine (vecType.IsAbstract}; // writes false 
Console .WriteLine (vecType.IsClass}); // writes true 
Console .WriteLine (vecType.IsEnum); // writes false 
Console .WriteLine (vecType.IsPrimitive}); // writes false 
Console .WriteLine (vecType.IsVvalueType}); // writes false 


也 可 以 获取 在 其 中 定义 该 类 型 的 程序 集 的 引用 ， 该 引用 作为 System.Reflection.Assembly 类 的 实例 的 一 个 引 
用 来 返回 : 


TYPe 七 = typeof (Vector): 
Assembly containingAssembly = new Assembly(t); 


2. 万 法 

System.Type 的 大 多 数 方法 都 用 于 获取 对 应 数据 类 型 的 成 员 信息 : 构造 函数 、 属 性 、 方 法 和 事件 等 。 它 有 许 
多 方法 ， 但 它们 都 有 相同 的 模式 。 例 如 ， 有 两 个 方法 可 以 获取 数据 类 型 的 方法 的 细节 信息 : GetMethod0 和 
GetMethods()。GetMethod0 方 法 返回 System.Reflection.MethodInfo 对 象 的 一 个 引用 ， 其 中 包含 一 个 方法 的 细节 
信息 。GetMethods0 方 法 返回 这 种 引用 的 一 个 数组 。 其 区 别 是 GetMethods0 方 法 返回 所 有 方法 的 细节 信息 ; 而 
GetMethod0 方 法 返回 一 个 方法 的 细节 信息 ， 其 中 该 方法 包含 特定 的 参数 列表 。 这 两 个 方法 都 有 重 载 方法 ， 重 载 
方法 有 一 个 附加 的 参数 ， 即 BindingFlags 枚 举 值 ， 该 值 表示 应 返回 哪些 成 员 ， 例 如 ， 返 回 公 有 成 员 、 实 例 成 员 

例如 ，GetMethods0 方 法 的 最 简单 的 一 个 重 载 方 法 不 带 参 数 ， 返 回 数据 类 型 的 所 有 公共 方法 的 信息 ; 


TYPe 二 = typeof (double):; 
foreach (MethodIinfo nextMethod in t.GetMethods(}) 


| 
jh ass 
} 
Type 的 成 员 方 法 如 表 16-3 所 示 ， 遵 循 同一 个 模式 。 注 意 名 称 为 复数 形式 的 方法 返回 一 个 数组 。 
表 16-3 
返回 的 对 象 类 型 方 ”法 

ConstmctorImfo GetConstructor().GetConstrmmctorsO| 
EventInto GetEvent(),.GetEvents() 
FieldInfo GetField().GetFields() 
MemberInfo GetMember(),GetMembers(|).GetDefaultMembers() 
MethodInfo GetMethod().GetMethods() 
PropertyInto GetProperty(),GetProperties() 


GetMember0 和 GetMembers0 方 法 返回 数据 类 型 的 任何 成 员 或 所 有 成 员 的 详细 人 信息， 不管 这 些 成 员 是 构造 
函数 、 属 性 和 方法 等 。 


16.3.2 TypeView 示例 


下 面 用 一 个 短小 的 示例 TypeView 来 说 明 Type 类 的 一 些 功 能 , 这 个 示例 可 以 用 来 列 出 数据 类 型 的 所 有 成 员 。 
本 例 主要 说 明 对 于 double 型 TypeView 的 用 法 ， 也 可 以 修改 该 样 例 中 的 一 行 代码 ， 使 用 其 他 的 数据 类 型 。 
运行 应 用 程序 的 结果 输出 到 控制 台 上 ， 如 下 : 


Analysis of type Double 
TYPe Name: Double 

FU Name: SyYSstem.Double 
Namespace: SYStem 
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= 
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Base Type: ValueType 
members: 


public 


SYStem. 
SYS3stem. 
SYStem. 
SYStLem - 
SySstem. 
SYStem. 
SYStem. 
SYS3tem. 
SYStLem - 
SYStem. 
SYSstem. 
SYStem. 
SySstem. 
SySstem. 
SYS3tem. 
SYStem. 
SYS3tem. 
SySstem. 
SYS3stem. 
SYStem. 
SYS3tem. 
SYStLem - 
System. 
SYStem. 
SYStem. 
SYS3tem. 
SySstem. 
SYS3stem. 
SYStem. 
SYStem. 
SySstem. 
SySstem. 
SYStem. 


Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Double 
Object 
Double 
Double 
Double 
Double 
Double 
Double 


Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 
Field 
Field 
Field 
Field 
Field 
Field 


IsInfinity 
IsPoOSsitiveInfinity 
IsNegativeInfinity 
ISsNaN 

CompareTo 
CompareTo 

Equals 

op Equality 

op Inequality 

op LessThan 

op GreaterThan 

op LessThanOrEqual 
op GreaterThanorEqual 
Equals 

GetHashCode 
ToString 

ToString 

ToString 

ToSsString 

Parse 

Parse 

Parse 

Parse 

TryParse 

TIvParse 
GetTyYpPeCode 
GetType 


Minvalue 
MaxValue 

EpSilon 
NegativeInfinity 
PositiveInfinity 
NaN 


控制 台 显 示 了 数据 类 型 的 名 称 、 全 名 和 名 称 空 间 ， 以 及 底层 类 型 的 名 称 。 然 后 ， 它 迭代 该 数据 类 型 的 所 有 
公有 实例 成 员 ， 显 示 所 声明 类 型 的 每 个 成 员 、 成 员 的 类 型 (方法 、 字 段 等 ) 以 及 成 员 的 名 称 。 声 明 类 型 是 实际 声 
明 类 型 成 员 的 类 的 名 称 (例如 ， 如 果 在 System.Double 中 定义 或 重 载 它 ， 该 声明 类 型 就 是 System.Double， 如 果 成 
员 继 承 目 茶 个 基 类 ， 该 声明 类 型 就 是 相关 基 类 的 名 称 )。 

TypeView 不 会 显示 方法 的 签名 ， 因 为 我 们 是 通过 MemberInfo 对 象 获取 所 有 公有 实例 成 员 的 详细 信息 ， 参 
数 的 相关 信息 不 能 通过 MemberInfo 对 象 来 获得 。 为 了 获取 该 信息 , 需要 引用 MemberInfo 和 其 他 更 特殊 的 对 象 ， 
即 需 要 分 别 获取 每 一 种 类 型 的 成 员 的 详细 信息 。 

TypeView 的 示例 代码 使 用 如 下 名 称 空间 : 

System 
System.Retlection 
System. [Text 

TypeView 会 显示 所 有 公有 实例 成 员 的 详细 信息 ， 但 对 于 double 类 型 ， 仅 定义 了 字段 和 方法 。 全 部 代码 都 
放 在 Program 一 个 类 中 ， 这 个 类 包含 两 个 静态 方法 和 一 个 静态 字段 ，StringBuilder 的 一 个 实例 称 为 OutputText， 
OutputText 用 于 创建 在 消息 框 中 显示 的 文本 。Main0 方 法 和 类 的 声明 如 下 所 示 (代码 文件 TypeView/Progranm.cs): 


class Program 
{ 
private static StringBuilder OutputText = new StringBuilder(}); 
static void Main() 
{ 
/:/ modify this line to retrieve details of any other data type 
Type tt = typeof (double); 
AnalyzeType (七 ) ; 
Console.WriteLine($"Analysis of type {t.Name}").; 
Console.WriteLine (OutputText .ToString (})}); 
Console.ReadLine (}); 
} 
i 
} 


实现 的 Main0 方 法 首先 声明 一 个 Type 对 象 ， 来 表示 我 们 选择 的 数据 类 型 ， 再 调用 方法 AnalyzeType0， 
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AnalyzeType0 方 法 从 Type 对 象 中 提取 信息 ， 并 使 用 该 信息 构建 输出 文本 。 最 后 在 控制 台中 显示 输出 。 这 些 都 由 
AnalyzeType0 方 法 完成 : 
static void AnalyzeType (Type 七 ) 
{ 
TYPpeInfo typeInfo = t.GetTypelInfol(); 
AddToOutput ($"Type Name: {t.Name}"),; 
AddToOutput ($"Full Name: {t.FullName}"); 
AddToOutput ($"Namespace: {t.Namespace}"); 
Type tBase = t.BaseTypes 
1f (tBase != null) 
{ 
AddToOutput ($"Base Type: {tBase.Name}"); 
} 


addTooutput ("\npublic members:"); 
foreach (MemberIinfo NextMember in t.GetMembers'()) 


AddToOutput ($" {member.DeclaringType} {member.MemberType} {member.Name}"™"); 
} 
} 
实现 AnalyzeType0 方 法 ， 仅 需要 调用 Type 对 象 的 各 种 属性 ， 就 可 以 获得 我 们 需要 的 类 型 名 称 的 相关 信息 ， 
再 调用 GetMembers0 方 法 ， 获 得 一 个 MemberInfo 对 象 的 数组 ， 该 数组 用 于 显示 每 个 成 员 的 信息 。 注 意 ， 这 里 使 用 
了 一 个 辅助 方法 AddToOutput0， 该 方法 创建 要 显示 的 文本 : 


static void AddToOutput (string Text) => 
OutputText.Append(™\n™. + Text); 


16.3.3 Assembly 类 


Assembly 类 在 System.Reflection 名 称 空间 中 定义 ， 它 允许 访问 给 定 程序 集 的 元 数据 ， 它 也 包含 可 以 加 载 和 
执行 程序 集 (假定 该 程序 集 是 可 执行 的 ) 的 方法 。 与 Type 类 一 样 ，Assembly 类 包含 非常 多 的 方法 和 属性 ， 这 里 
不 可 能 逐一 论述 。 下 面 仅 介绍 完成 WhatsNewAttributes 示例 所 需要 的 方法 和 属性 。 

在 使 用 Assembly 实例 做 一 些 工 作 前 ， 需 要 把 相应 的 程序 集 加 载 到 正在 运行 的 进程 中 。 为 此 ， 可 以 使 用 静态 
成 员 Assembly.Load0 或 AssemblyLoadFrom0。 这 两 个 方法 的 区 别 是 Load0 方 法 的 参数 是 程序 集 的 名 称 , 运行 库 
会 在 各 个 位 置 上 搜索 该 程序 集 ， 试 图 找到 该 程序 集 ， 这 些 位 置 包 括 本 地 目录 和 全 局 程序 集 缓存 。 而 LoadFrom( 
方法 的 参数 是 程序 集 的 完整 路 径 名 ， 它 不 会 在 其 他 位 置 搜索 该 程序 集 : 

Assembly assemblyl = Assembly.Load("SomeAssembly"); 


Assembly assembly2 = BAssembly.LoadFrom 
(GQ"C:\My Projects\Software\SomeOtherAssembly"); 


这 两 个 方法 都 有 许多 其 他 重 载 版 本 ， 它 们 提供 了 其 他 安全 信息 。 加 载 了 一 个 程序 集 后 ， 就 可 以 使 用 它 的 各 
种 属性 进行 查询 ， 例 如 ， 查 找 它 的 全 名 


string name = assemblyl .FullName; 

1. 获取 在 程序 集中 定义 的 类 型 的 详细 信息 

Assembly 类 的 一 个 功能 是 它 可 以 获得 在 相应 程序 集中 定义 的 所 有 类 型 的 详细 信息 ， 只 要 调用 
Assembly.GetIypes0 方 法 ， 它 就 可 以 返回 一 个 包含 所 有 类 型 的 详细 信息 的 System.Type 引用 数组 ， 然 后 就 可 以 按 
照 上 一 节 的 方式 处 理 这 些 Type 引用 : 


TYPe[] tvypes = theBAssembly.GetTypes(); 
foreach (Type definedType in types) 
{ 

DosomethingWith (definedType); 


2. 获取 上 自 定义 特性 的 详细 信息 
用 于 查找 在 程序 集 或 类 型 中 定义 了 什么 日 定 义 特 性 的 方法 取决 于 与 该 特性 相关 的 对 象 类 型 。 如 果 要 确定 程序 
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集 从 整体 上 关联 了 什么 自 定 义 特性 ， 就 需要 调用 Attribute 类 的 一 个 静态 方法 GetCustomAttributes0， 给 它 传递 
程序 集 的 引用 : 
Attribute[] definedAttributes = 


Attribute.GetCustomAttributes (assembly]l).; 
// assemblyl is an Assembly object 


注意 : 

这 是 相当 重要 的 。 以 前 你 可 能 想 知道 ， 在 定义 自 定义 特性 时 ， 为 什么 必须 费 尽 周折 为 它们 编写 类 ， 以 及 为 
什么 Microsoft 没有 更 简单 的 语法 。 答案 就 在 于 此 。 自 定义 特性 确实 与 对 象 一 样 ， 加 载 了 程序 集 后 ， 就 可 以 读 取 
这 些 特性 对 象 ， 查 看 它们 的 属性 ， 调 用 它们 的 方法 。 


GetCustomAttributes0 方 法 用 于 获取 程序 集 的 特性 ， 它 有 两 个 重 载 方法 : 如 果 在 调用 它 时 ， 除 了 程序 集 的 引 
用 外 ， 没 有 指定 其 他 参数 ， 该 方法 就 会 返回 为 这 个 程序 集 定 义 的 所 有 目 定 义 特 性 。 当然， 也 可 以 通过 指定 第 二 
个 参数 来 调用 它 ， 第 二 个 参数 是 表示 感 兴趣 的 特性 类 的 一 个 Type 对 象 ， 在 这 种 情况 下 ，GetCustomAttributes() 
方法 就 返回 一 个 数组 ， 该 数组 包含 指定 类 型 的 所 有 特性 。 

注意 ， 所 有 特性 都 作为 一 般 的 Attribute 引用 来 获取 。 如 果 要 调用 为 目 定义 特性 定义 的 任何 方法 或 属性 ， 就 需 
要 把 这 些 引 用 显 式 转换 为 相关 的 自 定 义 特 性 类 。 调 用 AssemblyGetCustomAttributes0 的 另 一 个 重 载 方法 ， 可 以 获 
得 与 给 定数 据 类 型 相关 的 目 定义 特性 的 详细 信息 , 这 次 传递 的 是 一 个 Type 引用 , 它 摘 述 了 要 获取 的 任何 相关 特 
性 的 类 型 。 另 一 方面 ， 如 果 要 获得 与 方法 、 构 造 函 数 和 字段 等 相关 的 特性 ， 就 需要 调用 GetCustomAttributes(0 方 
法 ， 该 方法 是 MethodInfo、ConstructorInfo 和 FieldInfo 等 类 的 一 个 成 员 。 

如 果 只 需要 给 定 类 型 的 一 个 特性 ， 就 可 以 调用 GetCustomAttribute0 方 法 ， 它 返回 一 个 Attribute 对象。 在 
WhatsNewAttributes 示例 中 使 用 GetCustomAttribute(0) 方 法 ,是 为 了 确定 程序 集中 是 否 有 SupportsWhatsNew 特性 。 
为 此 , 调用 GetCustomAttribute0 方 法 , 传递 对 WhatsNewAttributes 程序 集 的 一 个 引用 和 SupportsWhatsNewAttribute 
特性 的 类 型 。 如 果 有 这 个 特性 ， 就 返回 一 个 Attribute 实例 。 如 果 在 程序 集中 没有 定义 任何 实例 ， 就 返回 null。 如 果 
找到 两 个 或 多 个 实例 ，GetCustomAttribute0 方 法 就 抛 出 一 个 System Reflection .AmbiguousMatchException 异常 。 该 调 
用 如 下 所 示 : 


Attribute supportsAttribute = 
Attribute.GetcustomAttrilbutes (assemblyl, typeof (SupportsWhatsNewAttribute))}),; 


16.3.4 完成 WhatsNewAttributes 示例 


现在 已 经 有 足够 的 知识 来 完成 WhatsNewAttributes 示例 了 .为 该 示例 中 的 最 后 一 个 程序 集 LookupWhatsNew 
编写 源 代码 ， 这 部 分 应 用 程序 是 一 个 控制 台 应 用 程序 ， 它 需要 引用 其 他 两 个 程序 集 WhatsNewAttributes 和 
VectorClass。 
LookupWhatsNew 项 目的 示例 代码 引用 了 WhatsNewAttributes 和 VectorClass 库 ， 使 用 了 如 下 名 称 空间 : 
System 
System.Collections.Generic 
System.Ling 
System.Retlection 
System. [Text 
WhatsNewAttributes 
Program 类 包含 主 程序 入 口 点 和 其 他 方法 。 我 们 定义 的 所 有 方法 都 在 这 个 类 中 ， 它 还 有 两 个 静态 字段 : 
outputText 和 backDateTo。outputText 字段 包含 在 准备 阶段 创建 的 文本 ， 这 个 文本 要 写 到 消息 框 中 ，backDateTo 
字段 存储 了 选择 的 日 期 一 -自从 该 日 期 以 来 进行 的 所 有 修改 都 要 显示 出 来 。 一 般 情 况 下 ， 需 要 显示 一 个 对 话 框 ， 
让 用 户 选择 这 个 日 期 ， 但 我 们 不 想 编 写 这 种 代码 ， 以 免 转移 读者 的 注意 力 。 因 此 ， 把 backDateTo 字段 硬 编码 为 
日 期 2017 年 2 月 1 日 。 在 下 载 这 段 代 码 时 ， 很 容易 修改 这 个 日 期 (代码 文件 LookupWhatsNew/Program.cs):: 
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class Program 

{ 
private static readonly StringBuilder outputText = new StringBuilder (1000}); 
private static DateTime backDateTo = new DateTime (2017, 2, 1);} 


static void Maint) 
{ 
Assembly theAssembly = Assembly.Load (new AssemblyName ("VectorClass"™)); 
Attribute supportsAttribute = theAssembly.GetcustomAttributel 
typeof (SupportsWhatsNewAttribute)):; 


AddToOutput ($"Assembly: {theAssembly.FullName}"); 


if (supportsAttribute == null) 

{ 
AddToOutput ("This assembly does not support WhatsNew attributes"™),; 
returns 

} 

全] 三 

{ 
AddToOutput ("Defined Types:"); 

} 


IEnumerable<Type> types = theAssembly.ExportedTypes; 
foreach (Type definedType in types) 
{ 
DisplayTypeInfo (definedType); 
} 


Console .WriteLine (S$"What\‘s New Since {backDateTo:D}"); 
Console.WriteLine (outputText .ToString()); 
Console.ReadLine ()，; 


a 
} 


Main0 方 法 首先 加 载 VectorClass 程序 集 , 验证 它 是 否 用 SupportsWhatsNew 特性 标记 。 我 们 知道 , VectorClass 
程序 集 应 用 了 SupportsWhatsNew 特性 ， 虽然 才 编 译 了 该 程序 集 , 但 进行 这 种 检查 还 是 必要 的 ， 因 为 用 尸 可 能 项 
望 检查 这 个 程序 集 。 

验证 了 这 个 程序 集 后 ， 使 用 Assembly.ExportedTypes 属性 获得 一 个 集合 ， 其 中 包括 在 该 程序 集中 定义 的 所 
有 类 型 ， 然 后 在 这 个 集合 中 遍历 它们 。 对 每 种 类 型 调用 一 个 方法 一 一 DisplayTypeImfo0， 它 给 outputText 字段 添 
加 相关 的 文本 ， 包 括 LastModifiedAttribute 类 的 任何 实例 的 详细 信息 。 最 后 ， 显 示 带 有 完整 文本 的 控制 台 。 
DisplayTypeImfo0 方 法 如 下 所 示 ( 代 码 文件 LookupWhatsNew/Program.cs): 


private static void DisplayTypeInfo (TYPe type) 
{ 
// make sure we only pick out classes 
if (!'type.GetTypeInfo() -IsClass) ) 
{ 
return; 


} 
AddToOutput ($"{Environment.NewLine}class {type.Name}"); 


IEnumerable<LastModifijedAttrilbute> lastModifiedAttributes = 
type.GetTypeInfo() .GetCcustomaAttributes () 
.OfType<LastModifiedAttribute> () 

-Wherel(a => a.DateModified >= backDateTo) .ToArray(); 


if (attributes.Count() == 0) 
{ 
addTooutput ($"\tNo changes to the class {type.Name}"™ + 
Ss"T{Environment .NewLine}"™):; 
】 
全 二 扎 忆 
{ 
foreach (LastFieldModifiedAttribute attribute in lastModifiedattributes) 
{ 
WriteAttributeInfol(attribute}),; 
} 
】 


AddToOutput ("changes to methods of this class:"); 
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foreach (MethodInfo method In 
type.cGetTypeInfo() .DeclaredMembers .OfType<MethodInfo>()) 
{ 
IEnumerable<LastModifijedaAttribute> attributesToMethods = 
method.GetCustomattributes () .ofType<LastModifiedAttribute> () 
.Where(a => a.DateModified >= backDateTo) .ToArray(); 


if (attributesToMethods.Ccount{()} > 0) 

{ 
AddToOutput ($"{method.ReturnType} {method.Name} ()}"); 
foreach (Attribute attribute in attributesToMethods) 
{ 

WriteaAttributeInfot(attribute}):; 

} 

} 

} 
} 


注意 ， 在 这 个 方法 中 ， 首 先 应 检查 所 传递 的 Type 引用 是 否 表 示 一 个 类 。 因 为 ,为 了 简化 人 代码， 指定 
LastModified 特性 只 能 应 用 于 类 或 成 员 方 法 ， 如 果 该 引用 不 是 类 ( 它 可 能 是 一 个 结构 、 委 托 或 枚 举 )， 那 么 进行 任 
何 处 理 都 是 浪费 时 间 。 

接 痢 使 用 type.GetTypeInfo().GetCustomAttributes0 方 法 确定 这 个 类 是 否 有 相关 的 LastModifiedAttribute 实 
例 。 如 果 有 ， 就 使 用 辅助 方法 WriteAttributeInfo0 把 它们 的 详细 信息 添加 到 输出 文本 中 。 

最 后 ， 使 用 TypeImfo 类 型 的 DeclaredMembers 属性 遍历 这 种 数据 类 型 的 所 有 成 员 方 法 ， 然 后 对 每 个 方法 进 
行 相同 的 处 理 (类 似 于 对 类 执行 的 操作 ): 检查 每 个 方法 是 否 有 相关 的 LastModifiedAttribute 实例 ， 如 果 有 ， 就 用 
WiiteAttributeInfo0 方 法 显示 它们 。 

下 面 的 代码 显示 了 WriteAttributeInfo(0 方 法 , 它 负责 确定 为 给 定 的 LastModifiedAttribute 实例 显示 什么 文本 ， 
注意 因为 这 个 方法 的 参数 是 一 个 Attribute 引用 ， 所 以 需要 先 把 该 引用 强制 转换 为 LastModifiedAttribute 引用 。 
之 后 ， 就 可 以 使 用 最 初 为 这 个 特性 定义 的 属性 获取 其 参数 。 在 把 该 特性 添加 到 要 显示 的 文本 中 之 前 ， 应 检查 特 
性 的 日 期 是 否 是 最 近 的 (代码 文件 LookupWhatsNew/Program .cs): 


private static void WriteAttributeInfo(Attribute attribute) 


{ 
if (attribute is LastModifiedAattribute lastModifiedAttributey 
{ 
AddToOutput ($"\tmodified: {lastModifiedAttrilbute.DateModified:D}: ™ + 
ss"{lastModifiedAttribute.cCchanges}").; 
if (lastModifiedAttribute.Issues != null) 
{ 
AddToOutput ($"\tOutstanding issues: {lastModifiedattribute.Issues}"); 
} 
} 
} 


最 后 ， 是 辅助 方法 AddToOutput 0: 


static void AddToOutput (string text) =»> 
outputText .Append ($"{Environment .NewLine} {text}"); 


运行 这 段 代码 ， 得 到 如 下 结果 : 


What s New Since Wednesday, February 1, 2017 
Assembly: VectorClass, Version=2.1.0.0, Culture=neutral, PublicKeyToken=null 
Defined Types: 


Class Vector 
modified: Wednesday, July 19, 2017: updated for C# 7 and .NET Core 2 
changes to methods of this class: 
System.SsString ToString() 
modified: Wednesday, July 19, 2017: changed 1ijk format from StringBuilder to format string 


注意 , 在 列 出 VectorClass 程序 集中 定义 的 类 型 时 , 实际 上 选择 了 两 个 类 : Vector 类 和 内 账 的 VectorEnumerator 
类 。 还 要 注意 ， 这 段 代 码 把 backDateTo 日 期 硬 编码 为 2 月 1 日 ， 实 际 上 选择 的 是 日 期 为 7 月 19 日 的 特性 (添加 
集合 支持 的 时 间 )， 而 不 是 前 述 日 期 。 
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16.4 ”为 反射 使 用 动态 语言 扩展 


前 面 一 直 使 用 反射 来 读 取 元 数据 。 还 可 以 使 用 反射 ， 从 编译 时 还 不 清楚 的 类 型 中 动态 创建 实例 。 下 一 个 示 
例 显示 了 创建 Calculator 类 的 一 个 实例 ， 而 编译 器 在 编译 时 不 知道 这 种 类 型 。 程 序 集 CalculatorLib 是 动态 加 载 
的 ， 没 有 添加 引用 。 在 运行 期 间 ， 实 例 化 Calculator 对 象 ， 调 用 方法 。 知 道 如 何 使 用 ReflectionAPI 后 ， 使 用 C# 
dynamic 关键 字 可 以 完成 相同 的 操作 。 这 个 关键 字 目 C# 4 版 本 以 来 ， 就 成 为 C# 语 言 的 一 部 分 。 


16.4.1 创建 Calculator 库 


要 加 载 的 库 是 一 个 简单 的 类 库 ， 包 含 Calculator 类 型 与 Add 和 Subtract 方法 的 实现 代码 。 因 为 方法 是 很 简 
单 的 ， 所 以 它们 使 用 表达 式 语法 实现 (代码 文件 CalculatorLib/Calculator.cs): 


Public class Calculator 
{ 
Public double Add (double x, double Y) => x + yr 
PUublic double Subtract (double XxXx, double vy) => XxX 一 Yi 
} 


编译 库 后 ， 将 DLL 复制 到 文件 夹 c:/addins。 


16.4.2 ”动态 实例 化 类 型 


为 了 使 用 反射 动态 创建 Calculator 实例 ， 应 创建 一 个 Console App (NET Core)， 命 名 为 ClientApp。 

常量 CalculatorTypeName 定义 了 Calculator 类 型 的 名 称 , 包括 名 称 空 间 。Main0 方 法 需要 一 个 命令 行 参数 指 
定 库 的 路 径 ， 然 后 调用 UsingReflection 和 UsingReflectionWithDynamic 方法 ， 这 两 个 变 体 进行 反射 (代码 文件 
DynamicSamples/ClientApp/Proeram.cs): 


class Program 
{ 
Private const string CalculatorIypeName = "CalculatorLib.Calculator™; 


static void Main{(string[] args) 
{ 
if (args.Length != 1) 
{ 
ShowUsage () ; 
returns 
} 
UsingReflection (args [0]); 
UsingReflectionWithDynamic(args[0]).; 
} 


private static void ShowUsage () 
{ 
Console.WriteLine($"Usage: {nameof (ClientApp)} path™); 
Console .WriteLine{():; 
Console.WriteLine{("Copy CalculatorLib.dll to an addin directory"™); 
Console.WriteLine("and pass the absolute path of this directory ™ 十 
"when starting the application to load the library™); 
} 


在 使 用 反射 调用 方法 之 前 , 需要 实例 化 Calculator 类 型 .GetCalculator 方法 使 用 Assembly 类 的 方法 LoadFile 
动态 加 载 程序 集 ， 并 使 用 CreateInstance 方法 创建 一 个 Calculator 类 型 的 实例 : 
private static object GetCalculator() 


Assembly assembly = Assembly.LoadFile (CalculatorLibPath).; 
return assembly.Createlnstance (CalculatorIvypeName) ; 


} 
ClientApp 的 示例 代码 使 用 了 以 下 依赖 项 和 .NET 名 称 空间 : 
依赖 项 


System.Runtime.Loader 
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.NET 名 称 空间 
Microsott.CSharp.RuntimeBmder 
System 

System.Retlection 


16.4.3 用 Reflection API 调用 成 员 


接 下 来 ， 使 用 Reflection API 调用 Calculator 实例 的 方法 Add0。 首 先 ，Calculator 实例 使 用 辅助 方法 
GetCalculator0 来 检索 。 如 果 想 添加 对 CalculatorLib 的 引用 ， 可 以 使 用 new Calculator 创建 一 个 实例 。 但 这 并 不 
是 那么 容易 。 

使 用 反射 调用 方法 的 优点 是 ， 类 型 不 需要 在 编译 期 间 可 用 。 只 要 把 库 复制 到 指定 的 目录 中 ， 就 可 以 在 稍 后 
添加 它 。 为 了 使 用 反射 调用 成 员 ， 利 用 GetType 方法 检索 实例 的 Type 对 象 一 一 它 是 基 类 Object 的 方法 。 通 过 
扩展 方法 GetMethod0( 这 个 方法 在 NuGet 包 System.Reflection.TypeExtensions 中 定义 ) 访问 MethodInfo 对 象 的 
Add0 方 法 。MethodInfo 定义 了 Invoke() 方 法 ， 使 用 任意 数量 的 参数 调用 该 方法 。Invoke0 方 法 的 第 一 个 参数 需 
要 调用 成 员 的 类 型 的 实例 。 第 二 个 参数 是 object[] 类 型 , 传递 调用 所 需 的 所 有 参数 。 这 里 传递 x 和 yy 变量 的 值 ( 代 
码 文件 DynamicSamples/ClientApp/Program.cs): 


private static void UsingReflection() 
{ 

double Xx = 3; 

double y = 4; 

object calc = GetcCalculator (); 


object result = calc.GetTIype() .GetMethod("Add") 
.Invoke (calc, new object[] { x, vy }); 
Console.WriteLine($"the result of {x} and {vy} is {result}"); 


} 
运行 该 程序 ， 调 用 计算 器 ， 结 果 写 入 控制 台 : 
The result of 3 and 4 is 7 


动态 调用 成 员 有 很 多 工作 要 做 。 下 一 节 看 看 如 何 使 用 dynamic 关键 字 。 


16.4.4 ”使 用 动态 类 型 调用 成 员 


使 用 反射 和 dynamic 关键 字 ， 从 GetCalculator 方法 返回 的 对 象 分 配给 一 个 dynamic 类 型 的 变量 。 该 方法 本 
喘 没有 改变 ， 它 还 返回 一 个 对 象 。 结 果 返 回 给 一 个 dynamic 类 型 的 变量 。 现 在 ， 调 用 Add 方法 ， 给 它 传递 两 个 
double 值 (代码 文件 DynamicSamples/ClientApp/Program.cs): 


private static void ReflectiIonNew() 
{ 
double KK = 3}; 
double Y¥ = 4; 
dynamic calc = GetCalculator'().; 
double result = calc.Add (x, vv); 
Console.WriteLine{($"the result of {x} and {vy} is {result}"); 


} 

语法 很 简单 ， 看 起 来 像 是 用 强 类 型 访问 方式 调用 一 个 方法 。 然 而 ，Visual Studio 没有 提供 智能 感知 功能 ， 
因为 可 以 立即 在 Visual Studio 编辑 器 中 看 到 编码 ， 所 以 很 容易 出 现 拼写 错误 。 

也 没有 在 编译 时 进行 检查 。 调 用 Multiply 方法 时 ， 编 译 器 运行 得 很 好 。 只 需要 记 住 ， 定 义 了 计算 器 的 Add 
和 Subtract 方法 。 


tryY 
{ 

result = calc.Muyultiply (x, vy); 
} 


catch (RUuNntimeBinderException ex) 


Console .WriteLine (ex); 
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运行 应 用 程序 ， 调 用 Multiply 方法 ， 就 会 得 到 一 个 RuntimeBinderException 寞 音 : 


Microsoft.cSharp.RuntimeBinder.RuntimeBinderException: "CalculatorLib.Calculator" 
does not contain a definition for ‘Multiply'" 
at Callsite.Target (Closure , Callsite , Object , Double , Double ) 
at System.Dynamic.UpdateDelegates.UpdateAndExecute3[T0,T]1,T2,TRet] (Callsite 
site, TO arg0, Tl1 argl, T2 arg2) 
at ClientApp.Program.UsingReflectionWithDynamic (String addinPath}) in... 


与 以 强 类 型 方式 访问 对 象 相 比 ， 使 用 dynamic 类 型 也 有 更 多 的 开销 。 因 此 ， 这 个 关键 字 只 用 于 某 些 特定 的 
情形 ， 如 反射 。 调 用 Type 的 InvokeMember 方法 没有 进行 编译 器 检查 ， 而 是 给 成 员 名 字 传 递 一 个 字符 串 。 使 用 
dynamic 类 型 的 语法 很 简单 ， 与 在 这 样 的 场景 中 使 用 Reflection API 相 比 ， 有 很 大 的 优势 。 

dynamic 类 型 还 可 以 用 于 COM 集成 和 脚本 环境 ， 话 细 讨论 dynamic 关键 字 后 ， 会 探讨 它 。 


16.5 _ dynamic 类 型 


dynamic 头 型 允许 编写 忽略 编译 期 间 的 类 型 检查 的 代码 。 编 译 嚣 假定， 给 dynamic 类 型 的 对 象 定义 的 任何 
操作 都 是 有 效 的 。 如 果 该 操作 无 效 ， 则 在 代码 运行 之 前 不 会 检测 该 错误 ， 如 下 面 的 示例 所 示 : 
class Program 
| static void Main{) 
Var staticPerson = new Person(); 
dynamic dynamicPerson = new Person(); 
staticPerson.GetFullName ("John™., "Smith"™}); 
dynamicPerson.GetFullName ("John™", "Smith"™"}); 
} 
} 


class Person 

{ 
Public string FirstName { get; set; } 
Public string LastName { get; set; } 
public string GetrFullName() => S$"{FirstName} {LastName} ™; 

} 


这 个 示例 没有 编译 ， 因 为 它 调用 了 staticPerson.GetFullName(0 方 法 。 因 为 Person 对 象 上 的 方法 不 接受 两 个 
参数 ， 所 以 编译 器 会 提示 出 错 。 如 果 注 释 掉 该 行 代码 ， 这 个 示例 就 会 编译 。 如 果 执 行 它 ， 就 会 发 生 一 个 运行 错 
误 。 所 抛 出 的 异常 是 RuntimeBinderException 异常 。RuntimeBinder 对 象 会 在 运行 时 判断 该 调用 ， 确定 Person 类 
是 否 文 持 被 调用 的 方法 。 这 将 在 本 章 后 面 讨论 。 

与 var 关键 字 不 同 , 定义 为 dynamic 的 对 象 可 以 在 运行 期 间 改变 其 类 型 。 注意 在 使 用 var 关键 字 时 , 对象 类 
型 的 确定 会 延迟 。 类 型 一 旦 确定 ， 就 不 能 改变 。 动 态 对 象 的 类 型 可 以 改变 ， 而 且 可 以 改变 多 次 ， 这 不 同 于 把 
对 象 的 类 型 强制 转换 为 男 一 种 类 型 。 在 强制 转换 对 象 的 类 型 时 ， 是 用 男 一 种 兼容 的 类 型 创建 一 个 新 对 象 。 例 
如 ， 不 能 把 int 强制 转换 为 Person 对 象 。 在 下 面 的 示例 中 ， 如 果 对 象 是 动态 对 象 ， 就 可 以 把 它 从 int 变 成 Person 
类 型 ; 

dynamic dyn; 

dyn = 100; 

Console .WriteLine (dyn.GetType () ) ; 

Console .WriteLine (dyn); 

dyn = "This is a string"s 

Console.WriteLine (dyn.GetType () ); 

Console .WriteLIine (dyn}); 

dyn = new Person() { FirstName = "Bugs", LastName = "Bunny™ }; 


Console .WriteLine (dyn.GetType () ) ; 
Console .WriteLine ($"{dyn.FirstName} {dvyn.LastName}"); 


执行 这 段 代 码 可 以 看 出 ，dyn 对 象 的 类 型 实际 上 从 System.Int32 变 成 System.String， 再 变 成 Person。 如 果 
dyn 声明 为 int 或 string， 这 上段 代码 就 不 会 编译 。 


注意 : 
对 于 dynamic 类 型 有 两 个 限制 。 动 态 对 象 不 支持 扩展 方法 ， 匿 名 池 数 (lambda 表达 式 ) 也 不 能 用 作 动 态 方法 
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调用 的 参数 ， 因 此 LINQ 不 能 用 于 动态 对 象 。 大 多 数 LINQ 调用 都 是 扩展 方法 ， 而 lambda 表达 式 用 作 这 些 扩展 
方法 的 参数 。 


后 台 上 的 动态 操作 


在 后 台 ， 这 些 是 如 何 发 生 的 ? C# 仍 是 一 种 静态 的 类 型 化 语言 ， 这 一 点 没有 改变 。 看 看 使 用 dynamic 类 型 生 
成 的 二 (中间 语言 )。 
首先 ， 看 看 下 面 的 示例 C# 代 码 (代码 文件 DynamicSamples/DecompileSample/Program.cs): 


Class Program 
{ 
static void Mainil) 
{ 
StaticClass staticObject = new StaticClass(}); 
DynamicClass dynamicObject = new DynamicClass (); 
Console.WriteLine (staticObject.IntValue); 
Console.WriteLine (dynamlcob]Ject .DYnValuel) ; 
Console.ReadLine {().; 
} 
} 


Class StaticClass 
{ 

public int IntValue = 100; 
} 


class DynamicClass 


{ 
public dynamic DynValue = 100; 
} 


其 中 有 两 个 类 StaticClass 和 DynamicClass。StaticClass 类 有 一 个 返回 int 的 字段 DynamicClass 有 一 个 返回 
dynamic 对 象 的 字段 。Main0 方 法 仅 创 建 了 这 些 对 象 ， 并 输出 方法 返回 的 值 。 该 示例 非常 简单 。 
现在 注释 掉 Main0 方 法 中 对 DynamicClass 类 的 引用 : 


static void Mainl() 

{ 
staticClass staticobject = new StaticClass (); 
//DynamicClass dynamicObject = new DynamicClass (}); 
Console.WriteLine (staticObject.IntValue}); 
/console.WriteLine (dynamicObject -DYnValLue) : 
Console.ReadLine(); 


} 
使 用 ildasm 工具 ， 可 以 看 到 给 Main(0 方 法 生成 的 工 : 


-method private hidebysig static void Main() cil managed 


{ 
-entrypoint 
// Code size 22 (0x16) 
-Maxstack 8 
IL 0000: newob] instance void DecompileSample.SsStaticClass:: .ctor{() 
IL 0005: Jldfld int32 DecompileSample.SsStaticCclass::IntValue 
IL O00a: call vold [System.Console] System.Console: :WriteLine (int32) 
IL O00f: call string [SYystem.Console]System.Console: :ReadLine{() 


IL 0014: pop 
IL 001>2>: ret 
} // end of method Program: :Main 


这 里 不 讨论 工 的 细节 ， 只 看 看 这 段 代码 ， 就 可 以 看 出 其 作用 。 第 0000 行 调用 了 StaticClass 构造 函数 ， 第 
0005 行 调用 了 StaticClass 类 的 IntValue 字段 。 下 一 行 输出 了 其 值 。 
现在 注释 掉 对 StaticClass 类 的 引用 ， 取 消 DynamicClass 引用 的 注释 : 


static woid Mainl) 

{ 
/:/staticClass staticObject = new StaticClass(); 
DynamicClass dynamicoObject = new DynamicClass (); 
//Cconsole.WriteLine(staticObject.IntValue); 
Console.WriteLine (dynamicObject.DynValue),; 
Console.ReadLine (); 
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再 次 编译 应 用 程序 ， 下 面 是 生成 的 工 : 


-method private hidebysig static void Main{() cil managed 
{ 

-entrypoint 

// Code size 119 (0x77) 

.maxstack 9 

-locals init (class DecompileSample.DynamicClass V 0) 


IL 0000: newob] instance void DecompileSample.DynamicClass::.ctor!() 
IL 0005: stloc.0 
IL 0006: ldsfld class 


[System.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite 1l<class 
[System.Runtime]System.Action 3<class 
[SYstem.Ling.Expressions] System.Runtime.CompilerServices.CallSite,class 
[System.Runtime]System.Type,object»>> DecompileSample.Program/'<>o 0::'<>p 0 
IL O00b: brtrue.s IL O04c 
IL O000d: ldc.14 Ox100 
IL 0012: ldstr WriteLine™ 


IL 0017: ldnull 


IL 0018: ldtoken DecompileSample.Program 

IL O00ld: call class [System.Runtime] System.Type 
[SYystem.Runtime]System.Type: :GetTypeFromHandle (valuetype [SYystem.Runtime]System.RuntimeTypeHandle) 

IL 0022: ldc.1i4.2 

IL 0023: newarr [Microsoft.cSharp]Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo 

IL 0028: dup 

IL 0029: ldc-14-0 

IL 002a: ldc.i4.s 33 

IL O02c: ldnull 

IL O002d: call class [Microsoft.CSharp]Microsoft.cSharp.RuntimeBinder.CSharpArgumentInfo 
[Microsoft.cCSharp]Microsoft.cSharp.RuntimeBinder.cSharpArgumentIinfo: :Create (valuetype 
[Microsoft .CSharp]Microsoft.cCSharp.RuntimeBinder.csharpArgumentIinfoFlags, 

string) 

IL 0032: stelem.ref 

IL 0033: dup 

IL 0034: Jldc.14.1 

IE 0033: ldc.i14.0 

IL 0036: ldnull 

IL 0037: call class [Microsoft.cCcSharp]Microsoft.cCcSharp.RuntimeBinder.CcSharpArgumentInfo 


[Microsoft.cCcSharp]Microsoft.cCcSharp.RuntimeBinder.csharpArgumentIinfo: :Create (valuetype 
[Microsoft.csharp]Microsoft.cCSharp.RuntimeBinder.csharpArgumentIinforFlags, 


string) 
IL O03c: stelem.ref 
IL O03d: call Class 


[System.Ling.Expressions]System.Runtime .CompilerSservices.CallsiteBinder 
[Microsoft.csharp]Microsoft.CSharp.RuntimeBinder.Binder: :InvokeMember (valuetype 
[Microsoft.csharp]Microsoft.CSharp.RuntimeBinder.cCcSsSharpBinderFlags, 
string, 
class [System.Runtime]System.Ccollections.Generic.IEnumerable 1<class [System.Runtime]System.Type>, 
class [System.Runtime]System.TYype, 
class [System.Runtime]System.Collections.Generic.IEnumerable 1l<class 
[Microsoft.cSsharp]Microsoft.CSharp.RuntimeBinder.csharpArgumentInfo>) 
IL O0042: call Class 
[SyYstem.Ling.Expressions] System.Runtime.CompilerSsServices.CallSsite 1<1I0> class 
[System.Ling.Expressions] System.Runtime .CompilerServyvices.CallSsite 1<elass 
[System.Runtime]System.Action 3<class 
[System.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite,class 
[SyYstem.Runtime]System.Type,object>>: :Create (class 
[System.Ling.Expresslilons] System.Runtime.CompilerServices.CallSsiteBinder) 
IL 0047: stsfld Class 
[System.Ling.Expressions]System.Runtime .CompilerServices.CallSsSite 1l<class 
[SYystem.Runtime]System.Action 3<class 
[SyYstem.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite,class 
[System.Runtime]System.Type,object>> DecompileSample.Program/'<>o 0'::'<>p 0' 
IL O04c: ldsfld class 
[System.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite 1l<class 
[SYystem.Runtime]System.Action 3<class 
[System.Ling.Expressions] System.Runtime .CompilerServyices.CallSsSite,class 
[System.Runtime]System.Type,object>> DecompileSample.Program/"'<>o 0'::'<>p 0' 
IL 0031: ldfld 10 class 
[System.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite 1l<class 
[System.Runtijme]System.Action 3<class 
[System.Ling.ExXpressions] System.Runtime .CompilerServyices.CallSsSite,class 
[System.Runtime]System.Type,object>>: :Target 
IL 0056: ldsfld class 
[SyYstem.Ling.Expressions] System.Runtime .CompilerServices.CallSsSite l<class 
[SyYstem.Runtime]System.Action 3<class 
[System.Ling.Expressions] System.Runtime .CompilerServyices.CallSsSite,class 
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[System.Runtime] System.Type, object>> DecompileSample.Program/'<>o 0":: <>p 0' 
IL O05b: ldtoken [Svstem.cCconsole] System.Console 
IL O060: call class [System.Runtime]System.Type 
[SYystem.Runtime]System.Type: :GetTypeFromHandle (valuetype 
[System.Runtime]System.RuntimeTypeHandle) 
IL 0065: Jldloc.0 
IL 0066: ldfld object DecompileSample.DynamilcClass: :DynVvalue 
IL O006b: callvirt instance Vold Class [SyYystem.Runtime]System.Action 3<class 
[System.Ling.Expressions] System.Runtime.CompilerServices.Callsite,class 
[System.Runtimel]System.Type,object>: :Invoke(!o0, 
1 
2) 
IL O070: call string [System.Console] System.Console: :ReadLine () 
IL O013: pop 
IL O0176: ret 
} // end of method Program: :Main 


显然 ，C# 编 译 器 做 了 许多 工作 ， 以 支持 动态 类 型 。 在 生成 的 代码 中 ， 会 看 到 对 System.Runtime. 
CompllerServices.CallSsite 类 和 System.Runtime.CompilerServices. CallSsiteBinder 类 的 引用 。 

CallSite 是 在 运行 期 间 处 理 查 找 操作 的 类 型 。 在 运行 期 间 调 用 动态 对 象 时 ， 必 须 找到 该 对 象 ,， 看 看 其 成 员 是 
否 存 在 。CallSsite 会 缓存 这 个 信息 , 这 样 查找 操作 就 不 需要 重复 执行 。 没有 这 个 过 程 , 循环 结构 的 性 能 就 有 问题 。 

CallSite 完成 了 成 员 查 找 操作 后 ， 就 调用 CallSiteBinder0 方 法 。 它 从 Callsite 中 提取 信息 ， 并 生成 表达 式 树 ， 
来 表示 绑 定 器 绑 定 的 操作 。 

显然 这 需要 做 许多 工作 。 优 化 非常 复杂 的 操作 时 要 格外 小 心 。 显 然 ， 使 用 dynamic 类 型 是 有 用 的 ， 但 它 是 
有 代价 的 。 


16.6 DynamicObject 和 ExpandoObject 概述 


如 果 要 创建 自己 的 动态 对 象 , 该 怎么 办 ? 有 两 种 方法 : 从 DynamicObject 中 派生 , 或 者 使 用 ExpandoObject。 
使 用 DynamicObject 需要 做 的 工作 较 多 ， 因 为 必须 重 写 几 个 方法 。ExpandoObject 是 一 个 可 立即 使 用 的 密封 类 。 
16.6.1 DynamicObject 

考虑 一 个 表示 人 的 对 象 。 一 般 应 定义 名 字 、 中 间 名 和 姓氏 等 属性 。 现 在 假定 要 在 运行 期 间 构建 这 个 对 象 ， 
且 系 统 事先 不 知道 该 对 象 有 什么 属性 或 该 对 象 可 能 文 持 什么 方法 。 此 时 就 可 以 使 用 基于 DynamicObject 的 对 象 。 
需要 这 类 功能 的 场合 几乎 没有 ， 但 到 目前 为 止 ，C# 语 言 还 没有 提供 该 功能 (代码 文件 DynamicSamples/ 
DynamicSample/WroxDyamicOblject.cs)。 

首先 看 看 DynamicObject( 代 码 文 件 DynamicSamples/DynamicSample/WroxDyamicObject.cs): 

public class WroxDynamicObject : DynamicobJject 

private Dictionary<string, object> dynamicData = 


new Dictionary<string, object>().; 


Public override bool TryGetMember (GetMemberBinder binder, out object result) 


| 
bool SUCCESS = false; 
result = null:; 
if ( dynamicData.CcontainsKey (binder .Name)) 
{ 
result = dynamicDatalbinder.Namel]; 
success = true; 
} 
1] se 
{ 
result = "Property Not FEOUnOGI : 
} 
return success; 
} 


public override bool TrySetMember (SetMemberBinder binder, object value) 
{ 

dynamicDatal[lbinder.Name] = value; 

return true; 


} 
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Public override bool TIYIPVOKeMember (InVOKeMembeITB1Inader binder., 
object[] args, out object result) 

{ 
dynamic method = dynamicDatal[lbinder.Namel]; 
工人 SUJt = method( (DateTime}args[0]):; 
return result I= mull]:; 

} 

} 


在 这 个 示例 中 ， 重 写 了 3 个 方法 TrySetMember()、TryGetMember0O 和 TryInvokeMember(。 

TrySetMember0 方 法 给 对 象 添 加 了 新 方法 、 属 性 或 字段 。 本 例 把 成 员 信 息 存 储 在 一 个 Dictionary 对 象 中 。 传 
送 给 TrySetMember0 方 法 的 SetMemberBinder 对 象 包含 Name 属性 ， 它 用 于 标识 Dictionary 中 的 元 素 。 

TryGetMember0 方 法 根据 GetMemberBinder 对 象 的 Name 属性 检索 存储 在 Dictionary 中 的 对 象 。 

下 面 的 代码 使 用 了 刚才 新 建 的 动态 对 象 (代码 文件 DynamicSamples/DynamicSample/Program.cs): 

dynamic WroxDYyn = new WroxDynamicObject (); 

WIOXDYN.FI1rstName = "Bugs"; 

WTOEDYT .LastName = "BUY 


Console .WriteLine (wroxDyn.GetType ()); 
Console .WriteLine ($"{wroxDyn.FirstName} {wroxDyn.LastName}™"); 


看 起 来 很 简单 ， 但 在 哪里 调用 了 重 写 的 方法 ? 正 是 .NET 帮助 完成 了 调用 。DynamicObject 处 理 了 绑 定 ， 我 
们 只 需要 引用 FirstName 和 LastName 属性 即 可 ， 就 好 像 它 们 一 直 存 在 一 样 。 

添加 方法 很 简单 。 可 以 使 用 上 例 中 的 WroxDynamicObject， 给 它 添 加 GetTomorrowDate0 方 法 。 该 方法 接受 
一 个 DateTime 对 象 为 参数 ， 返 回 表 示 第 二 天 的 日 期 字符 串 。 代 码 如 下 : 


dynamic wroxDyn = new WIIOXDYnamlcoOb]Ject () ; 

Func<DateTime, string> GetTomorrow = today => today.AddDays (1) .ToShortDatestring(); 
WIOXDYN.GetTomorrowDate = GetTomorrows; 

Console .WriteLine ($"Tomorrow is {wroxDyn.GetTomorrowDate (DateTime .Now) }").; 


这 段 代 码 使 用 Func<T TResult> 创 建 了 委托 GetTomorrow。 该 委托 表示 的 方法 调用 了 AddDays， 给 传 入 的 
Date 加 上 一 天 ， 返 回 得 到 的 日 期 字符 串 。 接 着 把 委托 设置 为 wroxDyn 对 象 上 的 GetTomorrowDate( 方 法 。 最 后 
一 行 调用 新 方法 ， 并 传递 今天 的 日 期 。 动 态 功 能 再 次 发 挥 了 作用 ， 对 象 上 有 了 一 个 有 效 的 方法 。 

16.6.2 ExpandoObject 

ExpandoObject 的 工作 方式 类 似 于 上 一 节 创 建 的 WroxDynamicObject， 区 别 是 不 必 重 写 方 法 ， 如 下 面 的 代码 

示例 所 示 ( 代 码 文件 DynamicSamples/DynamicSample/WroxDynamicObjectcs): 


static void DoExpando() 

{ 
dynamic expOb] = new ExpandoObject (); 
expOb]j] .FirstName = "Daffy"™; 
expOb] .LastName = "DUCK" ; 
Console.WriteLine ($"{expOb] .FirstName} {expOb] .LastName}"); 
Func<DateTime, string> GetTomorrow = today => 

today.AddDays (1) .ToShortDateSstring(); 


expOb] .GetTomorrowDate = GetTomorrow; 
Console.WriteLine ($"Tomorrow 1is {expOb] .GetTomorrowDate (DateTime .Now) }"); 
expOb]j] .Friends = new List<Person> () ， 
EXDOb] .Friends.Add(new Person() { FirstName = "Bob", LastName = "Jones™ }); 
EXDOb] .Friends.Add(new Person() { FirstName = "Robert", 

LastNMame = "Jones™ }).; 


expOb]j] .Friends.Add (new Person() 1{ FirstName = "Bobby", LastName = "Jones™ }); 
foreach (Person friend in expOb] .Friends) 
{ 
Console.WriteLine($"{friend.FirstName} {friend.LastName}"); 
} 
} 


注意 ， 这 段 代码 与 前 面 的 代码 几乎 完全 相同 ， 也 添加 了 FirstName 和 LastName 属性 ， 以 及 GetTomorrow 函 
数 ， 但 它 还 多 做 了 一 件 事 ”把 一 个 Person 对 象 集合 添加 为 对 象 的 一 个 属性 。 

初 看 起 来 ， 这 似乎 与 使 用 dynamic 类 型 没有 区 别 。 但 其 中 有 两 个 微妙 的 区 别 非 常 重要 。 第 一 ， 不 能 仅 创 建 
dynamic 类 型 的 空 对 象 。 必 须 把 dynamic 类 型 赋予 某 个 对 象 ， 例 如 ， 下 面 的 代码 是 无 效 的 : 


dynamic qynob] ; 
dynobj .FirstName = "Joen; 
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与 前 面 的 示例 一 样 ， 此 时 可 以 使 用 ExpandoObject。 

第 二 ， 因 为 dynamic 类 型 必须 赋予 某 个 对 象 ， 所 以 ， 如 果 执 行 GetType 调用 ， 它 就 会 报告 赋予 了 dynamic 
类 型 的 对 象 类 型 。 所 以 ， 如 果 把 它 赋 予 int，GetType 就 报告 它 是 一 个 int。 这 不 适用 于 ExpandoObject 或 派生 目 
DynamicObject 的 对 象 。 

如 果 需 要 控制 动态 对 象 中 属性 的 添加 和 访问 ， 则 使 该 对 象 派 生 目 DynamicObject 是 最 佳 选择 。 使 用 
DynamicObject, 可 以 重 写 几 个 方法 , 准确 地 控制 对 象 与 运行 库 的 交互 方式 。 而 对 于 其 他 情况 , 就 应 使 用 dynamic 
类 型 或 ExpandoObject。 

下 面 是 使 用 dynamic 类 型 和 ExpandoObject 的 另 一 个 例子 。 假 设 需求 是 开发 一 个 通用 的 逗号 分 隔 值 (CSV) 
文件 的 解析 工具 。 从 一 个 扩展 到 另 一 个 扩展 时 ， 不 知道 文件 中 将 包含 什么 数据 ， 只 知道 值 之 间 是 用 喜 号 分 隔 的 ， 
并 且 第 一 行 包含 字段 名 。 

首先 ， 打 开 文 件 并 读 入 数据 流 。 这 可 以 用 一 个 简单 的 辅助 方法 完成 (代码 文件 DynamicSamples/ 
DynamicFileReader/DynamicFileHelper.cs): 

public class DynamicFileHelper 

se | 

private StreamReader OpenFile (string fileName) 
if (File.Exists (fileName)) 
return new StreamReader (fileName); 
} 
return null; 
} 


a 
} 


这 有 段 代码 打开 文件 ， 并 创建 一 个 新 的 StreamReader 来 读 取 文 件 内 容 。 

接 下 来 要 获取 字段 名 。 方 法 很 简单 : 读 取 文件 的 第 一 行 ， 使 用 Split 函数 创建 字段 名 的 一 个 字符 串 数组 。 

string[] headerLine = fileStream.ReadLine() .Split(',') .Trim() .ToArray (); 

接 下 来 的 部 分 很 有 趣 : 读 入 文件 的 下 一 行 ， 就 像 处 理 字段 名 那样 创建 一 个 字符 串 数组 ， 然 后 创建 动态 对 象 。 
具体 代码 如 下 所 示 ( 代 码 文件 DynamicSamples/DynamicFileReader/DynamicFileHelper.cs): 

Public class DynamicFileHelper 

f/f/-.--. 


public IEnumerable<dynamic> ParseFile(string fileName) 
{ 


var retList = new List<dynamic> (); 
while (fileStream.Peekl) > 0) 


string[] dataLine = filestream.ReadLine() .Split(',") .Trim() .ToArray (); 
dynamic dynamicEntity = new ExpandoObject(); 
for(int i=0;i<headerLine.Length;1++) 
{ 
({ (IDictionary<string,object>) dynamicEntity) .Add (headerLine[i], 
dataLine[il]):; 
} 
retList.Add (dynamicEntity); 
} 
return retList:; 
} 
fp 
} 


有 了 字段 名 和 数据 元 素 的 字符 串 数组 后 ,创建 一 个 新 的 ExpandoObject， 在 其 中 添加 数据 。 注 意 ， 代 码 中 将 
ExpandoObject 强制 转换 为 Dictionary 对 象 。 用 字段 名 作为 键 ， 数 据 作 为 值 。 然 后 ， 把 这 个 新 对 象 添 加 到 所 创建 
的 retList 对 象 中 ， 返 回 给 调用 该 方法 的 代码 。 

这 样 做 的 好 处 是 有 了 一 段 可 以 处 理 传递 给 它 的 任何 数据 的 代码 。 这 里 唯一 的 要 求 是 确保 第 一 行 是 字段 名 ， 
并 且 所 有 的 值 是 用 逗号 分 隔 的 。 可 以 把 这 个 概念 扩展 到 其 他 文件 类 型 ， 甚 至 DataReader。 

使 用 这 个 CSV 文件 内 容 和 下 载 的 示例 代码 : 
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FirstName, LastName, City, State 

Niki, Lauda, Vienna, Austria 

Carlos, Reutemann, Santa Fe, Argentine 
Sebastian, Vettel, Thurgovia, Switzerland 


以 及 Main0 方 法 ， 读 取 示 例文 件 EmployeeList.txt( 代 码 文 件 DynamicSamples/DynamicFileReader/ 
Program.cs): 


static void Maint{) 
{ 
var helper = new DynamicFileHelper (); 
Var employeeList = helper.ParseFile ("EmPloyeeList.txt"),; 
foreach (Var employee in employeeLlist) 
{ 
Console.WriteLine($"{employee.FirstName} {employee.LastName} lives in ™ 十 
s"{employee.Ccity}, {employee.State}.™),; 
} 
Console.ReadLine ():; 


} 
把 如 下 结果 输出 到 控制 全 
NIK1I Lauda lives in Vienna, Austria. 


Carlos Reutemann lives in Santa Fe, Argentine. 
Sebastian Vettel lives in Thurgovia, Switzerland. 


16.7 ”小结 


本 章 介绍 了 Type 和 Assembly 类 ， 它 们 是 访问 反射 所 提供 的 扩展 功能 的 主要 入 口 扣 。 

另外 ， 本 重 还 探讨 了 反射 的 一 个 第 用 方面 : 目 定义 特性 ， 它 比 其 他 方面 更 和 常用。 介绍 了 如 何 定 义 和 应 用 目 
己 的 目 定义 特性 ， 以 及 如 何在 运行 期 间 检索 目 定 义 特 性 的 信息 。 

本 章 的 第 二 部 分 介绍 了 dynamic 类 型 。 通 过 使 用 ExpandoObject 代替 多 个 对 象 ， 代 码 量 会 显著 减少 。 另 外 ， 
通过 使 用 DLR 及 添加 Python 或 Ruby 等 脚本 语言 ， 可 以 创建 多 态 性 更 好 的 应 用 程序 ， 改 变 它们 十 分 简单 ， 并 
且 不 需要 重新 编译 。 

下 一 章 将 详细 介绍 如 何 使 用 IDisposable 接口 释放 原生 资源 ， 并 使 用 不 安全 的 C# 代 码 。 


和 


托管 和 非 托 管内 存 


本 章 要 点 
运行 期 间 在 栈 和 堆 上 分 配 空 间 
垃圾 收集 
使 用 析 构 函数 和 System.IDisposable 接口 释放 非 托管 的 资源 
C# 中 使 用 指针 的 语法 
引用 语义 
使 用 Span 类 型 
平台 调用 ， 访 问 本 机 API 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 Www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Memory 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® PoimterPlayeround 


PomterPlayeround2 
ReterenceSemantics 
SpanSample 
PlatftormInvokeSample 


17.1 内 存 


变量 存储 在 堆栈 中 。 它 引用 的 数据 可 以 位 于 栈 ( 结 构 ) 或 堆 ( 类 ) 上 。 结构 体 也 可 以 沪 箱 ， 这 样 对 象 束 会 在 堆 上 
创建 。 垃 圾 收集 器 需要 从 托管 堆 中 释放 不 再 需要 的 非 托管 对 象 。 使 用 本 机 API， 可 以 在 本 机 堆 上 分 配 内 存 。 垃 
圾 收集 器 不 负责 在 本 机 堆 上 分 配 内 存 。 必 须 目 己 释 放 这 些 内 存 。 关 于 内 存 ， 有 很 多 东西 需要 考虑 。 

使 用 托管 环境 时 ， 很 容易 被 误导 ， 注 意 不 到 内 存 管理 ， 因 为 垃圾 收集 器 (GC) 会 处 理 它 。 很 多 工作 都 由 GC 
完成 ， 了解 它 是 如 何 工作 的 ， 什 么 是 大 小 对 象 堆 ， 以 及 什么 数据 类 型 存储 在 堆栈 上 是 非常 有 益 的 。 同 时 ， 垃 圾 
收集 器 处 理 托管 的 资源 ， 那 么 非 托管 资 源 呢 ? 它们 需要 由 开发 人 员 释 放 。 程 序 可 能 是 完全 托管 的 程序 ， 但 是 杠 
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架 的 类 型 呢 ? 例如， 文件 类 型 (参见 第 22 章 ) 包装 了 一 个 本 地 文件 句柄 。 这 个 文件 句柄 需要 释放 。 为 了 尽早 
释放 这 个 句柄 ， 最 好 了 解 IDisposable 接口 和 using 语句 ， 参 见 本 章 的 内 容 。 

其 他 方面 也 很 重要 。 尽 管 一 些 语言 结构 更 易于 创建 不 可 变 的 类 型 , 但 可 变 对 象 也 有 优势 。string 类 是 目 .NET 
Framework 1.0 以 来 一 直 可 用 的 不 可 变 类 型 。 现 在 我 们 经 常 需要 处 理 大 的 字符 串 。 在 操作 字符 串 时 ，GC 需要 清 
理 许多 对 象 。 直 接 访 问 字 符 串 的 内 存 并 进行 更 改 ， 将 使 程序 可 变 ， 在 不 同 的 场景 中 具有 更 好 的 性 能 。Span 类 型 
使 之 成 为 可 能 ， 参 见 第 9 章 和 第 7 章 。 对 于 数组 ， 还 介绍 了 ArrayPool 类 ， 该 类 还 可 以 减少 GC 的 工作 量 。 

本 革 介 绍 内 存 管理 和 内 存 访问 的 各 个 方面 。 如 果 很 好 地 理解 了 内 存 管 理 和 C# 提 供 的 指针 功能 ， 也 就 能 很 好 
地 集成 C# 代 码 和 原来 的 代码 ， 并 能 在 非常 注重 性 能 的 系统 中 高 效 地 处 理 内 存 。 本 章 介 绍 了 使 用 C# 7 中 的 ref 
关键 字 作 为 返回 类 型 和 本 地 变量 的 新 方法 。 这 个 特性 减少 了 对 使 用 不 安全 代码 和 C# 中 指针 的 需要 。 本 章 还 讨论 
了 使 用 Span 类 型 访问 不 同类 型 内 存 的 更 多 细节 ， 例 如 托管 堆 、 本 机 堆 和 堆栈 。 


17.2 后 台 内 存 管理 


C# 编 程 的 一 个 优点 是 程序 员 不 需要 担心 具体 的 内 存 管理 ， 垃 圾 收集 器 会 目 动 处 理 所 有 的 内 存 清 理工 作 。 用 
户 可 以 得 到 像 C++ 语言 那样 的 效率 ， 而 不 需要 考虑 像 在 C++ 中 那样 内 存 管理 工作 的 复杂 性 。 虽 然 不 必 手 动 管 理 
内 存 ， 但 仍 需 要 理解 后 台 发 生 的 事情 。 理 解 程 序 在 后 台 如 何 管理 内 存 有 助 于 提高 应 用 程序 的 速度 和 性 能 。 本 节 
要 介绍 给 变量 分 配 内 存 时 在 计算 机 的 内 存 中 发 生 的 情况 。 


江 加 一 
本 节 不 详细 介绍 许多 主题 的 相关 内 容 。 应 把 这 一 节 看 作 是 一 般 过 程 的 简化 向 寻 ， 而 不 是 实现 的 确切 说 明 .。 


17.2.1 值 数据 类 型 


Windows 使 用 一 个 虚拟 寻 址 系统 ， 该 系统 把 程序 可 用 的 内 存 地 址 映射 到 硬件 内 存 中 的 实际 地 址 上， 这些 任 
务 完全 由 Windows 在 后 台 管 理 。 其 实际 结果 是 32 位 处 理 器 上 的 每 个 进程 都 可 以 使 用 4GB 的 内 存 一 一 无 论 计算 
机 上 实际 有 多 少 物理 内 存 (在 64 位 处 理 器 上 ， 这 个 数字 会 更 大 )。 这 个 4GB 的 内 存 实 际 上 包含 了 程序 的 所 有 部 分 ， 
包括 可 执行 代码 、 代 码 加 载 的 所 有 DLL， 以 及 程序 运行 时 使 用 的 所 有 变量 的 内 容 。 这 个 4GB 的 内 存 称 为 虚拟 地 
址 空间 ， 或 虚拟 内 存 。 为 了 方便 起 见 ， 本 章 将 它 简 称 为 内 存 。 


注意 : 

默认 情况 下 ，.NET Core 应 用 程序 是 作为 可 移植 应 用 程序 构建 的 。 只 要 在 系统 上 安装 了 NET Core 运行 库 ， 
可 移植 的 应 用 程序 就 可 以 在 Windows 和 Linux 的 32 位 和 64 位 环境 上 运行 . 并 不 是 所 有 的 API 都 可 以 在 所 有 平 
台 上 使 用 ， 尤 其 是 在 使 用 本 机 API 时 。 为 此 ， 可 以 按照 第 1 章 的 解释 ， 给 NET Core 应 用 程序 指定 专门 的 平台 。 


4GB 中 的 每 个 存储 单元 都 是 从 0 开始 往 上 排序 的 。 要 访问 存储 在 内 存 的 某 个 空间 中 的 一 个 值 ， 就 需要 提供 
表示 该 存储 单元 的 数字 。 在 任何 复杂 的 高 级 语言 中 ， 编 译 器 负责 把 人 们 可 以 理解 的 变量 名 转换 为 处 理 器 可 以 理 
解 的 内 存 地 址 。 
在 处 理 器 的 虚拟 内 存 中 ， 有 一 个 区 域 称 为 栈 。 栈 存储 不 是 对 象 成 员 的 值 数 据 类 型 。 另 外 ， 在 调用 一 个 方法 
时 ， 也 使 用 栈 存储 传递 给 方法 的 所 有 参数 的 副本 。 为 了 理解 栈 的 工作 原理 ， 需 要 注意 在 C# 中 的 变量 作用 域 。 
如 果 变 量 a 在 变量 b 之 前 进入 作用 域 ，b 就 会 首先 超出 作用 域 。 考 虑 下 面 的 代码 : 
{ 
ry 
{ 
int bs 
// do something else 


} 
} 
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首先 声明 变量 a。 接 着 在 内 部 代码 块 中 声明 了 b。 人 然后 内 部 代码 块 终止 ，b 就 超出 作用 域 ， 最 后 a 超出 作用 
域 。 所 以 b 的 生存 期 完全 包含 在 a 的 生存 期 中 。 在 释放 变量 时 ， 其 顺序 总 是 与 给 它们 分 配 内 存 的 顺序 相反 ， 
这 就 是 栈 的 工作 方式 。 

还 要 注意 , b 在 另 一 个 代码 块 中 (通过 另 一 对 退 套 的 伦 括 号 来 定义 )。 因 此 ， 它 包含 在 另 一 个 作用 域 中 。 这 称 
为 块 作用 域 或 结构 作用 域 。 

我 们 不 知道 栈 具体 在 地 址 空间 的 什么 地 方 ， 这 些 信 息 在 进行 C# 开 发 时 是 不 需要 知道 的 。 栈 指针 (操作 系统 
维护 的 一 个 变量 ) 表 示 栈 中 下 一 个 空闲 存储 单元 的 地 址 。 程 序 第 一 次 开始 运行 时 ， 栈 指针 指向 为 栈 保 留 的 内 存 块 
末尾 。 栈 实际 上 是 阿 下 填充 的 ， 即 从 高 内 存 地 址 癌 低 内 存 地 址 填充 。 当 数据 入 栈 后 ， 栈 指针 就 会 随 之 调整 ， 以 
始终 指向 下 一 个 空闲 存储 单元 .这 种 情况 如 图 17-1 所 示 。 在 该 图 中 , 显示 了 栈 指 针 800000( 十 六 进 制 的 0xC3500)， 
下 一 个 空闲 存储 单元 是 地 址 799999。 

下 面 的 代码 会 告诉 编译 器 ， 需 要 一 些 存 储 空 间 以 存储 一 个 整数 和 一 个 双 精 度 浮 点 数 ， 这 些 存 储 单元 分 别称 
为 DRacingCars 和 engineSize。 声 明 每 个 变量 的 代码 行 表示 开始 请 求 访问 这 个 变量 ， 财 合 花 括号 标识 这 两 个 变量 
超出 作用 域 的 地 方 。 

int nRacingCars = 10; 

double engineSsize = 3000.0; 


/i: do calculations: 


} 
假定 使 用 如 图 17-1 所 示 的 栈 .nRacingCars 变量 进入 作用 域 ,赋值 为 10, 这 个 值 放 在 存储 单元 799996~799999 
上 ， 这 4 个 字 节 就 在 栈 指 针 所 指 空 间 的 下 面 。 有 4 个 字 节 是 因为 存储 int 要 使 用 4 个 字 节 。 为 了 容纳 该 int， 应 
从 栈 指针 对 应 的 值 中 减 去 4， 所 以 它 现在 指 同 位 置 799996， 即 下 一 个 空闲 单元 (799995)。 
存储 单元 


栈 指针 已 用 


未 用 


图 17-1 


下 一 行 代码 声明 变量 engineSize( 这 是 一 个 double 数 )， 把 它 初始 化 为 3000.0。 一 个 double 数 要 占用 8 个 字 
节 ， 所 以 值 3000.0 放 在 栈 上 的 存储 单元 799988~799995 上 ， 栈 指针 对 应 的 值 减 去 8， 再 次 指向 栈 上 的 下 一 个 空 
闲 单元 。 

当 engineSize 超出 作用 域 时 ， 运 行 库 就 知道 不 再 需要 这 个 变量 了 。 因 为 变量 的 生存 期 总 是 艇 套 的 ， 当 
engineSize 在 作用 域 中 时 ,无论 发 生 什么 情况 ， 都 可 以 保证 栈 指 针 总 是 会 指 同 存储 engineSize 的 空间 。 为 了 从 内 
存 中 删除 这 个 变量 ， 应 给 栈 指针 对 应 的 值 递增 8， 现 在 它 指向 engineSize 末尾 紧 接 着 的 空间 。 此 处 就 是 放置 闭 
合 花 括号 的 地 方 。 当 nRacingCars 也 超出 作用 域 时 ， 栈 指针 对 应 的 值 就 再 次 递增 4。 从 栈 中 删除 engineSize 和 
nRacingCars 之 后 ， 此 时 如 果 在 作用 域 中 又 放 入 另 一 个 变量 ， 从 799999 开始 的 存储 单元 就 会 被 覆盖 ， 这 些 空间 
以 前 是 存储 nRacingCars 的 。 

如 果 编 译 器 遇 到 inti，j 这 样 的 代码 行 ， 则 这 两 个 变量 进入 作用 域 的 顺序 是 不 确定 的 。 两 个 变量 是 同时 声明 
的 ， 也 是 同时 超出 作用 域 的 。 此 时 ， 变 量 以 什么 顺序 从 内 存 中 删除 就 不 重要 了 。 编 译 器 在 内 部 会 确保 先 放 在 内 
存 中 的 那个 变量 后 删除 ， 这 样 就 能 保证 该 规则 不 会 与 变量 的 生存 期 冲突 。 


17.2.2 引用 数据 类 型 


尽管 栈 有 非常 高 的 性 能 , 但 它 还 没有 灵活 到 可 以 用 于 所 有 的 变量 。 变量 的 生存 期 必须 租 套 , 在 许多 情况 下 ， 
这 种 要 求 都 过 于 苛刻 。 通 帝 我 们 希望 使 用 一 个 方法 分 配 内 存 ， 来 存储 一 些 数据 ， 并 在 方法 退出 后 的 很 长 一 段 时 
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间 内 数据 仍 是 可 用 的 。 只 要 是 用 new 运算 符 来 请 求 分 配 存 储 空 间 ， 束 存在 这 种 可 能 性 一 一 例如 ， 对 于 所 有 的 引 
用 类 型 。 此 时 就 要 使 用 托管 堆 。 
如 果 读 者 以 前 编写 过 需要 管理 低级 内 存 的 C++ 代码 ， 就 会 很 熟悉 堆 (heap)。 托 管 堆 和 C++ 使 用 的 堆 不 同 ， 
它 在 垃圾 收集 器 的 控制 下 工作 ， 与 传统 的 堆 相 比 有 很 显著 的 优势 。 
托管 推 (简称 为 扒 ) 是 处 理 器 的 可 用 内 存 中 的 另 一 个 内 存 区 域 。 要 了 解 堆 的 工作 原理 和 如 何 为 引用 数据 类 型 
分 配 内 存 ， 看 看 下 面 的 代码 : 
VOId DoWork'{) 
{ 
CuStomer arabel.: 
arabel = new Customer(); 


CuStomer othercustomer?2 = new EnhancedCustomer(); 


} 

在 这 段 代 码 中 , 假定 存在 两 个 类 Customer 和 EnhancedCustomer。EnhancedCustomer 类 扩展 了 Customer 类 。 

首先 ， 声 明 一 个 Customer 引用 arabel， 在 栈 上 给 这 个 引用 分 配 存 储 空 间 ， 但 这 仅 是 一 个 引用 ， 而 不 是 实际 
的 Customer 对 象 。arabel 引用 占用 4 个 字 节 的 空间 ， 足 够 包含 Customer 对 象 的 存储 地 址 (需要 4 个 字 节 把 0 一 
4GB 之 间 的 内 存 地 址 表示 为 一 个 整数 值 )。 


然后 看 下 一 行 代码 ; 
arabel = new Customer () ; 


这 行 代码 完成 了 以 下 操作 : 首先 ， 它 分 配 堆 上 的 内 存 ， 以 存储 Customer 对 象 ( 一 个 真正 的 对 象 ， 不 只 是 一 
个 地 址 )。 然后 把 变量 arabel 的 值 设 置 为 分 配给 新 Customer 对 象 的 内 存 地 址 ( 它 还 调用 合适 的 Customer0 构 造 函 数 
初始 化 类 实例 中 的 字段 ， 但 此 处 我 们 不 必 担 心 这 部 分 )。 

Customer 实例 没有 放 在 栈 中 ， 而 是 放 在 堆 中 。 在 这 个 例子 中 ， 现 在 还 不 知道 一 个 Customer 对 象 占 用 多 少 
字 节 ， 但 为 了 讨论 方便 ， 假 定 是 32 个 字 节 。 这 32 个 字 节 包含 了 Customer 的 实例 字段 ， 和 .NET 用 于 识别 和 管 
理 其 类 实例 的 一 些 信 息 。 

为 了 在 堆 上 找到 存储 新 Customer 对 象 的 一 个 存储 位 置 ，.NET 运行 库 在 堆 中 搜索 ， 选 取 第 一 个 未 使 用 的 且 
包含 32 个 字 节 的 连续 块 。 为 了 讨论 方便 ， 假 定 其 地 址 是 200000，arabel 引用 占用 栈 中 的 799996~799999 位 置 。 
这 表示 在 实例 化 arabel 对 象 前 ， 内 存 的 内 容 应 如 图 17-2 所 示 。 

给 Customer 对 象 分 配 空间 后 ， 内 存 的 内 容 应 如 图 17-3 所 示 。 注 意 ， 与 栈 不 同 ， 堆 上 的 内 存 是 向 上 分 配 的 ， 
所 以 空闲 空间 在 已 用 空间 的 上 面 。 


| T990906-799999 
Rp i 
[人 芝 


199999 | 
1999999 


17-2 图 17-3 


下 一 行 代码 声明 了 一 个 Customer 引用 ， 并 实例 化 一 个 Customer 对 象 。 在 这 个 例子 中 ， 用 一 行 代 码 在 栈 上 
为 otherCustomer2 引用 分 配 空 间 ， 同 时 在 堆 上 为 mrJones 对 象 分 配 空间 : 

Customer othercustomer2 = new EnhancedCustomer(); 

该 行 把 栈 上 的 4 个 字 节 分 配给 otherCustomer2 引用 ， 它 存储 在 799992~799995 位 置 上 ， 而 otherCustomer2 
对 象 在 堆 上 从 200032 开始 向 上 分 配 空 间 。 

从 这 个 例子 可 以 看 出 ， 建 立 引 用 变量 的 过 程 要 比 建立 值 变量 的 过 程 更 复杂 ， 且 不 能 避免 性 能 的 系统 开销 。 
实际 上 ， 我 们 对 这 个 过 程 进行 了 过 分 的 简化 ， 因 为 .NET 运行 库 需 要 保存 堆 的 状态 信息 ， 在 堆 中 添加 新 数据 时 ， 
这 些 信息 也 需要 更 新 。 尽 管 有 这 些 性 能 开销 ， 但 仍 有 一 种 机 制 ， 在 给 变量 分 配 内 存 时 ， 不 会 受到 栈 的 限制 。 把 
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一 个 引用 变量 的 值 赋予 男 一 个 相同 类 型 的 变量 ， 就 有 两 个 变量 引用 内 存 中 的 同一 对 象 了 。 当 一 个 引用 变量 超出 
作用 域 时 ， 它 会 从 栈 中 删除 ， 如 上 一 节 所 述 ， 但 引用 对 象 的 数据 仍 保留 在 堆 中 ， 一 直到 程序 终止 ， 或 垃圾 收集 
器 删除 它 为 止 ， 而 只 有 在 该 数据 不 再 被 任何 变量 引用 时 ， 它 才 会 被 删除 。 

这 就 是 引用 数据 类 型 的 强大 之 处 , 在 C# 代 码 中 广泛 使 用 了 这 个 特性 。 这 说 明 , 我 们 可 以 对 数据 的 生存 期 进 
行 非常 强大 的 控制 ， 因 为 只 要 保持 对 数据 的 引用 ， 该 数据 就 肯定 存在 于 堆 上 。 


17.2.3 垃圾 收集 


由 上 面 的 讨论 和 图 17-3 和 图 17-4 可 以 看 出 ， 托 管 堆 的 工作 方式 非常 类 似 于 栈 ， 对 象 会 在 内 存 中 一 个 挨 一 
个 地 放置 ， 这 样 就 很 容易 使 用 指 网 下 一 个 空闲 仓储 单元 的 堆 指针 来 确定 下 一 个 对 象 的 位 置 。 在 堆 上 添加 更 多 的 
对 象 时 ,也 容易 调整 。 但 这 比较 复杂 ， 因 为 基于 堆 的 对 象 的 生存 期 与 引用 它们 的 基于 栈 的 变量 的 作用 域 不 匹配 。 

在 垃圾 收集 器 运行 时 ， 它 会 从 堆 中 删除 不 再 引用 的 所 有 对 和 象 。 垃 圾 收集 器 在 引用 的 根 表 中 找到 所 有 引用 的 
对 象 ， 接 看 在 引用 的 对 象 树 中 查找 。 在 完成 删除 操作 后 ， 堆 会 立即 把 对 象 分 散 开 来 ， 与 已 经 释放 的 内 存 混合 在 


一 起 ， 如 图 17-4 所 示 。 


空闲 空间 


空闲 空间 


图 17-4 


如 果 托 管 的 堆 也 是 这 样 ， 在 其 上 给 新 对 象 分 配 内 存 就 成 为 一 个 很 难处 理 的 过 程 ， 运 行 库 必 须 搜 


索 整 个 堆 ， 
才能 找到 足够 大 的 内 存 块 来 存储 每 个 新 对 象 。 但 是 ， 垃 圾 收集 器 不 会 让 堆 处 于 这 种 状态 。 只 要 它 释 放 了 能 释放 
的 所 有 对 象 ， 就 会 把 其 他 对 象 移动 回 堆 的 问 部 ， 再 次 形成 一 个 连续 的 内 存 块 。 因 此 ， 堆 可 以 继续 像 栈 那样 确定 
在 什么 地 方 存储 新 对 象 。 当 然 ， 在 移动 对 象 时 ， 这 些 对 象 的 所 有 引用 都 需要 用 正确 的 新 地 址 来 更 新 ， 但 垃圾 收 
集 器 也 会 处 理 更 新 问题 。 

垃圾 收集 器 的 这 个 压缩 操作 是 托管 的 堆 与 非 托管 的 堆 的 区 别 所 在 。 使 用 托管 的 堆 ， 束 只 需要 读 取 堆 指针 的 
值 即 可 ， 而 不 需要 遍历 地 址 的 链表 ， 来 走 找 一 个 地 方 放置 新 数据 。 


注意 : 

一 般 情况 下 ， 垃 圾 收集 器 在 .NET 运行 库 确定 需要 进行 垃圾 收集 时 运行 。 可 以 调用 System.GC.CollectO 方 
法 ， 强 连 垃 圾 收集 器 在 代码 的 某 个 地 方 运行 。System.GC 类 是 一 个 表示 垃圾 收集 器 的 NET 类 ，Collect0 方 法 局 
动 一 个 垃圾 收集 过 程 。 但 是 ，GC 类 适用 的 场合 很 少 ， 例 如 ， 代 码 中 有 大 量 的 对 象 刚刚 取消 引用 ， 就 适合 调用 
垃圾 收集 器 。 但 是 ， 垃 圾 收集 器 的 还 辑 不 能 保证 在 一 次 垃圾 收集 过 程 中 ， 所 有 未 引用 的 对 象 都 从 堆 中 删除 。 


注意 : 

在 测试 过 程 中 运行 GC 是 很 有 用 的 。 这 样 ， 就 可 以 看 到 应 该 收集 的 对 象 仍然 未 收集 而 导致 的 内 存 泄 漏 。 因 
为 垃圾 收集 器 的 工作 做 得 很 好 ， 所 以 不 要 在 生产 代码 中 以 编程 方式 收集 内 存 。 如 果 以 编程 方式 调用 Collect， 对 
象 会 更 快 地 移入 下 一 代 ， 如 下 所 示 。 这 将 导致 GC 运行 更 多 的 时 间 。 


创建 对 象 时 ， 会 把 这 些 对 和 象 放 在 托管 堆 上 。 堆 的 第 一 部 分 称 为 第 0 代 。 创 建新 对 和 象 时 ， 会 把 它们 移动 到 堆 
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的 这 个 部 分 中 。 因 此 ， 这 里 驻 留 了 最 新 的 对 象 。 

在 通过 垃圾 收集 过 程 进行 第 一 次 对 象 收 集 之 前 ， 对 象 会 继续 放 在 这 个 部 分 。 在 此 清理 之 后 仍 保留 的 对 象 会 
被 压缩 ， 然 后 移动 到 堆 的 下 一 个 部 分 或 堆 的 第 1 代 对 应 的 部 分 。 

此 时 ， 第 0 代 对 应 的 部 分 为 空 ， 所 有 的 新 对 象 都 再 次 放 在 这 一 部 分 上 。 在 垃圾 收集 过 程 中 遗留 下 来 的 旧 对 
象 放 在 第 1 代 对 应 的 部 分 上 。 老 对 象 的 这 种 移动 会 再 次 发 生 。 接 者 重复 下 一 次 收集 过 程 。 这 意味 着 ， 第 1 代 中 
在 垃圾 收集 过 程 中 遗留 下 来 的 对 象 会 移动 到 堆 的 第 2 代 ， 位 于 第 0 代 的 对 象 会 移动 到 第 1 代 ， 第 0 代 仍 用 于 放 
置 新 对 象 。 


注意 : 
有 趣 的 是 , 在 给 对 象 分 配 内 存 空间 时 , 如 果 超 出 了 第 0 代 对 应 的 部 分 的 容量 , 或 者 调用 了 GC.Collect0 方 法 ， 
就 会 进行 垃圾 收集 。 


这 个 过 程 极 大 地 提高 了 应 用 程序 的 性 能 。 一 般 而 言 ， 最 新 的 对 象 通 党 是 可 以 收集 的 对 象 ， 而 且 可 能 也 会 收 
集 大 量 比较 新 的 对 象 。 如 果 这 些 对 象 在 堆 中 的 位 置 是 相 邻 的 ， 垃 圾 收集 过 程 就 会 更 快 。 另 外 ， 相 关 的 对 象 相 邻 
放置 也 会 使 程序 执行 得 更 快 。 

在 .NET 中， 垃圾 收集 提高 性 能 的 另 一 个 领域 是 架构 处 理 堆 上 较 大 对 象 的 方式 。 在 .NET 下， 较 大 对 象 有 自 
己 的 托管 堆 ， 称 为 大 对 象 堆 。 使 用 大 于 85 000 个 字 节 的 对 象 时 ， 它 们 就 会 放 在 这 个 特殊 的 堆 上 ， 而 不 是 主 堆 
上 。.NET 应 用 程序 不 知道 两 者 的 区 别 ， 因 为 这 是 目 动 完成 的 。 其 原因 是 在 堆 上 压缩 大 对 象 是 比较 昂贵 的 ， 因 此 
驻 留 在 大 对 象 堆 上 的 对 象 不 执行 压缩 过 程 。 

在 进一步 改进 垃圾 收集 过 程 后 ， 第 二 代 和 大 对 象 堆 上 的 收集 现在 放 在 后 人 台 线 程 上 进行 。 这 表示 ， 应 用 程序 
线程 仅 会 为 第 0 代 和 第 1 代 的 收集 而 阻塞 ， 减 少 了 总 暂停 时 间 ， 对 于 大 型 服务 器 应 用 程序 尤其 如 此 。 服 务 器 和 
工作 站 默认 打开 这 个 功能 。 

有 助 于 提高 应 用 程序 性 能 的 另 一 个 优化 是 垃圾 收集 的 平衡 ， 它 专用 于 服务 器 的 垃圾 收集 。 服 务 器 一 般 有 一 
个 线程 池 ， 执 行 大 致 相同 的 工作 。 内 存 分 配 在 所 有 线程 上 都 是 类 似 的 。 对 于 服务 器 ， 每 个 逻辑 服务 器 都 有 一 个 
垃圾 收集 堆 。 因 此 其 中 一 个 堆 用 尽 了 内 存 ， 触 发 了 垃圾 收集 过 程 时 ， 所 有 其 他 堆 也 可 能 会 得 益 于 垃圾 的 收集 。 
如 果 一 个 线程 使 用 的 内 存 远 远 多 于 其 他 线程 ， 导 致 垃圾 收集 ， 其 他 线程 可 能 不 需要 垃圾 收集 ， 这 就 不 是 很 高 效 。 
垃圾 收集 过 程 会 平衡 这 些 堆 一 一 小 对 象 堆 和 大 对 象 堆 。 进 行 这 个 平衡 过 程 ， 可 以 减少 不 必要 的 收集 。 

为 了 利用 包含 大 量 内 存 的 硬件 ， 垃 圾 收集 过 程 添加 了 GCSettings.LatencyMode 属性 。 把 这 个 属性 设置 为 
GCLatencyMode 枚 举 的 一 个 值 , 可 以 控制 垃圾 收集 器 进行 收集 的 方式 。 表 17-1 列 出 了 GCLatencyMode 可 用 的 值 。 


表 17-1 GCLatencyMode 的 设置 


成 员 说 明 
Batch 禁用 并 发 设置 ， 把 垃圾 收集 设置 为 最 大 吞吐 量 。 这 会 重 写 配 置 设置 
Interactive 工作 站 的 默认 行为 。 它 使 用 垃圾 收集 并 发 设置 ， 平 衡 吞 吐 量 和 响应 
LowLatency 保守 的 垃圾 收集 。 只 有 系统 存在 内 存 压力 时 ， 才 进行 完整 的 收集 。 只 应 用 于 较 短 时 间 ， 执 行 特 定 的 
操作 
SustainedLowLatency 只 有 系统 存在 内 存 压力 时 ， 才 进行 完整 的 内 存 块 收集 
NoGCRegion NET 4.6 新 增 成 员 。 对 于 GCSettings, 这 是 一 个 只 读 属性 ,可 以 在 代码 块 中 调用 GC.TryStartNoGC Region 


和 EndNoGCRegion 来 设置 它 。 调 用 TrystartNoGCRegion， 定 义 需 要 可 用 的 、GC 试图 访问 的 内 存 大 小 。 
成 功 调用 TryStartNoGCResgion 后 ， 指 定 不 应 运行 的 垃圾 收集 器 ， 直 到 调用 EndNoGCRegion 为 止 


LowLatency 或 NoGCRegion 设置 使 用 的 时 间 应 为 最 小 值 ， 分 配 的 内 存量 应 尽 可 能 小 。 如 果 不 小 心 ， 就 可 能 
出 现 洪 出 内 存 错误 。 
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17.3 强 引 用 和 和弦 引用 


垃圾 收集 器 不 能 收集 仍 在 引用 的 对 象 的 内 存 一 一 这 是 一 个 强 引 用 。 它 可 以 收集 不 在 根 表 中 直接 或 间接 引用 
的 托管 内 存 。 然 而 ， 有 时 可 能 会 筷 记 释放 引用 。 


注意 : 
如 果 对 象 相 互 引 用 ， 但 没有 在 根 表 中 引用 ， 例 如 ， 对 象 A 引 用 B，B 引 用 C，C 引 用 A， 则 GC 可 以 销毁 
所 有 这 些 对 象 。 


在 应 用 程序 代码 内 实例 化 一 个 类 或 结构 时 ， 只 要 有 代码 引用 它 ， 就 会 形成 强 引 用 。 例 如 ， 如 果 有 一 个 类 
MyClass， 并 创建 了 一 个 变量 myClassVariable 来 引用 该 类 的 对 象 ， 那 么 只 要 myClassVariable 在 作用 域内 ， 就 存 
在 对 MyClass 对 象 的 强 引用 ， 如 下 所 示 : 

Var myClassvVvariable = new MyClass(); 

这 意味 着 垃圾 收集 器 不 会 清理 MyClass 对 象 使 用 的 内 存 。 一 般 而 言 这 是 好 事 ， 因 为 可 能 需要 访问 MyClass 
对 象 ， 可 以 创建 一 个 缓存 对 象 ， 它 引用 其 他 几 个 对 象 ， 如 下 : 


var myCache = new MyCache (); 
myCache.Add (myClassVariable); 


现在 使 用 完 myClassVariable 了 。 它 可 以 超出 作用 域 ， 或 指定 为 pull: 

myClassVariable = null; 

如 果 垃 圾 收集 器 现在 运行 ， 就 不 能 释放 myClassVariable 引用 的 内 存 ， 因 为 该 对 象 仍 在 缓存 对 象 中 引用 。 这 
样 的 引用 可 以 很 容易 忘记 ， 使 用 WeakReference 可 以 避免 这 种 情况 。 

弱 引 用 允许 创建 和 使 用 对 象 , 但 是 垃圾 收集 器 磁 巧 在 运行 , 就 会 收集 对 象 并 释放 内 存 。 由 于 存在 潜在 的 bug 
和 性 能 问题 ， 一 般 不 会 这 么 做 ， 但 是 在 特定 的 情况 下 使 用 弱 引 用 是 很 合理 的 。 弱 引用 对 小 对 象 也 没有 意义 ， 因 
为 弱 引 用 有 上 自己 的 开销 ， 这 个 开销 可 能 是 比 小 对 象 更 大 。 

弱 引 用 是 使 用 WeakReference 类 创建 的 。 使 用 构造 函数 , 可 以 传递 强 引 用 。 示例 代码 创建 了 一 个 DataObject， 
并 传递 构造 函数 返回 的 引用 。 在 使 用 WeakReference 时 ， 可 以 检查 IsAlive 属性 。 再 次 使 用 该 对 象 时 ， 
WeakReference 的 Target 属性 就 返回 一 个 强 引 用 。 如 果 属 性 返回 的 值 不 是 null， 就 可 以 使 用 强 引 用 。 因 为 对 象 可 
能 在 任意 时 刻 被 收集 ， 所 以 在 引用 该 对 象 前 必须 确认 它 存 在 。 成 功 检索 强 引 用 后 ， 可 以 通过 正常 方式 使 用 它 ， 
现在 它 不 能 被 垃圾 收集 ， 因 为 它 有 一 个 强 引 用 : 

// Instantiate a weak reference to MathTest object 

var myWeakReference = new WeakReference (new DataObject ()); 

if (myWeakReference.IsAlive) 

, Dataobject strongReference = myWeakReference.Target as DataObject; 

if (strongReference != null) 


// use the strongReference 


} 
= 
{ 
/:/: reference not available 


} 


17.4 ”处 理 非 托 管 的 资源 


垃圾 收集 器 的 出 现 意味 着 ， 通 常 不 需要 担心 不 再 需要 的 对 象 ， 只 要 让 这 些 对 象 的 所 有 引用 都 超出 作用 域 ， 
并 多 许 垃圾 收集 器 在 需要 时 释放 内 存 即 可 。 但 是 ， 垃 圾 收集 器 不 知道 如 何 释放 非 托管 的 资源 (例如 ， 文 件 句 柄 、 网 
络 连 接 和 数据 库 连 接 )。 托 管 类 在 封装 对 非 托管 资源 的 直接 或 间接 引用 时 ， 需 要 制定 专门 的 规则 ， 确 保 非 托管 的 次 
源 在 收集 类 的 一 个 实例 时 释放 。 
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在 定义 一 个 类 时 ， 可 以 使 用 两 种 机 制 来 自动 释放 非 托管 的 资源 。 这 些 机 制 常 党 放 在 一 起 实现 ， 因 为 每 种 机 
制 都 为 问题 提供 了 略为 不 同 的 解决 方法 。 这 两 种 机 制 是 : 

e 声明 一 个 析 构 函数 (或 终结 器 )， 作 为 类 的 一 个 成 员 

e 在 类 中 实现 System.IDisposable 接口 

下 面 依次 讨论 这 两 种 机 制 ， 然 后 介绍 如 何 同 时 实现 它们 ， 以 获得 最 佳 的 效果 。 


17.4.1 析 构 函数 或 终结 器 


前 面 介 绍 了 构造 函数 可 以 指定 必须 在 创建 类 的 实例 时 进行 的 某 些 操作 。 相反 , 在 垃圾 收集 器 销毁 对 象 之 前 ， 
也 可 以 调用 析 构 函数 。 由 于 执行 这 个 操作 ， 因 此 析 构 函数 初 看 起 来 似乎 是 放置 释放 非 托 管 资源 、 执 行 一 般 清理 
操作 的 代码 的 最 佳 地 方 。 但 是 ， 事 情 并 不 是 如 此 简单 。 


注意 : 

在 讨论 C# 中 的 析 构 函数 时 ， 在 底层 的 .NET 体系 结构 中 ， 这 些 函 数 称 为 终结 器 (finalizer)。 在 C# 中 定义 析 构 
地 数 时 ， 编 译 器 发 送 给 程序 集 的 实际 上 是 Finalize0) 方 法 。 它 不 会 影响 源 代 码 ， 但 如 果 需 要 查看 生成 的 工 代码 ， 
就 应 知道 这 个 事实 。 


C++ 开发 人 员 应 很 熟悉 析 构 函数 的 语法 。 它 看 起 来 类 似 于 一 个 方法 ， 与 包含 的 头 同名， 但 有 一 个 前 组 波形 
符 (~)。 它 没有 返回 类 型 ， 不 带 参 数 ， 没 有 访问 修饰 符 。 下 面 是 一 个 例子 : 
class MyClass 
~MyClass'(}) 
// Finalizer implementation 
ee 
C# 编 译 占 在 编译 析 构 函数 时 ， 它 会 隐 式 地 把 析 构 函数 的 代码 编译 为 等 价 于 重 写 Finalize0 方 法 的 代码 ， 从 而 
确保 执行 父 类 的 Finalize0 方 法 。 下 面 列 出 的 C# 代 码 等 价 于 编译 器 为 ~ZMyClass0 析 构 函 数 生成 的 芽 : 
protected override void Finalize{) 
try 
{ 
z // Finalizer implementation 
Ee 
{ 二 
base.Finallizel().: 


} 
} 


如 上 所 示 ， 在 ~MyClass0 析 构 函 数 中 实现 的 代码 封装 在 Finalize0 方 法 的 一 个 try 块 中 。 对 父 类 的 Finalize0 
方法 的 调用 放 在 finally 块 中 ， 确 保 该 调用 的 执行 。 第 14 章 会 讨论 try 块 和 finally 块 。 

有 经 验 的 CH 开发 人 员 大 量 使 用 了 析 构 函数 ， 有 时 不 仅 用 于 清理 资源 ， 还 提供 调试 信息 或 执行 其 他 任务 。 
C# 析 构 函 数 要 比 C++ 析 构 函数 的 使 用 少 得 多 。 与 C++ 析 构 函数 相 比 ，C# 析 构 函 数 的 问题 是 它们 的 不 确定 性 。 在 
销毁 C++ 对 象 时 ， 其 析 构 函数 会 立即 运行 。 但 由 于 使 用 C# 时 垃圾 收集 器 的 工作 方式 ， 无 法 确定 C# 对 象 的 析 构 
函数 何 时 执行 。 所 以 ， 不 能 在 析 构 函数 中 放置 需要 在 某 一 时 刻 运 行 的 代码 ， 也 不 应 寄 望 于 析 构 函数 会 以 特定 顺 
序 对 不 同类 的 实例 调用 。 如 果 对 象 占用 了 宝贵 而 重要 的 资源 ， 应 尽快 释放 这 些 资 源 ， 此 时 就 不 能 等 待 垃圾 收 
集 器 来 释放 了 。 

男 一 个 问题 是 C# 析 构 函 数 的 实现 会 延迟 对 象 最 终 从 内 存 中 删除 的 时 间 。 没 有 析 构 函数 的 对 象 会 在 垃圾 收集 
器 的 一 次 处 理 中 从 内 存 中 删除 ， 但 有 析 构 函数 的 对 象 需要 两 次 处 理 才能 销毁 : 第 一 次 调用 析 构 函数 时 ， 没 有 删 
除 对 象 ， 第 二 次 调用 才 真 正 删除 对 象 。 另 外 ， 运 行 库 使 用 一 个 线程 来 执行 所 有 对 象 的 Finalize0 方 法 。 如 果 频 繁 
使 用 析 构 函数 ， 而 且 使 用 它们 执行 长 时 间 的 清理 任务 ， 对 性 能 的 影响 就 会 非常 显著 。 
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17.4.2 1IDisposable 接口 


在 C# 中 ， 推 荐 使 用 System.IDisposable 接口 蔡 代 析 构 函数 。IDisposable 接口 定义 了 一 种 模式 (具有 语言 级 的 
支持 ), 该 模式 为 释放 非 托管 的 资源 提供 了 确定 的 机 制 , 并 避免 产生 析 构 函数 固有 的 与 垃圾 收集 器 相关 的 问题 。 
IDisposable 接口 声明 了 一 个 Dispose0 方 法 ， 它 不 市 参数 ， 返 回 void。MyClass 类 的 Dispose0 方 法 的 实现 代码 
如 下 : 

class MyClass: IDisposable 


public void Dispose{) 
{ 
// implementation 
} 
} 


Dispose0 方 法 的 实现 代码 显 式 地 释放 由 对 象 直 接 使 用 的 所 有 非 托 管 资源 ， 并 在 所 有 也 实现 IDisposable 接口 
的 封装 对 象 上 调用 Dispose0 方 法 。 这 样 ，Dispose0 方 法 为 何 时 释放 非 托 管 资 源 提 供 了 精确 的 控制 。 

假定 有 一 个 ResourceGobbler 类 ， 它 需要 使 用 某 些 外 部 资源 ， 且 实现 IDisposable 接口 。 如 果 要 实例 化 这 个 
类 的 实例 ， 使 用 它 ， 然 后 释放 它 ， 就 可 以 使 用 下 面 的 代码 : 

var 七 heInStance = new ResourceGobbler () : 


// do Your processing 
theInstance.Dispose(); 


但 是 ， 如 果 在 处 理 过 程 中 出 现 异 常 ， 这 段 代 码 就 没有 释放 theInstance 使 用 的 资源 ， 所 以 应 使 用 try 块 ， 编 
写 下 面 的 代码 : 
ResourceGobbler theInstance = nullj]: 
try 
{ 
theInstance = new ResourceGobbler().; 
/i do your processing 
} 
finally 
{ 
theInstance?.Dispose (); 


} 


17.4.3 using 语句 


使 用 try/finally， 即 使 在 处 理 过 程 中 出 现 了 异常 ， 也 可 以 确保 总 是 在 theInstance 上 调用 Dispose0 方 法 ， 总 是 
释放 theInstance 使 用 的 任意 资源 。 但 是 ， 如 果 总 是 要 重复 这 样 的 结构 ， 代 码 就 很 容易 被 混淆 。C# 提 供 了 一 种 语 
法 ， 可 以 确保 在 实现 IDisposable 接口 的 对 象 的 引用 超出 作用 域 时 ， 在 该 对 象 上 目 动 调用 Dispose0 方 法 。 该 语法 使 
用 了 using 关键 字 来 完成 此 工作 一 一 该 关键 字 在 完全 不 同 的 环境 下 , 它 与 名 称 空间 没有 关系 。 下 面 的 代码 生成 与 
try 块 等 价 的 耳 代码 : 

using (var theInstance = new ResourceGobbler ()) 


// do Your processing 


} 
using 语句 的 后 面 是 一 对 圆 括 号 , 其 中 是 引用 变量 的 声明 和 实例 化 , 该 语句 使 变量 的 作用 域 限定 在 随后 的 语 
句 块 中 。 另 外 ， 在 变量 超出 作用 域 时 ， 即 使 出 现 异 音 ， 也 会 目 动 调用 其 Dispose0 方 法 。 


注意 ， 
using 关键 字 在 C# 中 有 多 个 用 法 。using 声明 用 于 导入 名 称 空间 。using 语句 处 理 实现 IDisposable 的 对 象 ， 
并 在 作用 域 的 末尾 调用 Dispose 方法 。 


注意 : 
.NET Framework 中 的 几 个 类 有 Close 和 Dispose 方法 。 如 果 常 常 要 关闭 资源 (如 文件 和 数据 库 ), 就 实现 Close 
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和 Dispose 方法 。 此 时 Close0 方 法 只 是 调用 Dispose0 方 法 。 这 种 方法 在 类 的 使 用 上 比较 清晰 , 还 支持 using 语句 。 
新 类 只 实现 了 Dispose 方法 ， 因 为 我 们 已 经 习惯 了 它 . 


17.4.4 ”实现 IDisposable 接口 和 析 构 函数 


前 面 的 章节 讨论 了 目 定义 类 所 使 用 的 释放 非 托 管 资源 的 两 种 方式 : 
e 利用 运行 库 强制 执行 的 析 构 函数 ， 但 析 构 函数 的 执行 是 不 确定 的 ， 而 且 ， 由 于 垃圾 收集 器 的 工作 方式 ， 
它 会 给 运行 库 增加 不 可 接受 的 系统 开销 。 
e IDisposable 接口 提供 了 一 种 机 制 , 该 机 制 允 许 类 的 用 户 控 制 释放 资源 的 时 间 , 但 需要 确保 调用 Dispose0 
方法 。 
如 果 创 建 了 终结 器 ， 就 应 该 实现 IDisposable 接口 。 假 定 大 多 数 程 序 员 都 能 正确 调用 Dispose0 方 法 ， 同 时 把 
实现 析 构 函数 作为 一 种 安全 机 制 ， 以 防 没有 调用 Dispose0 方 法 。 下 面 是 一 个 双重 实现 的 例子 : 
public class ResourceHolder: IDisposable 
private bool isDisposed = false; 
public void Dispose() 
Dispose (true); | 
GC.SuppressFinalize (this) ; 
} 
protected virtual void Dispose (bool disposing) 
- (! isDisposed) 


if (disposing) 
{ 


// Cleanup managed objects by calling their 
/i Dispose{) methods. 


// Cleanup unmanaged objects 


_1isDisposed = true; 


} 
~ResourceHolder tl() 


Dispose (false); 


public void SomeMethod () 
/i Ensure object not already disposed before execution of any method 
if( isDisposed) 
throw new ObjectDisposedException ("ResourceHolder"); 
/7 method implementation... 
} 
从 上 述 代 码 可 以 看 出 ，Dispose0 方 法 有 第 二 个 protected 重 载 方法 ， 它 带 一 个 布尔 参数 ， 这 是 真正 完成 清理 
工作 的 方法 。Dispose(bool) 方 法 由 析 构 函数 和 IDisposable.Dispose0 方 法 调用 。 这 种 方式 的 重点 是 确保 所 有 的 清 
理 代码 都 放 在 一 个 地 方 。 
传递 给 Dispose(bool) 方 法 的 参数 表示 Dispose(bool) 方 法 是 由 析 构 函数 调用 ， 还 是 由 IDisposable.Dispose0 方 
法 调用 一 一 Dispose(booDD) 方 法 不 应 从 代码 的 其 他 地 方 调用 ， 其 原因 是 : 
e 如 果 使 用 者 调用 IDisposable.Dispose0 方 法 ， 该 使 用 者 就 指定 应 清理 所 有 与 该 对 象 相关 的 资源 ， 包 括 托 
管 和 非 托 管 的 资源 。 

e 如 果 调 用 了 析 构 函数 ， 原 则 上 所 有 的 资源 仍 需 要 清理 。 但 是 在 这 种 情况 下 ， 析 构 函 数 必须 由 垃圾 收集 
器 调用 ， 而 且 用 户 不 应 试图 访问 其 他 托管 的 对 象 ， 因 为 我 们 不 再 能 确定 它们 的 状态 了。 在 这 种 情况 下 ， 
最 好 清理 已 知 的 非 托 管 资 源 ， 和 希望 任何 引用 的 托管 对 象 还 有 析 构 函数 ， 这 些 析 构 函数 执行 目 己 的 清理 
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_isDisposed 成 员 变 量 表 示 对 象 是 否 已 被 清理 ， 并 确保 不 试图 多 次 清理 成 员 变 量 。 它 还 允许 在 执行 实例 方法 
之 前 测试 对 象 是 否 已 清理 ， 如 SomeMethod0 方 法 所 示 。 这 个 简单 的 方法 不 是 线程 安全 的 ， 需 要 调用 者 确保 在 同 
一 时 刻 只 有 一 个 线程 调用 方法 。 要求 使 用 者 进行 同步 是 一 个 合理 的 假定 , 在 整个 NET 类 库 中 (例如 , 在 Collection 
类 中 ) 反 复 使 用 了 这 个 假定 。 第 21 章 将 讨论 线程 和 同步 。 

最 后 ，IDisposable.Dispose(0) 方 法 包含 一 个 对 System.GC.SuppressFinalize0 方 法 的 调用 。GC 类 表示 垃圾 收集 
器 ，SuppressFinalize0 方 法 则 告诉 垃圾 收集 器 有 一 个 类 不 再 需要 调用 其 析 构 函数 了 。 因 为 Dispose0 方 法 已 经 完 
成 了 所 有 需要 的 清理 工作 ， 所 以 析 构 函数 不 需要 做 任何 工作 。 调 用 SuppressFinalize0 方 法 就 意味 着 垃圾 收集 器 
认为 这 个 对 象 根 本 没有 析 构 函数 。 


17.4.5 1IDisposable 和 终结 器 的 规则 


学 习 了 终结 器 和 IDisposable 接口 后 ， 就 已 经 了 解 了 Dispose 模式 和 使 用 这 些 构造 的 规则 。 因 为 释放 资源 是 
托管 代码 的 一 个 重要 方面 ， 下 面 总 结 如 下 规则 : 

e 如 果 类 定义 了 实现 IDisposable 的 成 员 ， 该 类 也 应 该 实现 IDisposable。 

e 实现 IDisposable 并 不 意味 着 也 应 该 实现 一 个 终结 器 。 终 结 器 会 带 来 额外 的 开销 ， 因 为 它 需 要 创建 一 个 
对 象 ， 释放 该 对 象 的 内 存 , 需要 GC 的 额外 处 理 。 只 在 需要 时 才 应 该 实现 终结 器 , 例如 ,发 布 本 机 资源 。 
要 释放 本 机 资源 ， 就 需要 终结 器 。 

es 如 果实 现 了 终结 器 ， 也 应 该 实现 IDisposable 接口 。 这 样 ， 本 机 资源 可 以 早 些 释放 ， 而 不 仅 是 在 GC 找 
出 被 占用 的 资源 时 ， 才 释放 资源 。 

e 在 终结 器 的 实现 代码 中 ， 不 能 访问 已 终结 的 对 象 了 。 终 结 器 的 执行 顺序 是 没有 保证 的 。 

es 如 果 所 使 用 的 一 个 对 象 实 现 了 IDisposable 接口 , 就 在 不 再 需要 对 象 时 调用 Dispose 方法 。 如 果 在 方法 中 
使 用 这 个 对 象 ，using 语句 比较 方便 。 如 果 对 象 是 类 的 一 个 成 员 ， 就 让 类 也 实现 IDisposable。 


17.5 不 安全 的 代码 


如 前 所 述 ，C# 非 常 擅长 于 对 开发 人 员 隐 藏 大 部 分 基本 内 存 管理 ， 因 为 它 使 用 了 垃圾 收集 器 和 引用 。 但 是 ， 
有 时 需要 直接 访问 内 存 。 例 如 ， 由 于 性 能 问题 ， 要 在 外 部 ( 非 NET 环境 ) 的 DLL 中 访问 一 个 函数 ， 该 函数 需要 
把 一 个 指针 当 作 参 数 来 传递 (许多 Windows API 函数 就 是 这 样 )。 本 节 将 论述 C# 直 接 访问 内 存 的 内 容 的 功能 。 


17.5.1 用 指针 直接 访问 内 存 


下 面 把 指针 当 作 一 个 新 论题 来 介绍 ， 而 实际 上 ， 指 针 并 不 是 新 东西 。 因 为 在 代码 中 可 以 自由 使 用 引用 ， 而 
引用 就 是 一 个 类 型 安全 的 指针 。 前 面 已 经 介绍 了 表示 对 和 象 和 数组 的 变量 实际 上 存储 相应 数据 (被 引用 者 ) 的 内 存 
地 址 。 指 针 只 是 一 个 以 与 引用 相同 的 方式 存储 地 址 的 变量 。 其 区 别 是 C# 不 允许 直接 访问 在 引用 变量 中 包含 的 地 
址 。 有 了 引用 后 ， 从 语法 上 看 ， 变 量 就 可 以 存储 引用 的 实际 内 容 。 

C# 引 用 主要 用 于 使 C# 语 言 易于 使 用 ， 防 止 用 户 无 意 中 执 行 某 些 破坏 内 存 中 内 容 的 操作 。 男 一 方面 ， 使 用 
指针 ， 就 可 以 访问 实际 的 内 存 地 址 ， 执 行 新 类 型 的 操作 。 例 如 ， 给 地 址 加 上 4 个 字 节 ， 就 可 以 查看 甚至 修改 存 
储 在 新 地 址 中 的 数据 。 

下 面 是 使 用 指针 的 两 个 主要 原因 : 

® 辣 后 兼容 性 一 一 尽管 .NET 运行 库 提供 了 许多 工具 , 但 仍 可 以 调用 本 地 的 Windows API 函数 。 对 于 茶 些 

操作 ， 这 可 能 是 完成 任务 的 唯一 方式 。 这 些 API 函数 都 是 用 C++ 或 CH 如 言 编写 的 ， 通 第 要 求 把 指针 作 
为 其 参数 。 但 在 许多 情况 下 ， 还 可 以 使 用 Dllimport 声明 ， 以 避免 使 用 指针 ， 例 如 ， 使 用 System.IntPtr 
e 性 能 一 在 一 些 情况 下 ， 速 度 是 最 重要 的 ， 而 指针 可 以 提供 最 优 性 能 。 假 定 用 尸 知道 自己 在 做 什么 ， 就 
可 以 确保 以 最 高 效 的 方式 访问 或 处 理 数 据 。 但 是 ， 注 意 在 代码 的 其 他 区 域 中 ， 不 使 用 指针 ， 也 可 以 对 
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性 能 进行 必要 的 改进 。 请 使 用 代码 配置 文件 ， 碍 找 代码 中 的 瓶颈 ， Visual Studio 中 就 包含 一 个 代码 配 
置 文件 。 

但 是 ， 这 种 低级 的 内 存 访问 也 是 有 代价 的 。 使 用 指针 的 语法 比 引 用 类 型 的 语法 更 复杂 。 而 且 ， 指 针 使 用 起 
来 比较 困难 ， 需 要 非常 高 的 编程 技巧 和 很 强 的 能 力 ， 仔 细 考 虑 代码 所 完成 的 逻辑 操作 ， 才 能 成 功 地 使 用 指针 。 
如 果 不 仔细 ， 使 用 指针 就 很 容易 在 程序 中 引入 细微 的 、 难 以 碍 找 的 错误 。 例 如 ， 很 容易 重 写 其 他 变量 ， 寻 致 栈 
洲 出 ， 访 问 某 些 没有 存储 变量 的 内 存 区 域 ， 甚 至 重 写 .NET 运行 库 所 需要 的 代码 信息 ， 因 而 使 程序 裔 误 。 

尽管 有 这 些 问题 ， 但 指针 在 编写 高 效 的 代码 时 是 一 种 非常 强大 和 灵活 的 工具 。 


注意 : 

这 里 强烈 建议 不 要 轻易 使 用 指针 , 否则 代码 不 仅 难 以 编写 和 调试 , 而且 无 法 通过 CLR 施加 的 内 存 类 型 安全 
检查 。 

1. 用 unsafe 关键 字 编写 不 安全 的 代码 

因为 使 用 指针 会 带 来 相关 的 风险 , 所 以 C# 只 允许 在 特别 标记 的 代码 块 中 使 用 指针 。 标记 代码 所 用 的 关键 字 
是 unsafe。 下 面 的 代码 把 一 个 方法 标记 为 unsafe: 

unsafe int GetSomeNumber () 


/code that can use pointers 


| 

任何 方法 都 可 以 标记 为 unsafe 一 一 无 论 该 方法 是 否 应 用 了 其 他 修饰 符 (例如 ， 静 态 方 法 、 虚 方法 等 )。 在 这 种 
方法 中 ，unsafe 修饰 符 还 会 应 用 到 方法 的 参数 上 ， 人 允许 把 指针 用 作 参 数 。 还 可 以 把 整个 类 或 结构 标记 为 unsafe， 
这 表示 假设 所 有 的 成 员 都 是 不 安全 的 : 


unsafe class MycCclass 


| 


/any method in this class can now Use pointers 


同样 ， 可 以 把 成 员 标 记 为 unsafe: 
class MyClass 


unsafe int* PX; // declaration of a pointer field in a class 


} 
也 可 以 把 方法 中 的 一 块 代 码 标 记 为 unsafe: 
VD19 MyMethod()} 


// code that doesn't use pointers 
unsafe 


// unsafe code that uses pointers here 


/more 'safe' code that doesn't use pointers 


I 
但 要 注意 ， 不 能 把 局 部 变量 本 身 标记 为 unsafe: 


int MyMethod() 
{ 

unsafe int *pXx; // WRONG 
} 


如 果 要 使 用 不 安全 的 局 部 变量 ， 就 需要 在 不 安全 的 方法 或 语句 块 中 声明 和 使 用 它 。 在 使 用 指针 前 还 有 一 步 
要 完成 。C# 编 译 器 会 拒绝 不 安全 的 代码 ， 除 非 告 诉 编译 器 代码 包含 不 安全 的 代码 块 。 可 以 通过 设置 csproj 项 目 
文件 的 AllowUnsafeBlocks, 如 图 17-5 所 示 , 或 者 在 Visual Studio Build Project Properties 设置 中 选择 Allow Unsafe 
Code 复 选 框 ， 配 置 不 安全 的 代码 : 

<PropertyGroup> 


<AllowUnsafeBlocks>True</AllowUnsafeBlocks> 
</PropertyGroup> 
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2. 指针 的 语法 
把 代码 块 标记 为 unsafe 后 ， 就 可 以 使 用 下 面 的 语法 声明 指针 : 


int* pWidth, pHeight; 

double* pResult; 

byte*[] pFlags; 

这 段 代 码 声明 了 4 个 变量 ,pWidth 和 pHeight 是 整数 指针 ，pResult 是 double 型 指针 ，pFlags 是 字 节 型 的 数 
组 指针 。 我 们 常常 在 指针 变量 名 的 前 面 使 用 前 缀 p 来 表示 这 些 变量 是 指针 。 在 变量 声明 中 ,符号 * 表 示 声 明 一 个 
指针 ， 换 言 之 ， 就 是 存储 特定 类 型 的 变量 的 地 址 。 

声明 了 指针 类 型 的 变量 后 ， 就 可 以 用 与 一 般 变量 相同 的 方式 使 用 它们 ， 但 首先 需要 学 习 男 外 两 个 运算 符 : 

e && 表 示 “ 取 地 址 ”， 并 把 一 个 值 数据 类 型 转换 为 指针 ， 例如 ，int 转换 为 *int。 这 个 运算 符 称 为 寻 址 运算 符 。 

e * 表 示 “ 获 取 地 址 的 内 容 ”， 把 一 个 指针 转换 为 值 数 据 类 型 (例如 ，*float 转换 为 float)。 这 个 运算 和 从 称 为 

“间接 寻 址 运算 符 ”( 有 时 称 为 “取消 引用 运算 符 ”)。 
从 这 些 定义 中 可 以 看 出 ，& 和 * 的 作用 是 相反 的 。 


注意 : 

符号 及 和 * 也 表示 按 位 AND(&) 和 来 法 (四 运算 符 , 为 什么 还 可 以 以 这 种 方式 使 用 它们 ?答案 是 在 实际 使 用 时 
它们 是 不 会 混淆 的 ， 用 户 和 编译 器 总 是 知道 在 什么 情况 下 这 两 个 符号 有 什么 含义 ， 因 为 按照 指针 的 定义 ， 这 些 
符号 总 是 以 一 元 运算 符 的 形式 出 现 一 -它们 只 作用 于 一 个 变量 ， 并 出 现在 代码 中 该 变量 的 前 面 。 另 一 方面 ， 按 
位 AND 和 乘法 运算 符 是 二 元 运算 符 ， 它 们 需要 两 个 操作 数 。 


下 面 的 代码 说 明了 如 何 使 用 这 些 运 算 符 ; 


int w = 10: 
int* pX, pY; 


PR = &X; 
PT = pX; 
oY = 20» 


首先 声明 一 个 整数 x， 其 值 是 10。 接 着 声明 两 个 整数 指针 pX 和 pY。 然 后 把 pX 设置 为 指向 x( 换 言 之 ， 把 
pX 的 内 容 设 置 为 x 的 地 址 )。 然 后 把 pX 的 值 赋予 pY， 所 以 pY 也 指向 x。 最 后 ， 在 语句 *pY = 20 中 ， 把 值 20 
赋予 pY 指向 的 地 址 包含 的 内 容 。 实 际 上 是 把 x 的 内 容 改 为 20， 因 为 pY 指 同 x。 注 意 在 这 里 ， 变 量 pY 和 x 
之 间 没 有 任何 关系 。 只 是 此 时 pY 碰巧 指向 存储 x 的 存储 单元 而 已 。 

要 进一步 理解 这 个 过 程 ， 假 定 x 存储 在 栈 的 存储 单元 0x12F8C4 一 0xl2F8C7 中 (十 进 制 就 是 1243332 一 
1243335, 即 有 4 个 存储 单元 , 因为 一 个 int 占用 4 个 字 节 )。 因 为 栈 向 下 分 配 内 存 ,所 以 变量 pX 存储 在 0x12F8C0 一 
0x12F8C3 的 位 置 上 ，PpY 存储 在 0x12F8BC 一 0x12F8BF 的 位 置 上 。 注 意 ，pX 和 pY 也 分 别 占 用 4 个 字 节 。 这 不 
是 因为 一 个 int 占用 4 个 字 节 ， 而 是 因为 在 32 位 处 理 器 上 ， 需 要 用 4 个 字 节 存储 一 个 地 址 。 利 用 这 些 地 址 ， 在 执行 
完 上 述 代码 后 ， 栈 应 如 图 17-5 所 示 。 


Ox12F8C4-0x12F8C7 x=20 (=0x14) 
Ox12F8CO0-Ox12F8C3 PX=0x12F8C4 


Ox12F8BC-Ox12F8BF prY=012F8C4 


17-5 


注意 : 

这 个 示例 使 用 int 说 明 该 过 程 ， 其 中 int 存储 在 32 位 处 理 器 中 栈 的 连续 空间 上 ， 但 并 不 是 所 有 的 数据 类 型 
都 会 存储 在 连续 的 空间 中 。 原因 是 32 位 处 理 器 最 擅长 于 在 4 个 字 节 的 内 存 块 中 检索 数据 。 这 种 计算 机 上 的 内 存 
会 分 解 为 4 个 字 节 的 块 ， 在 Windows 上 ， 每 个 块 有 时 称 为 DWORD， 因 为 这 是 32 位 无 符号 int 数 在 NET 出 现 
之 前 的 名 字 。 这 是 从 内 存 中 获取 DWORD 的 最 高 效 的 方式 一 -跨越 DWORD 边界 存储 数据 通常 会 降低 硬件 的 性 
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能 。 因 此 ，.NET 运行 库 通常 会 给 某 些 数据 类 型 填充 一 些 空间 ， 使 它们 占用 的 内 存 是 4 的 倍数 。 例 如 ，short 数 
据 占 用 两 个 字 节 ， 但 如 果 把 一 个 short 放 在 栈 中 ， 栈 指针 仍 会 向 下 移动 4 个 字 节 ， 而 不 是 两 个 字 节 ， 这 样 ， 下 一 
个 存储 在 栈 中 的 变量 就 仍 从 DWORD 的 边界 开始 存储 。 


可 以 把 指针 声明 为 任意 一 种 值 类 型 一 一 即 任何 预定 义 的 类 型 uint、int 和 byte 等， 也 可 以 声明 为 一 个 结构 。 
但 是 不 能 把 指针 声明 为 一 个 类 或 数组 ， 因 为 这 么 做 会 使 垃圾 收集 器 出 现 问 题 。 为 了 正常 工作 ， 垃 圾 收集 器 需要 
知道 在 堆 上 创建 了 什么 类 的 实例 ， 它 们 在 什么 地 方 。 但 如 果 代 码 开始 使 用 指针 处 理 类 ， 就 很 容易 破坏 堆 中 .NET 
运行 库 为 垃圾 收集 器 维护 的 与 类 相关 的 信息 。 在 这 里 ， 垃 圾 收集 器 可 以 访问 的 任何 数据 类 型 称 为 托管 类 型 ， 而 
指针 只 能 声明 为 非 托管 类 型 ， 因 为 垃圾 收集 器 不 能 处 理 它 们 。 

3. 将 指针 强制 转换 为 整数 类 型 

由 于 指针 实际 上 存储 了 一 个 表示 地 址 的 整数 , 因此 任何 指针 中 的 地 址 都 可 以 和 任何 整数 类 型 之 间 相 互 转换 。 
指针 到 整数 类 型 的 转换 必须 是 显 式 指定 的 ， 隐 式 的 转换 是 不 允许 的 。 例 如 ， 编 写 下 面 的 代码 是 合法 的 : 

ee 

PX = E&F 

PY = PpXir 

#DY = 205 

ulong Y = (ulong)pX; 

int* pD = {int*}yv¥; 

把 指针 pX 中 包含 的 地 址 强制 转换 为 一 个 uint， 存 储 在 变量 y 中 。 接 着 把 y 强制 转换 回 一 个 int*， 存 储 在 新 
变量 pD 中 。 因 此 pD 也 指向 x 的 值 。 

把 指针 的 值 强制 转换 为 整数 类 型 的 主要 目的 是 显示 它 。 虽 然 插 入 字符 串 和 Console.Write0 方 法 没有 带 指针 
的 重 载 方法 ， 但 是 必须 把 指针 的 值 强制 转换 为 整数 类 型 ， 这 两 个 方法 才能 接受 和 显示 它们 : 


WriteLine{($"Address is {pX}"); // wrong -- will give a compilation error 
WriteLine ($"Address is {(ulong})pX}"); // OK 


可 以 把 一 个 指针 强制 转换 为 任何 整数 类 型 ， 但 是 ， 因 为 在 32 位 系统 上 ， 一 个 地 址 占用 4 个 字 节 ， 把 指针 强 
制 转换 为 除了 uint、long 或 ulong 之 外 的 数据 类 型 ， 肯 定 会 导致 溢出 错误 (int 也 可 能 导致 这 个 问题 ， 因 为 它 的 
取 值 范围 是 -20 亿 ~20 亿 ， 而 地 址 的 取 值 范围 是 0~40 亿 )。 如 果 创 建 64 位 应 用 程序 ， 就 需要 把 指针 强制 转换 为 
ulong 类 型 。 

还 要 注意 ，checked 关键 字 不 能 用 于 涉及 指针 的 转换 。 对 于 这 种 转换 ， 即 使 在 设置 checked 的 情况 下 ， 发 生 
浇 出 时 也 不 会 抛 出 异常 。.NET 运行 库 假 定 ， 如 果 使 用 指针 ， 吏 知 着 自己 要 做 什么 ， 不 必 担 心 可 能 出 现 的 溢出 。 

4. 指针 类 型 之 则 的 强制 转换 

也 可 以 在 指向 不 同类 型 的 指针 之 间 进 行 显 式 的 转换 。 例 如 : 

byte aBvyte = 8.; 

byte* pByte= &aByte; 

double* pDouble = (double*)pByte; 

这 是 一 段 合法 的 代码 ， 但 如 果 要 执行 这 段 代码 ， 就 要 小 心 了 。 在 上 面 的 示例 中 ， 如 果 要 查找 指针 pDouble 
指 同 的 double 值 ， 就 会 查找 包含 1 个 byte(aByte) 的 内 存 ， 和 一 些 其 他 内 存 ， 并 把 它 当 作 包 含 一 个 double 值 的 内 
存 区 域 来 对 待 一 一 这 不 会 得 到 一 个 有 意义 的 值 。 但 是 ， 可 以 在 类 型 之 间 转 换 ， 实 现 C union 类 型 的 等 价 形式 , 或 
者 把 指针 强制 转换 为 其 他 类 型 ， 例 如 ， 把 指针 转换 为 sbyte， 来 检查 内 存 的 单个 字 节 。 


5. void 指针 
如 果 要 维护 一 个 指针 ， 但 不 希望 指定 它 指 同 的 数据 类 型 ， 就 可 以 把 指针 声明 为 void: 


int* pointerToInt; 
vold* pointerToVoid; 
pointerToVvoid = (void*})}pointerToInt; 


void 指针 的 主要 用 途 是 调用 需要 void* 参 数 的 API 图 数 。 在 CH#Hi 滞 言 中 ， 使 用 void 指针 的 情况 并 不 是 很 多 。 
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特殊 情况 下 ， 如 果 试 图 使 用 * 运 算 符 取消 引用 void 指针 ， 编 译 器 就 会 标记 一 个 错误 。 
6. 指针 算术 的 运算 


可 以 给 指针 加 减 整数 。 但 是 ， 编 译 器 很 智能 ， 知 道 如 何 执行 这 个 操作 。 例 如 ， 假 定 有 一 个 int 指针 ， 要 在 其 值 
上 加 1。 编 译 器 会 假定 我 们 要 得 找 int 后 面 的 存储 单元 ， 因 此 会 给 该 值 加 上 4 个 字 节 ， 即 加 上 一 个 int 占用 的 字 节 
数 。 如 果 这 是 一 个 double 指针 ， 加 1 就 表示 在 指针 的 值 上 加 8 个 字 节 ， 即 一 个 double 占用 的 字 节 数 。 只 有 指针 指 
问 byte 或 sbyte( 都 是 1 个 字 节 ) 时 ， 才 会 给 该 指针 的 值 加 上 1。 

可 以 对 指针 使 用 运算 符 +、-、+=、 一 =、+ 首 和 -一 ， 这 些 运 算 符 右边 的 变量 必须 是 long 或 ulong 类 型 。 


注意 : 
不 允许 对 void 指针 执行 算术 运算 。 


例如 ， 假 定 有 如 下 定义 : 

Uint uu = 3; 

byte b = 8; 

double d = 10.0; 

uint* pUint= gu; // size of a uint is 4 

byte* pByte = &g&b; // size of a byte is 1 
double* pDouble = &d; // size of a double is 8 


下 面 假定 这 些 指针 指向 的 地 址 是 : 

® DpUmt: 1243332 

® DpByte: 1243328 

es pDouble: 1243320 

执行 这 段 代 码 后 : 

++pUint; // adds (1*4) = 4 bytes to pUint 

pByte -= 3; // subtracts (3*1) = 3 bytes from pByte 
double* pDouble?2 = pDouble + 4; // pDouble2 = pDouble + 32 bytes (4*8 bytes) 
指针 应 包含 的 内 容 是 : 

® DpUmt: 1243336 

® DBVyte: 1243323 

® pDouble2: 1243352 


注意 ; 

一 般 规则 是 ， 给 类 型 为 工 的 指针 加 上 数值 义 ， 其 中 指针 的 值 为 P， 则 得 到 的 结果 是 P+ 又 *(sizeof(T))。 使 用 
这 条 规则 时 要 小 心 。 如 果 给 定 类 型 的 连续 值 存 储 在 连续 的 存储 单元 中 ， 指 针 加 法 就 允许 在 存储 单元 之 间 移 动 指 
针 。 但 如 果 类 型 是 byte 或 char， 其 总 字 节 数 不 是 4 的 倍数 ， 连 续 值 就 不 是 默认 地 存储 在 连续 的 存储 单元 中 。 


如 果 两 个 指针 都 指向 相同 的 数据 类 型 ， 则 也 可 以 把 一 个 指针 从 男 一 个 指针 中 减 去 。 此 时 , 结果 是 一 个 long,， 
其 值 是 指针 值 的 差 被 该 数据 类 型 所 占用 的 字 节 数 整 除 的 结果 : 

double* pDl1 = (double*}1243324; // note that it is perfectly Valid to 

/i initialize a pointer like this. 


double* pD2 = (double*})1243300; 
long L = pD1l-pD2; // gives the result 3 (=24/sizeof (double)})) 


7. sizeof 运算 符 


这 一 节 将 介绍 如 何 确定 各 种 数据 类 型 的 大 小 。 如 果 需 要 在 代码 中 使 用 茶 种 类 型 的 大 小 ， 就 可 以 使 用 sizeof 
运算 符 ， 它 的 参数 是 数据 类 型 的 名 称 ， 返 回 该 类 型 鼎 用 的 字 节 数 。 例 如 ;: 


int x = sizeof (double); 
这 将 设置 x 的 值 为 8。 


使 用 sizeof 的 优点 是 不 必 在 代码 中 硬 编码 数据 类 型 的 大 小 , 使 代码 的 移植 性 更 强 。 对 于 预定 义 的 数据 类 型 ， 
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sizeof 返回 下 面 的 值 。 
sizeof (sbyte) = 1; sizeof (byte) = 1; 
sizeof Short) = 2; sizeof (ushort)y = 2. 
Sizeof (int}) = 4; sizeof (uint) = 4; 
sizeof (long) = 8; sizeof (ulong) = 8; 
Sizeof (char) = 2; sizeof (floaty) = 4; 


sizeof (double}) = 8; sizeof (bool} = 1; 

也 可 以 对 目 己 定义 的 结构 使 用 sizeof， 但 此 时 得 到 的 结果 取决 于 结构 中 的 字段 类 型 。 不 能 对 类 使 用 sizeof。 

8. 结构 指针 : 指针 成 员 访 问 运算 符 

结构 指针 的 工作 方式 与 预定 义 值 类 型 的 指针 的 工作 方式 完全 相同 。 但 是 这 有 一 个 条 件 : 结构 不 能 包含 任何 
引用 类 型 ， 这 是 因为 前 面 介绍 的 一 个 限制 一 一 指针 不 能 指 回 任何 引用 类 型 。 为 了 避免 这 种 情况 ， 如 果 创 建 一 个 
指针 ， 它 指向 包含 任何 引用 类 型 的 任何 结构 ， 编 译 器 就 会 标记 一 个 错误 。 

假定 定义 了 如 下 结构 : 

struct MyStruct 


Public long X; 
Public float F; 
} 


就 可 以 给 它 定 义 一 个 指针 : 
MyStruct* pStruct; 
然后 对 其 进行 初始 化 : 


var mySsStruct = new MyStruct () ; 
pStruct = &myStruct; 


也 可 以 通过 指针 访问 结构 的 成 员 值 : 


{(*pStruct) .XX = 4; 
(*pStruct}.F = 3.4f; 


但 是 ， 这 个 语法 有 后 复杂 。 因 此 ，C# 定 义 了 男 一 个 运算 符 ， 用 一 种 比较 简单 的 语法 ， 通 过 指针 访问 结构 的 
成 员 ， 它 称 为 指针 成 员 访 问 运算 符 ， 其 符号 是 一 个 短 划 线 ， 后 跟 一 个 大 于 号 ， 它 看 起 来 像 一 个 箭头 : 一 。 


注意 : 
C++ 开发 人 员 能 识别 指针 成 员 访 问 运算 符 。 因 为 C++ 使 用 这 个 符号 完成 相同 的 任务 。 
使 用 这 个 指针 成 员 访 问 运算 符 ， 上 述 代码 可 以 重 写 为 : 


PStLITUC 上 一 > 天 = 4; 
pStruct-—>F = 3.4f; 


也 可 以 直接 把 合适 类 型 的 指针 设置 为 指 问 结构 中 的 一 个 字段 


long* pL = & (Struct.X); 
float* pF = &{(Struct.F)s 


或 者 


long* pL = & (pStruct— >X).; 
float* pF = &(pStruct— >rF).,; 


9. 类 成 员 的 指针 

前 面 说 过 ， 不 能 创建 指 同类 的 指针 ， 这 是 因为 垃圾 收集 器 不 维护 关于 指针 的 任何 信息 ， 只 维护 关于 引用 的 
信息 ， 因 此 创建 指 癌 类 的 指针 会 使 垃圾 收集 器 不 能 正常 工作 。 

但 是 ， 大 多 数 类 都 包含 值 类 型 的 成 员 ， 可 以 为 这 些 值 类 型 成 员 创 建 指 针 , 但 这 需要 一 种 特殊 的 语法 。 例 如， 
假定 把 上 面 示例 中 的 结构 重 写 为 类 ; 

class MyClass 

public long X; 


Public float 下; 
} 
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然后 就 可 以 为 它 的 字段 XX 和 下 创建 指针 了 ， 方 法 与 前 面 一 样 。 但 这 么 做 会 产生 一 个 编译 错误 : 


Var myObject = new MyClass (); 
long* pL = & (myGbject.X); // wrong -—— compilation error 
float* pF = &(myObject.F); // wrong -—— compilation error 


尽管 入 和 下 都 是 非 托 管 类 型 ， 但 它们 磐 入 在 一 个 对 象 中 ， 这 个 对 象 存 储 在 堆 上 。 在 垃圾 收集 的 过 程 中 ， 垃 
圾 收集 器 会 把 MyObject 移动 到 内 存 的 一 个 新 单元 上 ,， 这样, pL 和 pF 就 会 指 同 错误 的 存储 地 址 。 由 于 存在 这 个 
问题 ， 因 此 编译 器 个 允许 以 这 种 方式 把 托 官 类 型 的 成 员 的 地 址 分 配给 指针 。 

解决 这 个 问题 的 方法 是 使 用 fixed 关键 字 ， 它 会 告诉 垃圾 收集 器 ， 可 能 有 引用 某 些 对 象 的 成 员 的 指针 ， 所 
以 这 些 对 象 不 能 移动 。 如 果 要 声明 一 个 指针 ， 则 使 用 fxed 的 语法 ， 如 下 所 示 : 


Var myObject = new MyClass (); 
fixed (long* pObject = & (myobject.X)) 
{ 
// do something 
} 


在 关键 字 fixed 后 面 的 圆 括号 中 ， 定 义 和 初 始 化 指针 变量 。 这 个 指针 变量 (在 本 例 中 是 pObject) 的 作用 域 是 
花 括 号 标识 的 fixed 块 。 这 样 ， 垃 圾 收集 器 就 知道 ， 在 执行 fixed 块 中 的 代码 时 ， 不 能 移动 myObject 对 象 。 
如 果 要 声明 多 个 这 样 的 指针 ， 就 可 以 在 同一 个 代码 块 前 放置 多 条 fixed 语句 : 


Var myObject = new MyClass (); 
fixed (long* pX = &{(myobject.X)) 
fixed (float* pF = & (myobject.rF)) 
{ 

i:/ do something 


如 果 要 在 不 同 的 阶段 固定 几 个 指针 ， 就 可 以 岁 套 整个 fixed 块 : 
Var myObject = new MyClass (); 
fixed (long* pX = & {myobject.X)) 

// do something with pX 

fixed (float* pF = & (myobject.F)) 


// do something else with pF 
} 
} 


如 果 这 些 变量 的 类 型 相同 ， 就 可 以 在 同一 个 fixed 块 中 初始 化 多 个 变量 : 


Var myObject = new MyClass (}); 
Var myObject2 = new MyClass (); 
fixed (long* pX = & (myoObject.X), pX2 = & (myObject2 .XX)) 
{ 
// etc. 
} 


在 上 述 情 况 中 ， 是 否 声 明 不 同 的 指针 ， 让 它们 指向 相同 或 不 同 对 象 中 的 字段 ， 或 者 指向 与 类 实例 无 关 的 琵 
态 字 段 ， 这 一 点 并 不 重要 。 


17.5.2 ”指针 示例 : PointerPlayground 


为 了 理解 指针 ， 最 好 编写 一 个 使 用 指针 的 程序 ， 再 使 用 调试 器 。 下 面 给 出 一 个 使 用 指针 的 示例 : 
PointerPlayground。 它 执行 一 些 简 单 的 指针 操作 ， 显 示 结 果 ， 还 允许 查看 内 存 中 发 生 的 情况 ， 并 确定 变量 存储 在 
什么 地 方 (代码 文件 PointerPlayground/Program_cs): 


class Program 


{ 


unsafe static void Main'() 
{ 

int x=10.- 

Short vw = -1; 


byte vy2 = 人; 
double z = 1.5; 
int* pX = EX; 
short* pY = E&Y; 
double* p22 = &zr 


第 17 章 托管 和 非 托 管内 存 | 365 


Console.WriteLine($"Address of x is Ox{ (ulong) &x:X}, ™ 十 
$s"sijze is {sizeof (i1nt)}, value is {x}"™); 
Console.WriteLine($"Address of Y 1is Ox{ (ULong) gy2:X}, ™ + 
Ss"size is {sizeof (short)}, value is {yy}"); 
Console.WriteLine($"Address of Y2 is Ox{ (ulong) &y2:X}, ™ + 
s"Sslze is {sizeof (byte)}, value 1is {vy2}"); 
Console.WriteLine($"Address of z is 0x{ (ulong) &z:X}, ™ 十 
$s"size is {sizeof (double}}, value is {2z}"); 
Console.WriteLine($"Address of pX=&x 15 Ox{ (ulong) EpX:X}, "+ 
s"slize is {sizeof (int*)}, value 15 Ox{ (ulong)pX:X}"); 
Console.WriteLine($"Address of pY=&y 1S Oxf{ (ulong) gpY:X}, "+ 
$s"size 1s {sizeof (short*}}, value is Ox{ (ulong}pY:X}"); 
Console.WriteLine($"Address of p2=&z 15 0x{ (ulong) EpZ:X}, ™ + 
s"slze is {sizeof (double*)}}, value is Ox{ (ulong) pzZ:X}"); 
*pX = 之 口 ; 
Console.WriteLine($"After settijng *pX, X = {x}"); 
Console.WriteLine($"*pX = {*pX}"); 
PE = (double*) px; 
Console.WriteLine($"x treated as a double = {*p2}"); 
Console.ReadLine (}); 


} 
} 
这 段 代 码 声明 了 4 个 值 变量 : 
® 1ntx 
® shorty 
® bytey2 
® doublez 


它 还 声明 了 指 回 其 中 3 个 值 的 指针 : pX、pY 和 pzZ。 

然后 显示 这 3 个 变量 的 值 ， 以 及 它们 的 大 小 和 地 址 。 注 意 在 获取 pxX、pY 和 pZ 的 地 址 时 ， 我 们 查看 的 是 
指针 的 指针 ， 即 值 的 地 址 的 地 址 ! 还 要 注意 , 与 显示 地 址 的 常见 方式 一 致 ， 在 WriteLine0 命 令 中 使 用 {0:X} 格 式 
说 明 符 ， 确 保 该 内 存 地 址 以 十 六 进 制 格式 显示 。 

最 后 ， 使 用 指针 pX 把 x 的 值 改 为 20， 执 行 一 些 指 针 类 型 强制 转换 ， 如 果 把 x 的 内 容 当 作 double 类 型 ， 就 
会 得 到 无 意义 的 结果 。 

编译 并 运行 这 段 代码 ， 得 到 下 面 的 结果 : 

Address of xX is 0x376943D5A8, size is 4, value is 10 

Address of Y is Ox376943D5A0, size is 2, Value is -1 

Address of Y2 135 0x376943D5998, size 15 1, value is 4 

Address of z is 0x376943D590, size is 8, value is 1.5 

Address of pX=&x 1s Ox376943D588, size 15 8, value is Ox3716943D5n8 

Address of pY=g&y 15 Ox376943D580, size 15 8, value is Ox3716943D5A0 

Address of p2Z=&z is Ox376943D578, size is 8, value is Ox376943D590 

After setting *pX, X = 20 

*pX = 20 

XX treated as a double = 9.88131291682493E—323 


注意 : 
用 CoreCLR 运行 应 用 程序 时 ， 每 次 运行 应 用 程序 都 会 显示 不 同 的 地 址 ， 


检查 这 些 结果 ， 可 以 证 实 “ 后 台 内 存 管理 ”一 节 描 述 的 栈 操 作 ， 即 栈 癌 下 给 变量 分 配 内 存 。 注 意 ， 这 还 证 
实 了 栈 中 的 内 存 块 总 是 按照 4 个 字 节 的 倍数 进行 分 配 。 例 如 ，y 是 一 个 short 数 (其 大 小 为 2 字 节 )， 其 地 址 是 
0xD4E710( 十 六 进 制 )， 表 示 为 该 变量 分 配 的 存储 单元 是 0xD4E710~0xD4E713。 如 果 .NET 运行 库 严格 地 逐个 排 
列 变量 ， 则 y 应 只 占用 两 个 存储 单元 ， 即 0xD4E712 和 0xD4E713。 

下 一 个 示例 PointerPlayground2 介绍 指针 的 算术 ， 以 及 结构 指针 和 类 成 员 。 开 始 时 ， 定 义 一 个 结构 
CurencyStmct， 它 把 货币 值 表示 为 美元 和 美 分 ， 再 定义 一 个 等 价 的 类 CurencyClass( 代码 文件 
PointerPlayeround2/Currency.cs ): 


internal struct CurrencySstruct 
{ 

public long Dollars; 

public byte Cents; 
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public override string ToStIrIng() => $"$ {Dollars}. {Cents}™; 
} 


internal class CurrencyClass 
{ 

public long Dollars = 0; 

Public byte Cents = 07 

public override string ToSsString{() => $"$ {Dollars}.{Cents}™; 
} 


定义 好 结构 和 类 后 ， 就 可 以 对 它们 应 用 指针 了 。 下 面 的 代码 是 一 个 新 的 示例 。 这 段 代码 比较 长 ， 我 们 对 此 
将 做 详细 讲解 。 首 先 显示 CurrencyStruct 结构 的 字 节 数 ， 创 建 它 的 两 个 实例 和 一 些 指针 ， 然 后 使 用 pAmount 指 
针 初 始 化 一 个 CurrencyStruct 结构 amountl 的 成 员 ， 显 示 变 量 的 地 址 (代码 文件 PointerPlayground2/Program.cs ): 


unsafe static void Maint) 

{ 
Console .WriteLine($"Size of CurrencySstruct struct is ™ + 

ss"{sizeof (CurrencyStruct}) }"); 

CurrencySstruct amountl, amount2; 
CUuIrrencySstruct* pAmount = &amountl; 
long* PDollars = & (pAmounNnt—>Dollars}); 
byte* pCents = & (pAmount—>Cents).; 
Console .WriteLine ("Address of amountl] is Ox{ (ulong) gamountl :Xx}"); 
Console .WriteLine ("Address of amount2 is Ox{ (ulong) tamount2:X}"); 
Console.WriteLine ("Address of pAmount is Ox{ (ulong) spAmount: XxX}"); 
Console.WriteLine ("Address of pDollars is Ox{ (ulong) gpDollars:XxX}"); 
Console.WriteLine ("Address of pCents 15 Ox{ (ulong) spCents: XxX}"); 


PAmount—>Dollars = 20; 
*#*DCents = 50; 
Console .WriteLine (S$"amountl contains {amountl}™"™):; 
ee 
} 


现在 根据 栈 的 工作 方式 ， 执 行 一 些 指 针 操 作 。 因 为 变量 是 按 顺 序 声 明 的 ， 所 以 amount2 存储 在 amountl 后 
面 的 地 址 中 。sizeof(CurrencyStruct) 运 算 符 返 回 16( 见 后 面 的 屏幕 输出 )， 所 以 CurrencyStruct 结构 占用 的 字 节 数 是 4 
的 倍数 。 在 递减 了 Currency 指针 后 ， 它 就 指 同 amount2: 


—-—pAmount; // this should get it to point to amount2 
Console.WriteLine ($"amount2 has address 0x{ (ulong})}pAmount:X} "+ 
$s"and contains {*pAmount}"); 


在 调用 Console.WiiteLine0 语 句 时 , 它 显 示 了 amount 的 内 容 , 但 还 没有 对 它 进 行 初始 化 。 显 示 出 来 的 东西 就 
是 随机 的 垃圾 一 一 在 执行 该 示例 前 内 存 中 存储 在 该 单元 中 的 内 容 。 但 这 有 一 个 要 点 : 一 般 情况 下 ，C# 编 译 器 会 森 
止 使 用 未 初始 化 的 变量 ， 但 在 开始 使 用 指针 时 ， 就 很 容易 绕 过 许多 通常 的 编译 检查 。 此 时 我 们 这 么 做 ， 是 因为 编 
译 器 无 法 知道 我 们 实际 上 要 显示 的 是 amount?2 的 内 容 。 因 为 知道 了 栈 的 工作 方式 ， 所 以 可 以 说 出 递减 PAmount 的 
结果 是 什么 。 使 用 指针 算术 ， 可 以 访问 编译 器 通常 禁止 访问 的 各 种 变量 和 存储 单元 ， 因 此 指针 算术 是 不 安全 的 。 

接 下 来 在 pCents 指针 上 进行 指针 运算 。pCents 指针 目前 指 问 amountl.Cents, 但 此 处 的 目的 是 使 用 指针 算术 
让 它 指 同 amount2.Cents， 而 不 是 直接 告诉 编译 器 我 们 要 做 什么 。 为 此 ， 需 要 从 pCents 指针 所 包含 的 地 址 中 减 
去 sizeofl(Currency): 

// do some clever casting to get pCents to point to cents 

// inside amount2 

Currencystruct* pTempCurrency = (Currencystruct*)pCents; 


pCents = (byte*} ( -~-pTempCurrency }; 
Console.WriteLine ("Address of pCents 15 now Ox{0:X}", (ulong) spCents); 


最 后 ， 使 用 fixed 关键 字 创建 一 些 指向 类 实例 中 字段 的 指针 ， 使 用 这 些 指针 设置 这 个 实例 的 值 。 注 意 ， 这 
也 是 我 们 第 一 次 查看 存储 在 堆 中 (而 不 是 栈 ) 的 项 的 地 址 ; 


Console .WriteLine ("\nNow with classes"™); 

/i now try it out with classes 

VAaAr amount3 = new CurrencyClasst(); 

fixed(long* pDollars2 = &(amount3.Dollars)) 

fixed(byte* pCents2 = &(amount3.Ccents)) 

{ 
Console .WriteLine($"amount3.Dollars has address Ox{ (ulong)}pDollars2:X})"); 
Console .WriteLine($"amount3.Ccents has address 0x{ (ulong)pCents2:X}"); 
*DDOoOl1lars2 = -100.; 
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编译 并 运行 这 段 代 码 ， 得 到 如 下 所 示 的 结果 : 
Size of CurrencySsStruct struct is 16 
Address of amountl is 0xD290DCD7TCO 
Bddress of amount2 15 OxD290DCDTBO0 
Address of pAmount is OxD290DCDT7A8 
Address of pDollars 15 0XD290DCD7RAO 
Address of pCents 1s OQxD290DCD798 

amountl1 contains $ 20.50 

amount2 has address 0xD29390DCDTB0 and contains $ 0.0 
Address of pCents is now OxD290DCD798 
Now with classes 

amount3.Dollars has address VxD2920C91AT0 
amount3.cents has address OxD292C91A18 
amount3 contains $ -100.0 


注意 ， 在 这 个 结果 中 ， 显 示 了 未 初始 化 的 amount2 的 值 ，CurencyStruct 结构 的 字 节 数 是 16， 大 于 其 字段 
的 字 节 数 ( 一 个 long 数 占 用 8 个 字 节 ， 加 上 1 个 字 节 等 于 9 个 字 节 )。 


17.5.3 ”使 用 指针 优化 性 能 


前 面 用 许多 篇 幅 介 绍 了 使 用 指针 可 以 完成 的 各 种 任务 ， 但 在 前 面 的 示例 中 ， 仅 是 处 理 内 存 ， 让 有 兴趣 的 人 
们 了 解 实 际 上 发 生 了 什么 事 ， 并 没有 帮助 人 们 编写 出 更 好 的 代码 ! 本 节 将 应 用 我 们 对 指针 的 理解 ， 用 一 个 示例 
来 说 明 使 用 指针 可 以 大 大 提高 性 能 。 

1. 创建 基于 栈 的 数组 

本 节 将 探讨 指针 的 一 个 主要 应 用 领域 : 在 栈 中 创建 高 性 能 、 低 系统 开销 的 数组 。 第 2 章 介 绍 了 C# 如 何 文 持 
数组 的 处 理 。 第 7 章 详 细 介 绍 了 数组 。C# 很 容易 使 用 一 维 数组 和 和 矩形 或 锯齿 形 多 维 数组 ， 但 有 一 个 缺点 ， 这 些 数 
组 实际 上 都 是 对 象 ， 它 们 是 System.Array 的 实例 。 因 此 数组 存储 在 堆 上 ， 这 会 增加 系统 开销 。 有 时 ， 我 们 希望 
创建 一 个 使 用 时 间 比 较 短 的 高 性 能 数组 ， 不 希望 有 引用 对 象 的 系统 开销 。 而 使 用 指针 就 可 以 做 到 ， 但 指针 只 对 
于 一 维 数 组 比较 简单 。 

为 了 创建 一 个 高 性 能 的 数组 ， 需 要 使 用 另 一 个 关键 字 : stackalloc。stackalloc 命令 指示 .NET 运行 库 在 栈 上 
分 配 一 定量 的 内 存 。 在 调用 stackalloc 命令 时 ， 需 要 为 它 提 供 两 条 信息 : 

e 要 存储 的 数据 类 型 

e 需要 存储 的 数据 项 数 

例如 ， 要 分 配 足 够 的 内 存 ， 以 存储 10 个 decimal 数据 项 ， 可 以 编写 下 面 的 代码 : 

decimal* pDecimals = stackalloc decimal[10]; 

注意 ， 这 条 命令 只 分 配 栈 内 存 。 它 不 会 试图 把 内 存 初 始 化 为 任何 默认 值 ， 这 正好 符合 我 们 的 目的 。 因 为 要 
创建 一 个 高 性 能 的 数组 ， 给 它 不 必要 地 初始 化 相应 值 会 降低 性 能 。 

同样 ， 要 存储 20 个 double 数据 项 ， 可 以 编写 下 面 的 代码 : 

double* pDoubles = stackalloc double[20]; 

虽然 这 行 代 码 指 定 把 变量 的 个 数 存 储 为 一 个 常数 ， 但 它 等 于 在 运行 时 计算 的 一 个 数字 。 所 以 可 以 把 上 面 的 
示例 写 为 : 

we // or some other value calculated at runtime 

double* pDoubles = stackalloc double[size]; 

从 这 些 代 码 段 中 可 以 看 出 ，stackalloc 的 语法 有 点 不 寻常 。 它 的 后 面 紧 跟 要 存储 的 数据 类 型 名 (该 数据 类 型 
必须 是 一 个 值 类 型 )， 之 后 把 需要 的 项 数 放 在 方 括号 中 。 分 配 的 字 节 数 是 项 数 乘 以 sizeof( 数 据 类 型 )。 在 这 里 ， 
使 用 方 括号 表示 这 是 一 个 数组 。 如 果 给 20 个 double 数 分 配 存储 单元 ， 就 得 到 了 一 个 有 20 个 元 素 的 double 
数组 ， 最 简单 的 数组 类 型 是 逐个 存储 元 素 的 内 存 块 ， 如 图 17-6 所 示 。 
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在 栈 上 分 配 的 
连续 存储 单元 


数组 的 第 0 个 元 素 


数组 的 第 1 个 元 素 
数组 的 第 2 个 元 素 


17-6 


在 图 17-6 中 ， 显 示 了 stackalloc 返回 的 指针 ，stackalloc 总 是 返回 分 配 数据 类 型 的 指针 ， 它 指 回 新 分 配 内 存 
块 的 顶部 。 要 使 用 这 个 内 存 块 ， 可 以 取消 对 已 返回 指针 的 引用 。 例 如 ， 给 20 个 double 数 分 配 内 存 后 ， 把 第 一 
个 元 素 ( 数 组 的 元 素 0) 设 置 为 3.0， 可 以 编写 下 面 的 代码 : 


double* pDoubles = stackalloc double[z20]; 
*pDoubles = 3.0; 


要 访问 数组 的 下 一 个 元 素 ， 可 以 使 用 指针 算术 。 如 前 所 述 ， 如 果 给 一 个 指针 加 1， 它 的 值 就 会 增加 它 指 癌 
的 数据 类 型 的 字 节 数 。 在 本 例 中 ， 就 会 把 指针 指向 己 分 配 的 内 存 块 中 的 下 一 个 空间 存储 单元 。 因 此 可 以 把 数组 
的 第 二 个 元 素 ( 元 系 编 号 为 1) 设 置 为 8.4: 

double* pDoubles = stackalloc double[20]; 

*pDoubles = 3.0; 

*(pDoubles + 1) = 8.4; 

同样 ， 可 以 用 表达 式 *(pDoubles+ 双 访问 数组 中 下 标 为 X 的 元 素 。 

这 样 ， 就 得 到 一 种 访问 数组 中 元 素 的 方式 ， 但 对 于 一 般 目的 ， 使 用 这 种 语法 过 于 复杂 。C# 为 此 定义 了 田 
一 种 语法 。 对 指针 应 用 方 插 号 时 ，C# 为 方 括 号 提供 了 一 种 非常 精确 的 含义 。 如 果 变 量 p 是 任意 指针 类 型 ，X 
是 一 个 整数 ， 表 达 式 p[X] 就 被 编译 器 解释 为 *p+TX)， 这 适用 于 所 有 的 指针 ， 不 仅仅 是 用 stackalloc 初始 化 的 
指针 。 利 用 这 个 简洁 的 表示 法 ， 就 可 以 用 一 种 非常 方便 的 语法 访问 数组 。 实 际 上 ， 访 问 基 于 栈 的 一 维 数组 所 
使 用 的 语法 与 访问 由 System.Array 类 表示 的 基于 堆 的 数组 完全 相同 : 

double* pDoubles = stackalloc double [20]; 


pDoubles[0] = 3.0; // pDoubles[0] is the same as *pDoubles 
pDoubles[1] = 838.4; // pDoubles[1] is the same as *(pDoublest+1) 


注意 : 

把 数组 的 语法 应 用 于 指针 并 不 是 新 东西 。 自 从 开发 出 C 和 C++H 语 言 以 来 ， 它 就 是 这 两 种 语言 的 基础 部 分 。 
实际 上 ，C++ 开 发 人 员 会 把 这 里 用 stackalloc 获得 的 、 基 于 栈 的 数组 完全 等 同 于 传统 的 基于 栈 的 C 和 C++ 数组 。 
这 种 语法 和 指针 与 数组 的 链接 方式 是 C 语言 在 20 世纪 70 年 代 后 期 流行 起 来 的 原因 之 一 ,也 是 指针 的 使 用 成 为 
C 和 C++ 中 一 种 流行 的 编程 技巧 的 主要 原因 。 


尽管 高 性 能 的 数组 可 以 用 与 一 般 C# 数 组 相同 的 方式 访问 ， 但 需要 注意 : 在 C# 中 ， 下 面 的 代码 会 抛 出 一 个 
异常: 


double[] myDoubleArray = new double [20]: 
myDoubleArray[S30] = 3.0; 


抛 出 异常 的 原因 是 : 使 用 越界 的 下 标 来 访问 数组 ， 下 标 是 50， 而 允许 的 最 大 下 标 是 19。 但 是 ， 如 果 使 用 
stackalloc 声明 了 一 个 等 价 的 数组 ， 对 数组 进行 边界 检查 时 ， 这 个 数组 中 就 没有 封装 任何 对 象 ， 因 此 下 面 的 代码 
不 会 抛 出 异 滑 : 


double* pDoubles = stackalloc double [20]; 
PpDoubles[50] = 3.0; 


在 这 段 代 码 中 ， 我 们 分 配 了 足够 的 内 存 来 存储 20 个 double 类 型 的 数 。 接 着 把 sizeofdouble) 存 储 单元 的 起 
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始 位 置 设 置 为 该 存储 单元 的 起 始 位 置 加 上 5$0*sizeoffdouble) 个 存储 单元 ， 来 保存 双 精 度 值 3.0。 但 这 个 存储 单元 
超出 了 刚才 为 double 数 分 配 的 内 存 区 域 。 谁 也 不 知道 这 个 地 址 存储 了 什么 数据 。 最 好 是 只 使 用 某 个 当前 未 使 用 
的 内 存 , 但 所 重 写 的 存储 单元 也 有 可 能 是 在 栈 上 用 于 存储 其 他 变量 ， 或 者 是 某 个 正在 执行 的 方法 的 返回 地 址 。 
因此 ， 使 用 指针 获得 高 性 能 的 同时 ， 也 会 付出 一 些 代 价 ， 需 要 确保 自己 知道 在 做 什么 ， 否 则 就 会 抛 出 非常 古怪 
的 运行 错误 。 

2. QuickArray 示例 

下 面 用 一 个 stackalloc 示例 QuickArray 来 结束 关于 指针 的 讨论 。 在 这 个 示例 中 ， 程 序 仅 要 求 用 户 提 供 为 数 
组 分 配 的 元 素数 。 然 后 代码 使 用 stackalloc 给 long 型 数组 分 配 一 定 的 存储 单元 。 这 个 数组 的 元 素 是 从 0 开始 的 
整数 的 平方 ， 结 果 显 示 在 控制 台 上 (代码 文件 QuickArray/Program.cs): 


class Program 
{ 
unsafe static woid Maint{) 
{ 
Console.Write ("How big an array do you want? \n> "™);} 
string userIinput = ReadLine (}; 
uint size = uint.Parse(userIinput); 
long* pArray = stackalloc long[ (int) sizel]; 
for (nt 1 = 0; i < size; 1i++) 
{ 


pArray[i] = i*i; 
for (int i = 0; i < size; i++} 
Console .WriteLine (S$"Element {1i} = {* (pArray + 1)1}"); 
Console.ReadLine (}); 
运行 这 个 示例 ， 得 到 如 下 所 示 的 结果 : 


How big an array do You want? 
> 15 


Element 0 = 0 
Element 1 = 1 
Element 2 = 4 
Element 3 = 9 
Element 4 = 16 
Element 5 = 25 
Element 6 = 36 
Element 7 = 49 


Element 8 = 64 

Element 9 = 81 

Element 10 = 100 
Element 11 = 121 
Element 112 = 144 
Element 13 = 169 
Element 14 = 196 


17.6 引用 的 语义 


第 3 章 展示 了 在 将 参数 传递 给 方法 时 所 使 用 的 ref 关键 字 。 当 通过 值 传递 结构 时 ， 将 复制 结构 的 内 容 。 通 
过 引用 传递 结构 (使 用 ref 关键 字 )， 新 变量 会 引用 相同 的 数据 。 

通过 C# 7.0， 还 可 以 使 用 ref 关键 字 作 为 返回 类 型 的 修饰 待 ， 并 作为 本 地 变量 的 修饰 竺 。 在 C# 7.2 中 ， 可 
以 将 readonly 修饰 符 添加 到 ref 关键 字 ， 以 不 允许 更 改 。C# 7.2 还 添加 了 in 关键 字 ， 以 通过 引用 传递 值 类 型 ， 
而 不 允许 它们 发 生 更 改 。 本 节 将 讨论 这 些 新 特性 。 

一 方面 ， 最 好 有 不 可 变 类 型 ， 因 为 这 些 类 型 允许 从 多 个 线程 中 访问 ， 而 不 需要 同步 ， 因 为 没有 线程 可 以 更 
改 值 。 然 而 ， 不 可 变 类 型 也 意味 着 需要 复制 大 量 数据 。 对 于 值 类 型 ， 需 要 复制 数据 ， 当 然 ， 这 也 会 降低 性 能 。 
使 用 引用 类 型 ， 需 要 不 同 的 变量 来 引用 堆 上 的 相同 数据 ， 而 且 这 些 数据 可 能 也 需要 一 个 副本 。 例 如 ，string 类 
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型 是 不 可 变 的 。 像 ToUpper 和 ToLower 这 样 string 类 型 的 方法 永远 不 会 更 改 字符 串 ， 而 是 返回 一 个 新 字符 串 。 
当 这 些 对 象 不 再 被 引用 时 ， 和 需要 收集 垃圾 。 为 了 避免 过 度 使 用 垃圾 收集 器 和 复制 数据 ， 而 不 需要 使 用 IntPtr 和 
不 安全 的 代码 ，ref 关键 字 的 增强 功能 提供 了 极 大 的 帮助 。 
ReferenceSemantics 示例 使 用 了 如 下 名 称 空间 : 
System 
System.Linqg 
看 看 下 面 的 Data 类 。 该 类 包含 变量 名 称 为 anumber 的 值 类 型 int， 它 在 构造 函数 中 初始 化 。 方 法 Show 将 
数字 的 当前 值 写 入 控制 台 。 最 有 趣 的 部 分 是 GetNumber 方法 。 在 实现 代码 中 ， 变 量 anumber 使 用 ref 关键 字 返 
回 ， 以 返回 对 它 的 引用 。 这 是 由 GetNumber 的 返回 类 型 的 声明 实现 的 ; 它 是 ref int 类 型 的 声明 ， 返 回 一 个 对 int 
的 引用 。GetReadonlyNumber 方法 是 一 个 ref readonly int 返回 的 方法 。ref readonly 是 C# 7.2 中 新 增 的 ， 通 过 引 
用 返回 值 类 型 ， 但 是 不 允许 由 调用 者 改变 (代码 文件 ReferenceSemantics/Data.cs): 


Public class Data 
{ 


Public Datal(int anumber) => anumber = anumber; 
private int anumber; 


Public ref int GetNumber() => ref anumber; 
public ref readonly int GetReadonlyNumber() => ref anumber; 


public void Show() => Console.WriteLine(s"Data: { anumber}"); 
} 


下 面 使 用 Data 类 并 调用 GetNumber 方法 。 该 方法 声明 为 返回 ref int, 但 是 在 下 面 的 代码 片段 中 ,结果 写 到 
一 个 int 中 。n 是 一 个 本 地 变量 ， 它 保存 了 一 个 int，GetNumber 的 结果 会 复制 到 这 个 变量 中 。 更 改 本 地 变量 的 
值 时 ，Data 类 内 的 数据 不 会 更 改 ( 代 码 文件 ReferenceSemantics/Proeram.cs): 

static void UseMember () 

ee (nameof (UseMember) ) ; 


var d = new Data (ll1}).: 
int n = d.GetNumber{():; 


Console .WriteLine().: 


} 

运行 应 用 程序 时 ， 输 出 显示 ，Data 类 在 本 地 变量 更 改 之 后 仍然 包含 初始 化 的 数据 : 
UseMember 

Data: 11 


在 方法 UseRefMember 的 实现 中 做 一 个 小 小 的 更 改 ， 调 用 GetNumber 方法 ,返回 一 个 ref, 它 在 方法 之 前 指 
定 ref 关键 字 ， 变 量 n 指定 为 ref local， 因 此 它 在 Data 类 中 直接 引用 anumber。 也 可 以 用 refreadonly 修饰 符 声 
明 本 地 变量 。 方 法 GetNumber 返回 ref int 的 结果 可 以 分 配给 ref readonly int， 这 保证 不 能 更 改变 量 n2。 编 译 器 
会 抱怨 n2 是 否 会 被 更 改 (代码 文件 ReferenceSemantics/Program.cs): 


static void UseRefMember() 
{ 
Console .WriteLine (nameof (UseRefMember)):; 
var dd = new Data (lll)}).: 
ref int n = ref d.SGetNumbert{():; 
n 一 42; 
d.Show(): 


ref readonly int n2 = d.GetNumber (); 
/i n2 = 42; // not allowed - it's readonly! 
Console .WriteLine (); 


} 

使 用 此 更 改 运行 应 用 程序 时 ，Data 类 中 的 数据 将 更 改 。 不 需要 使 用 ntpt 和 不 安全 的 代码 ， 也 可 以 快速 直 
接地 访问 : 

UseRefMember 


Data: 42 
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接 下 来 ， 调 用 方法 GetReadonlyNumber。 这 个 方法 返回 ref readonly int。 可 以 将 结果 赋 给 一 个 int。 把 ref 赋 
予 int 会 建立 一 个 副本 ， 副 本 可 以 更 改 ， 但 不 会 更 改 原始 副本 。 将 结果 分 配给 ref readonly int， 会 通过 引用 传递 
结果 ， 但 结果 不 能 更 改 (代码 文件 ReferenceSemantics/Proeram.cs): 


static void UseReadonlyRefMember () 

{ 
Console.WriteLine (nameof (UseReadonlyRefMember)); 
Var d= new Datat(ll).; 
int n = d.GetReadonlyNumber(}; // create a copy 
n = 42; 
d. Showt(}; 


i:/ ret int n = d.GetReadonlyNumber(}); // not allowed 
ref readonly int n2 = ref d.GetReadonlyNumber (); 

/i/ n2 = 42; // not allowed 

Console .WriteLine().; 


I 
该 方法 的 结果 是 一 个 不 变 的 Data 成 员 : 


UseRefMember 
Data: 11 


17.6.1 传递 ref 和 返回 ref 


下 面 是 另 一 个 例子 : 传递 一 个 ref int 并 返回 一 个 ref int。 Max 方法 通过 ref 接收 x 和 yy 参数， 并 通过 ref 
返回 这 两 个 值 的 较 高 者 (代码 文件 ReferenceSemantics/Proeram.cs): 

static ref int Max{(ref int x, ref int Y) 

{ 


if (x > Y) return ref x; 
eelse return ref vy; 


} 

如 果 不 需 要 复制 变量 x 和 y， 将 它们 传递 给 方法 Max， 则 可 以 快速 返回 较 高 的 值 。 如 果 经 常 调用 此 方法 ， 
这 将 非常 有 用 : 

static vold UseMax() 

{ 


Console .WriteLine (nameof (UseMax})).: 
1nt = 4, Y= 了; 
ref int z = ref Maxl(ref x, ref vy); 
Console.WriteLine ($"{z} is the max of {x} and {vy}"); 
En 

} 


返回 的 消息 如 下 : 
5 is the max of 4 and 5 
返回 引用 是 很 快速 的 ， 因 为 幕后 只 使 用 指针 。 但 是 ， 这 也 意味 着 可 以 更 改 引 用 指 问 的 原始 项 。 例 如 ， 改 变 
引用 x 或 y 中 数据 的 变量 z， 根 据 较 大 的 值 ， 也 改变 了 原始 变量 的 值 : 
ee voOld UseMax () 
FB 
zz 二 和 十 Yr 


Console.WriteLine ($s$"y after changing z: {vy}"); 


Console .WriteLine (}); 


} 
运行 这 个 程序 时 ， 可 以 看 到 y 现在 有 了 被 分 配 的 值 。 
y after changing z: 9 

17.6.2 ref 和 数组 


另 一 个 展示 refreturm 和 ref local 特性 的 示例 使 用 了 该 关键 字 与 数组 .类 Container 定义 了 nt 类 型 的 成 员 ( 它 
们 在 构造 函数 中 初始 化 )。GetItem 方法 通过 引用 返回 数组 的 一 个 项 。 这 人 允许 在 容器 数组 中 直接 使 用 快速 路 径 ( 代 
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码 文 件 ReferenceSemantics/Container cs): 
Public class Container 
{ 


public Contalner (Int[] data) => data = data; 
private int[] data; 


i 
Public ref int GetItem(int index) => ref datal[lindex]; 


public void ShowAll() 
{ 
Console._WriteLine{(string-.Join(", ", data))}); 
Console.WriteLine(). 
} 
} 


当 使 用 这 个 Container 时 ， 一 个 包含 10 项 列表 的 样本 数组 被 传递 给 构造 函数 。 第 4 项 从 GetItem 方法 中 检 
索 ， 此 项 更 改 为 33， 最 后 所 有 项 都 使 用 ShowAl 方法 写 入 控制 台 ( 代 码 文件 ReferenceSemantics/Program.cs): 

private static void UseItemOofcontainert{) 
{ 

Console .WriteLine (nameof (UseItemOfcCcontainer}}.; 

Var C = new Container (Enumerable.Range (0, 10) .Select (x => X) .ToArray () ); 

ref int item = ref c.GetItem(3).; 

item = 33; 

CcC.ShowAll()}); 

Console .WriteLine'r().; 


} 


运行 应 用 程序 时 ， 可 以 看 到 第 4 项 从 外 部 更 改 : 

0 

下 面 看 看 添加 GetData 方法 除了 处 理 数组 项 之 外 ， 还 可 以 处 理 完整 的 数组 。 该 方法 返回 一 个 对 数组 本 身 的 
引用 (代码 文件 ReferenceSemantics/Container.cs): 


Public class Container 
{ 
7 


Public ref int[] GetData() => ref data; 


Pha 
} 


使 用 Container 类 的 GetData 方法 ,将 返回 数组 的 引用 ， 并 将 其 写 入 ref 本 地 变量 dl 中 。 一 个 包含 三 个 元 素 
的 新 数组 被 分 配给 这 个 变量 (代码 文件 ReferenceSemantics/Program.cs): 
private static void UseArrayofContainer() 
{ 
ConSsole .ATrIteLIne (nameof (UseArrayOfContainer))}; 
Var CcC = new Container (Enumerable.Range (0, 10) .Select (x => x) .ToArray () ) ; 
ref Int[] di = ref c.GetData ().; 
dl = new int[] { 4, 5, 6 }; 
C.ShowAllt(); 
Console .WriteLine'(),; 


} 


因为 返回 对 数组 的 引用 , 所 以 可 以 伙 换 完整 的 数组 。 容器 现在 包含 新 创建 的 数组 ， 其 中 包含 元 素 4、5 和 6: 


UseArrayofContainer 
4, 5, 6 


注意 : 

用 于 refreturns 和 reflocals 的 ref 关键 字 需 要 在 返回 引用 时 保持 活跃 . 例如 , 只 要 在 引用 类 型 中 包含 值 类 型 ， 
就 可 以 返回 对 值 类 型 的 引用 ， 这 样 它们 就 在 托管 的 堆 中 。 使 用 结构 ， 不 能 定义 方法 来 返回 结构 成 员 的 引用 。 可 
以 将 对 结构 的 引用 返回 为 引用 ， 如 Max 方法 所 示 。 这 些 值 类 型 在 方法 返回 时 应 保证 是 活跃 的 ， 因 为 它们 是 由 等 
待 返回 方法 的 调用 者 传递 的 。 
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注意 : 

第 3 章 介 绍 了 使 用 ref、out 和 加 修饰 符 定义 和 参数。 这些 修饰 符 在 引用 语义 方面 也 很 重要 。 使 用 C#7.2 的 新 
参数 in 和 值 类 型 ， 指 定 值 类 型 是 通过 引用 传递 的 (类 似 于 通过 参数 使 用 Tef 关键 字 )， 但 是 不 允许 更 改 它 。 对 于 
参数 ，in 类 似 于 refreadonly。 


17.7 Span<T> 


第 3 章 介 绍 了 创建 引用 类 型 (类 ) 和 值 类 型 (结构 )。 类 的 实例 存储 在 托管 堆 上 。 结 构 的 值 可 以 存储 在 堆栈 上 ， 
或 者 当 使 用 装 箱 时 ， 可 以 存储 在 托管 堆 上 。 现 在 我 们 有 了 男 一 种 类 型 ,一 种 只 能 在 堆栈 上 存储 其 值 的 类 型 ， 而 
不 会 在 堆 上 存储 ， 有 时 称 为 类 ref 类 型 。 这 种 类 型 的 装 箱 是 不 可 能 的 。 这 样 的 类 型 用 ref truct 关键 字 声 明 。 使 用 
ref struct 提供 了 一 些 额 外 的 行为 和 限制 。 限 制 如 下 : 

e 它们 不 能 添加 为 数组 项 。 

e 它们 不 能 用 作 泛 型 类 型 参数 。 

e 它们 不 能 装 箱 。 

e 它们 不 能 是 静态 字段 。 

e 它们 只 能 是 类 ref 类 型 的 实例 字段 。 

在 本 节 中 ，Span<T> 和 ReadOnlySpan<T> 是 类 似 于 ref 的 类 型 。 这 些 类 型 已 经 在 讨论 数组 扩展 方法 的 第 7 
章 中 介绍 了 ， 在 第 9 章 中 介绍 了 字符 串 的 扩展 方法 。 这 里 介绍 的 附加 特性 包括 在 托管 堆 、 堆 栈 和 本 机 堆 上 引用 
数据 。 


17.7.1 Span 引用 托管 堆 


Span 可 以 引用 托管 堆 上 的 内 存 ， 如 第 7 和 第 9 章 所 示 。 在 下 面 的 代码 片段 中 ,创建 了 一 个 数组 ， 并 使 用 扩 
展 方法 AsSpan 创建 了 一 个 新 的 Span， 它 引用 托管 堆 上 数组 的 内 存 。 创 建 在 变量 spanl 中 引用 的 Span 之 后 ， 创 
建 Span 的 一 个 切片 ， 其 中 用 值 42 填充 。 下 一 个 Console.WriteLine 将 spanl 的 值 写 入 控制 台 ( 代 码 文件 
SpanSample/Proeram.cs): 

Private static void SpanonTheHeap () 


Console.WriteLine (nameof (SpanonTheHeap) ) ; 
Span<int> spanl = {new lnt[] { 1， 5, 11, 71, 22, 19, 21, 33 }) .asSpanf) ; 


spanl.slice (start: 4, length: 3) .Fil1l1 (42); 
Console.WriteLine (string.Join{", ", spanl.ToArray())}); 


Console .WriteLine (}); 


} 
运行 应 用 程序 时 ， 可 以 看 到 在 span 的 切片 中 ， 用 42 填充 的 spanl 的 输出 : 


SpanonTheHeap 
1, 5, 11, 71, 42, 42, 42, 33 


17.7.2 Span 引用 栈 


Span 可 以 用 来 引用 堆栈 上 的 内 存 。 在 堆栈 上 引用 单个 变量 并 不 像 引 用 一 个 内 存 块 那样 有 趣 ， 这 就 是 为 什么 
下 面 的 代码 片段 使 用 stackalloc 关键 字 的 原因 。stackalloc 返回 一 个 lone*， 它 要 求 将 方法 SpanOnTheStack 声明 
为 unsafe， 而 Span 类 型 的 构造 函数 允许 传递 一 个 指针 和 表示 该 指针 大 小 的 附加 参数 。 接 下 来 ， 变 量 spanl 与 索 
引 器 一 起 使 用 ， 以 填充 每 个 条 目 (代码 文件 SpanSample/Program.cs): 
private static unsafe Vola SpanonThesStack() 
console.WriteLine (nameof (SpanonThestack) ) ; 


long* lp = stackalloc long[20]; 
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Var Spanl = new Span<long> (1p, 20); 


for (int i = 0; i < 20; i++) 
{ 
spanl[i] = i; 


} 


Console .WriteLine (string.Join{(", ", spanl.ToArray(}))})); 
Console .WriteLine'().; 


} 
运行 该 程序 时 ， 以 下 输出 显示 了 在 堆栈 上 初始 化 数据 的 Span: 


spanonTheSstack 
0, 1, 2, 3, 4, 5, 6, 1, 8, 9, 10, 1i, 12, 3, 14,. 15, 1é6, 17, 18, 19 


17.7.3 ”Span 引用 本 机 堆 


Span 的 一 个 重要 特征 是 它们 也 可 以 引用 本 机 堆 上 的 内 存 。 本 机 堆 上 的 内 存 通 营 是 从 本 机 API 上 分 配 的 。 在 
下 面 的 代码 片段 中 , Marshal 类 的 AllocHGlobal 方法 用 于 在 本 机 堆 上 分 配 100 个 字 节 。 Marshal 类 返回 一 个 IntPtr 
类 型 的 指针 。 为 了 直接 访问 int*， 调 用 了 IntPtr 的 ToPointer 方法 。 这 是 Span 类 的 构造 函数 所 需要 的 指针 。 在 此 
内 存 中 写 入 int 值 ， 应 注意 需要 多 少 字 节 。 当 int 包含 32 位 时 ， 字 节 数 除 以 4， 并 移动 两 位 。 在 此 之 后 ， 通 过 调 
用 Span 的 Fill 方法 来 填充 本 机 内 存 。 在 for 循环 中 ， 从 Span 中 引用 的 每 个 项 都 写 到 控制 台 ( 代 码 文件 
SpanSample/Program.cs): 

private static unsafe void SpanoOnNativeMemory () 

Console.WriteLine (nameof (SpanOonNativeMemory) ); 

const Int nbytes = 100. 
IntPtr p = Marshal.AllocHG1lobal (nbytes); 
int* p2 = (int*}p-ToPointer ()，; 


Span<int> span = new Span<int>(p2, nbytes >> 2); 
span.Fill (42); 
Int max = nbytes >> 2; 
for (int 1 = 0; 1 < max; 工 二 +) 
{ 
Console .Write(s$"{span[i]} "™); 
} 
Console .WriteLinel).; 
} 
finally 
{ 


Marshal .FreeHGlobal (p}; 


Console .WriteLine():; 


} 

运行 应 用 程序 时 ， 存 储 在 本 机 堆 中 的 值 将 写 入 控制 台 : 

SpanOnNativeMemory 

42 42 42 42 42 42 42 42 42 42 42 42 4A2 42 42 A422 42 42 42 42 42 42 42 42 42 

注意 : 

使 用 Span 访 问 本 机 内 存 和 堆栈 , 需要 使 用 不 安全 的 代码 ,因为 通过 传递 一 个 指针 来 创建 Span 和 分 配 内 存 。 
在 初始 化 之 后 ， 使 用 Span， 就 不 再 需要 不 安全 的 代码 。 


17.7.4 Span 扩展 方法 


对 于 Span 类 型 ， 定 义 了 扩展 方法 ， 使 其 更 容易 使 用 这 种 类 型 。 下 面 的 代码 片段 演示 了 Overlaps、Reverse 
和 IndexOf 方法 的 使 用 。 使 用 Overlaps 方法 ， 检 查 用 于 调用 此 扩展 方法 的 span 是 否 与 该 参数 传递 的 span 重 登 。 
Reverse 方法 反 转 了 span 的 内 容 。.IndexOf 方法 返回 用 参数 传递 的 span 的 索引 (代码 文件 SpanSample/Program.cs): 


private static void SpanExtensions () 
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Console.WriteLine (nameof (SpanExtensions)); 

Span<int> spanl = (new int[] { 1, 5, 11, 71, 22, 19, 21, 33 }) .AsSpan (); 

Span<int> span2 = spanl.Sslice(3, 4); 

bool overlaps = spanl .Overlaps (span2).; 

Console.WriteLine($"spanl overlaps span?2: {overlaps}"); 

spanl .Reversel().; 

Console.WriteLine ($"spanl reversed: {string.Join(", ", spanl.ToArray())})}"); 

Console.WriteLine($"span2 (a slice) after reversing spanl: ™+ 
s"{string.Join(™", ", span?2.ToArray(}))})}"); 

int index = spanl.IndexOf (span2).; 

Console.WriteLine ($"index of span2 in spanl: {index}"™").; 

Console.WriteLine (); 


} 
运行 这 个 程序 ， 产 生 如 下 输出 : 
SpanExtensions 


spanl overlaps span2: True 

spanl reversed: 33, 21, 19, 22, 11. 11, SS. 1 

span2 {a slice) after reversing spanl: 22, 71, 1l1, 5 

index of span2 in spanl: 3 

为 Span 类 型 定义 的 其 他 扩展 方法 是 StartWith， 用 于 检查 一 个 Span 是 否 以 另 一 个 Span 的 序列 开始 ， 
SequenceEqual 用 于 比较 两 个 Span 的 序列 ，SequenceCompareTo 用 于 对 序列 排序 , LastIndexOf 返回 从 Span 末尾 
处 开始 的 第 一 个 匹配 索引 。 


17.8 平台 调用 


并 不 是 Windows API 调用 的 所 有 特性 都 可 用 于 NET。 旧 的 Windows API 调用 是 这 样 ， 新 功能 也 是 这 样 。 也 
许 开 发 人 员 会 编写 一 些 DLL， 导 出 非 托 管 的 方法 ， 在 C# 中 使 用 它们 。 

要 重用 一 个 非 托管 库 ， 其 中 不 包含 COM 对 象 ， 只 包含 导出 的 功能 ， 就 可 以 使 用 平台 调用 (P/Invoke)。 有 了 
P/Invoke，CLR 会 加 载 DLL， 其 中 包含 应 调用 的 函数 ， 并 编组 参数 。 

要 使 用 非 托 管 函 数 ， 首 先 必须 确定 导出 的 函数 名 。 为 此 ， 可 以 使 用 dumpbin 工具 和 /exports 选项 。 例 如 ， 
命令 : 

dumpbin /exports c:\windows\system32\kernel32.d1ll | more 

列 出 DLL kermel32.dll 中 所 有 导出 的 函数 。 这 个 示例 使 用 Windows API 函数 CreateHardLink 来 创建 到 现 有 
文件 的 硬 链接 。 使 用 此 API 调用 ， 可 以 用 几 个 文件 名 引用 相同 的 文件 ， 只 要 文件 名 在 一 个 硬盘 上 即 可 。 这 个 
API 调用 不 能 用 于 .NET Core， 因 此 必须 使 用 平台 调用 。 

为 了 调用 本 机 函数 ,必须 定 义 一 个 参数 数量 相同 的 C# 外 部 方法 , 用 非 托 管 方法 定义 的 参数 类 型 必须 用 托管 
代码 映射 类 型 。 

在 C++ 中 ，Windows API 调用 CreateHardLink 有 如 下 定义 : 

BOOL CreateHaradLInK( 

LPCTSTR lpFileName., 

LPCTSTR lpExistingFileName, : 

LPSECURITY ATTRIBUTES lJpSecurlityAttributes); 

这 个 定义 必须 映射 到 .NET 数据 类 型 上 。 非 托管 代码 的 返回 类 型 是 BOOL; 它 仅 映射 到 bool 数据 类 型 。 
LPCTSTR 定义 了 一 个 指向 const 字符 串 的 long 指针 。Windows API 给 数据 类 型 使 用 Hungarian 命名 约定 。LP 
是 一 个 long 指针 ，C 是 一 个 音量 ，STR 是 以 null 结尾 的 字符 串 。T 把 类 型 标志 为 泛 型 类 型 ， 根 据 编译 器 设置 为 
32 位 还 是 64 位 ， 该 类 型 解析 为 LPCSTR(ANSI 字符 串 ) 或 LPWSTR( 宽 Unicode 字符 串 )。C 字符 串 映射 到 .NET 
类 型 string。LPSECURITY_ATTRIBUTES 是 一 个 long 指针 ， 指 向 SECURITY_ATTRIBUTES 类 型 的 结构 。 因 
为 可 以 把 NULL 传递 给 这 个 参数 ， 所 以 把 这 种 类 型 映射 到 IntPtr 是 可 行 的 。 该 方法 的 C# 声 明 必须 用 extern 修饰 
竺 标记 ， 因 为 在 C# 代 码 中 ， 这 个 方法 没有 实现 人 代码。 相反， 该 方法 的 实现 代码 在 DLL kernel32.dll 中 ， 它 用 属 
性 [DlImport] 引 用 。.NET 声明 CreateHardLink 的 返回 类 型 是 bool， 本 机 方法 CreateHardLink 返回 一 个 布尔 值 ， 
所 以 需要 一 些 额 外 的 澄清 。 因 为 C++ 有 不 同 的 Boolean 数据 类 型 (例如 ， 本 机 bool 和 Windows 定义 的 BOOL 有 
不 同 的 值 )， 所 以 特性 [MarshalAs] 指 定 NET 类 型 bool 应 该 映射 为 哪个 本 机 类 型 ; 
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[D1llImport("kernel32.d1ll", SetLastError="true", 
EntryPoint="CreateHardLink", CharSset=Charset.Unicode)})] 

[return: MarshalaAs (UnmanagedType.Bool)] 

Public static extern bool CreateHardLink (string newFileName, 
string existingFilename, IntPtr securityAttributes).; 


注意 : 
网 站 http://www.pinvoke.net 非常 有 助 于 从 本 机 代码 到 托管 代码 的 转换 。 


可 以 用 [DiImport] 属 性 指定 的 设置 在 表 17-2 中 列 出 。 


表 17-2 
Dlllmport 属性 或 字段 说 明 
EntryPoint 可 以 给 函数 的 C# 声 明 指定 与 非 托管 库 不 同 的 名 称 。 非 托管 库 中 方法 的 名 称 在 EntryPoint 字段 中 定义 
CallingConvention 根据 编译 器 或 用 来 编译 非 托 管 函 数 的 编译 器 设置 ， 可 以 使 用 不 同 的 调用 约定 。 调 用 约定 定义 了 如 何 


处 理 参 数 ， 把 它们 放 在 堆栈 的 什么 地 方 。 可 以 设置 一 个 可 枚 举 的 值 ,来 定义 调用 约定 。 Windows API 
在 Windows 操作 系统 上 通常 使 用 StdCall 调用 约定 , 在 Windows CE 上 使 用 Cdecl 调用 约定 。 把 值 设 
置 为 CallingConvention.Winapi， 可 让 Windows API 用 于 Windows 和 Windows CE 环境 


Charset 字符 串 参 数 可 以 是 ANSI 或 Unicode。 通 过 Charset 设置 ， 可 以 定义 字符 串 的 管理 方式 。 用 CharSet 
枚 举 定 义 的 值 有 Ansi、Unicode 和 Auto.Charset。Anuto 在 Windows NT 平台 上 使 用 Unicode， 在 微软 
的 旧 操作 系统 上 使 用 ANSI 

SetLastError 如 果 非 托管 函数 使 用 Windows API SetLastError 设置 一 个 错误 ， 就 可 以 把 SetLastError 字段 设置 为 


true。 这 样 ， 就 可 以 使 用 Marshal. GetLastWin32Error 读 取 后 面 的 错误 号 


为 了 使 CreateHardLink 方法 更 易于 在 .NET 环境 中 使 用 ， 应 该 遵循 如 下 规则 : 

e 创建 一 个 内 部 类 NativeMethods， 来 包装 平台 调用 的 方法 调用 。 

e 创建 一 个 公共 类 ， 给 .NET 应 用 程序 提供 本 机 方法 的 功能 。 

e 使 用 安全 特性 来 标记 所 需 的 安全 。 

在 接 下 来 的 例子 中 ， 类 FileUtility 中 的 公共 方法 CreateHardLink 可 以 由 NET 应 用 程序 使 用 。 这 个 方法 的 文 
件 名 参数 ， 与 本 机 Windows API 方法 CreateHardLink 的 顺序 相反 。 第 一 个 参数 是 现 有 文件 的 名 称 ， 第 二 个 参数 
是 新 的 文件 。 这 类 似 于 框架 中 的 其 他 类 ， 如 File.Copy。 

因为 第 三 个 参数 用 来 传递 新 文件 名 的 安全 特性 ， 此 实现 代码 不 使 用 它 ， 所 以 公共 方法 只 有 两 个 参数 。 
返回 类 型 也 改变 了 。 它 不 通过 返回 false 值 来 返回 一 个 错误 ， 而 是 抛 出 一 个 异 币 。 如 果 出 错 ， 非 托管 方法 
CreateHardLink 就 用 非 托 管 API SetLastError 设置 错误 号 。 要 从 .NET 中 读 取 这 个 值 ，[DIIImport] 字段 
SetLastError 设置 为 tue。 在 托管 方法 CreateHardLink 中 ， 错 误 号 是 通过 调用 Marshal.GetLastWin32Error 读 
取 的 。 要 从 这 个 号 中 创建 一 个 错误 消息 ， 应 使 用 System.ComponentModel 名 称 空间 中 的 Win32Exception 类 。 这 
个 类 通过 构造 函数 接受 错误 号 ， 并 返回 一 个 本 地 化 的 错误 消息 。 如 果 出 错 ， 就 抛 出 IOException 类 型 的 异 第， 
它 有 一 个 类 型 Win32Exception 的 内 部 异 曾 。 应 用 公共 方法 CreateHardLink 的 FileIOPermission 特性 ， 检 查 调 用 
程序 是 否 拥有 必要 的 许可 (代码 文件 PInvokeSampleLib/NativeMethods.cs): 

[SecuritycCriticall] 

internal static Class NativeMethods 

[Dllimport{("kernel32.d1l1l™", SetLastError = true, 

EntryPoint = "CreateHardLinkW", Charset = Charset.Unicode})] 
[return: Marshalas (UnmanagedTYype .Bool)] 
private static extern bool CreateHardLink!( 
[In, Marshalas (UnmanagedType.LPWStr)] string newFileName, 
[In, Marshalns (UnmanagedType .LEWStr)] string existingFileName, 
IntPtr securityAttributes).; 
internal static void CreateHardLink (string oldrileName, 


string newFlileName) 


{ 


第 17 章 托管 和 非 托 管内 存 | 377 


if (!ICreateHardLink (newFileName, oldFileName, IntPretr.%ero)) 
{ 
Var ex = new Win32Exception (Marshal .GetLastWin32Error())}); 
throw new IOException (ex.Message, ex),;} 
} 
} 
} 


public static class FileUt1ility 
{ 
[FileIOPermission(SecurityAction.LinkDemand, Unrestricted = true)] 
Public static void CreateHardLink (string oldFileName, 
string newFileName) 
{ 
NativeMethods.CreateHardLink (oldFileName, newFlleName); 
} 
} 


这 个 库 使 用 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.Security.Permissions 
名 称 空间 
System 
System.IO 
System.Runtime.InteropServices 
System.Security 


System.Security.Permissions 


警告 
PlatformInvoke 示例 在 Linux 上 成 功 编译 ， 但 没有 运行 ， 因 为 在 Linux 操作 系统 上 找 不 到 库 kernel32.dll。 


现在 可 以 使 用 这 个 类 轻松 地 创建 硬 链接 。 如 果 程 序 的 第 一 个 参数 传递 的 文件 不 存在 ， 就 会 得 到 一 个 异常 ， 
提示 “系统 无 法 找到 指定 的 文件 ”。 如 果 文 件 存 在 ， 就 得 到 一 个 引用 原始 文件 的 新 文件 名 。 很 容易 验证 它 : 在 
一 个 文件 中 改变 文本 ， 它 就 会 出 现在 男 一 个 文件 中 (代码 文件 PInvokeSample/Program.cs): 


class Program 


{ 
static void Main(string[] args) 
{ 
IE (args.Length != 2) 
{ 
Console .WriteLine ("usage: PInvokeSample " 十 
"existingfilename newfilename™); 
return; 
} 
try 
{ 
FileUtility.CreateHardLink (args[0], args[1]); 
} 
catch (IOException ex) 
{ 
Console .WriteLine (ex.Message).,; 
} 
} 


} 

在 Windows 上 调用 本 地 方法 时 ， 通 常 必 须 使 用 Windows 句 柄 。Windows 句 柄 是 一 个 32 位 或 人 4 位 值 ， 根 据 句 
柄 类 型 ， 不 允许 使 用 一 些 值 。 在 NET 1.0 中 ,句柄 通常 使 用 IntPtt 结 构 ， 因 为 可 以 用 这 种 结构 设置 每 一 个 可 能 的 
32 位 值 。 然 而 ， 对 于 一 些 句 柄 类 型 ， 这 会 导致 安全 问题 ， 可 能 还 会 出 现 线 程 竞 态 条 件 ， 在 终结 阶段 泄漏 句柄 。 
所 以 .NET 2.0 引 入 了 SafeHandle 类 。SafeHandle 类 是 一 个 抽象 的 基 类 ， 用 于 每 个 Windows 句 柄 。Microsoft Win32. 
SafeHandles 名 称 空 间 中 的 派生 类 是 SafeHandleZeroOrMinus OneIsImvalid 和 SafeHandleMinusOneIsInvalid。 顾 名 思 
义 ， 这 些 类 不 接受 无 效 的 0 或 -1 值 。 进一步 派生 的 句柄 类 型 是 SafeFileHandle、SafeWaitHandle、SafeNCryptHandle 
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和 SafePipeHandle， 可 以 供 特定 的 Windows API 调 用 使 用 。 
例如 ， 为 了 映射 Windows API CreateFile， 可 以 使 用 以 下 声明 返回 一 个 SafeFileHandle。 当 然 ， 通 常 可 以 使 
用 .NET 类 File 和 FileInfo。 


[D1llImport("Eernel32.d1ll", SetLastError = true, 
Charset = Charset.Unicode})l] 
internal static extern SafeFileHandle CreateFilert 
string fileName, 
[MaTrshalas (UnmanagedType.U04)] Filehccess fileAccess, 
[Marshalas (UnmanagedType.U4)] FileShare fileSshare, 
IntPtr securityAttributes, 
[Marshalns (UnmanagedType.U4)] FileMode creationDisposition, 
int flags, 
SafeFileHandle template); 


17.9 ”小结 


要 想 成 为 真正 优秀 的 C# 程 序 员 ， 必 须 牢 固 和 掌握 存储 单元 和 垃圾 收集 的 工作 原理 。 本 章 摘 述 了 CLR 管理 以 
及 在 堆 和 栈 上 分 配 内 和 存 的 方式 ， 讨 论 了 如 何 编写 正确 地 释放 非 托管 资 源 的 类 ， 并 介绍 如 何在 C# 中 使 用 指针 ， 这 
些 都 是 很 难 理解 的 高 级 主题 , 初学 者 常常 不 能 正确 实现 。 至少 本 章 有 助 于 理解 如 何 使 用 IDisposable 接口 和 using 
语句 释放 资源 。 

本 章 还 介绍 了 C#7.0 和 C#7.2 通过 引用 传递 值 和 通过 引用 返回 值 的 增强 功能 ,特别 是 ref return 和 ref locals,， 
以 及 使 用 ref readonly 修饰 符 。 

下 一 章 将 介绍 Visual Studio 2017 的 所 有 功能 。 


.18. 


Visual Studio 2017 


本 章 要 点 

使 用 Visual Studio 2017 

创建 和 使 用 项 目 

用 Visual Studio 进行 重 构 

使 用 不 同 技术 工作 (UWP、ASP.NET Core 等 ) 
分 析 应 用 程序 

通过 Docker 创建 和 使 用 容器 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 VisualStudio 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

® DockerSample 

® WebAppWithVs 


18.1 使 用 Visual Studio 2017 


到 目前 为 止 ， 你 应 该 已 经 对 C# 语 言 比较 熟悉 ， 并 准备 开始 学 习 本 书 的 应 用 部 分 。 在 这 些 章节 中 会 介绍 如 何 
使 用 C# 编 写 各 种 应 用 程序 。 但 在 学 习 之 前 ， 需 要 理解 如 何 使 用 Visual Studio 和 .NET 环境 提供 的 一 些 功能 ， 使 
程序 达到 最 佳 效果 。 

本 章 讲 解 在 实际 工作 中 , 如 何在 .NET 环境 中 编程 。 介 绍 主要 的 开发 环境 Visual Studio， 该 环境 用 于 编写 、 
编译 、 调 试 和 优化 C# 程 序 ， 并 且 为 编写 优秀 的 应 用 程序 提供 指导 。Visual Studio 是 主要 的 IDE， 用 于 多 种 目 
的 ， 包 括 编写 ASPNET 和 ASP.NET Core Web 应 用 程序 、Windows Presentation Foundation (WPF) 应 用 程序 、 
用 于 Universal Windows Platform (UWP) 的 应 用 程序 、 由 ASPNET Web 创建 的 访问 服务 。 

本 章 还 探讨 如 何 构 建 目标 框架 为 .NET Core 的 应 用 程序 。 

Visual Studio 2017 是 一 个 全 面 集成 的 开发 环境 。 编 写 、 调 试 、 编 译 代码 以 生成 一 个 程序 集 的 整个 过 程 被 设 
计 得 尽 可 能 容易 。 这 意味 着 Visual Studio 是 一 个 非常 全 面 的 多 文档 界面 应 用 程序 ， 在 该 环境 中 可 以 完成 所 有 代 
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码 开 发 的 相关 事情 。 它 具有 以 下 特性 : 
e 文本 编辑 器 一 一 使 用 这 个 编辑 器 ， 可 以 编写 C#{ 还 有 Visual Basic、C++、F#、JavaScript、 XAML、JSON 


以 及 SQLD) 代 码 。 这 个 文本 编辑 器 是 非常 先进 的 。 例 如 ， 当 用 户 输 入 时 ， 它 会 用 缩 进 代码 行 自动 布局 代 
码 ， 匹 配 代 码 块 的 开始 和 结束 括号 ， 以 及 使 用 颜色 编码 关键 字 。 它 还 会 在 用 户 输入 时 检查 语法 ， 并 用 
下 划 线 标识 导致 编译 错误 的 代码 ， 这 也 称 为 设计 时 的 调试 。 另 外 ， 它 具有 IntelliSense 功能 ， 当 开始 输 
入 时 它 会 自动 显示 类 、 字 上 段 或 方法 的 名 称 。 开 始 输 入 方法 参数 时 ， 它 也 会 显示 可 用 重 载 的 参数 列表 。 
图 18-1 用 UWP 应 用 程序 展示 了 IntelliSense 功能 。 这 个 对 话 框 在 Visual Studio 2017 中 有 一 个 新 特性 : 可 
以 使 用 底部 的 按钮 选择 只 查看 属性 、 事 件 或 方法 。 这 对 大 型 团队 列表 有 很 大 帮助 。 


| Upapp - Microsoft Visual Studio ¢ | h IC a 


[| 
EB Vew Pomct Buld Gebug Tem Took Test Hnalyze Window Halp = 
入 = 寻宝 于 | Debgg = ze Local Pigsc haine EE 怕 号 
eal UWRFApP "| thy Upp a9 可 可 
【3 mi ml ;: 巾 
村 f nl .Na 
ls 人 [1 PS 
本 本 UWPApp (Unkverssl Windovsh 
1 ji The Blank Page item template is documented at https:/ /go.microsoft, com/fwlin di 
17 
I8 snames pace UNPApP 
1 { 
地 各 - 


Jj 
An smpty pape that can be used cn its own or navigated to within a Frame 
Lai 
public sealed partial class MainPapge : Page 
| 


public Mainpagerl) 


this, InitializeComponentt ); 
this, 


图 18-1 


注意 ; 
如 果 需 要 IntelliSense 的 列表 框 ， 或 者 因为 其 他 原因 该 列表 框 不 见 了 ， 可 以 按 下 CtrlHSpace 组 合 键 找 回 该 列 
表 框 。 如 果 和 希望 看 到 IntelliSense 框 下 面 的 代码 ， 可 以 按 住 Ctrl 按钮 。 


设计 视图 编辑 顺 一 一 这 个 编辑 器 允许 在 项 目 中 放置 用 户 界 面 控件 和 数据 绑 定 控件 ，Visual Studio 会 在 项 
目 中 目 动 将 必需 的 C# 代 码 添 加 到 源 文件 中 ， 来 实例 化 这 些 控件 (这 是 可 能 的 ， 因 为 所 有 .NET 控件 都 是 
具体 基 类 的 实例 )。 
支持 窗口 一 一 这 些 窗口 允许 但 看 和 修改 项 目的 各 个 方面 ， 例 如 源 代 码 中 的 类 、Windows Forms 和 Web 
Forms 类 的 可 用 属性 (以 及 它们 的 启动 值 )。 也 可 以 使 用 这 些 窗口 来 指定 编译 选项 ， 例 如 代码 需要 引用 的 
程序 集 。 
集成 的 调试 着 一 一 从 编程 的 本 质 讲 ， 第 一 次 试 运 行 时 ， 代 码 可 能 会 无 法 正常 运行 。 可 能 第 二 次 或 者 第 三 
次 都 无 法 正 背 运行 。Visual Studio 无 颖 地 链接 到 一 个 调试 器 中 , 允许 设置 断 点 ， 监 视 集 成 环境 中 的 变量 。 
集成 的 MSDN 帮助 一 一 Visual Studio 允许 在 IDE 中 访问 MSDN 文档 。 例 如 ， 如 果 使 用 文本 编辑 器 时 不 
太 确 定 一 个 关键 字 的 含义 ， 只 需要 选择 该 关键 字 并 按 Fl 键 ，Visual Studio 将 会 访问 
https://docs.microsoft.com 并 展示 相关 主题 。 同 样 ， 如 果 不 确定 某 个 编译 错误 是 什么 意思 ， 可 以 选择 错误 
消息 并 按 Fl 键 ， 调 出 MSDN 文档 ， 查 看 该 错误 的 演示 。 
访问 其 他 程序 一 一 Visual Studio 也 可 以 访问 一 些 其 他 实用 程序 ， 在 不 退出 集成 开发 环境 的 情况 下 ， 
就 可 以 检查 和 修改 计算 机 或 网 络 的 相关 方面 。 可 以 用 这 些 实用 工具 检查 运行 的 服务 和 数据 库 连 接 ， 直 
接 查 看 SQL Server 表 ， 浏 览 Microsoft Azure Cloud 服务 ， 甚 至 用 一 个 Web 浏览 器 窗口 来 浏览 Web。 
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e Visual Studio 扩展 ”Visual Studio 的 一 些 扩展 已 经 在 Visual Studio 的 正常 安装 过 程 中 安装 好 了 ， 
Microsoft 和 第 三 方 还 提供 了 更 多 的 扩展 。 这 些 扩 展 允 许 分 析 人 代码， 提供 项 目 或 项 模板 ， 访 问 其 他 服务 
等 。 使 用 NET 编译 器 平台 ， 与 Visual Studio 工具 的 集成 会 更 简单 。 

Visual Studio 的 最 新 版 本 有 一 些 有 趣 的 改进 ,一 个 主要 部 分 是 用 户 界 面 , 另 一 个 主要 部 分 是 后 台 功 能 和 .NET 
编译 器 平台 。 

对 于 用 户 界 面 , Visual Studio 2010 基 于 WPF 重 新 设计 了 外 壳 , 而 不 是 基于 原生 的 Windows 控 件 .Visual Studio 
2012 的 界面 在 此 基础 上 又 有 了 一 些 变化 ， 尤 其 是 用 户 界面 更 关注 主要 工作 区 一 一 编辑 器 ， 人 允许 直接 在 代码 编辑 
器 中 完成 更 多 的 工作 ， 而 不 需要 使 用 许多 其 他 工具 。 当 然 ， 还 需要 代码 编辑 器 之 外 的 一 些 工 具 ， 但 更 多 的 功能 
内 置 于 几 个 工具 中 ， 所 以 减少 了 通常 需要 的 工具 数量 。 在 Visual Studio 2017 中 ， 改 进 了 一 些 UI 功能 。 可 以 立 
即 在 Visual Studio 安装 程序 中 看 到 frst UI 增强 ， 它 从 Windows 8 磁 贴 的 设计 中 获得 了 一 些 灵感 ， 更 容易 地 选 
择 工 作 负载 (参见 图 18-2)。 
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有 了 .NET 编译 器 平台 (代码 名 称 是 Roslyn)，.NET 编译 器 完全 重 写 了 ， 它 现在 集成 了 编译 器 管道 的 功能 ， 
例如 语法 分 析 、 语义 分 析 、 绑 定 和 代码 输出 。Microsoft 基于 此 重 写 了 许多 Visual Studio 集成 工具 。 代 码 编辑 器 、 
智能 感知 和 重 构 都 基于 .NET 编译 器 平台 。 

对 于 XAML 代码 编辑 ，Visual Studio 2010 和 Blend for Visual Studio 共享 相同 的 编辑 器 引擎 。 不 仅 代 码 引 擎 
是 一 样 的 : Visual Studio 2013 从 Blend 中 得 到 了 XAML 引擎 ， 目 从 Blend for Visual Studio 2015 以 来 ，Blend 获 
得 了 Visual Studio 的 外 壳 。 启 动 Blend for Visual Studio 2017， 会 看 到 它 类 似 于 Visual Studio， 可 以 立即 开始 使 
用 它 。 

Visual Studio 的 男 一 项 改进 是 搜索 。Visual Studio 有 许多 命令 和 功能 ， 常 常 很 难 找到 需要 的 菜单 或 工具 栏 按 
钮 。 只 要 在 Quick Launch 中 输入 所 需 命令 的 一 部 分 ， 就 可 以 看 到 可 用 的 选项 。Quick Launch 位 于 窗口 的 右上 角 
( 见 图 18-3)。 搜 索 功 能 还 可 以 从 其 他 地 方 找到 ， 如 工具 栏 、 解 决 方案 资源 管理 器 、 代 码 编 辑 器 (可 以 按 CtrI+F 组 
合 键 来 调用 ) 以 及 引用 管理 器 上 的 程序 集 等 。 
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Dedicra ， 
i The Blank Page item template is documernted at https://Eo. micros Taw Editor - CCss = Enperiments (redectering, superimvental, ehellisens 
奉 


namespace UnPApp 
{ 
Iii An empty paege that can be used on its own or navigated to 
i UMMaT YN; 


public sealed partial class Mainpage : Page 


public MainPagert) 


this: InitializeComponent(); 
] 
} 
} 


18.1.1 Visual Studio 的 版 本 


Visual Studio 2017 提供 了 多 个 版 本 。 最 便宜 的 是 Visual Studio 2017 Community 版 ， 这 个 版 本 在 某 些 情况 下 
是 免费 的 ! 它 对 个 人 开发 者 、 开 源 项 目 、 学 术 研 究 、 教 育 和 小 型 专业 团队 是 免费 的 。 

可 供 购 买 的 是 Professional 和 Enterprise 版 。 只 有 Enterprise 版 包含 所 有 功能 。Enterprise 版 独 享 的 功能 有 
IntelliTrace( 智 能 跟踪)、 负 和 载 测试 和 一 些 染 构 工 具 。 微 软 的 Fakes 框架 (隔离 单元 测试 ) 只 能 用 于 Visual Studio 
Enterprise 版 .本 章 介 绍 Visual Studio 2017 包含 的 一 些 功 能 , 这 些 功 能 仅 适 用 于 特定 版 本 。 有关 Visual Studio 2017 
各 个 版 本 中 功能 的 详细 信息 ， 请 参考 http://www.visualstudio.com/vs/compare/。 


18.1.2 Visual Studio 设置 


当 第 一 次 运行 Visual Studio 时 ， 需 要 选择 一 个 符合 环境 的 设置 集 ， 例 如 General Development、Visual Basic、 
Visual C#、Visual C++ 或 Web Development。 这 些 不 同 的 设置 反映 了 用 于 这 些 语言 的 不 同 工 具 。 在 微软 平台 上 编 
写 应 用 程序 时 ， 可 以 使 用 不 同 的 工具 创建 Visual 
Basic、C++ 和 Web 应 用 程序 。 同 样 ，Visual Basic、 
Visual C++ 和 Visual InterDev 具有 完全 不 同 的 编程 
环境 ,设置 和 工具 选项 ,现在 ,可 以 使 用 Visual Studio 
为 所 有 这 些 技术 创建 应 用 程序 ， 但 Visual Studio 仍 
然 提 供 了 快捷 键 , 可 以 根据 Visual Basic、 Visual C++ 


Impart and Export Settings Wizard 
i Choose a Default Collection of Settings 


Which collection of settings do you want to reset to? 
各 Gereral Description: 
检 Jamwa Senipt 
从 Vigual Basic 


Customizes the environment to 
marimlize code editor sereen space and 


Visual C# improve the wisibility of commands 
Visual C+4 specific to C#Inereases productivity 
全 ; 一 生 到 二 十 
和 Visual InterDev 选择 。 当 然 ， 也 可 以 选择 特定 的 阁 Web Development a bo ht a 

La iWeb Develaopment [Code Only) desigred to be easy to learmm arnd use. 


C# 设 置 。 

在 选择 了 设置 的 主 类 别 ， 确 定 了 键盘 快捷 键 、 
菜单 和 工具 窗口 的 位 置 后 ， 就 可 以 通过 Tools | 
Customize... (工具 栏 和 命令 ) 和 Tools | Options...( 在 
此 可 以 找到 所 有 工具 的 设置 ), 来 改变 每 个 设置 。 也 
可 以 重 置 设置 集 ， 方 法 是 使 用 Tools | Import and 
Export Settings 调用 一 个 向 导 , 来 选择 一 个 新 的 默认 ee ee 
设置 集 (如 图 18-4 所 示 )。 图 18-4 
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接 下 来 的 小 节 贯 罕 一 个 项 目的 创建 、 编 码 和 调试 过 程 ， 展 示 Visual Studio 在 各 个 阶段 能 够 帮助 完成 什么 
工作 。 


18.2 创建 项 目 


安装 Visual Studio 2017 之 后 ， 会 希望 开始 目 己 的 第 一 个 项 目 。 使 用 Visual Stdio， 很 少 会 局 动 一 个 空白 文 
件 ， 然 后 添加 C# 人 代码。 但 在 本 书 前 面 的 章节 中 ， 一 直 是 按 这 种 方式 做 的 (当然 ， 如 果 想 从 头 开 始 编写 代码 ， 或 
者 打算 创建 一 个 包含 多 个 项 目的 解决 方案 ， 则 可 以 选择 一 个 空白 解决 方案 的 项 目 模 板 )。 

在 此 , 告诉 Visual Studio 想 创建 什么 类 型 的 项 目 , 它 会 生成 文件 和 C# 代 码 , 为 该 类 型 的 项 目 提供 一 个 框架 。 
之 后 在 这 个 基础 上 继续 添加 代码 即 可 。 例 如 ， 如 果 想 创建 一 个 Windows 桌面 应 用 程序 (一 个 WPF 应 用 程序 )， 
Visual Studio 将 生成 一 个 XAML 文件 和 一 个 包含 C# 源 代码 的 文件 ， 它 创建 了 一 个 基本 的 窗 体 。 这 个 窗 体能 够 
与 Windows 通信 和 接收 事件 。 它 能 够 最 大 化 、 最 小 化 或 调整 大 小 : 用 户 需 要 做 的 仅 是 添加 控件 和 想 要 的 功能 。 
如 果 应 用 程序 是 一 个 命令 行 实用 程序 (一 个 控制 台 应 用 程序 )，Visual Studio 将 提供 一 个 基本 的 名 称 空间 、 一 个 类 
和 一 个 Main 方法 ， 用 户 可 以 从 这 里 开始 。 

最 后 一 点 也 很 重要 : 在 创建 项 目 时 ，Visual Studio 会 根据 项 目 是 编译 为 命令 行 应 用 程序 、 库 还 是 WPF 应 用 
程序 ， 为 C# 编 译 器 设置 编译 选项 。 它 还 会 告诉 编译 器 ， 应 用 程序 需要 引用 哪些 基 类 库 和 NuGet 包 。 例如，WPF 
GUI 应 用 程序 需要 引用 许多 与 WPF 相关 的 库 ， 控 制 台 应 用 程序 则 不 需要 引用 这 些 库 。 当 然 ， 在 编辑 代码 的 过 
程 中 ， 可 以 根据 需要 修改 这 些 设置 。 

第 一 次 启动 Visual Studio 时 ，IDE 会 包含 一 些 菜单 、 一 个 工具 栏 以 及 一 个 包含 入 门 信息 、 操 作 方 法 视频 和 
最 新 新 闻 的 页 面 ， 如 图 18-5 所 示 。 起 始 页 包含 指 回 有 用 网 站 和 一 些 实际 文章 的 链接 ， 可 以 打开 现 有 项 目 或 者 新 
建 项 目 。 
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图 18-5 


图 18-5 是 使 用 Visual Studio 2017 后 显示 的 起 始 页 ， 其 中 包含 最 近 编 辑 过 的 项 目 列表 。 单 击 其 中 的 某 个 项 目 
就 可 以 打开 该 项 目 。 


384 | 第 1 部 分 C# 语言 


18.2.1 面向 多 个 版 本 的 .NET 


Visual Studio 2017 人 允许 设置 想 用 于 工作 的 .NET Framework 版 本 。 当 打开 New Project 对 话 框 时 ， 如 图 18-6 
所 示 ， 对 话 框 顶部 的 一 个 下 拉 列 表 显示 了 可 用 的 选项 。 
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在 这 种 情况 下 ， 该 下 拉 列 表 人 允许 设置 的 NET Framework 版 本 有 4.0、4.5、4.5.1、4.5.2、4.6 和 4.6.1、4.7 和 
4.7.1。 但 是 ， 对 于 许多 应 用 程序 类 型 ， 此 选项 不 适用 。 如 果 创 建 NET Core 应 用 程序 ， 或 者 Windows 通用 应 用 
程序 ， 选 择 什 么 版 本 并 不 重要 。 不 过 ， 可 以 稍 后 更 改 面 癌 的 NET Core 版 本 或 Windows 运行 库 版 本 。 

如 果 想 改变 NET Core 应 用 程序 正在 使 用 的 框架 版 本 , 只 需要 在 Solution Explorer 中 右 击 项 目 并 选择 Project 
Properties， 选 择 Application 选项 卡 ， 从 Target Framework 列表 中 选择 .NET Core 版 本 (参见 图 18-7)。 

这 和 Windows 应 用 程序 没什么 不 同 。 也 是 在 Solution Explorer 中 右 击 项 目 ， 并 选择 Project Properties， 选 择 
Application 选项 卡 ， 现 在 可 以 选择 目标 和 最 小 的 构建 版 本 ， 如 图 18-8 所 示 。 
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18.2.2 选择 项 目 类 型 
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Windows 10 (10.0: Build 10240) 


图 18-8 
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要 新 建 一 个 项 目 ， 从 Visual Studio 菜单 中 选择 File | New Project。New Project 对 话 框 如 图 18-9 所 示 ， 通 过 
该 对 话 框 可 以 大 致 了 解 能 够 创建 的 不 同 项 目 。 
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使 用 这 个 对 话 框 ， 可 以 有 效 地 选择 希望 Visual Studio 生成 的 初始 框架 文件 和 代码 、 和 希望 Visual Studio 生成 


的 代码 、 要 用 于 创建 项 目的 编程 语言 以 及 应 用 程序 的 不 同类 别 。 


表 18-1~ 表 18-3 描述 了 与 本 书 相关 的 Visual C# 项 目下 最 重要 的 选项 。 这 里 没有 介绍 你 可 能 仍然 需要 的 旧 项 
目 模板 ， 对 于 这 些 模板 ， 应 该 查阅 本 书 的 旧版 本 。 
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1. 使 用 Windows Universal 项 目 模 板 

表 18-1 列 出 了 用 于 Universal Windows Platform 的 模板 。 这 些 模板 可 用 于 Windows 10 和 Windows 8.1， 但 
需要 Windows 10 系统 来 测试 应 用 程序 。 这 些 模板 用 于 创建 应 用 程序 , 使 用 任何 设备 系列 运行 在 Windows 10 上 ， 
例如 电脑 、XBox、IoT 设备 等 。 


表 18-1 
项 目 模板 名 称 项 目 模板 描述 
空 日 应 用 程序 (Universal Windows) 一 个 使 用 XAML 的 空白 Universal Windows 应 用 程序 ， 没 有 样式 和 其 他 基 类 
类 库 (Universal Windows) 一 个 .NET 类 库 ， 其 他 用 .NET 编写 的 Windows Store 应 用 程序 可 以 调用 它 。 在 这 个 
库 中 可 以 使 用 Windows 运行 库 的 API 
Windows 运行 库 组 件 (Universal 一 个 Windows Runtime 类 库 ， 其 他 用 不 同 编 程 语 言 (C#、C++、JavaScript) 开 发 的 
Windows) Windows Store 应 用 程序 可 以 调用 它 


单元 测试 应 用 程序 (Universal Windows) 一 个 包含 Universal Windows Platform 应 用 程序 的 单元 测试 的 库 

编码 的 UI 测试 项 目 (Universal Windows) 这 个 项 目 定 义 了 编码 的 UI 测试 ， 用 于 Windows 应 用 程序 

Windows 应 用 程序 打包 项 目 WPF 或 Windows Forms 项 目 。 可 以 构建 一 个 Windows 10 安装 包 ， 并 将 该 应 用 程序 
与 现代 Windows 10 代码 混合 使 用 


注意 : 

对 于 Windows 10， 通 用 应 用 程序 的 默认 模板 数 已 削减 。 为 了 创建 Windows 8 的 Windows Store 应 用 程序 ， 
Visual Studio 提供 了 更 多 的 项 目 模板 , 来 预定 义 基于 网 格 、 基 于 分 隔 板 或 者 基于 Hub 的 应 用 程序 .对 于 Windows 
10， 只 有 空 模 板 可 用 。 可 以 从 空 的 模板 开始 ， 或 者 虑 使 Windows Template Studio 作为 开始 。 一 旦 安装 了 微软 的 
Template Visual Studio 扩展 ，Windows Template Studio 模板 就 可 用 ， 其 命令 是 Tools | Extensions and Updates。 


2. 使 用 .NET Core 项 目 模板 
Visual Studio 2017 中 的 有 趣 改进 是 NET Core 项 目 模 板 。 最 初 ， 只 有 表 18-2 中 的 5 个 选项 。 


表 18-2 
项 目 模板 名 称 项 目 模板 描述 

控制 台 应 用 程序 (NET Core) 一 个 带 有 .NET Core 的 控制 台 应 用 。 这 是 在 为 前 几 章 创建 代码 时 主要 使 用 的 模板 

类 库 (.NET Core) 可 以 与 NET Core 应 用 程序 一 起 使 用 的 类 库 。 如果 想 在 .NET Core、 Universal Apps 和 Xamarin 
之 间 共 享 库 ， 请 不 要 使 用 此 模板 。 而 是 寻找 标准 库 。 需 要 使 用 这 个 库 创 建 .NET 标准 没有 提 
供 的 特殊 .NET Core 功能 

单元 测试 项 目 (.NET Core) 一 个 单元 测试 项 目 ， 使 用 MSTest 测试 NET Core 项 目 、NET 标准 项 目 和 库 

xUnit 测试 项 目 (.NET Core) 一 个 单元 测试 项 目 ， 使 用 xUnit. 测 试 .NET Core 项 目 、.NET 标准 项 目 和 库 


上 


ASP.NET Core Web 应 用 程序 ASPNET Core Web 应 用 程序 ， 它 可 以 是 把 HIML 代码 返回 到 客户 端的 网 站 ， 也 可 以 是 运行 
JSON 或 XML 的 服务 。 在 选择 这 个 项 目 模 板 后 ， 可 用 的 选择 在 表 18-3 中 描述 


在 选择 ASPNET Core Web 应 用 程序 模板 后 ， 就 可 以 选择 一 些 预 先 配置 的 模板 ， 如 图 18-10 所 示 。 使 用 顶 
部 的 组 合 框 来 选择 .NET Core 或 .NET Framework。ASPNET Core 也 可 以 在 NET Framework 上 运行 ， 而 不 仅仅 
是 在 NET Core 上 运行 。 然 后 可 以 选择 ASPNET Core 版 本 号 , 这 取决 于 已 安装 的 SDK。 只 有 需要 使 用 仅 与 NET 
Framework 一 起 运行 的 旧 库 时 ，.NET Framework 选项 才 有 有 用， 否则 保留 .NET Core 选项 。 如 果 选 择 .NET Core 
和 ASPNET Core 2.0， 就 将 看 到 如 图 18-10 所 示 的 屏幕 。 这 些 模板 将 在 表 18-3 中 描述 。 
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| aT Tre 
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图 18-10 
表 18-3 
项 目 模 板 名 称 项 目 模板 描 述 
空白 应 用 程序 一 个 ASP.NET Core Web 应 用 程序 。 在 选择 这 个 模板 时 ， 不 会 得 到 一 个 完全 空 的 项 目 ， 而 是 使 用 .NET 
Core 创建 一 个 基本 的 Web 应 用 程序 。 这 个 模板 是 在 第 30 和 31 章 中 开始 使 用 的 。 在 这 两 章 会 学 习 需 要 
添加 什么 内 容 
Web API 使 用 ASP.NET Core 提供 Web API 的 服务 。Web API 模板 很 容易 创建 RESTful 服务 。 这 个 项 目 参 见 第 


Web 应 用 程序 
MVC 


Aneular 


React.]s 


React.js 和 Redux 


32 章 

具有 Razor 页 面 的 Web 应 用 程序 。 这 是 ASPNET Core 2.0 的 一 个 新 选项 ， 在 第 31 章 中 介绍 

使 用 ASP.NET Core MVC 的 Web 应 用 程序 。 这 个 模板 使 用 完全 “模型 -视图 -控制 器 ”模式 。 它 可 以 用 
于 创建 Web 应 用 程序 ， 在 第 31 章 中 介绍 

使 用 Angular 脚本 库 和 ASP.NET Core 为 后 端 服务 创建 单 页 应 用 程序 (Single Page Application，SPA) 的 
Web 应 用 程序 

为 后 端 服务 使 用 React 和 ASP.NET Core 的 Web 应 用 程序 。React.js 是 男 一 种 SPA 技术 

该 Web 应 用 程序 给 客户 疹 使 用 Reactjs 和 Redux, 为 后 端 服务 使 用 ASP.NET Core.。 这 一 次 ,除了 React.js 
之 外 ， 还 使 用 了 Redux 库 


3. 使 用 .NET 标准 模板 


这 个 类 别 只 包含 一 个 模板 , 但 它 非 闸 重要 ， 所 以 这 里 介绍 它 。 可 以 创建 一 个 类 库 (.NET 标准 )。 从 现在 开始 ， 
这 是 要 创建 的 首选 类 库 。 这 个 库 可 以 在 NET Framework、.NET Core、 通 用 应 用 程序 、Xamarin 和 更 多 技术 之 间 


共享 。 只 需要 注意 创建 这 个 库 后 所 选择 的 标准 的 版 本 。 
NET 标准 库 详 见 第 19 章 。 


注意 : 


.NET 标准 库 取代 了 可 移植 库 。 现在， 可 移植 的 库 在 Visual Studio 中 被 列 为 旧 库 。 
这 不 是 一 个 完整 的 Visual Studio 2017 项 目 模 板 列 表 ， 但 它 列 出 了 一 些 最 常用 的 模板 。 
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18.3 ”浏览 并 编写 项 目 


本 节 痢 眼 于 Visual Studio 提供 用 于 帮助 在 项 目 中 添加 和 浏览 代码 的 功能 。 学 习 如 何 使 用 Solution Explorer 
浏览 文件 和 代码 ， 使 用 编辑 器 的 IntelliSense 和 代码 片段 等 功能 浏览 其 他 窗口 ， 如 Properties( 属 性 ) 窗 口 和 
Document Outline( 文 档 大 纲 )。 


18.3.1 Solution Explorer 
在 创建 项 目 [例如 ， 前 面 草 节 最 利用 的 控制 全 应 用 程序 CNET Core)] 之 后 ， 要 用 到 的 最 重要 的 工具 除了 代码 
编辑 器 ， 就 是 Solution Explorer。 使 用 这 个 工具 可 以 浏览 项 目的 所 有 文件 和 项 ， 碍 看 所 有 的 类 和 类 成 员 。 


注意 : 

在 Wisual Studio 中 运行 控制 台 应 用 程序 时 ， 有 一 个 常见 的 误解 ， 即 需要 在 Main() 方 法 的 最 后 一 行 添加 一 个 
Console.ReadLine 方法 来 保持 控制 台 窗 口 打开 。 事 实 并 非 如 此 ， 通 过 命令 Debug | Start without Debugging( 或 按 
CtrlHFS 组 合 键 ) 可 以 启动 应 用 程序 ， 而 不 必 通 过 命令 Debug | Start Debugging( 或 按 F5 键 ) 来 开启 。 这 样 可 以 保持 
窗口 打开 直到 按 下 某 个 键 。 使 用 F5 键 开启 应 用 程序 也 是 有 意义 的 ， 如 果 设 置 了 断 点 ，Visual Studio 就 会 在 断 点 
处 挂 起 。 

1. 使 用 项 目 和 解决 方案 

Solution Explorer 会 显示 项 目 和 人 解决 方案 。 理 解 它们 之 间 的 区 别 是 很 重要 的 : 

e 项 目 是 一 个 包含 所 有 源 代 码 文 件 和 资源 文件 的 集合 ， 它 们 将 编译 成 一 个 程序 集 ， 在 某 些 情况 下 也 可 能 

编译 为 一 个 模块 。 例 如 ， 项 目 可 能 是 一 个 类 库 或 一 个 Windows GUI 应 用 程序 。 

e 解决 方案 是 一 个 包含 所 有 项 目的 集合 ， 它 们 组 合成 一 个 特定 的 软件 包 (应 用 程序 )。 

要 理解 这 个 区 别 ， 可 以 考虑 当 发 布 一 个 包括 多 个 程序 集 的 项 目 时 会 发 生 什么 。 例 如 ， 可 能 有 用 户 界 面 、 目 
定义 控件 和 作为 应 用 程序 一 部 分 的 库 的 其 他 组 件 。 甚 至 可 能 为 管理 员 提 供 不 同 的 用 户 界面 和 通过 网 络 调用 的 服 
务 。 应 用 程序 的 每 一 部 分 可 能 包含 在 单独 的 程序 集中 ， 因 此 Visual Studio 会 认为 它们 是 单独 的 项 目 。 而 且 很 有 
可 能 并 行 编码 这 些 项 目 ， 并 将 它们 彼此 结合 。 因 此 ， 在 Visual Studio 中 把 这 些 项 目 当 作 一 个 单位 来 编辑 是 非常 
有 用 的 。Visual Studio 允许 把 所 有 相关 的 项 目 构 成 一 个 解决 方案 ， 并 且 当 作 一 个 单位 来 处 理 ，Visual Studio 会 读 
取 该 单位 并 允许 在 该 单位 上 进行 工作 。 

到 目前 为 止 ， 本章 已 经 零散 地 讨论 创建 一 个 控制 台 项 目 。 在 这 个 例子 中 ，Visual Studio 实际 上 已 经 创建 一 
个 解决 方案 ， 只 不 过 它 仅 包含 一 个 项 目 而 已 。 可 以 在 Solution Explorer 
中 看 到 这 样 的 场景 (如 图 18-11 所 示 ), 它 包含 一 个 树 型 结构 , 用 于 定义 
该 解决 方案 。 

在 这 个 例子 中 ， 项 目 包 含 了 源 文件 Program.cs， 以 及 项 目 配 置 文 
件 projectjson( 人 多 许 定 义 项 目 摘 述 .版 本 和 依赖 项 )。 在 Solution Explorer 4 回 consoleApp1 


中 无 法 清楚 地 看 到 项 目 文件 。 只 需要 选择 项 目 (图 18-11 中 的 ye 
ConsoleApp1), 然后 在 上 下 文 沫 单 中 选择 Edit ConsoleAppl.csproj( 单 击 Me 
键盘 上 的 菜单 按钮 或 右 击 )。 有 了 .NET Core 项 目 ， 就 可 以 这 么 做 ， 而 Program 

不 需要 人 卸 载 解决 方案 。 使 用 其 他 项 目 类 型 (例如 ，Universal Windows We 
Apps) 时 ， 在 直接 从 Visual Studio 中 编辑 项 目 文件 之 前 ， 需 要 首先 卸载 图 18-11 


解决 方案 。 
Solution Explorer 也 显示 了 项 目 引 用 的 NuGet 包 和 程序 集 。 在 Solution Explorer 中 展开 Dependencies 文件 夹 
就 可 以 看 到 这 些 信息 。 


注意 : 
对 于 较 旧 的 项 目 类 型 ， 会 看 到 References 文件 夹 ， 而 不 是 Dependencies 文件 夹 。 
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如 果 在 Visual Studio 中 没有 改变 任何 默认 设置 , 在 屏幕 右上 方 就 可 以 找到 Solution Explorer。 如 果 找 不 到 它 ， 
则 可 以 进入 View 这 单 并 选择 Solution Explorer。 

解决 方案 是 用 一 个 扩展 名 为 .sln 的 文件 来 描述 的 ， 在 这 个 示例 中 ， 它 是 ConsoleAppl.sln。 人 解决 方 案 文 件 是 一 个 
文本 文件 ， 它 包含 解决 方案 中 包含 的 所 有 项 目的 信息 ， 以 及 可 用 于 所 有 包含 项 目的 全 局 项 。 


显示 隐藏 文件 

默认 情况 下 ，Solution Explorer 隐藏 了 一 些 文件 。 单 击 Solution Explorer 工具 栏 中 的 Show All Files 按钮 ， 可 
以 显示 所 有 隐藏 的 文件 。 例 如 ，bin 和 obj 子 文件 夹 存 放 了 编译 的 文件 和 中 间 文 件 。obj 子 文件 夹 存放 各 种 临时 
的 文件 或 中 间 文 件 ; bin 子 文件 夹 存放 已 编译 的 程序 集 。 


2. 将 项 目 添 加 到 解决 方案 中 
下 面 各 节 将 介绍 Visual Studio 如 何 处 理 Windows 桌面 应 用 程序 和 控制 台 应 用 程序 。 最 终 会 创建 一 个 名 为 
SimpleApp 的 Windows 项 目 ， 将 它 添加 到 当前 的 解决 方案 ConsoleAppl 中 。 


注意 : 

创建 SimpleApp 项 目 ， 得 到 的 解决 方案 将 包含 一 个 UWP 应 用 程序 和 一 个 控制 台 应 用 程序 。 这 种 情况 并 
不 多 见 ， 更 有 可 能 的 是 解决 方案 包含 一 个 应 用 程序 和 许多 类 库 。 这 么 做 只 是 为 了 展示 更 多 的 代码 。 不 过 ， 有 时 
需要 创建 这 样 的 解决 方案 ， 例 如 ， 编 写 一 个 既 可 以 运行 为 UWP 应 用 程序 、 又 可 以 运行 为 命令 行 实用 工具 的 实用 
程序 。 


创建 新 项 目的 方式 有 几 种 。 一 种 方式 是 在 File 们 单 中 选择 New | Project( 前 面 就 是 这 么 做 的 )， 或 者 在 File 
菜单 中 选择 Add | New Project。 选 择 New Project 命令 将 打开 熟悉 的 Add New Project 对 话 框 ， 如 图 18-12 所 示 。 
不 过 ， 此 时 Visual Studio 会 在 已 有 ConsoleApp1l 项 目 所 在 的 解决 方案 中 创建 新 项 目 。 
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图 18-12 


如 果 选 择 该 选项 ， 就 会 添加 一 个 新 项 目 ， 因 此 ConsoleAppl 解决 方案 现在 包含 一 个 控制 台 应 用 程序 和 一 个 
空白 的 应 用 程序 (Universal Windows)。 
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注意 : 
Visual Studio 支持 语言 独立 性 ， 所 以 新 项 目 并 不 一 定 是 C# 项 目 。 将 C# 项 目 、Visual Basic 项 目 和 C++ 项 目 
放 在 同一 个 解决 方案 中 是 完全 可 行 的 。 但 是 ， 本 书 的 主题 是 C#， 所 以 创建 C# 项 目 。 


对 于 平台 版 本 ， 选 择 安装 在 系统 上 的 Target 和 Minimum 版 本 。 可 以 为 Target 和 Minimum 版 本 选择 最 新 版 
本 (参见 图 18-13)。 

当然 ， 这 意味 着 ConsoleApp1l 不 再 适合 作为 解决 方案 的 名 称 。 要 改变 名 称 ， 可 以 右 击 解 决 方案 的 名 称 ， 并 
选择 上 下 文 琳 单 中 的 Rename 命令 ,将 新 的 解决 方案 命名 为 DemoSolution。Solution Explorer 窗口 现在 如 图 18-14 
所 示 。 
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b 

Target version: Windows 10 Fall Creators Update (10.0: Build 16299) ~ ， a Assets 
b 


| App.xaml 


Minimurm version: Windows 10 Fall Creators Update (10.0; Build 16299) 局 MainPage.xaml 


L 回 Package.appxmanifest 


Which wersion should | choose? Cancel 同 simpleApp_TemporaryKey.pfx 
18-13 图 18-14 


可 以 看 出 ，Visual Studio 目 动 为 新 添加 的 UWP 项 目 引 用 一 些 额 外 的 基 类 ， 这 些 基 类 对 于 WPF 功 能 非常 重要 。 

注意 ， 在 Windows Explorer 中 ， 解 决 方案 文件 的 名 称 已 经 改 为 DemoSolution.sln。 通 常 ， 如 果 想 重 命 名 任 
何 文件 ，Solution Explorer 窗口 是 最 合适 的 选择 ， 因 为 Visual Studio 会 自动 更 新 它 在 其 他 项 目 文件 中 的 引用 。 如 
果 只 使 用 Windows Explorer 重 命名 文件 ， 可 能 会 破坏 解决 方案 ， 因 为 Visual Studio 不 能 定位 需要 读 入 IDE 的 所 
有 文件 。 因 此 需要 手动 编辑 项 目 和 解决 方案 文件 来 更 新 文件 引用 。 

3. 设置 局 动 项 目 

请 记 住 ， 如 果 一 个 解决 方案 有 多 个 项 目 ， 就 需要 配置 哪个 项 目 作 为 启动 项 目 来 运行 。 也 可 以 配置 多 个 同 
时 启动 的 项 目 。 这 有 多 种 方式 。 在 Solution Explorer 中 选择 一 个 项 目 之 后 ， 上 下 文 菜单 会 提供 Set as Startup 
Project 选 项 ， 它 允许 一 次 设置 一 个 局 动 项 目 。 也 可 以 使 用 上 下 文 沫 单 中 的 Debug | Start new instance 命 令 ， 在 一 
个 项 目 后 启动 另 一 个 项 目 。 要 同时 启动 多 个 项 目 ， 右 击 Solution Explorer 中 的 解决 方案 ， 并 选择 上 下 文 菜单 中 的 Set 
Startup Projects， 打 开 如 图 18-15 所 示 的 对 话 框 。 当 选择 Multiple Startup Projects 之 后 ， 可 以 定义 启动 哪些 项 目 。 

4. 浏览 类 型 和 成 员 

当 Visual Studio 初次 创建 UWP 应 用 程序 时 ， 该 应 用 程序 比 控制 台 应 用 程序 要 多 包含 一 些 初 始 代 码 。 这 是 
因为 创建 窗口 是 一 个 较 复杂 的 过 程 。 第 34 章 详细 讨论 UWP 应 用 程序 的 代码 。 现 在 ， 查 看 MainPage.xaml 中 的 
XAML 代码 ， 和 MainPage.xaml.cs 中 的 C# 人 代码。 这 里 也 有 一 些 隐 藏 的 C# 人 代码。 遍历 Solution Explorer 中 的 树 
状 结构 ， 在 MainPage.xamlcs 的 下 面 可 以 找到 MainPage 类 。Solution Explorer 在 该 文件 中 显示 了 所 有 代码 文件 
中 的 类 型 。 在 MainPage 类 型 中 ， 可 以 看 到 类 的 所 有 成 员 。 _contentLoaded 是 一 个 布尔 类 型 的 字段 。 单 击 这 个 字 
段 ， 会 打开 MainWindow.g.ics 文件 。 这 个 文件 是 MainPage 类 的 一 部 分 ， 它 由 设计 器 自动 生成 ， 包 含 一 些 初始 
化 代码 。 
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solution Dermcscolutmon Property Pages | A | 
WA Wia nnguration Manager.. 
a Common Properties 门 ) Curent eclion 
3tartup Project OO single startup project 
Project Dependencles 
ConsoleApp | 


Code Analysis Settings 
Debug source Files 


I 午 ) Multiphe startup projects 
b Configquration Properties - : 


Project hetion 中 
ConsoleAppl start a 
SimpleApp 

图 18-15 


5. 预览 项 

Solution Explorer 提供 的 一 个 功能 是 Preview Selected Items 按钮 。 局 用 这 个 按钮 ， 在 Solution Explorer 中 单 
击 一 项 ， 就 会 打开 该 项 的 编辑 器 ， 这 与 往 童 相同。 但 如 果 该 项 以 前 没有 打开 过 ， 编 辑 器 的 选项 卡 流 束 会 在 最 右 
端 显示 新 打开 的 项 。 现 在 单 击 另 一 项 ， 以 前 打开 的 项 就 会 天 财 。 这 大 大 减少 了 打开 的 项 数 。 

在 预览 项 的 编辑 器 选项 卡 中 有 Keep Open 按钮 ， 它 会 使 该 项 在 单 击 另 一 项 时 仍 处 于 打开 状态 ， 保 持 打 开 的 
项 的 选项 卡 会 器 左 移动 。 

6. 使 用 作用 域 

设置 作用 域 可 以 让 用 户 专注 于 解决 方案 的 某 一 特定 部 分 .Solution Explorer 列表 显示 的 项 会 越 来 越 多 。 例 如 ， 
打开 一 个 类 型 的 上 下 文 淋 单 ， 束 可 以 从 Base Types 某 单 中 z 
选择 该 类 型 的 基 类 型 。 这 里 可 以 看 到 完整 的 类 型 继承 层次 ee 


结构 ， 如 图 18-16 所 示 。 EE z 2 3” 2 加 
因为 Solution Explorer 包含 的 信息 量 比 在 一 个 屏幕 中 Tree Te pp 
可 以 轻松 查看 的 信息 量 要 多 ， 所 以 可 以 用 New Solution jue we a, 
Explorer View 华 单 项 一 次 打开 多 个 Solution Explorer 窗口 ， 如 Control (Controls) 
并 且 可 以 设置 作用 域 来 显示 一 个 特定 元 素 。 例 如 ， 要 显示 at 
一 个 项 日 或 一 个 类 ， 可 选择 上 下 文 华 单 中 的 Scope to This 4 如 本 (Xaml) 
命令 。 要 返回 到 以 前 的 作用 域 ， 可 单 击 Back 按钮 。 
7. 将 项 添加 到 项 目 中 图 18-16 


在 Solution Explorer 中 可 以 直接 将 不 同 的 项 添加 到 项 目 中 。 选 择 项 目 ， 打 开 上 下 文 菜 单 Add | New Item， 打 
开 如 图 18-17 所 示 的 对 话 框 。 打 开 这 个 对 话 框 的 男 一 种 方式 是 ,使 用 主 菜 单 Project | Add New Item。 该 对 话 框 有 
很 多 不 同 的 类 别 ， 例 如 添加 类 或 接口 的 代码 项 、 使 用 Entity Framework 或 其 他 数据 访问 技术 的 数据 项 等 。 

8. 管理 引用 和 依赖 项 

使 用 Visual Studio 添加 引用 需要 特别 关注 ， 因 为 项 目 类 型 有 区 别 。 根 据 项 目 类 型 ， 可 以 在 Solution Explorer 
中 看 到 Dependencies 或 References。 在 单 击 此 项 时 打开 上 下 文 菜单 ， 可 以 看 到 Add References 菜单 项 ， 它 用 以 
打开 Reference Manager。 
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0 路 


Add New ltem =- SimpleApp 
4 Installed Sort bw | Default 


门 Blank Page Visual C# Type: Visual Cs 
高 blank page. 


Content Dialog Wisual 亡 二 
LU Resource Dictromary Visual 已 过 
下面 本 


Ey) | Templated Controal Visual 已 天 


Warmann Forms 


| 
4 | User Control Wisual C§ 
Ei 


bb Online 


站 REPAL Wiew Wiswal 已 昌 


[i Resources File (resiwl Wiswual (者 


BlankPagel.xamil 


图 18-17 


如 图 18-18 所 示 的 Reference Manager 可 以 同 同一 解决 方案 中 添加 对 其 他 项 目的 引用 ， 疝 同一 解决 方案 中 添 
加 对 共享 项 目的 引用 ， 并 浏览 程序 集 。 


Reference Manager - SimpleApp 
bb Acsermblies 


4 Projects Name Path Name: 


colut [L CorsoleAppl Cprocsharp\ConsoleAppl\Co... ConsaleAppl] 
Glutian 


bk Shared Projects 
b Universal Wirdows 


EE Drawae 


| Browse... | OK || Cancel | 


图 18-18 


注意 : 
共享 项 目 允 许 在 不 同 的 技术 之 间 共 享 代 码 ， 而 不 需要 创建 库 。 这 个 特性 在 第 19 章 中 介绍 。 


根据 要 添加 引用 的 项 目 类 型 ，Reference Manager 提供 了 不 同 的 选项 。 对 于 .NET Framework 项 目 ， 还 可 以 引 
用 共享 程序 集 和 COM 对 象 。 

当 创 建 Universal Windows Platform 应 用 程序 时 ， 可 以 引用 Universal Windows Extensions， 例 如 可 用 于 
Windows IoT 或 Windows Mobile 的 API 扩展， 如 图 18-19 所 示 。 

NET Core 的 所 有 新 功能 都 可 以 通过 NuGet 包 使 用 。 许多 对 .NET Framework 的 改进 也 可 以 通过 NuGet 包 使 
用 .可 以 在 Solution Explorer 的 上 下 文 菜单 中 访问 NuGet 包 管理 器 (请 参见 图 18-20), 也 可 以 选择 Project | Manage 
NuGet Packages。 可 以 浏览 要 安装 的 新 软件 包 ， 得 看 已 安装 的 软件 包 ， 更 新 已 安装 的 软件 包 。 图 18-20 显示 了 包 
更 新 可 用 的 指示 。 


Bb Assermblies 


b Projects 


b Shared Projects 


a Universal Windows 


bb Breawse 


Reference Manager - simplehpp 


Filtered to: SDks applicable to SimpleApp 


Name 


hicrosoft General ii OLS for Uniwersal Windo 


Microsoft Universal CRT Debug Runtime 
Microsoft Universal CRT Debug Runtime 
Microsoft Universal CRT Debug Runtime 


Core 
Extensions 


Recent hicrosoft Visual Studio Test Core 


Microsoft Visual Studio Test Core 
MSTest for Managed Projects 
MSTest for Managed Projects 


Visual C+4 2012 UWP Desktop Runtime for nati,.. 
Visual C+4+ 2013 UWP Desktop Runtime for nati,,, 
Visual 起 本 让 2015 Runtime for Universal Windews,., 
Visual C++ 2015 UWP Desktep Runtime fer natl,,, 


Microsoft General MIDI DLS for Universal Windo.,, 
Microsoft General ID DLS fer Universal Wirnee... 


hicrosoft Visual E++ 2013 Runtime Package for... 


Version 


10.0.1530630 
10.0.143930 
10.0.16299.0 
10.0.15063.0 
10.0.143930 


i40 
15.5 
15.0 
15.9 
15.0 
140 
14.0 
14.0 
0 
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Name: 

Microsoft General MID| DLS for 
Universal Windows Apps 
Wersion: 

100.16299.0 
Targets: 

UAP 10.00.0 


Installed Updates 回 


B= BB [| | include prenleam 


Noewtonsotft.Json 二 by lumes Notor 
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jQuery by jQuery Foundation Inc 42.00 temonds 
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NuGet Package Manager: SimpleApp 


Farkaoe sauce | mugetorg -| 将 


~- NewtonsoftJsaon 局 
Wertion: Lasedn qable 1003 
= | Options 


Bercription 

Jor, MET Bh & Populsr high- Perlesrrpree ISON (rer ter MET 
Wersign: 100.3 

Butherish: 和 | 


[本 本 


| Ei] aiehuks 本 = 


LICENSE md 
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Prajaet URL: 
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要 配置 NuGet 包 的 来 源 ， 可 以 通过 选择 Tools | Options， 打 开 Options 对 话 框 。 在 Options 对 话 框 中 选择 树 
视图 中 的 NuGet Package Manager | Package Sources ( 见 图 18-21)。 默 认 情 况 下 ， 配 置 了 微软 的 NuGet 服务 器 ， 也 
可 以 配置 其 他 NuGet 服务 器 或 自己 的 服务 器 。 在 NET Core 和 ASPNET Core 1.0 中 ， 微 软 提供 了 每 日 更 新 的 


NuGet 包 种 子 。 


Options 
Search Options (Ctrl+E) Pp Available package sources: 
pb Al Tools A 


- kA nuget.o 
b rure Data Lake 9 吗 


bP Arure Service Autherntication 

b Contalrer Tools 

PF Cross Plattorm 

b Database Tools 

忆 FX Tooks 

bP Live Unit Testing 

a NuGet Packadge lanader 
General 
Package Sources 

b Python 

bp snapshoat Debugger 

FF SQL Server Tools 

bh Test 

b Text Templatwng 

b Web 

b Web Forms Desligner 

Pp Web Perfommance Test Tools 


ASP.NET Core Daily 


夯 Local Packages 
cpackages 


Name: Local Packages 


30Urce: CNpackages 


LE 
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https /dotnet.myget.org/F/aspnetcore-dev/api/v3/index json 


Machine-wide package sources: 
El] Mierosoft Visual Studio Offline Packages 
CAProgram Files (xH6)\Microsoft SOKs\NuGetPackades, 


[| 


中 六 个 路 


https: /api.nuget.orgv3/indexjson 


Ok Caricel 
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使 用 NuGet 包 管 理 器 ， 不 仅 可 以 选择 包 的 来 源 ， 也 可 以 选择 一 个 过 滤器 ， 碍 看 安装 的 所 有 包 ， 或 者 可 用 的 
升级 包 ， 并 搜索 服务 器 上 的 包 。 


注意 : 
在 ASPNET Core 中 ，JavaScript 库 不 再 在 NuGet 服务 器 中 使 用 。 相 反 ，JavaScript 包 管理 器 ， 例 如 NPM、 
Bower 等 ， 在 Visual Studio 2017 中 获得 直接 支持 。 参 见 第 30 章 。 


依赖 项 或 引用 的 另 一 个 选项 是 Add Connected Service 菜单 。 这 将 打开 如 图 18-22 所 示 的 对 话 框 ， 该 对 话 框 
允许 同 应 用 程序 轻松 添加 特定 的 特性 。 选 择 这 些 包 中 的 一 个 会 添加 NuGet 包 ， 在 应 用 程序 中 做 一 些 修 改 ， 通 和 
打开 一 个 网 页 来 帮助 确定 下 一 步 需要 做 什么 。 可 以 通过 在 这 个 对 话 框 中 的 Find More Services... 链 接 来 访问 更 多 
的 连接 服务 。 


Connected Services 


Add code and dependerneies for one of these services to your application 


< 一 Crash Reporting with HockeyApp 


Enable symbolicated cerash collection far meanimgtul Bnalysis, 


Mobile Backend with Azure App Service Mobile App 


Store data in the loud, add authentication, and deliver push netifications for moebile apps. 


Claoud Storage with Arure Storage 
i Store and access data with Arure Storage services like Blobs, Queues, and Tables. 


口 Access Office 365 Services with Microsoft Graph 


Lse the Micraosoltt Graph API to integrate your applications with Office 365 services. 


Find meore services 


图 18-22 


18.3.2 ”使 用 代码 编辑 器 


Visual Studio 代码 编辑 器 是 进行 大 部 分 开发 工作 的 地 方 。 在 Visual Studio 中 ， 从 默认 配置 中 移 除 一 些 工具 
栏 ， 并 移 除 了 呈 单 栏 、 工 具 栏 和 选项 卡 标题 的 边框 ， 从 而 增加 了 代码 编辑 器 的 可 用 空间 。 下 面 介绍 该 编辑 器 中 
最 有 用 的 功能 。 


1. 可 折合 的 编辑 需 


Visual Studio 中 的 一 个 显著 功能 是 使 用 可 折 有 登 的 编辑 器 作为 默认 的 代码 编辑 器 .图 18-23 是 前 面 生 成 的 控制 
台 应 用 程序 代码 。 注 意 窗口 左 侧 的 小 减 叶 ， 这 些 符号 所 标记 的 点 是 编辑 器 认为 新 代码 块 (或 文档 注释 ) 的 开始 位 
置 。 可 以 单 击 这 些 图 标 来 关闭 相应 代码 块 的 视图 ， 如 同 关闭 树 状 控件 中 的 节点 ， 如 图 18-24 所 示 。 

这 意味 着 在 编辑 时 可 以 只 关注 所 需 的 代码 区 域 ， 隐 藏 此 刻 不 感 兴趣 的 代码 。 如 果 不 喜 欢 编辑 器 折 倒 代码 的 
方式 , 可 以 用 C# 预 处 理 器 指令 #region 和 #endregion 来 指定 要 折 县 的 代码 块 。 例如 , 要 折 倒 Main0 方 法 中 的 代码 ， 
可 以 添加 如 图 18-25 所 示 的 代码 。 
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oj Demasolution 


Program.cs 
ConsoleApp1 
] using System; 
anamespace ConsoleApp1 
{ 
class Program 
{ 
static void Main(string[] args) 


{ 
Console WriteLine("Hello Worldl!"); 


18-23 


中 | Demaeselutien 
ConsoleApp1 A consoleAce1 -| Maintstring 


using System; 


anamespace ConsoleAppl 
{ 


class Program, .， ,| 


图 18-24 


xd DemosSolution 
og | 


ConsoleApp1 
] using System; 


. . ConsoleApp1.Program 到 中。 Main(string 


anamespace ConsoleAppl 
{ 


class Program 


{ 


tregion Some Implementation of the Main method 


static void Main(string[] args) 


{ 
} 


#endregion 


Console .WriteLine("Hello World!"); 


18-25 
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代码 编辑 器 目 动 检测 要 egion 块 ， 并 通过 殷 egion 指令 放置 一 个 新 的 减 号 标识 ， 这 允许 关闭 该 区 域 。 封 闭 区 
域 中 的 这 段 代 码 允 许 编辑 器 关闭 它 (如 图 18-26 所 示 )， 在 贞 egion 指令 中 用 指定 的 注释 标记 这 个 区 域 。 然 而 ， 编 
译 器 会 忽略 这 些 指令 ， 跟 往常 一 样 编译 Main(0 方 法 。 


using System; 


:Enamespace ConsoleAppl 


图 18-26 


2. 在 编辑 器 中 导航 

编辑 器 的 顶 行 是 三 个 组 合 框 。 右 边 的 组 合 框 允 许 导 航 输入 的 类 型 成 员 。 中 间 的 组 合 框 允 许 导航 类 型 。 左 边 
的 组 合 框 允许 在 不 同 的 应 用 程序 或 框架 之 间 导 航 。 例 如 ， 如 果 正 在 处 理 一 个 共享 项 目的 源 代 码 ， 在 编辑 器 的 左 
边 组 合 框 中 ， 可 以 选择 使 用 共享 项 目的 一 个 项 目 ， 查看 所 选项 目的 活跃 代码 。 不 为 所 选项 目 编译 的 代码 会 瞳 显 。 
使 用 C# 预 处 理 器 命令 可 以 为 不 同 的 平台 创建 代码 段 。 

3. |IntelllSense 

除了 可 折 登 编辑 器 的 功能 之 外 ，Visual Studio 的 代码 编辑 器 也 集成 了 Microsoft 流行 的 IntelliSense 功能 。 它 
不 仅 减少 了 输入 量 ， 还 确保 使 用 正确 的 参数 。IntelliSense 会 记 住 首 选项 ， 并 从 这 些 选 项 开始 提供 列表 ， 而 不 是 
使 用 IntelliSense 提供 的 有 时 相当 长 的 列表 。 

代码 编辑 器 甚至 在 编译 代码 之 前 就 对 代码 进行 语法 检查 ， 用 短波 浪 线 指示 错误 。 将 鼠标 指针 晤 停 在 带 有 下 
划 线 的 文本 上 ， 会 弹出 一 个 包含 了 错误 描述 的 小 方 框 。 


4. CodeLens 


用 户 可 能 修改 了 一 个 方法 , 但 生 了 调用 它 的 方法 。 现 在 很 容易 找到 调用 者 。 引 用 数 会 直接 显示 在 编辑 器 中 ， 
如 图 18-27 所 示 。 单 击 引用 链接 时 ， 会 打开 CodeLens， 以 便 查看 调用 者 的 代码 ， 并 导航 到 它们 。 

如 果 使 用 Git 或 TFS 把 源 代码 签 入 到 源 代码 控制 系统 中 ， 例 如 Visual Studio Online， 也 可 以 看 到 作者 和 所 
进行 的 更 改 。 如 果 正 在 使 用 单元 测试 (在 第 28 草 中 介绍 )， 就 可 以 看 到 成 功 和 失败 的 测试 运行 数量 ， 可 以 立即 切 
换 到 详细 的 信息 。 


注意 : 
CodeLens 不 能 用 于 Visual Studio Community 版 本 。 


5. 使 用 代码 片段 

代码 片段 提升 了 代码 编辑 器 的 工作 效率 ， 仅 需要 在 编辑 器 中 写 入 cw<tab><tab>， 编 辑 器 就 会 创建 
Console.WriteLine():。 Visual Studio 目 带 很 多 代码 片段 : 

se 使 用 快捷 方式 do、for、forr、foreach 和 while 创建 循环 

e 使 用 equals 实现 Equals 方法 

e 使 用 attribute 和 exception 来 创建 Attribute 和 Exception 派生 类 型 等 


第 18 章 Visual Studio 2017 | 397 


Es| UmitTesira Fammplien 村 Es LnitTegliray mpler Slriney Terrale 日 盔 mil 


二 ME Ey 到 七 故而 记 
-namespace UnitTestingSamples 
| 
public class Stringsample 
a WnitTestingS arm phes HS Tesis .Sring Saori pleTeat.es (2) = mesa lelstrlne jnity 
2 : string ctual = sample GetlrngDemol ab Ee 
» 32: thing tual = HOm pe etngbemel abcd el ne i 


a UnitTestingSsrmplhes sinit Testsi Sringtemple Testcs (6 
19: Assort T hr < AreurenablullEnceptionr I = > Sple.Gwistrieg bem ll “a 
3 a0: ArserttThrows -ArgunentMNullEceptonz tl 二 > semple.Gelstrirgbemol en nu: 


merle. Delstriragbemelstnrg Empty, “a°Ik 
| 


throw new AreumentHul lException( nameof(init}yy): 

t = linits 

器 [lapse BI 
19 pr /acre—string _init; 

BE [十 人 nas 

public string GetstringDemtstring first, string second) 


if Cfirst == null) 


throw new ArpgumentNul lExceptiontnameof(tfirst}): 
if rstring: IsMNul lOrEmpty(firsty) 
{ 
throw new ArgumentExcepticon("empty string is not allowed”, first}; 
10 号 =| 忆 


图 18-27 


选择 Tools | Code Snippets Manager， 在 打开 的 Code Snippets Manager 中 可 以 看 到 所 有 可 用 的 代码 片段 (如 图 
18-28 所 示 )。 也 可 以 创建 自 定 义 的 代码 片段 。 


Code Snippets lanager ? 


Larmgunsape 
Coharp 


Location 
ENProgram Files (sbej /hicrosoft Visual Studio PreviewiEntenprise Va Snippets" ia 七 专 


ll Refactoning a 
ml Test 
ml US0L 

ww me Visual C# 


Bdd.., Remopre 


IFaart Carneel 
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6. EditorConfig 

Visual Studio 支持 不 同 的 编码 风格 。 在 Visual Studio 的 早期 版 本 中 ， 可 以 配置 环境 的 编码 风格 。 但 是 ， 处 理 
不 同 的 项 目 时 ， 可 能 需要 不 同 的 编码 风格 。 如 果 在 Tools | Options | Text Editor | General 中 配置 Follow Project 
Coding Conventions 选项 ，EditorConfig 就 支持 不 同 的 编码 风格 。 

要 使 用 EditorConfig， 可 以 将 .editorconfig 文件 添加 到 项 目 目录 或 子 目录 中 。 该 配置 适用 于 此 目录 和 子 目 录 
中 的 所 有 源 代 码 文 件 。 在 子 目录 中 ， 可 以 添加 更 多 的 .editorconfig 文件 ， 这 些 文 件 可 以 和 覆盖 父 目 录 的 配置 。 

ASPNET Core MVC 团队 使 用 的 .editorconfig 文件 如 下 代码 片段 所 示 。 在 这 个 文件 中 ,可 以 根据 不 同 的 文件 
扩展 名 ， 定 义 缩 进 的 大 小 ， 还 可 以 定义 编码 指南 一 一 例如 ，var 是 应 该 首选 还 是 无 效 ， 应 该 或 不 应 该 使 用 this 限 
定 待 ，C# 定 义 的 关 型 是 否 应 该 优 于 .NET 类 型 ， 是 否 应 该 允许 throw 表达 式 等 。 通 过 这 些 设置 ， 可 以 判断 编辑 器 
应 该 生成 建议 、 警 告 还 是 错误 : 

# Editorconfig is awesome:http://EditorConfig.org 


# top-most EditorCconfig file 
root = true 


# Don't use tabs for indentation. 


E 
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indent style = SPace 
# (Please don't specify an indent size here; that has too many unintended 
# consequences.) 


# Code files 
[*. {cs, cs, vh, vohx}] 
indent size = 4 


# Xml project files 
[*. {csproj, vbhpro],vCxproj, VCXEPIO] .filters,proj,projitems, shproj}] 
indent size = 2 


# Xml config files 

[*. {props,targets,ruleset,config,nuspec, resx, vsixmanifest,vsct}] 
indent size = 2 

# JSON files 

[* .Jj son] 


indent size 一 


# Dotnet code style settings: 


LI[*.cs] 
# Sort using and Import directives with System.* appearing first 
dotnet sort system directives first = true 


# Don't use this. qualifier 
dotnet style qualification for field = false:suggestion 
dotnet style qualification for property = false:suggestion 


# use int x = .. over Int32 
dotnet style predefined type for locals parameters members = true:suggestion 


# use int.MaxValue over Int32.MaxVvalue 
dotnet style predefined type for member access = true:suggestion 


# Require Var all the time. 

csharp style Var for built in types = true:suggestion 
csharp style Var When type is apparent = true:suggestion 
csharp style Var elsewhere = true:suggestion 


# Disallow throw expressions. 
csharp style throw expression = false:suggestion 


# Newline settings 

csharp new line before open brace = all 

csharp new line before else = true 

csharp new line before catch = true 

csharp new line before finally = true 

csharp new line before members in object initializers = true 
csharp new line before members in anonymous types = true 


使 用 这 个 .editorconfig 文件 ， 输 入 intx = 42， 就 可 以 看 到 一 个 建议 ， 如 图 18-29 所 示 。 请 注意 ， 因 为 可 能 需 
要 在 更 改 .editorconfig 后 重新 打开 源 代码 ， 以 激活 新 的 配置 。 
i 


国 ConsoleApp1 "| ConsoleAppl.Program "| S Mainfstringl] args) 
| UsSiNnE SysStem; 
J 
anamespace ConsoleAppl 


class Program 


{ 


:Eion Some Implementation of the Main methed 


static void Main(string[] ares) 
{ 


Console.WriteLine{"Hello World!l"); 
int Xx = 42; 


车 一 [i 
struct Sn 


} Wepresents a 32-bit sgned integer. 


Lse vi’ nstesd of explieit type 


hay poatentiy| fines [ALErnter Gr GH.) 


图 18-29 
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注意 : 
在 http://editorconfig.org 上 可 以 获得 关于 文件 格式 、 各 种 编辑 器 的 插件 、editorconfig 项 目 页 面 的 更 多 信息 。 


18.3.3 学习 和 理解 其 他 窗口 


除了 代码 编辑 器 和 Solution Explorer 外 ，Visual studio 还 提供 了 许多 其 他 窗口 ， 允 许 从 不 同 的 角度 来 查看 或 
管理 项 目 。 


注意 : 

本 节 的 其 余部 分 介绍 其 他 几 个 窗口 。 如 果 这 些 窗口 在 屏幕 上 不 可 见 ， 可 以 在 View 菜单 中 选择 它们 。 要 显 
示 设 计 视 图 或 代码 编辑 器 ， 可 以 右 击 Solution Explorer 中 的 文件 名 ， 并 选择 上 下 文 菜单 中 的 View Designer 或 
View Code; 也 可 以 选择 Solution Explorer 顶部 工具 栏 中 的 对 应 项 。 设计 视图 和 代码 编辑 器 共用 同一 个 选项 卡 式 
窗口 。 

1. 使 用 设计 视图 窗口 

如 果 设 计 一 个 用 户 界面 应 用 程序 ， 如 Windows 应 用 程序 或 类 库 (Universal Windows)， 则 可 以 使 用 设计 视图 
窗口 。 这 个 窗口 显示 窗 体 的 可 视 化 概览 。 设 计 视 图 窗口 经 常 和 工具 箱 窗 口 一 起 使 用 。 工具 箱包 含 许多 .NET 组 件 ， 
可 以 将 它们 拖 放 到 程序 中 。 工 具 箱 的 组 件 会 根据 项 目 类 型 而 有 所 不 同 。 图 18-30 显示 了 Windows 应 用 程序 中 的 
数据 项 。 

要 将 目 定义 的 类 别 添加 到 工具 箱 ， 请 执行 如 下 步骤 : 

(1) 右 击 任何 一 个 类 别 。 

(2) 选择 上 下 文保 单 中 的 Add Tab。 

可 以 将 代码 片段 移动 到 工具 箱 中 的 项 中 ， 这样 就 可 以 方便 地 访问 它们 。 也 可 以 选择 上 下 文 菜 单 中 的 Choose 
Items， 在 工具 箱 中 放置 其 他 工具 ， 这 尤其 适合 于 添加 自 定义 的 组 件 或 工具 箱 默 认 没 有 显示 的 通用 窗口 组 件 ， 如 
图 18-31 所 示 。 
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2. 使 用 Properties 窗口 


如 本 书 第 I 部 分 所 述 ，NET 类 可 以 实现 属性 。Properties 窗口 可 用 于 项 目 、 文 件 和 使 用 设计 视图 选择 的 项 。 
18-32 显示 了 Windows 应 用 程序 中 一 个 控件 的 Properties 视图 。 

在 这 个 窗口 中 可 以 看 到 一 项 的 所 有 属性 ， 并 对 其 进行 相应 的 配置 。 一 些 属 性 可 以 通过 在 文本 框 中 输入 文 
本 来 改变 ， 一 些 属 性 有 预定 义 的 选项 ， 一 些 属 性 有 上 自 定 义 的 编辑 器 。 也 可 以 在 Properties 窗口 中 添加 事件 处 
理 程 序 。 


3. 使 用 类 视图 窗口 


solution Explorer 可 以 显示 类 和 类 的 成 员 ， 这 是 类 视图 的 一 般 功 能 (如 图 18-33 所 示 )。 要 调用 类 视图 ， 可 选 
择 View | Class View。 类 视图 显示 代码 中 的 名 称 空间 和 类 的 层次 结构 。 它 提供 了 一 个 树 型 结构 ， 可 以 展开 该 结 
构 来 查看 名 称 空 间 下 包含 哪些 类 ， 类 中 包含 哪些 成 员 。 
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18-32 图 18-33 


类 视图 的 一 个 杰出 功能 是 ， 如 果 右 击 任何 有 权 访 问 其 源 代 码 的 项 的 名 称 ， 然 后 选择 上 下 文 菜单 中 的 Go To 
Definition 命令 ， 就 会 转 到 代码 编辑 器 中 的 项 定义 。 另 外 , 在 类 视图 中 双击 该 项 (或 在 代码 编辑 器 中 右 击 想 要 的 
项 ， 并 从 上 下 文 菜单 中 选择 相同 的 选项 )， 也 可 以 查看 该 项 的 定义 。 上 下 文 菜单 还 允许 给 类 添加 字段 、 方 法 、 
属性 或 索引 器 。 换 句 话说 ， 在 对 话 框 中 指定 相关 成 员 的 详细 信息 ， 就 会 自动 添加 代码 。 这 个 功能 对 于 添加 属性 
和 索引 器 非常 有 用 ， 因 为 它 可 以 减少 相当 多 的 输入 量 。 


4. 使 用 Object Browser 窗口 


在 .NET 环境 中 编程 的 一 个 重要 方面 是 能 够 找 出 基 类 或 从 程序 集 引 用 的 其 他 库 中 有 哪些 可 用 的 方法 和 其 他 
代码 项 。 这 个 功能 可 通过 Object Browser 窗口 获得 (参见 图 18-34)。 在 Visual Studio 2017 中 选择 View 菜单 中 的 
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Object Browser， 可 以 访问 这 个 窗口 。 使 用 这 个 工具 ， 可 以 浏览 并 选择 现 有 的 组 件 集 ， 如 .NET Framework 4.0 到 
4.7.1 版 本 、 适 用 于 Windows 运行 库 的 NET Portable Subsets 以 及 .NET for UWP， 并 查看 这 个 子 集中 可 用 的 类 和 
类 成 员 。 在 Browse 下 拉 框 中 选择 Universal Windows， 来 选择 Windows 运行 库 ， 也 可 以 找到 这 个 用 于 UWP 应 用 
EN API 的 所 有 名 称 空 间 、 类 型 和 方法 。 
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System Lingd 

"0 Systerm Ling. Expresslions 
"systemLing.Parallel 
Syster Lina, Queryable 
1 Systerm Met 

system Net. Http 
"ystem et.Htp.Rte 


上 本 本 System Net.NameResolution 


Systerm, Net.Netwerkln hormatian 
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SMMmary: 
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注意 : 
不 要 因为 下 拉 列 表 中 提供 的 许多 选择 没有 显示 任何 结果 而 对 Object Browser 感到 厌烦 ， 这 是 根据 设计 而 
定 的 。 


5. 使 用 Server Explorer 窗口 


使 用 Server Explorer 窗口 ， 如 图 18-35 所 示 ， 可 以 在 编码 PS 
时 找 出 计算 机 在 网 络 中 的 相关 信息 。 在 该 窗口 的 Servers 部 分 由 x| 记 谭晶 | 蒜 
中 ， 可 以 找到 服务 运行 情况 的 信息 (这 对 于 开发 Windows 服务 ， 入 Am uaumnmoseuve pg 
是 非常 有 用 的 )， 创 建新 的 性 能 计数 ， 访 问 事件 日 志 。 在 Data ! ) 
Connections 部 分 中 不 仅 能 够 连接 现 有 数据 库 ， 查 询 数据 ， 还 可 bp 全 Data Lake Analytics 
以 创建 新 的 数据 库 。Visual Studio 2017 也 有 一 些 内 置 于 Server Noobon un 
Explorer 的 Windows Azure 信息 ， 包 括 App Services、Virtual 


, 国 SAL Databases 
| i Storage 
Machmes、Nontfications、 Storage 等 选项 o 其 Stream Analytics jobs 


号 Virtual Machines 


6 Data Connmections 
6. 使 用 Cloud Explorer Sorvers 


4 国 Chariots 
» [9 Event Logs 
.Message Queues 
I Performance Counters 


Explorer 可 以 访问 Microsoft Azure 订阅 ， 访 问 资源 ， 查 看 日 志 六 sevices 


如 果 安 装 了 Azure SDK， 那 么 Cloud Explorer ( 见 图 18-36) 
是 一 个 可 用 于 Visual Studio 2017 的 新 浏览 器 。 使 用 Cloud 


局 动 调试 会 话 。 


图 18-35 
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7. 使 用 Document Outline 窗口 


可 用 于 WPF 和 UWP 应 用 程序 的 一 个 窗口 是 Document Outline。 如 图 18-37 所 示 ， 在 这 个 窗口 中 打开 了 网 
上 附加 第 1 章 的 一 个 应 用 程序 ， 从 中 可 以 查看 XAML 元 素 的 逻辑 结构 和 层次 结构 ,锁定 元 素 以 防止 其 无 意 中 被 
修改 ， 在 层次 结构 中 轻松 地 移动 元 素 ， 在 新 的 元 素 容器 中 分 组 元 素 和 改变 布局 类 型 。 

使 用 这 个 工具 还 可 以 创建 XAML 模板 ， 图 形 化 地 编辑 数据 绑 定 。 
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18.3.4 排列 窗口 


学 习 Visual Studio 时 会 发 现 , 许多 窗口 有 一 个 有 趣 的 功能 会 让 人 联想 到 工具 栏 。 尤 其 是 , 它们 都 可 以 浮动 (也 
可 以 显示 在 第 二 个 显示 器 上 )， 也 可 以 停 知 。 当 它们 停 徘 时， 在 每 个 窗口 右上 角 的 最 小 化 按钮 劳 边 会 显示 一 个 类 
似 图 钉 的 额外 图 标 。 这 个 图 标的 作用 确实 像 图 钉 ， 它 可 以 用 来 固定 打开 的 窗口 。 固 定 窗口 (图 钉 是 垂直 显示 的 ) 
的 行为 与 平时 使 用 的 窗口 一 样 。 但 当 它 们 取消 固定 时 (图 钉 是 水 平 显 示 的 )， 则 窗口 只 有 获得 焦点 才 会 打开 。 当 
失去 焦点 时 (因为 单 击 或 者 移动 鼠标 到 其 他 地 方 )， 它 们 会 快速 退出 到 Visual Studio 应 用 程序 的 主 边框 内 。 固 定 
窗口 和 取消 固定 窗口 提供 了 另 一 种 方式 来 更 好 地 利用 屏幕 上 有 限 的 空间 。 

Visual Studio 2017 中 的 一 个 特性 是 ， 可 以 存储 不 同 的 布局 。 用 户 很 有 可 能 运行 在 不 同 的 环境 中 。 例 如 ， 在 
办 公 室 笔记 本 电脑 可 能 连接 到 两 个 大 屏幕 上 ， 但 在 飞机 上 编程 时 ， 就 只 有 一 个 屏幕 。 过 去 ， 可 能 总 是 根据 需要 
安排 窗口 ， 必 须 一 天 几 次 地 改变 窗口 的 布局 。 可 能 需要 不 同 布局 的 另 一 个 场景 是 做 网 络 开发 ， 创 建 UWP 和 
Xamarin 应 用 程序 。 现 在 可 以 保存 布局 ,轻松 地 从 一 个 布局 切换 到 男 一 个 。 在 Window 沫 单 中 选择 Save Window 
Layout， 保 存 当 前 的 工具 布局 。 使 用 Window | Apply Window Layout， 选 择 一 个 保存 的 布局 ， 把 窗口 安排 为 保存 
它们 时 的 布局 。 


18.4 构建 项 目 


Visual Studio 不 仅 可 以 编写 项 目 ， 它 实际 上 是 一 个 IDE， 管 理 着 项 目的 整个 生命 周期 ， 包 括 生成 或 编译 解 
决 方案 。 本 节 讨论 如 何 用 Visual Studio 生成 项 目 。 
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18.4.1 构建、 编译 和 生成 代码 


讨论 各 种 构建 选项 之 前 ， 先 要 弄 清 楚 一 些 术语 。 从 源 代 人 码 转换 为 可 执行 代码 的 过 程 中 ， 经 党 看 到 3 个 不 同 
的 术语 : 构建 、 编 译 和 生成 。 这 3 个 术语 的 起 源 反 映 了 一 个 事实 : 直到 最 近 ， 从 源 代 人 码 到 可 执行 代码 的 过 程 涉 
及 多 个 步骤 (在 C++ 中 仍然 如 此 )。 这 主要 是 因为 一 个 程序 包含 了 大 量 的 源 文件 。 

例如 ， 在 C++ 中 ， 每 个 源 文 件 都 需要 单独 编译 。 这 就 产生 了 所 谓 的 对 象 文件 ， 每 个 对 象 文 件 包含 类 似 于 可 
执行 代码 的 内 容 ， 但 每 个 对 象 文 件 只 与 一 个 源 文 件 相关 。 要 生成 一 个 可 执行 文件 ， 这 些 对 象 文 件 需要 连接 在 一 
起 ， 这 个 过 程 官方 称 为 链接 。 这 个 合并 过 程 通 常 称 为 构建 代码 (至 少 在 Windows 平台 上 是 如 此 )。 然 而 ,在 C# 
术语 中 ， 编 译 器 比较 复杂 ， 能 够 将 所 有 的 源 文件 当 作 一 个 块 来 读 取 和 处 理 。 因 此 ， 没 有 真正 独立 的 链接 阶段 ， 
所 以 在 C# 上 下 文中 ， 术 语 “ 构 建 ” 和 “编译 ”可 以 互 换 使 用 。 

术语 “生成 ”的 含义 与 “构建 ”基本 相同 ， 虽 然 它 在 C# 上 下 文中 没有 真正 使 用 。 术 语 “ 生 成 ”起 源 于 旧 的 
大 型 机 系统 ， 在 该 系统 中 ， 当 一 个 项 目 由 许多 源 文 件 组 成 时 ， 就 在 一 个 单独 的 文件 中 写 入 指令 ， 告 诉 编 译 妖 如 
何 构建 项 目 : 包含 哪些 文件 和 链接 什么 库 等 。 这 个 文件 通 向 称 为 生成 文件 ， 在 UNIX 系统 上 它 仍 然 是 非 沼 标准 
的 文件 。 事 实 上 ，MSBnuild 项 目 文件 和 旧 的 生成 文件 非常 类 似 ， 它 只 是 一 个 新 的 高 级 XML 变 体 。 在 MSBuild 
项 目 中 ， 可 以 使 用 MSBuild 命令 ,将 项 目 文件 当 作 输入 ， 来 编译 所 有 的 源 文件 。 使 用 构建 文件 非常 适合 于 在 一 
个 单独 的 构建 服务 器 上 进行 构建 ， 其 中 所 有 的 开发 人 员 仪 需要 签 入 他 们 的 代码 ， 构 建 过 程 会 在 深夜 自动 完成 。 
第 1 章 介 绍 了 .NET Core 命令 行 (CLD 工 具 ， 该 命令 行 建立 了 .NET Core 环境 ， 现 在 在 后 台中 使 用 MSBuild。 


18.4.2 ”调试 版 本 和 发 布 版 本 


C++ 开发 人 员 非 常熟 悉 生成 两 个 版 本 的 这 种 思想 ， 有 Visual Basic 开发 背景 的 开发 人 员 也 不 会 十 分 陌生 。 其 
关键 在 于 : 可 执行 文件 在 调试 时 的 目标 和 行为 应 与 正式 发 布 时 不 同 。 准 备 发 布 软件 时 ， 可 执行 文件 应 尽 可 能 小 
而 快 。 但 是 ， 这 两 个 目标 与 调试 代码 时 的 需求 不 兼容 ， 在 接 下 来 的 小 节 中 将 看 到 这 一 点 。 

1. 优化 

在 高 性 能 方面 ， 编 译 器 对 代码 进行 的 多 次 优化 起 到 了 一 定 的 作用 。 这 意味 着 编译 器 在 编译 代码 时 ， 会 在 代 
码 实 现 细节 中 积极 找 出 可 以 修改 的 地 方 。 编 译 器 所 做 的 修改 并 不 会 改变 整体 效果 ， 但 是 会 使 程序 更 加 融 效 。 例 
如 ， 假 设 编译 器 遇 到 了 下 面 的 源 代 码 : 

double InchesToCcm(double ins})} => ins * 2.54; 

/i later on in the code 

YY 二 InchesToCm (XX); 

就 可 能 把 它们 蔡 换 为 下 面 的 代码 : 

Y= XX* 2.54; 


类 似 地 ， 编 译 器 可 能 把 下 面 的 代码 : 


{ 
string message = "Hi"™; 
Console.WriteLine (message),; 
} 
替换 为 : 


Console .WriteLine ("Hi"); 

这 样 ， 编 译 器 就 不 需要 在 此 过 程 中 声明 任何 非 必要 的 对 象 引 用 。 

C# 编 译 右 会 进行 怎样 的 优化 无 从 判断 ， 我 们 也 不 知道 前 两 个 例子 中 的 优化 在 特定 情况 中 是 否 会 实际 发 生 ， 
因为 编译 器 的 文档 没有 提供 这 类 细节 。 不 过 ， 对 于 C# 这 样 的 托管 语言 ， 上 述 优 化 很 可 能 在 JIT 编译 时 发 生 ， 而 
不 是 在 C# 编 译 器 把 源 代码 编译 为 程序 集 时 发 生 。 显 然 ， 由 于 专利 原因 ， 编 写 编 译 器 的 公司 通 前 不 愿意 过 多 地 说 
明 他 们 使 用 了 什么 技巧 。 注 意 ， 优 化 不 会 影响 源 代码 ， 而 只 影响 可 执行 代码 的 内 容 。 退 过 前 面 的 示例 ， 可 以 基 
本 了 解 优 化 产生 的 效果 。 
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问题 在 于 ， 虽 然 示 例 代 码 中 的 优化 可 以 加 快 代码 的 运行 速度 ， 但 是 它们 也 增加 了 调试 的 难度 。 在 第 一 个 例 
子 中 ， 假 设想 要 在 InchesToCmO 方 法 中 设置 一 个 断 点 ， 了 解 该 方法 的 工作 机 制 。 如 果 在 编译 器 做 了 优化 后 ， 可 
执行 代码 中 不 再 包含 InchesToCmO 方 法 ， 怎 么 可 能 进行 这 种 操作 呢 ? 同样 ， 如 果 编 译 后 的 代码 中 不 再 包含 
Message 变量 ， 又 如 何 监视 该 变量 的 值 ? 

2. 调试 器 符号 

在 调试 过 程 中 ， 经 沼 需 要 查看 变量 的 值 ， 这 时 使 用 的 是 它们 在 源 代码 中 的 名 称 。 问 题 是 可 执行 代码 一 般 不 
包含 这 些 名 称 一 一 编译 器 用 内 存 地 址 代替 了 变量 名 称 。NET 在 一 定 程度 上 改变 了 这 种 情况 ， 使 程序 集中 的 某 些 
项 以 名 称 的 形式 存储 , 但 是 这 只 适用 于 少量 的 项 (例如 公有 类 和 方法 )， 而 且 这 些 名称 在 JIT 编译 程序 集 后 也 仍然 
会 被 移 除 。 如 果 让 调试 器 显示 变量 HeightInInches 的 值 ， 但 是 编译 器 在 查看 可 执行 代码 时 只 看 到 了 地 址 ， 而 没 
有 看 到 任何 对 名 称 HeightmImches 的 引用 ， 自 然 就 得 不 到 期 望 的 结果 。 

因此 ， 为 了 正确 地 调试 ， 需 要 在 可 执行 文件 中 提供 一 些 额 外 的 调试 信息 。 这 些 信息 包含 变量 名 和 代码 行 信 
轧 ， 人 允许 调试 句 确 定 可 执行 机 器 汇编 语言 指令 与 源 代码 中 的 哪些 指令 对 应 。 但 是 ， 不 应 该 在 发 布 版 本 中 包含 这 
些 信 息 ， 这 既是 出 于 专利 考虑 (提供 调试 信息 会 方便 其 他 人 反 汇 编 代码 )， 也 是 因为 包含 调试 信息 会 增加 可 执行 
文件 的 大 小 。 

3. 其 他 源 代码 调试 指令 

一 个 相关 问题 是 ， 在 调试 时 ， 程 序 经 常 包含 一 些 额 外 的 代码 行 ， 用 于 显示 关键 的 调试 信息 。 显 然 ， 在 发 布 
软件 前 ， 需 要 从 可 执行 代码 中 彻底 删除 这 些 相 关 指令 。 手 动 删 除 是 可 以 的 ， 但 是 如 果 能 以 某 种 方式 标记 这 些 语 
句 ， 让 编译 器 在 编译 发 布 代 码 时 目 动 忽 略 它们 ， 不 是 更 方便 吗 ? 本 书 的 第 I 部 分 提 到 ， 在 C# 中 ， 定 义 合 适 的 预 
处 理 器 指令 ， 再 结合 使 用 Conditional 特性 (所 谓 的 条 件 编译 )， 就 可 以 实现 这 种 操作 。 

所 有 这 些 因 素 综合 到 一 起 ， 决 定 了 几乎 所 有 商业 软件 的 编译 调试 方式 与 最 终 交 付 产 品 的 编译 方式 是 稍 有 区 
别 的 。Visual Studio 能 够 处 理 这 种 区 别 ， 因 为 Visual Studio 在 编译 代码 时 ,会 存储 应 传递 给 编译 器 的 所 有 编译 选 
项 信息 。 为 了 支持 不 同类 型 的 构建 版 本 ，Visual Studio 需要 存储 多 组 编译 选项 。 这 些 不 同 的 版 本 信息 集合 称 为 
配置 。 在 创建 项 目 时 ，Visual Studio 会 自动 提供 两 种 配置 : 调试 和 发 布 。 

e 调试 : 这 种 配置 通常 指定 编译 器 不 优化 编译 过 程 ， 可 执行 文件 应 该 包含 额外 的 调试 信息 ， 编 译 占 假 

定 调 试 预 处 理 器 指令 Debug 是 存在 的 ， 除 非 源 代码 中 显 式 使 用 了 加 mndefined Debusg 指令 。 
e 发 布 : 这 种 配置 指定 编译 器 应 优化 编译 过 程 ， 可 执行 文件 不 应 包含 额外 的 调试 信息 ， 编 译 器 不 应 假定 
源 代 码 包含 特定 的 预 处 理 器 符号 。 

还 可 以 定义 目 己 的 配置 , 例如 设置 软件 的 专业 级 版 本 和 企业 级 版 本 。 过去， 由 于 Windows NT 文 持 Unicode 
字符 编码 ， 但 Windows 95 不 支持 ， 因 此 C+H+ 项 目 经 常 使 用 Unicode 配置 和 MBCS(Multi-Byte Character Set， 多 
字 节 字符 集 ) 配 置 。 


18.4.3 选择 配置 


Visual Studio 存储 了 多 个 配置 的 细节 ， 那 么 在 准备 生成 一 个 项 目 时 ， 如 何 决定 使 用 哪个 配置 ? 答案 是 ， 项 
目 总 是 有 一 个 活动 的 配置 ， 当 要 求 Visual Studio 生成 项 目 时 ， 就 使 用 这 个 配置 。 注 意 ， 活 动 配置 是 针对 每 个 项 
目 、 而 不 是 每 个 解决 方案 设置 的 。 

在 创建 项 目 时 ， 默 认 情况 下 Debug 配置 是 活动 配置 。 如 果 想 修改 活动 配置 ， 可 以 单 击 Build 菜单 ， 选 择 
Configuration Manager 某 单 项 。 在 Visual Studio 主 工具 栏 的 下 拉 华 单 中 也 可 以 找到 此 选项 。 


18.4.4 编辑 配置 


除了 选择 活动 配置 外 ， 还 可 以 但 看 及 编辑 配置 。 为 此 ， 在 Solution Explorer 中 选择 相关 的 项 目 ， 然 后 选择 
Project 菜单 中 的 Properties 羔 单 项 ， 这 会 打开 一 个 复杂 的 对 话 框 。 打 开 该 对 话 框 的 男 一 个 方法 是 ， 在 Solution 
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Explorer 中 右 击 项 目 名 称 ， 然 后 从 上 下 文 华 单 中 选择 Properties。 

这 个 对 话 框 包含 多 个 选项 卡 ， 用 于 选择 要 得 看 或 编辑 的 常规 属性 类 别 。 由 于 篇 幅 原 因 ， 本 节 不 展示 所 有 的 
属性 类 别 ， 只 介绍 其 中 两 个 最 重要 的 选项 卡 。 

根据 项 目 类 型 的 不 同 ， 可 用 的 选项 完全 不 同 。 首 先 ， 图 18-38 显示 了 UWP 应 用 程序 的 属性 ， 其 中 显示 了 
可 用 属性 的 选项 卡 式 视图 。 这 个 屏幕 截图 显示 了 常规 应 用 程序 设置 。 

需要 注意 的 一 点 是 ， 可 以 选择 程序 集 的 名 称 以 及 使 用 新 项 生成 的 默认 名 称 空间 。 单 击 Assembly Information 
按钮 ， 可 以 输入 版 本 号 、 标 题 、 描 述 、 公 司 和 其 他 信息 。 单 击 Package Manifest 按钮 将 切换 到 第 33 章 中 介绍 的 
Package Manifest 编辑 器 。 


Asspemibhy Infornmation. 


Package Maenifest... 


Linrwersdl Windows 
Winaows 10 Fall Creators Update (10.0: Build 16299 * 


Winadaws 10 Fall Creators Update (100 Build 16239 ~ 


18-38 
图 18-39 显示 了 NET Core Console 应 用 程序 的 配置 。 还 可 以 看 到 Application 设置 , 但 是 这 个 屏幕 看 起 来 不 
同 。 程 序 集 名 称 和 默认 名 称 空间 也 是 可 配置 的 ， 但 是 这 里 可 以 选择 目标 框架 的 版 本 、 应 用 程序 的 输出 类 型 和 局 
动 对 象 (如 果 有 多 个 Main0 方 法 )。 


Dema 


SOLUTE 


图 18-39 


图 18-40 显示 了 Universal Windows 应 用 程序 的 生成 配置 属性 。 注意， 在 对 话 框 顶部 的 下 拉 列 表 中 可 以 指定 
要 查看 的 配置 类 型 。 对 于 Debug 配置 ， 编 译 嚣 假定 已 经 定义 了 DEBUG 和 TRACE 预 处 理 器 符号 。 此 外 ， 编 译 
器 不 会 优化 代码 ， 而 且 会 生成 额外 的 调试 信息 ， 不 使 用 NET Native 工具 链 。 
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图 18-41 显示 了 .NET Core 项 目的 构建 配置 属性 。 同 样 ， 在 调试 配置 中 ， 代 码 没 有 优化 ， 而 定义 了 DEBUG 
和 TRACE 预 处 理 器 符号 。 
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Warning levet a 


SupPrews Wiminge 1701:1702:1705 
Treat warnings ss eors 


CO Mone 


I all 


®) Specilic wamings 


tp 
Chput path: bin\Debuginetcorsappa.0, 


LL] XML documerntation file 


Generate senalization assembby 


图 18-41 


18.5 ”调试 代码 


现在 ， 已 经 准备 好 运行 和 调试 应 用 程序 了 。 在 C# 中 调试 应 用 程序 与 早 于 .NET 的 语言 一 样 ， 涉 及 的 主要 技 
巧 是 设置 断 点 ， 使 用 断 点 检查 在 代码 执行 到 特定 位 置 时 发 生 了 什么 情况 。 


第 18 章 Visual Studio 2017 | 407 


18.5.1 设置 断 点 


在 Visual Studio 中 ， 可 在 实际 执行 的 任何 代码 行 上 设置 断 点 。 最 简单 的 方法 是 在 代码 编辑 器 中 单 击 文档 窗 
口 最 左边 的 灰色 区 域 ， 或 者 在 选中 合适 的 行 后 按 F9 键 。 这 会 在 该 代码 行 上 设置 一 个 断 点 ， 当 程序 执行 到 该 行 
时 将 暂停 执行 ， 并 把 控制 权 转 交 给 调试 器 。 与 Visual Studio 以 前 的 版 本 一 样 ， 断 点 由 代码 编辑 器 中 代码 行 左边 
的 红色 圆圈 表示 。Visual Studio 还 使 用 不 同 的 颜色 高 亮 显示 该 行 代 码 的 文本 和 背景 。 再 次 单 击 红色 圆圈 将 删除 
断 点 。 

如 果 对 于 特定 的 问题 ， 每 次 在 特定 的 代码 行 暂停 执行 不 足以 解决 该 问题 ， 则 还 可 以 设置 条 件 断 点 。 为 此 ， 
选择 Debug | Windows | Breakpoints。 在 打开 的 对 话 框 中 ， 输 入 想 要 设置 的 断 点 的 细节 。 例 如 ， 在 该 对 话 框 中 可 
以 执行 以 下 操作 ， 如 图 18-42 所 示 : 


Location: Program.cs, Line: 14, Character: 17, Must match source 


”| Conditions 


Conditional Expression = ls true 


Add comndition 


| Actions 
Log a message to Output Window: $FUNCTION: the value of i is 
| Continue execution 


亡 商 IEE| 
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e 指定 条 件 一 一 例如 ， 只 有 当 条 件 表 达 式 返回 tue 时 ， 才 激活 断 点 。 你 还 可 以 指定 遇 到 代码 行 达 到 一 定 次 
数 时 ， 才 激活 断 点 。 
e 设置 将 消息 记录 到 输出 窗口 并 继续 执行 的 操作 。 
使 用 该 对 话 框 还 可 以 导出 和 导入 断后 设置 ， 如 果 根 据 不 同 的 调试 场景 想 要 使 用 不 同 的 断 操 设置， 那么 这 些 
选项 十 分 有 用 。 男 外 ， 在 该 对 话 框 中 还 可 以 存储 调试 设置 。 


18.5.2 ”使 用 数据 提示 和 调试 絮 可 视 化 工具 

在 断 点 触发 后 ， 通 常 想 要 查看 变量 的 值 。 最 简单 的 方法 是 在 代码 编辑 器 中 ， 在 变量 名 的 上 方 蕉 停 光 标 。 这 
将 弹出 一 个 很 小 的 数据 提示 框 ， 其 中 显示 了 该 变量 的 值 。 也 可 以 展开 数据 提示 框 来 查看 更 多 细节 ， 如 图 18-43 
所 示 。 


"| 5 Simplespp vainFage "| 3 ongurtenc cklobjed sender, RouledEventAngs €] 


1 img Windows .UI .Xaml ,Navigation,; 
/i The Blank Page item template is documented at https:/ /eo. microsoft, com fwlink j 


namespace SimpleApp 
有 忒 二 IT 
An empty page that can be used on its own 区 
i SUNMMarm Ya 


public sealed partial class MainPage : Page 


Ee 
public MainPapel ) ; ekgrour Miredevs. Ul Maml hedia. Solkdc ohorBrusht 
lms=appx /hainPagpe xarml 
Mr .arm hedia. sol alarB rushl 


} b CrderThicen sess | 
ichehAsde ma 
到 


this,.InitializeComponentt( ); 


private void OnButtonClick(object sender, Ff_ 此 Characterspacing ， 
岂 a wh sender (Windewes. Ul Xaml Contrals Buttenl S 
Text2.Text = Textl.Text; 
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数据 提示 中 的 某 些 值 会 带 有 一 个 放大 镜 图 标 。 单 击 这 个 放大 镜 图 标 时 ， 根 据 数据 的 类 型 ， 会 显示 一 个 或 多 
个 使 用 调试 器 可 视 化 工具 (debugger visualizer) 的 选项 。 如 图 18-44 所 示 的 JSON Visualizer 可 显示 JSON 内 容 。 还 
有 其 他 许多 可 视 化 工具 ， 如 HTML、XML 和 Text 可 视 化 工具 。 


SQN Visualzer 


Expression: 


Value: 
a [JSON] 
a Inventoryltems 
[| 

4 [1] 
ISBN: "1234567890° 
Discount: 0 
ProductlD: 101 
ProductName: "How To Use Your New Product Thing" 
SupplierliD: 10 
CategorylD: 0 
QuantityPerUnit mull 
UnitPrice: 0 
UnitsInStock: 0 
UnitsQnOQrder: 0 
ReorderLevel: 0 
Discontinued: False 


图 18-44 


18.5.3 Live Visual Tree 

Visual Studio 2017 为 基于 XAML 的 应 用 程序 提供 了 一 个 新 特性 : Live Visual Tree。 调 试 UWP 和 WPF 应 用 
程序 时 ， 可 以 打开 Live Visual Tree ( 见 图 18-45): 选择 Debug | Windows | Live Visual Tree， 就 会 在 Live Property 
Explorer 中 打开 XAML 元 素 的 实时 树 (包括 其 属性 )。 使 用 此 窗口 ， 可 以 单 击 Selection 按钮 ， 在 UI 中 选择 一 个 
元 素 ， 在 树 中 查看 它 的 元 素 。 在 Live Property Explorer 中 ， 可 以 直接 改变 属性 ， 看 看 这 种 改变 在 运行 着 的 应 用 
程序 上 的 结果 。 


| a 口 simpleApp [windeow] 
ty [PopupRoot] 
az [FullWindowviediaRcct 
4 < [RootscrollViewer] 
a [ScrollContentPresenber) 
4 对 [Border 
a 四 [Frame 


了 [ContentPresenter] 


4 MainPagel 邯 
4 时 [Gridl 轩 
a 上 昌 [StackPanell 加 
b 国 Text1 [TextBgox] 国 


到 [Wy [Button| 国 
a Rootornd [Grid 
二 PP Caontenthresenter [Content (1 
国 [TextBlockl| 
国 Text2 [TextBlock] BD 


图 18-45 
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18.5.4 监视 和 修改 变量 


有 时 候 ， 需 要 连续 查看 变量 的 值 。 此 时 ， 可 以 使 用 Autos、Locals 和 Watch 窗口 检查 变量 的 内 容 。 这 3 个 
窗口 监视 不 同 的 变量 ; 

e Antos 一 一 监视 在 程序 执行 过 程 中 离 断 点 最 近 的 几 个 变量 。 

se Locals 一 一 监视 在 程序 执行 过 程 中 当前 断 点 所 在 方法 内 可 访问 的 变量 。 

e Watch 一 一 监视 在 程序 执行 过 程 中 显 式 指定 名 称 的 任何 变量 。 可 以 把 变量 拖 放 到 Watch 窗口 中 。 

只 有 当 使 用 调试 器 运行 程序 时 ， 这 些 窗口 才 是 可 见 的 。 如 果 看 不 到 它们 ， 则 选择 Debug | Windows， 然 后 根 
据 需 要 选择 菜单 项 。 考 虑 到 可 能 要 监视 的 内 容 过 多 ， 需 要 进行 分 组 ，Watch 窗口 提供 了 4 个 不 同 的 窗口 。 在 这 
些 窗 口中 都 可 以 得 看 和 修改 变量 的 值 ， 所 以 不 必 离 开 调 试 器 就 可 以 尝试 改变 程序 的 不 同 路 径 。 图 18-46 显示 了 
Locals 窗口 。 


Locals 四 
Name Walue Type i 
bw this [SimpleApp.MainPagel} SimpleApp.MainPage 
b WW sender Windows.Ul.Xaml.Controls.Buttonl abject {Windows.Ul.Xal 
a IWindows.Ul.Xaml.RoutedEventArgs) Windows, Ul.Xaml.Rout 

4 tindows.Ul.Xaml.Controls.Button) object Windows.Ul.Xa 
FF hccesskey ee A = string 
Access KeyScopeOwner null Windows.Ul.Xaml.Depe 
PF ActualHeight 32 double 
FF hctualTheme Light Windows, Ul.Xaml.Elem: 
PP ActualWidth 81 double 
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另外 ， 还 有 一 个 Immediate 窗口 ， 虽 然 它 与 刚才 讨论 的 其 他 几 个 窗口 没有 直接 关系 ， 但 仍然 是 一 个 可 以 监 
视 和 修改 变量 的 重要 窗口。 在 该 窗口 中 可 以 查看 变量 的 值 。 还 可 以 在 此 窗口 中 输入 并 运行 代码 ， 这 样 在 调试 过 
程 中 进行 测试 时 就 能 够 关注 细节 ， 试 用 方法 ， 以 及 动态 修改 调试 运行 。 


18.5.5 异常 


在 准备 交付 应 用 程序 时 ， 异 常 是 很 好 的 帮手 ， 它 们 确保 错误 条 件 得 到 了 恰当 的 处 理 。 如 果 正 确 使 用 ， 寞 第 
就 能 够 确保 用 户 不 会 看 到 技术 性 或 者 恼人 的 对 话 框 。 但 是 ， 在 调试 应 用 程序 时 ， 异 帝 就 没有 那么 令 人 愉快 了 。 
它们 的 问题 在 于 两 个 方面 : 

e 如 果 在 调试 过 程 中 发 生 异 常 ， 通 常 不 希望 自动 处 理 它们 ， 特 别 是 有 时 自动 处 理 异常 意味 着 应 用 程序 将 

终止 。 调 试 器 应 能 帮助 确定 为 什么 会 发 生 异 常 。 当 然 ， 如 果 编 写 了 优良 、 健 壮 的 防御 性 代码 ， 程 序 将 
能 够 目 动 处 理 几乎 任何 事情 ， 包 括 想 要 检测 的 bug! 

e 如 果 发 生 了 某 个 异 闸 ，.NET 运行 库 就 会 尝试 搜索 该 异常 的 处 理 程序 , 即使 没有 为 该 异 前 编写 处 理 程 序 。 
没有 找到 寞 剃 时 ， 它 会 终止 程序 。 这 时 没有 了 调用 栈 ， 意 味 着 所 有 的 变量 将 超出 作用 域 ， 所 以 将 无 法 
查看 任何 变量 的 值 。 

当然 ， 可 以 在 catch 块 中 设置 断 点 ， 但 是 这 稍 和 没有 多 大 帮助 ， 因 为 按照 定义 ， 当 遇 到 catch 块 时 ， 执 行 流 
己 经 退出 了 对 应 的 try 块 。 这 意味 着 想 要 通过 检查 变量 值 来 确定 问题 所 在 时 ， 那 些 变量 已 经 超出 了 作用 域 。 甚 
至 不 能 通过 查看 栈 跟踪 来 找 出 在 遇 到 throw 语句 时 执行 的 方法 ， 因 为 控制 流 已 经 离开 了 该 方法 。 在 throw 语句 


处 设置 断 点 显然 可 以 解决 这 个 问题 ,但 是 对 于 防御 性 编码 ， 代 码 中 将 存在 许多 throw 语句 。 如 何 判断 哪 条 throw 
语句 抛 出 了 该 异常 ? 


Visual Studio 为 这 种 问题 提供 了 一 个 很 好 的 解决 方法 。 可 以 配置 调试 器 中 断 处 的 异 向 类 型 。 这 在 菜单 Debug 
| Windows | Exception Settings 中 配置 。 如 图 18-47 所 示 ， 在 该 窗口 中 可 以 指定 抛 出 异常 后 执行 什么 操作 。 例 如 ， 
可 以 选择 继续 执行 ， 或 者 停止 执行 并 启动 调试 一 一 些 时 程序 将 停止 执行 ， 调 试 器 将 在 throw 语句 位 置 启 动 。 
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oll 


Break When Thrown 
b 男 E++ Exceptions 
a Common Language Runtime Exceptions 
LD] <All Commeon Language Runtime Exceptions not in thls lists 
口 MicrosoftJScriptJSscriptException 
DD System AccessViolationException 
口 Sytem.AggregateException 
DD) SystemAppDomainUnloadedException 
LL] System.ApplicationException 
LD] system.ArgumentException 
LDL] system.ArgumentNullException 
LD] system .ArgumentOutOlRangeException 
LD) system.ArithmeticException 
[| System ArrayTypelMismatehException 
LL] System.BadlmadgeFormatException 
口 system,CannetUnloadAppDomainException 
LD system.Collections.Generic KeyNotFoundException 
LI system .ComponentylodelL Composition.ChangeRejectedExcepti 
| System.Componenthvledel Composition.CompositionContracthi 
口 en nentModel. np sition,.CompositionException 
[ ian, [ [Ee 


这 个 对 话 框 的 强大 之 处 在 于 允许 根据 所 抛 出 异常 的 类 型 选择 相应 的 操作 。 例 如 ， 可 以 配置 为 在 遇 到 .NET 
基 类 抛 出 的 任何 异常 时 进入 调试 器 ， 但 是 对 于 其 他 异常 类 型 则 不 进入 调试 器 。 

Visual Studio 知道 .NET 基 类 中 的 所 有 异常 类 ， 以 及 许多 可 在 .NET 环境 外 抛 出 的 寞 弟 。Visual Studio 不 会 目 
动 知道 用 尸 编写 的 任何 上 自 定 义 寞 常 类 ， 但 是 可 以 把 目 定 义 异 第 类 手动 添加 到 Visual Studio 的 异 意 列表 中 ， 并 指 
定 哪些 目 定 义 异常 类 应 该 导致 执行 立即 停止 。 为 此 ， 只 需要 单 击 Add 按钮 (在 列表 中 选择 一 个 顶层 节点 时 ， 将 
局 用 该 按钮 )， 并 输入 目 定 义 异 剃 类 的 名 称 即 可 。 


18.5.6 多 线程 


Visual Studio 为 调试 多 线程 程序 提供 了 出 色 的 文 持 。 在 调试 多 线程 程序 时 ， 必 须 理解 在 调试 器 中 运行 与 不 
在 调试 器 中 运行 时 ， 程 序 的 行为 会 发 生变 化 。 遇 到 断 点 时 ，Visual Studio 会 停止 程序 的 所 有 线程 ， 所 以 此 时 有 
机 会 查看 所 有 线程 的 当前 状态 。 为 了 在 不 同 的 线程 间 切 换 ， 可 以 局 用 Debug Location 工具 栏 。 这 个 工具 栏 有 一 
个 针对 所 有 进程 的 组 合 框 ， 还 有 男 外 一 个 组 合 框 ， 用 于 当前 运行 的 应 用 程序 的 所 有 线程 。 当 选择 一 个 不 同 的 线 
程 时 ， 可 以 看 到 该 线程 在 哪 一 行 代码 暂停 ， 以 及 当前 可 在 其 他 线程 中 访问 的 变量 。Tasks 窗口 (如 图 18-48 所 示 ) 
显示 了 所 有 正在 运行 的 任务 ， 包 括 这 些 任务 的 状态 、 位 置 、 任 务 名 、 任 务 使 用 的 当前 线程 、 所 在 的 应 用 程序 域 
以 及 进程 标识 符 。 该 窗口 还 显示 了 不 同 的 线程 在 什么 时 候 彼 此 阻 寒 ， 导 致死 锁 。 


status start Tim... Duration..， Location Task 

Deadlock 0.000 173.877 ThreadinglssuesProc Threadinglssues.Pi 
@ Deadlock 0.000 173.877 Threadinglssues.Proc Threadinglssues.Pi 
Oh scheduled 0.000 173.877 [Scheduled and waiti Task.Delay 
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图 18-49 显示 了 Parallel Stacks 窗口 ， 该 窗口 以 分 层 视图 的 形式 显示 了 不 同 的 线程 或 任务 (取决 于 所 选项 )。 
单 击 任务 或 线程 可 跳 转 到 对 应 的 源 代码 。 


1 Thread 1 Thread 
et sampleTask.Deadlockl J sampleTask.Deadlock2 


Program.Deadleck.AnonmymousMethed_0 Program.Deadlock.AnonymousMethod_1 | 


2Threads 
[External Code] 


图 18-49 


18.6 重 构 工具 
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许多 开发 人 员 在 开发 应 用 程序 时 首先 完成 功能 ， 然 后 修改 应 用 程序 ， 使 它们 更 易于 管理 和 阅读 。 这 个 过 程 
称 为 重 构 。 重 构 过 程 包括 修改 代码 来 实现 更 好 的 性 能 和 可 读 性 ， 提 供 类 型 安全 ， 以 及 确保 应 用 程序 符合 标准 的 


面向 对 和 象 编程 实践 。 更 新 应 用 程序 时 ， 也 需要 重 构 。 


Visual Studio 2017 的 C# 环 境 包含 一 组 重 构 工 具 , 位 于 Visual Studio 菜单 的 Refactoring 选项 中 。 为 了 演示 这 


些 工 具 ， 在 Visual Studio 中 创建 一 个 新 类 Car: 


Public class Car 

{ 
Public string color; 
Public string doors; 


public int Gof) 
{ 
int speedMph = 100; 
return speedMph; 
} 
} 


现在 ， 假 设 为 了 进行 重 构 ， 需 要 对 代码 稍 作 修 改 ， 将 变量 color 和 door 封装 到 公有 的 .NET 属性 中 。Visual 
Studio 2017 的 重 构 功能 允许 在 文档 窗口 中 简单 地 右 击 这 两 个 属性 ， 然 后 选择 Quick Actions， 就 会 看 到 不 同 的 
重 构 选项 , 例如 生成 构造 函数 ,来 填充 字段 , 或 者 输出 方法 Equals 和 GetHashCode， 或 者 封装 字段 ， 如 图 18-50 


所 示 。 


ConsoleAppl "| ConsoleAppl1.Car 


es 
2 using System.Collections.Generic; 
using System,Text; 


anamespace ConsoleAppl 


3 
4 
5 
6 


7 | public class Car 
8 { 

dd 号 -> private string _color; 
1E Generate constructor'Carfstring, string)' 加 和 

1 Generate Equalstobject) 


413 Generate Equals and GetHashCode 


_t0lor = COlOr: 
_doors = doors; 


13 Encapsulate fields (and use property) 
14 Encapsulate fialds (but still Use fisld) } 
PER sm public int Gor) 


} 


Preview changes 
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public Car(strineg color, string doors) 


在 该 对 话 框 中 可 以 提供 属性 的 名 称 ， 然 后 单 击 Preview 链接 ,或 者 直接 接受 更 改 。 选 择 封装 字段 的 按钮 时 ， 


代码 将 修改 为 如 下 所 示 : 
Public class Car 
{ 
private string color; 
private string doors; 


二 > _ Color 
=> doors 


Public string Color { get 
Public string Doors { get 


=> color;: set 
一 > doors; set 


Public int Go() 
{ 


value; 1} 
value; 1} 
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int speedMph = 100; 
return speedMph; 
} 
} 


可 以 看 到 , 使 用 这 些 向 导 重 构 代 码 很 简单 , 不 仅 是 一 页 的 代码 , 重 构 整个 应 用 程序 的 代码 都 一 样 简单 。Visual 
Studio 的 重 构 工具 还 提供 了 以 下 功能 : 

e 重 命 名 方法 、 局 部 变量 、 字 段 等 

e 从 选 定 代 码 中 提取 方法 

e 基于 一 组 已 有 的 类 型 成 员 提 取 接 口 

se 将 局 部 变量 提升 为 参数 

e 重 命 名 参数 或 修改 参数 的 顺序 

Visual Studio 2017 的 重 构 工 具 是 得 到 更 整洁 、 可 读 性 更 好 、 结 构 更 合理 的 代码 的 一 种 优秀 方法 。 


18.7 ”诊断 工具 


Visual Studio 2017 提供 了 许多 有 用 的 工具 来 帮助 分 析 应 用 程序 ， 提 前 解决 应 用 程序 中 可 能 发 生 的 问题 。 本 
节 将 讨论 其 中 的 一 些 分 析 工 具 。 

与 体系 结构 工具 类 似 ， 分 析 工 具 也 在 Visual Studio 2017 企业 版 中 可 用 。 

为 了 分 析 应 用 程序 的 完整 运行 ， 可 以 使 用 诊断 工具 。 诊断 工具 用 于 确定 调用 了 什么 方法 、 方法 的 调用 频率 、 
方法 调用 所 需 的 时 间 、 使 用 的 内 存量 等 。 在 Visual Studio 2017 中 ， 启 动 调试 器 时 ， 会 自动 启动 诊断 工具 。 使 用 
诊断 工具 ， 还 可 以 看 到 IntelliTrace( 历 史 调 试 ) 事 件 。 遇 到 一 个 断 点 后 ， 能 够 查看 以 前 的 信息 (如 图 18-51 所 示 )， 
例如 以 前 的 断 点 、 抛 出 的 异常 、 数 据 库 访 问 、ASPNET 事件 、 跟 踪 或 者 用 户 操作 (如 单 击 按钮 )。 单 击 以 前 的 事 
件 时 ， 可 以 查看 局 部 变量 、 调 用 栈 以 及 函数 调用 。 使 用 这 种 功能 时 ， 不 需要 重启 调试 器 并 为 发 现 问题 前 调用 的 
方法 设置 断 点 ， 就 可 以 轻松 地 找到 问题 所 在 。 
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图 18-51 


注意 : 
IntelliTrace 也 在 Visual Studio 2017 企业 版 中 可 用 。 
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启动 诊断 工具 的 另 一 种 方法 是 通过 配置 文件 来 启动 : Debug | Performance Profiler 或 Analyze | Performance 
Profiler。 这 里 可 以 对 要 局 动 的 功能 进行 更 多 的 控制 ( 见 图 18-52)。 根 据 使 用 的 项 目 类 型 ， 可 以 使 用 或 多 或 少 的 特 
性 。 对 于 UWP 项 目 , 可 以 看 到 应 用 程序 的 时 间 线 、 内 存 使 用 情况 、CPU 使 用 情况 和 内 存 。 其 他 工具 包括 HTML 
UI 啊 应 、JavaScript 内 存 、UI 分 析 和 性 能 同 导 。 


品目 UICaleulatar 
Re port20180105 -1327.diagsession 上 有 | 
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startup Project 
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口 Memory Usage 春 口 Netweork 
Investigate application memary to firsd issues such as memory Examine information about each network operation in your 
leaks applicaton, ircluding HTTP request ard response headers, 
payvloads, cookies, timing data arvd more 
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第 一 个 选项 Application Timeline ( 见 图 18-53) 提 供 了 UI 线程 的 信息 ， 以 及 解析 、 布 局 、 泻 染 、IUO 和 应 用 代 
码 所 花 的 时 间 。 根 据 所 花 的 最 多 时 间 ， 可 以 确定 优化 在 哪里 是 有 用 的 。 


Diagnostics sessione 31.511 secomds (13.561 s selectedy 大 上 pp lifecyde ma Liser mark 
ER 了 i0s 12. 双 


a UI thread utihizatien 0 | Parsing ayout ander Nl pp Code 可 IT EF 
Ul thread utilization (%) 园 Farsing 图 L 国 Rend vo 国 App Cod Xaml 口 th 
100 100 


| 
a || | 可 ml Sa si 于。 sl 下 al | 。.ia Eh 


a Visual throughput (FPS) pcomposition Thread 性 UI Thread 


的 了 TI 一 一 = 一 -站 60 
| lu . Mi 1 


引 0 } 站 i i | n ir! I 四 本 | 人 | 十 | 五 上 折 


| Ti | 1 | | | [| I 
* 办 


18-53 


如 果 选 择 CPU Usage 选项 (如 图 18-54 所 示 )， 监 控 的 开销 就 很 小 。 使 用 此 选项 时 ， 每 经 过 固定 的 时 间 间 隔 
就 对 性 能 信息 采样 。 如 果 方 法 调用 运行 的 时 间 很 短 ， 就 可 能 看 不 到 这 些 方 法 调用 。 但 是 再 提 一 次 ， 这 个 选项 的 
优势 在 于 开销 很 低 。 进 行 探查 时 总 是 应 该 记 住 ， 并 不 只 是 在 监视 应 用 程序 的 性 能 ， 也 是 在 监视 数据 获取 操作 的 
性 能 。 所 以 不 应 该 同时 探查 全 部 数据 ， 因 为 采样 全 部 数据 会 影响 得 到 的 结果 。 收 集 关 于 .NET 内 存 分 配 的 信息 有 
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助 于 找 出 发 生 内 存 泄 漏 的 地 方 ， 以 及 哪 种 类 型 的 对 象 需要 多 少 内 存 。 资 源 争 用 数据 对 分 析 线 程 有 帮助 ， 能 够 很 
容易 地 看 出 不 同 的 线程 是 否 会 彼此 阻塞 。 
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图 18-54 


完成 了 分 析 运 行 后 ， 图 18-55 显示 了 一 个 探查 会 话 的 摘要 屏幕 。 从 中 可 以 看 到 应 用 程序 的 CPU 使 用 率 ， 说 
明 哪 些 函 数 占 用 最 长 时 间 的 热 路 径 (hot path)， 以 及 使 用 最 多 CPU 时 间 的 函数 的 排序 列表 。 
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诊断 工具 还 有 许多 屏幕 ， 这 里 无 法 一 一 展示 。 其 中 有 一 个 函数 视图 ， 人 允许 根据 函数 调用 次 数 进行 排序 ， 或 
者 根据 函数 占用 的 时 间 ( 包 括 或 者 不 包含 函数 调用 本 身 ) 进 行 排 序 。 这 些 信息 有 助 于 确定 哪些 方法 的 性 能 值得 关 
注 ， 而 其 他 方法 则 可 能 因为 调用 得 不 是 很 频繁 或 者 不 会 占用 过 多 时 间 ， 所 以 不 必 考 虑 。 

在 函数 内 单 击 ， 就 会 显示 该 函数 的 详细 信息 ， 如 图 18-56 所 示 。 这 样 就 可 以 看 到 调用 了 哪些 函数 ， 并 立即 
开始 单 步调 试 源 代码 。Caller/Callee 视图 也 会 显示 函数 的 调用 关系 。 
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18.8 ”通过 Docker 创建 和 使 用 容器 


Visual Studio 的 一 个 杰出 的 新 特性 是 它 的 Docker 集成 。 因 为 Docker 在 .NET 领域 中 相对 较 新 ， 值 得 介绍 。 

Docker 有 什么 好 处 ? Docker 提供 了 虚拟 化 ; 它 是 一 个 容器 技术 ,能够 打包 并 部 署 应 用 程序 和 服务 ， 且 与 所 
有 依赖 项 相隔 离 。 与 虚拟 机 相 比 ， 它 是 轻 量 级 的 ， 因 为 映像 可 以 小 得 多 ， 因 为 一 个 映像 是 基于 男 一 个 映像 的 。 
一 个 Docker 容器 也 不 需要 保留 一 个 CPU 内 核 和 内 存 , 因为 它们 可 以 共享 .可 以 通过 开发 创建 用 于 生产 的 Docker 
映像 。 它 不 再 是 ,“ 它 在 我 的 机 器 上 运行 。” 

以 下 是 了 解 Docker 的 关键 术语 ; 

e 映像 一 一 部 牙 单元。 映像 是 一 个 包 ， 其 中 包括 运行 应 用 程序 所 需 的 所 有 依赖 项 (框架 ) 和 和 配置。 映像 可 以 
从 其 他 映像 中 得 到 。 在 映像 创建 之 后 ， 就 是 不 可 变 的 。 

e 注册 表 一 一 存储 Docker 映像 的 存储 区 。 在 Docker 的 官方 注册 中 心 https://hub.docker.com 可 以 找到 成 干 
上 万 的 映像 。 在 https://hub.docker.comyr/microsoft/dotmnet /上 可 以 为 Linux 和 Windows 服务 器 拉 出 官方 的 
Microsoft .NET Core 映像 。 

se 容 希 一 一 一 个 运行 的 映像 。 容 器 是 一 个 应 用 程序 或 服务 的 运行 库 环 境 。 可 以 通过 从 同一 个 映像 中 创建 多 
个 容器 实例 来 扩展 它 。 容 器 在 主机 中 运行 。 可 以 在 https://store.docker.com/editions/community/docker- 
ce-desktop-windows 上 下 载 Docker Community Edition for Windows， 以 便 在 Windows 10 上 驻 留 Docker。 
Microsoft Azure 提供 了 一 些 在 云 中 运行 Docker 映像 的 产品 。 
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e Dockerfile 一 一 一 个 文本 文件 ， 其 中 包含 构建 Docker 映像 的 指令 。 可 以 使 用 Docker 命令 行 来 处 理 
dockerfile。 
要 了 解 Docker， 最 好 尝试 一 下 。 


18.8.1 ”Docker 简介 


在 安装 Docker Community Edition 之 后 ， 就 可 以 使 用 Docker 命令 来 提取 和 运行 Docker 容器 。 开 始 的 第 一 
个 命令 是 Docker 版 本 的 “Hello World!”。 在 命令 行 中 ， 只 需要 调用 docker run hello-world。 第 一 次 启动 此 操作 
时 ， 可 以 看 到 如 下 输出 所 示 的 结果 。 因 为 Docker 映像 hello-world 尚未 在 本 地 安装 ， 所 以 Docker 映像 从 Docker 
注册 表 中 提取 并 局 动 。 下 载 成 功 后 ， 会 显示 Hello from Docker!: 

> docker TU hello-world 

Unable to find image "hello-world:latest" locally 

latest: Pulling from library/hello-world 

Cad4felbl923c: Pull complete 


Digest: sha256:ca0eebéfb0535ldfc8759c20733c91def84cb8007aa89a5bf606bc8b315b9fc7 
Status: Downloaded newer image for hello-world:latest 


Hello from Docker! 


第 二 次 调用 该 命令 时 ， 因 为 Docker 映像 已 经 在 本 地 下 载 ， 所 以 会 立即 得 到 结果 : 


> docker run hello-world 
Hello from Docker! 


18.8.2 在 Docker 容器 中 运行 ASP .NET Core 


接 下 来 ， 从 Microsoft 获取 Docker 容器 ， 创 建 并 运行 ASPNET Core 应 用 程序 。 

要 获取 并 运行 容器 ， 可 以 使 用 以 下 选项 启动 命令 docker run: 

> docker run -p 8000:80 -e "ASPNETCORE URLS=http://+:80" -it -rm microsoft/dotnet 

选项 -p 将 端口 80 从 容器 映射 到 容器 外 的 8000 端口 。 在 本 地 系统 上 ， 端 口 80 可 能 已 经 被 Web 服务 器 占用 
了 。 选 项 -e 在 容器 内 设置 环境 变量 。 通 过 设置 环境 变量 ASPNETCORE URLS， 可 以 指定 端口 号 ， 它 是 托管 
ASPNET Core 的 Kestrel 服务 器 监听 的 端口 。 选 项 -it 启动 容器 与 终端 交互 ; 因此 ， 当 命令 完成 时 ， 在 容器 的 命 
令 提示 符 中 键入 。 选 项 --rm 删除 在 再 次 下 载 容器 之 前 已 经 存在 的 容器 。 命 令 的 最 后 一 部 分 指定 从 中 心 提取 的 映 
像 并 局 动 。microsoft/dotnet 映像 包含 了 带 有 命令 行 工 具 的 .NET Core SDK。 


注意 : 

microsoft/dotnet 使 用 已 发 布 的 SDK 获取 最 新 的 microsoftdotmet Docker 映像 。 通 过 在 名 称 中 添加 标记 ， 可 
以 获取 特定 的 版 本 ， 并 使 用 可 以 用 于 生产 的 运行 库 获 取 一 个 版 本 。Imicrosoft/dotnet:-<version>-sdk 检索 .NET Core 
SDK，microsoft/domet:<version>- runtime 检索 运行 库 的 映像 ， 以 及 microsoft/dotnet:< version>-runtime-deps 检索 一 
个 较 小 的 映像 ， 其 中 不 包含 运行 库 ， 但 包含 了 托管 自 包 含 应 用 程序 所 需 的 本 地 二 进 制 文件 。 自 包含 应 用 程序 在 
第 1 章 中 解释 了 。 有 关 映 像 的 详细 信息 可 以 在 https://hub.docker.comyr/microsoft/domet/ 上 找到 。 


启动 命令 时 ， 映 像 从 Docker 集中 提取 并 启动 ， 然 后 就 可 以 进入 Docker 容器 。 下 面 创建 一 个 ASPNET Core 
MVC 应 用 程序 ， 并 用 以 下 命令 启动 它 : 


# mkdir websample 
# cd websample 

# dotnet new mvc 
# dotnet restore 
# dotnet build 

# dotnet run 


现在 可 以 从 容器 外 部 的 浏览 器 中 访问 http://localhost:8000， 并 访问 容器 中 的 ASPNET Core 网 站 。 从 Docker 
容器 的 外 部 可 以 使 用 如 下 命令 : 


> docker images 
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得 看 所 有 已 下 载 的 映像 ， 使 用 如 下 命令 : 
> docker container list 
查看 正在 运行 的 活动 容器 。 这 是 一 个 简化 符号 : 


> docker ps 


18.8.3 创建 Dockerfile 


对 于 目前 为 止 所 使 用 的 命令 , 我 们 已 经 了 解 了 如 何 提取 和 运行 Docker 容器 。 接 下 来 创建 一 个 运行 ASPNET 
Core 应 用 程序 的 目 定 义 Docker 镜像 。 这 次 ， 要 创建 一 个 发 布 版 本 ， 并 构建 一 个 发 布 包 。 

首先 ， 使 用 ASPNET Core CLI 创建 ASPNET Core MVC Web 应 用 程序 。 给 dotnet build 命令 传递 -cRelease， 
会 生成 发 布 代码 。 发 布 domet publish 命令 的 选项 -o ./Publish 将 在 Publish 子 目 录 中 写 入 用 于 发 布 的 输出 。 

> mkdir DockerSample 

> cd DockerSample 

> dotnet new myvce 

> dotnet restore 


> dotnaet build -cc Release 
> dotnet publish -cc Release -0o ./Publish 


接 下 来 ， 在 命令 提示 符 的 当前 目录 中 ， 创 建 一 个 与 Web 应 用 程序 相同 的 dockerfile( 代 码 文件 
DockerSample/dockerfile): 


FROM microsoft/aspnetcore 

WORKDIR /app 

COPY ./publish . 

RUN dir . 

ENTRYPOINT [ "dotnet", "/app/DockerSample.dll™ ] 
RUN echo ‘completed building image'" 


警告 : 
在 Linux 上 运行 Docker 时 ， 注 意 文件 名 区 分 大 小 写 。 在 Linux 中 ,文件 dockersample.dll 不 同 于 
DockerSample.dll, 


下 面 讨论 每 个 命令 。dockerfile 从 一 个 FROM 开始 。 新 构建 的 映像 基于 microsoft/aspnetcore 映像 。 此 映像 只 
包含 运行 库 。 对 于 构建 映像 , 可 以 使 用 microsoft/aspnetcore-build。microsoft/aspnetcore 本 身 基于 microsoft/dotnet。 
microsoft/aspnetcore 映像 包含 一 组 用 于 ASPNET Core 库 的 本 机 映像 , 因此 第 一 次 运行 库 没 有 花费 时 间 来 编译 这 
些 库 。 

FROM microsoft/aspnetcore 

下 一 个 命令 在 要 创建 的 映像 中 把 工作 目录 设置 为 /app 文件 夹 : 

WOREDIR /app 

COPY 命令 把 本 地 ./Publish 目录 的 内 容 复制 到 映像 中 的 当前 目录 一 一 之 前 定义 的 工作 目录 : 

COPY ./publish . 

下 一 个 命令 只 显示 当前 目录 中 的 文件 ， 以 查看 复制 是 否 成 功 ; 

RUN dir . 

ENTRYPOINT 定义 的 命令 应 该 在 通过 参数 运行 容器 时 启动 。 在 运行 期 间 , ASPNET Core 应 用 程序 用 dotnet 
和 了 DLL 的 名 称 启动 : 

ENTRYPOINT [ "dotnet", "/app/dockersample.dll"™ ] 

使 用 dockerfile， 可 以 通过 命令 docker build 构建 一 个 docker 映像 。 选 项-t 给 映像 起 一 个 名 字 。 最 后 的 .命令 
定义 了 应 该 搜索 dockerfile 的 目录 。 


> docker build -七 mysampleapp . 
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注意 : 
在 docker build 命令 的 选项 -t 中 ， 可 以 标记 上 映像， 例如， 使 用 带 有 版 本 号 的 docker build -t mysampleapp:1.4。 


在 成 功 构建 之 后 ， 可 以 运行 Docker 映像 ， 并 将 80 端口 从 容器 内 映射 到 容器 外 的 8002 端口 : 

> docker run -p 8002:80 mysampleapp 

使 用 生产 代码 和 预 编译 的 ASPNET Core 映像 时 ， 如 果 通 过 浏览 器 访问 ASPNET Core Web 应 用 程序 ， 会 体 
验 到 快速 响应 。 


18.8.4 使 用 Visual Studio 


现在 进入 Visual Studio 2017 。Docker 的 体验 是 如 何 集 成 的 ? 使 用 项 目 模 板 Web Application 
(Model-View-Controller) 创 建 一 个 Web 应 用 程序 。 这 个 项 目 称 为 WebAppWithVS。 这 个 名 称 将 在 生成 的 dockerfile 
中 。 使 用 第 一 个 对 话 框 ， 可 以 选择 一 个 复 选 框 并 在 Linux 或 Windows 容器 之 间 选 择 ， 从 而 启用 Docker 支持 ( 见 
图 18-57)。 取 消 选 中 这 个 选项 。 以 后 很 容易 添加 Docker 支持 。 


.NET Core “| ASP.NET Core 2.0 “| Learm more 


A project template for creating an ASP.NET Core 

~、 | 四 号] A application with example ASP.NET Core MYC Views and 
Controllers. This template can also be used for RESTfuI 

Empty Web API Web Web Angular HTTP semvices., 


Gol Appl 
pplication pplication Learn more 


tbocdel-Vievww 
Controller) 


de ， 二 
Reactjs Reactjs and 


Redux 
Change Authentication | 


huthentication Ne Authentication 


|_ | Enable Docker Support 


DOs: | Linux 
Requires Docker for Winaews 
Docker support can also be enabled later Laan more 


图 18-57 


使 用 项 目 模板 时 ,将 创建 与 使 用 命令 行 时 相同 的 文件 ,为 了 给 现 有 的 项 目 添加 Docker 支持 ,可 以 选择 Project 
| Docker Support。 在 图 18-58 所 示 的 对 话 框 中 ， 选 择 目 标 OS。 下 面 在 Linux 上 驻 留 它 。 


Targeat Os: 
OO) Windows 


(®) Limux 


图 18-58 


现在 得 到 了 项 目的 dockerfile。 这 个 dockerfile 包含 多 个 FROM， 用 于 多 阶段 docker 构建 。 这 里 ， 根 据 调 试 
或 发 布 构建 ， 创 建 多 个 映像 。 下 面 通 过 多 个 步骤 来 完成 这 个 文件 。 第 一 个 FROM 基于 映像 microsoft/aspnet- 
core:2.0， 它 定义 为 AS base， 以 后 使 用 名 称 base 引用 它 。 在 第 一 个 映像 定义 中 ， 工 作 目 录 设 置 为 /app， 指 定 了 
端口 80( 代 码 文件 WebAppWithVS/Dockerfile): 

FROM microsoft/aspnetcore:2.0 AS base 


WORKDIR /app 
EXPOSE 80 
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第 二 个 FROM 完全 独立 于 第 一 个 FROM。 这 个 FROM 定义 了 映像 基础 aspnetcore-build:2.0。 带 有 build 标 
记 的 映像 是 ASPNET Core 图 像 ， 包 括 SDK。 工 作 目 录 现 在 是 /src。 接 下 来 ， 使 用 两 个 COPY 命令 将 解决 方案 和 
项 目 文件 复制 到 rc 目录 中 。 运 行 dotmet restore 恢复 所 有 的 NuGet 包 ， 下 一 个 COPY 命令 把 完整 的 文件 夹 及 其 
子 目录 复制 到 src 目录 中 。 在 运行 dometbuild 之 前 ， 新 的 工作 目录 设置 为 Web 应 用 程序 的 文件 夹 。 

FROM microsott/aspnetcore-builq:2.0 AS build 

WORKDIR /src 

COPY *.sln -/ 

COPY WebappWithVs/WebappWithVs .cspro] WebAppWithvs/ 

RUN dotnet restore 

COPY . - 


WOREDIR /src/WebAppPWithVs 
RUN dotnet build -cc Release -o /app 


下 一 个 映像 定义 使 用 先前 配置 的 构建 映像 ， FROM build As publish。 新 名 称 是 publish， 其 中 ， 调 用 .NET 命 
令 dotnet publish， 以 创建 /app 子 目录 中 的 发布 文件 : 


FROM build AS publish 
RUN dotnet publish -C Release -DO /app 


最 后 一 个 FROM 定义 了 一 个 名 为 final 的 映像 , 它 基 于 已 定义 的 第 一 个 映像 :base 映像. 工作 目录 现在 是 /app。 
COPY 命令 将 /app 目录 从 先前 定义 的 publish 映像 (发 布 版 本 放 在 /app 目录 中 ) 复 制 到 工作 目录 。 最 后 ， 容 器 的 入 
口 点 设置 为 dotnet 命令 : 

FROM base AS final 

WORKDIR /app 


COPY -from=publish /app . 
ENTRYPOINT ["dotnet", "WebAppWithVs.d11"] 


有 了 Dockerfile 之 后 ， 只 需要 调用 前 面 所 示 的 Docker 命令 来 创建 所 需 的 上 映像。 但是， 除了 使 用 Docker 命 
令 之 外 ， 还 可 以 使 用 Docker Compose, 这 是 一 个 运行 多 个 Docker 应 用 程序 的 工具 。 对 于 这 个 工具 ， 需 要 一 个 
YAML 文件 来 定义 组 成 应 用 程序 的 服务 。 从 服务 中 ， 可 以 引用 dockerfiles 构建 映像 。 

通过 Visual Studio 将 Docker 支持 添加 到 项 目 中 时 ， 可 以 在 解决 方案 中 找到 男 一 个 项 目 : docker -compose。 
docker-compose 项 目 包 含 的 文件 使 用 了 YAML 语法 和 yml 文件 扩展 名 。 


注意 : 
YAML (YAML Ain't 标记 语言 ) 是 一 种 语法 ， 它 不 像 XML 那样 复杂 。YAML 在 语法 中 使 用 了 空白 。 


文件 docker-compose.yml 是 自动 创建 的 。 在 Docker Compose 的 版 本 号 之 后 ，services: 将 列 出 已 构建 的 服务 。 
服务 名 称 webappwithvs 需要 匹配 在 CSPROJ 配置 文件 中 定义 的 <DockerServiceName> 元 素 中 的 值 。CSPROJ 文 
件 还 列 出 了 用 来 触发 这 个 项 目的 Microsoft.Docker.Sdk。 所 创建 的 映像 名 称 由 image 指定 。 可 以 更 改 这 个 映像 名 
称 。 映 像 名 称 使 用 dev( 用 于 调试 构建 ) 和 latest( 用 于 发 布 构建 ) 标 记 ( 配 置 文件 WebAppWithVS/docker- 
compose/docker-compose.yml): 
VeErslion: '3" 
ES 
image: webappwithvs 
bulild: 
Context: . 
dockerfile: WebApWithVS/Dockerfile 
通过 调试 和 发 布 构建 来 构建 和 运行 项 目 ， 现 在 可 以 使 用 webappwithvs:dev 和 webappwithvs:latest 创建 和 运 
行 映像 。 虽 然 这 已 经 是 Visual Studio 目 动 构建 映像 的 一 个 很 好 的 特性 ， 但 是 最 好 的 特性 是 设置 断 点 、 启 动 调试 
器 ， 从 Windows 机 器 上 运行 的 Visual Studio 调试 以 及 运行 在 Linux 上 的 Docker 映像 一 一 都 在 同一 个 系统 上 ! 
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18.9 ”小结 


本 章 探讨 了 .NET 环境 中 最 重要 的 编程 工具 之 一 : Visual Studio 2017。 大 部 分 内 容 都 在 讲解 这 个 工具 如 何 简 
化 C# 编 程 。 

本 章 讨 论 了 各 种 项 目 模 板 、Solution Explorer 和 编辑 器 的 各 种 特性 。 还 调试 了 代码 ， 重 构 了 操作 ， 学 习 了 
Docker 的 新 集成 。 

本 书 的 第 一 部 分 以 这 一 章 结 束 。 下 一 章 将 开始 深入 到 .NET 标准 库 ， 介 绍 库 、 程 序 集 和 NuGet 包 。 


第 中 部 分 
.NET Core 与 Windows 
Runtime 


> 第 19 草 库 、 程 序 集 、 包 和 NuGet 
> 第 20 章 依赖 注入 

> 第 21 章 任务 和 并 行 编程 

> 第 22 章 文件 和 流 

> 第 23 章 网 络 

> 第 24 章 安全 性 

> 第 25 章 ADO.NET 和 事务 

> 第 26 章 Entity Framework Core 
> 第 27 章 本 地 化 

> 第 28 章 测试 


> 第 29 草 跟踪 、 日 志和 分 析 


站 二 


库 、 程 序 集 、 包 和 NuGet 


本 草 要 扣 

e 库 、 程 序 集 和 包 之 间 的 差异 

e 创建 库 

e 使 用 NET 标准 

e 使 用 共享 项 目 

e 创建 NuGet 包 

本 章 源 代码 下 载 : 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 音源 代码 。 源 代码 也 可 以 在 Libraries 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

® UsingLibs 

® UsmeLegacyLibs 

® UsineASharedProject 

® CreateNuGet 


19.1 ” 库 的 地 狱 


库 可 以 在 多 个 应 用 程序 中 重用 代码 。 在 Windows 中 ， 库 有 很 长 的 历史 ,而 构建 原则 通过 更 新 的 技术 走 同 了 
不 同 的 方向 。 在 NET 之前， 动态 链接 库 (Dynamic Link Library，DLL) 可 以 在 不 同 的 应 用 程序 之 间 共 享 。 这 些 
DLL 已 安装 在 共享 目录 中 。 这 些 库 在 同一 个 系统 上 不 可 能 有 多 个 版 本 ,但 它们 应 该 是 同上 兼容 的 。 当 然 ， 情 况 
并 非 总 是 如 此 。 此 外 ， 应 用 程序 的 安装 也 存在 一 些 问题 ， 例 如 没有 关注 指导 方针 ， 用 旧版 本 替代 共享 库 。 这 就 
是 DLL 地 狱 。 

.NET 试图 用 程序 集 解 决 这 个 问题 。 程 序 集 是 可 以 共享 的 库 。 除 了 正常 的 DLL 之 外 ， 程 序 集 还 包含 可 扩展 
的 元 数据 ， 以 及 关于 库 和 版 本 号 的 信息 ， 并 且 可 以 在 全 局 程序 集 缓存 中 并 排 安 装 多 个 版 本 。 微 软 试 图 解决 版 本 
问题 ， 但 这 又 增加 了 一 层 复杂 性 。 

假设 使 用 的 是 应 用 程序 X 中 的 库 A 和 库 B( 参 见 图 19-1)。 应 用 程序 义 引用 库 A 的 1.1 版 本 和 库 B 的 1.0 版 
本 。 问 题 是 库 B 也 引用 了 库 A, 但 是 它 引 用 了 男 一 个 版 本 一 一 1.0。 一 个 进程 只 能 加 载 库 的 一 个 版 本 。 那 么 ， 在 
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进程 中 加 载 哪个 版 本 的 库 A? 如 果 库 B 在 库 A 之 前 使 用 , 那么 版 本 1.0 就 会 胜出 。 当 应 用 程序 X 需要 使 用 库 A 
时 ， 这 就 是 一 个 大 问题 。 


应 用 程序 义 


19-1 


为 了 避免 这 个 问题 ,可 以 配置 程序 集 重 定 同 。 可 以 为 应 用 程序 六 定义 一 个 程序 集 重 定 同 ， 以 便 加 载 库 A 的 
版 本 1.1， 然 后 库 B 需要 使 用 库 A 的 版 本 1.1。 如 果 库 A 是 向 上 兼容 的 ， 这 就 不 应 该 有 问题 。 

当然 ， 兼 容 性 并 不 总 是 存在 的 ， 问 题 可 能 更 复杂 。 组 件 的 发 布 者 可 以 创建 一 个 用 布 者 策略 来 定义 库 本 身 的 
重 定向 。 这 个 重 定向 可 以 由 应 用 程序 重 写 。 这 里 面 有 很 多 复杂 的 东西 ， 导 致 了 程序 集 的 地 狱 。 


注意 : 
在 .NET Core 中 ,并 没有 像 NET Framework 那样 的 程序 集 全 局 共享 。 只 有 .NET 运行 库 可 以 在 不 同 的 应 用 程 
序 之 间 共 享 。 


NuGet 包 在 库 中 添加 了 另 一 个 抽象 层 。NuGet 包 可 以 包含 一 个 或 多 个 程序 集 的 多 个 版 本 ， 以 及 其 他 内 容 ， 
例如 程序 集 重 定 回 的 目 动 配置 。 

不 需要 等 竺 新 的 NETFramework 版 本 ， 而 可 以 通过 NuGet 包 添 加 功能 ， 这 样 可 以 更 快 地 更 新 包 。NuGet 包 是 
一 款 很 棒 的 运载 工具 。 一 些 库 ， 例 如 Entity Framework， 已 切换 到 NuGet 上 ， 它 提供 的 更 新 比 NETFramework 
更 快 。 

然而 ，NuGet 也 存在 一 些 问 题 。 经 常 在 项 目 中 添加 NuGet 包 会 失败 。NuGet 包 可 能 与 项 目 不 兼 容 。 当 添加 
包 成 功 时 , 包 可 能 会 在 项 目 中 进行 一 些 不 正确 的 配置 , 例如 错误 的 绑 定 重 定 同 。 这 就 导致 了 “NuGet 包 的 地 狱 ”。 
DLL 的 问题 转移 到 不 同 的 抽象 层 ， 并 且 确 实 是 不 同 的 。 在 NuGet 的 新 版 本 和 升级 版 本 中 ， 微 软 尝 试用 NuGet 
解决 问题 。 

NET Core 体系 结构 中 的 方向 也 发 生 了 变化 。 对 于 .NET Core, 包 的 粒度 更 细 。 例如 , 在 NET Framework 中 ， 
Console 类 位 于 mscorlib 程序 集中 , 这 是 每 个 .NET Framework 应 用 程序 都 需要 的 程序 集 。 当然 , 并 不 是 每 个 NET 
应 用 程序 都 需要 Console 类 。 在 NET Core 1.0 中 有 一 个 单独 的 包 System.Console， 其 中 包含 Console 类 和 一 些 相 
关 类 。 其 目标 是 使 更 新 更 容易 ， 并 选择 真正 需要 的 包 。 在 NET Core 1.0 的 一 些 Beta 版 本 中 ， 项 目 文件 包含 了 大 
量 的 包 ， 这 并 没有 使 开发 变 得 更 容易 。 在 NET Core 1.0 发 布 之 前 ， 微 软 引 入 了 元 包 ( 或 称 为 引用 包 )。 元 包 不 包 
括 代 码 ， 而 包括 其 他 包 的 列表 。 

.NET Core 2.0 包含 了 另 一 种 简化 。 用 NET Core 1.1 创建 “Hello，World!”* 控 制 台 应 用 程序 时 ， 生 成 的 
project.asset.json 文件 的 大 小 为 313 KB。 这 个 文件 (在 obj 目录 中 ) 显 示 了 依赖 树 。 在 .NET Core 2.0 中 ， 由 于 包 更 
大 ， 引 用 却 较 少 ， 文 件 大 小 减少 到 33 KB。 

本 章 将 介绍 程序 集 和 NuGet 包 的 细节 ， 解 释 如 何 使 用 .NET 标准 库 共享 代码 ， 并 解释 与 Windows 运行 库 组 
件 的 不 同 之 处 。 
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19.2 程序 集 


程序 集 是 包含 额外 元 数据 的 库 或 可 执行 文件 。 使 用 .NET Core, 包含 Main0 方 法 的 应 用 程序 会 创建 为 具有 文 
件 扩展 名 .dl 的 库 。 这 个 DLL 需要 一 个 和 宿主 进程 来 加 载 这 个 库 ， 为 此 可 以 使 用 dometrun， 或 者 在 运行 库 环境 中 
使 用 dotnet。 使 用 NET Core 创建 独立 的 应 用 程序 时 ， 会 为 每 个 平台 创建 不 同 的 可 执行 文件 来 加 载 库 。 

下 面 看 看 一 个 简单 的 “Hello, World!” 控 制 台 应 用 程序 ， 它 使 用 如 下 命令 在 目录 ConsoleApp 中 创建 

> dotnet new console 

在 构建 应 用 程序 之 后 ，DLL 可 以 在 bin/debug/netcoreapp2.0 目录 中 找到 。netcoreapp2.0 目录 依赖 于 csproj 
项 目 文件 中 列 出 的 目标 框架 。 

可 以 使 用 ildasm.exe (LI 反 汇 编程 序 ) 命 令 行 实 用 程序 读 取 程 序 集 信 息 。ildasm.exe 显示 了 程序 集 及 其 成 员 的 
类 型 ， 和 附加 的 元 数据 ， 如 图 19-2 所 示 。 


避 ConsoleApp.dll - ILDASM 


File View Help 
目 . 过 Consoleapp, 册 


的， 
-时 consoleapp 
日 三 ConsolaApp. Progranm 
,class private auto ansl beforeflieldint 
ctor : void() 
加 Main ; voidistring[]) 


图 19-2 


单 击 MANIFEST( 参 见 图 19-2)， 为 程序 集 打开 元 数据 信息 ， 如 图 19-3 所 示 。 该 程序 集 的 名 称 是 ConsoleApp， 引 用 
了 程序 集 System.Runtime 和 System.Console。 还 有 几 个 已 配置 的 程序 集 属性 ， 例 如 AssemblyCompanyNameAttribute、 
AssemblyConfigurationAttribute、AssemblyDescriptionAttribute、AssemblyFileVersionAttribute 以 及 其 他 。 


到 MANIFEST 
Find Find Next 
-: Hetadata version: vk.B.36319 
.a5ssembly extern System.Runtime 


所 
-Publickeytoken = (BG 3F SF 7F 11 DS A 3 } 
= 四 四 2 本 = 中 


} 
-a5s5sembly extern System.Console 


-Publickeytoken = {BO 3F SF YF 11 DS QA 3 ) 
= 了 EF 21= 和 BB 


» 
-a55sembly Consolefipp 


:Custom instance void [System.Runtime]System.Runtine.CompilerServices.CompilationRelaxationsittribute:: .ctor(ints2, 
-CUStom instance void [System.Runtime]system.Runtine.Compilerservices.RuntimeCompatibilityAttributes: .ctorty = ( 
i 


i--- The following custom attribute i5 added automatically, do not unconmment ------- 
rie Custom instance void [Systen.Runtime]System.Diagnostics.DebuggableAttribute:: .ctortvaluetype [Systemn.Runtime]: 
-CUStom instance void [Systenm.Runtine]systenm.Runtine.Versioning.TargetFramneworkittribute::.ctortstring) = 世人 B80 * 
5 2 1 
6 Ft 
ME 61 4 
:Custom instance void [System.Runtime]Ssystem.Reflection.issemblytompanyittribute:: .ctortstring)y = Bi Ba BA kh3 6F 
-Custom instance void [System.Runtine]System.Reflection.AssemblyConFfigurationAttribute:: ctor(string}y = ( @1 B88 5 ., 
TT | 
» 


图 19-3 
描述 应 用 程序 的 程序 集 元 数据 可 以 使 用 Visual Studio 配置 ， 方 法 是 在 Project Properties 中 选择 Package ( 参 


见 图 19-4)。 
当然 ， 还 可 以 直接 编辑 项 目 文 件 (代码 文件 ConsoleApp/ConsoleApp.csproj): 


<Project Sdk="Microsoft.NET.Sdk"> 
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<PIopertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
<Authors>Christian Nagel</Authors> 
<Company>CN innovation</Company> 
<Product>Sample App</Product> 
<Description>Sample App for Professional C#</Description> 
<Copyright>Copyright {c) CN innovation</Copyright> 
<PackageProjectUrl>https://github.com/ProfessionalCsharp 
</PackageProjectUrl> 
<RepositoryUrl>https://github.com/ProfessionalCSharp/Professionalcsharp7 
</RepositoryUrl> 
<RepositoryType>git</RepositoryTYype> 
<PackageTags>WIrox Press, Sample, Libraries</PackageTags> 
</PropertyGroup> 


</Project> 


注意 ; 
在 前 面 的 项 目 中 ， 这 些 元 数据 信息 通常 使 用 全 局 C# 属 性 添加 到 文件 AssemblyInfo.cs 中 。 仍 然 可 以 这 样 做 ， 
但 是 需要 把 csproj 文件 配置 为 不 自动 生成 属性 。 


呆 昌 onsoleapp 3 9 
Application NA, Mi 
Build 
Build Events 
OD Generate NuGat package on build 
Debar 
9 口 ] Require license acceptance 
Signing 
i Package id: ConsoleApp 
Package WE 让 1.00 
Authars Christian Magel 
Compariy: Ch innovation 
Product: sample App 
Sample App for Prolessional Cs 
Dreseriptione 
Copyright Copyright () CN innovation 
License URL: 
Project URL https//github.com/ProfessionalC Sharp 
lean URL: 
Repository URL: https//github.ceom/Professional harp/ProfessionalCSharpr 
Repository type: 避让 
Tags Wirox Press, Sample .Libraries 
本 . 
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19.3 ”创建 库 


可 以 通过 创建 库 来 使 用 共享 代码 。 在 Visual Studio 2017 中 ， 有 许多 创建 库 的 选项 ， 如 下 所 示 : 
® ClassLibrary (.NET Core) 

Class Library (.NET Standard) 

Class Library (.NET Framework) 

WPF Custom Control Library (.NET Framework) 

WPF User Control Library (.NET Framework) 

Windows Forms Control Library (.NET Framework) 

Class Library (Universal Windows) 

Class Library (Legacy Portable) 
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e@ Shared Project 

上 面 列 出 的 Shared Project 并 不 是 一 个 真正 的 类 库 ， 但 是 可 以 使 用 它 来 共享 多 个 项 目 中 的 代码 。 

在 前 面 的 列表 中 ， 使 用 NET Framework 标识 的 类 库 应 该 与 .NET Framework 一 起 使 用 ， 它 们 可 以 有 特定 的 
限制 。WPF User Control Library 和 WPF Custom Control Library 只 能 在 WPF 应 用 程序 中 使 用 。 类似 地 , Windows 
Forms Control Library 只 能 在 Windows Forms 应 用 程序 中 使 用 。 

Class Library(Legacy Portable) 己 经 在 名 字 中 包含 Legacy 了 。 这 个 项 目 模板 最 初 称 为 Portable Class Library 
(PCD), 不 应 该 用 于 新 的 应 用 程序 。 这 个 库 能 够 共享 不 同 技术 之 间 的 代码 , 例如 在 Silverlight、 WPF、Xamarin、.NET 
Core 等 之 间 共 享 代码 。 根 据 平台 和 版 本 的 选择 ， 可 以 使 用 不 同 的 API。 平 台 越 多 ， 选 择 的 版 本 越 老 ， 可 用 的 
API 就 越 少 。 随 着 添加 的 平台 越 来 越 多 ， 就 增加 了 定义 的 复杂 性 ， 也 增加 了 在 可 移植 的 库 中 使 用 可 移植 库 的 复 
杂 性 。 

.NET 标准 为 可 移植 的 库 提 供 了 蔡 代 品 。 


19.3.1 .NET 标准 


.NET 标准 对 可 用 的 API 进行 了 线性 定义 ,这 与 可 用 于 可 移植 库 的 API 的 矩阵 定义 不 同 。.NET 标准 的 每 个 
版 本 都 添加 了 API， 而 API 从 未 删除 。 

.NET 标准 的 版 本 越 高 , 可 以 使 用 的 API 越 多 。 然而 , .NET 标准 并 没有 实现 API; 它 只 是 定义 了 需要 由 .NET 
平台 实现 的 API。 这 可 以 与 接口 和 具体 类 相 比 较 , 接口 为 需要 由 类 实现 的 成 员 定 义 了 协定 ,在 .NET 标准 中 , .NET 
标准 指定 了 哪些 API 需要 可 用 ， 以 及 需要 实现 这 些 API 的 .NET 平台 一 一 支持 特定 版 本 的 标准 。 

在 https://github.com/dotnet/standard/tree/master/docs/versions 中 可 以 找到 哪些 API 可 用 于 哪个 标准 版 本 ， 以 
及 标准 之 间 的 差异 。 

NET 标准 的 每 个 版 本 都 将 API 添加 到 标准 中 : 

.NET Standard 1.1 在 .NET Standard 1.0 中 添加 了 2414 个 API。 
版 本 1.2 只 添加 了 46 个 API。 

在 1.3 版 本 中 ， 添 加 了 3314 个 API。 

1.4 版 本 只 添加 了 18 个 加 密 API。 

1.5 版 本 主要 增强 了 反射 文 持 ， 增 加 了 242 个 API。 

e 1.6 版 本 增加 了 更 多 的 加 密 API 和 增强 的 正则 表达 式 ， 共 额外 添加 了 146 个 API。 

在 NET Standard 2.0 中 ， 微 软 进行 了 大 量 的 投资 ， 使 其 更 容易 将 旧 应 用 程序 迁移 到 NET Core。 在 这 个 新 标 
准 中 ， 添 加 了 19507 个 API。 并 非 所 有 这 些 API 都 是 新 的 。 有 些 已 经 在 NET Framework 4.6.1 中 实现 了 。 例 如 ， 
像 DataSet、DataTable 之 类 的 旧 API 现 在 可 用 于 .NET 标准 ,这 是 为 了 便于 将 旧 应 用 程序 迁移 到 .NET 标准 中 。.NET 
Core 需要 大 量 的 投资 ， 因 为 .NET Core 2.0 实现 了 NET Standard 2.0。 

哪些 API 不 是 标准 的 ， 永 远 都 不 会 变 成 标准 ? 特定 于 平台 的 API 不 可 能 成 为 NET 标准 的 一 部 分 。 例 如 ， 
Windows Presentation Foundation (WPF) 和 Windows Forms 定义 了 特定 于 Windows 的 API， 而 这 些 API 不 会 成 为 
标准 。 但 是 ， 可 以 创建 WPF 和 Windows Forms 应 用 程序 ， 并 在 其 中 使 用 NET 标准 库 。 不 能 创建 包含 WPF 或 
Windows Forms 控件 的 NET 标准 库 。 

测试 过 的 新 API 将 首先 进入 .NET Core。 一 旦 API 稳定 下 来 ， 就 可 以 用 于 .NET 标准 的 未 来 版 本 。 

下 面 讨 论 更 多 关于 .NET 标准 平台 支持 的 细节 。 如 果 需 要 支持 Windows Phone Silverlight 8.1， 就 要 将 库 限制 
为 可 用 于 .NET Standard 1.0 中 的 API。 当 然 , 现在 通常 不 需要 文 持 任 何 Silverlight 版 本 。 下 面 介绍 更 重要 的 .NET 
平台 。 

对 于 使 用 通用 Windows 平台 的 库 ， 需 要 注意 要 文 持 的 构建 号 。 如 果 只 文 持 Fall Creators Update of Windows 
10， 就 可 以 使 用 NET Standard 2.0。 为 了 文 持 Creators Update 和 旧 的 Windows10 构建 版 本 ， 可 以 升级 到 NET 
Standard 1.4。 在 这 种 情况 下 ， 新 版 本 是 不 可 用 的 。 如 果 创 建 一 个 包含 ASPNET Core 1.1 控制 器 的 库 ， 库 就 需要 
是 标准 的 1.6 版 。 
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注意 : 
要 支持 尽 可 能 多 的 平台 ， 需 要 选择 较 低 的 NET 标准 版 本 。 要 获得 更 多 的 API， 请 选择 更 高 NET 标准 版 本 。 


19.3.2 ”创建 .NET 标准 库 
要 创建 .NET 标准 库 ， 可 以 通过 如 下 命令 使 用 NET Core CLI 工具 。 


dotnet new classlib 


使 用 .NET Core 2.0 CLI 工 具 ， 将 创建 一 个 具有 这 个 csproj 定 义 的 库 ( 代 码 文 件 UsingLibs/SimpleLib/ 
SimpleLib.csproj): 
<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup> 
<TargetFramework>netstandard2.0</TargetFramework> 


</PropertyGroup> 
</Project> 


通过 更 改 TargetFramework 元 素 ， 可 以 更 改 NET 标准 库 的 版 本 。 在 Visual Studio 中 ， 可 以 使 用 Project 
Properties 的 Application Settings 设置 来 更 改 .NET 标准 版 本 (参见 图 19-5)。 


区 上 SilmeleLib 3 己 年 | 


亡 wi 思 

Build Evernts 

Package Asserilbly rar Delault narmespace 
Debug SimpleLib simplelLib 

igning Target famewatk: Cutput type: 
Pesouroes LNET Standard 20 二 | 局 ass Library 


NET Standard 10 
NET Standard 1.1 
NET Standard 1.2 
NET Standard 1.3 
NET Standard 14 
NET Stadad 1.% 
NET Standard 1.6 Bd 
MET Standard 20 


Install ather frameworks 
A ramifest determines specitic settinags tor an applleation. To embed a custom manifest, first 
add it to your project and then select it from the list below. 


lam: 


iDefault Iconml Browse- 加 ' 


OY) pesource file: 
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19.3.3 解决 方案 文件 


使 用 多 个 项 目 (例如 , 一 个 控制 台 应 用 程序 和 一 个 库 ) 时 , 使 用 解决 方案 文件 是 很 有 帮助 的 。 在 .NET Core CLI 
工具 的 新 版 本 中 ， 可 以 在 命令 行 中 使 用 解决 方案 ， 也 可 以 在 Visual Studio 中 使 用 它们 。 例 如 ， 下 面 的 命令 

> dotnet new sln 

在 当前 目录 中 创建 一 个 解决 方案 文件 。 

使 用 domet sln add 命令 ， 可 以 同 解 决 方案 文件 中 添加 项 目 : 


dotnet sln add SimpleLib/simpleLib.cspro]j 


项 目 文件 添加 到 解决 方案 文件 中 ， 如 下 面 的 代码 片段 所 示 ( 解 决 方案 文件 UsingLibs\ UsingLibs.sln): 


Microsoft Visual Studio Solution File, Format Version 12.00 

# Visual Studio 15 

Visualstudioversion = 15.0.26124.0 

MinimumvisualSstudioVversion = 15.0.26124.0 

Project("{FAEOA4ECO—301F-11D3-BFA4B-00C0O4F79EFBC}") = "SimpleLib", 
"SimpPleLib\SimpleLib.csproj", "{C58F9225-7407-45A0-932A-981AC3906F228}" 

EndProject 

Project ("{FAEO4ECO—301F-11D3-BF4B-00CO04F79EFBC}") = "ConsoleApp™", 
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"ConsoleApp\ConsoleApp .csproj", "{31E6F88A-COBC-4277-A9E9-19DAFDEBIATA}" 
EndProject 
Global 
# 


使 用 Visual Studio 时 , 可 以 在 Solution Explorer 中 选择 解决 方案 , 来 添加 新 项 目 。 从 上 下 文 华 单 中 选择 Add， 
然后 选择 Existing Project 来 添加 现 有 项 目 。 


19.3.4 引用 项 目 
使 用 dotmet add reference 命令 可 以 引用 一 个 库 。 当 前 目录 只 需要 定位 在 应 该 添加 库 的 项 目的 目录 中 : 


dotnet add reference ..\SimpleLib\SimpleLib.cspro] 


在 csproj 文件 中 使 用 ProjectReference 元 素来 添加 引用 (项 目 文件 UsingLibs/ConsoleApp/ConsoleApp.csproj): 
<Project Sdk="Microsoft.NET.Sdk"> 
<ItemGroup> 


<ProjectReference Include="..\SimpleLib\SimpleLib.csproj" /> 
</ItemGroup> 


<PIOpPpertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


</Project> 
在 Visual Studio 中 使 用 Solution Explorer， 可 以 选择 Dependencies 节点 ， 然 后 从 Project 沫 单 中 选择 Add 
Reference 命令 ， 从 而 同 其 他 项 目 添加 项 目 。 打 开 的 对 话 框 如 图 19-6 所 示 。 


Reference Manager - ConsoleApp 


a Projects 
solution Narme Path Name: 
YI simpleLib CAProCsharps... simpleLib 
bt Shared Projects 


bb Browse 


| Browse || Ok || Cancel | 


图 19-6 


19.3.5 引用 NuGet 包 
如 果 库 已 经 打包 在 NuGet 包 中 ， 则 可 以 直接 使 用 命令 dotnet add package 来 引用 NuGet 包 。 


dotnet add package Microsoft.Comosition 


它 没有 像 以 前 那样 添加 一 个 ProjectReference， 而 是 添加 了 一 个 PackageReference。 


<Project Sdk="Microsoft.NET.Sdk"> 
<ItemGroup> 
<ProjectReference Include="..\SimpleLib\SimpleLib.csproj" /> 
</ItemSroup> 
<ItemGroup> 
<PackageReference Include="Microsoft.Composition" Version="1.0.31" /> 
</ItemSroup> 
<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 
</Project> 
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为 了 请 求 包 的 特殊 版 本 , 可 以 使 用 .NET Core CLI 命 令 指 定 -version 选项 ,在 Visual Studio 中 , 可 以 使 用 NuGet 
包 管 理 器 (参见 图 19-7) 找 到 包 ， 并 选择 包 的 一 个 特定 版 本 。 使 用 此 工具 ， 还 可 以 获得 项 目的 细节 、 与 项 目的 链 
接 和 许可 信息 。 


注意 : 
在 www.nuget.org 上 ， 并 不 是 所 有 的 包 都 对 应 用 程序 有 用 。 应 该 检查 许可 信息 ， 以 确保 许可 证 符合 项 目 需 
求 。 另 外 ， 应 该 检查 包 的 作者 。 如 果 它 是 一 个 开源 的 包 ， 那 么 它 背 后 的 社区 有 多 活跃 ? 


NuGet ConsoleApp © X| I 


Installed Updates NuGet Package Manager: ConsoleApp 


PP- | | Include prerelease Package so0uUrce: | Mget,crg "| 晤 


-~ NewtonsoftJson 


Newtonsoft.Json by James Newton-kKing. 75.AM downloads vO0.3 


Json,NET is a popular high-performance ISON framewerk for ,NET 
Versien: | Latest stable 100.: = Install 


NUnit by Charlie Poole, 11.6M downloads 


NUnit is a unit-testing tramework for all ,NET languages with a strong TDD focus 


EntityFramework by Microsoft, 32,5M dovnloads 
Entity Frameweark is Microsoft's recommended data accaess technology for new 
applications 


jQuery by jQuery Foundation, Imc 37.6M downloads 
Ineompatible: Use Bower instesd 


ja |s a new ind of Javascript Library., 


HtmlAgilityPack by 了 Projects, Simeon Mourrier, Jeff Klawiter, Stephan Grell, 二 V1.3.1 
This is an agile HTML parser that builds a read/write DOM amd supports plain 
RPATH or MSLT (you Betualhy don't HAVE to understand MPATH nor XSLT to use it d.. 


YJ) Options 


Description 

lson NET is a popular hegh-performance JSON 
frarmmevwark for -ET 

Version: 10,0.3 

Autherls): lames Newton-King 


License: https raw github.caorm eames 
evetaraatt, sacrirriaster 


LIGCEMNSE.md 


Date published: Surnday, lunve 18 2017 
B12017N 


hmvateteran i Tibeee le EE eld 宇和 守 了 了 Project URL: httpe/ /wn newtonsott.com/]son 

Each package is leensed to yaou by its owner, Nucet is not responsible for, nor does it grant arvy 

licenses ta, third-party packages. Hewtonsoft.Json/l0.0.3 
ReporthAbuse 


Riaport Abuse: https//evw nugetorg/packages 


男 De net show this again 
Tags: em 
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19.3.6 NuGet 的 来 源 


包 从 哪里 来 ? www.nuget.org 是 微软 和 第 三 方 上 传 .NET 包 的 服务 器 。 痢 次 从 NuGet 服务 器 上 下 载 包 之 后 ， 
包 就 存储 在 用 户 配 置 文件 中 。 因 此 ， 用 相同 的 包 创建 男 一 个 项 目 会 快 得 多 。 

在 Windows 上 ， 用 户 配 置 文件 中 包 的 目录 是 %userprofile%\.nuget\packages。 也 使 用 其 他 临时 目录 。 要 获取 
关于 这 些 目录 的 所 有 信息 ， 最 好 安装 NuGet 命令 行 实 用 程序 ， 它 可 以 从 https://dist.nuget.org/ 下 载 。 

要 查看 全 局 包 、HTTP 缓存 和 temp 包 的 文件 来， 可 以 使 用 nuget local: 

> nuget locals all -list 

在 一 些 公司 中 ， 只 人 允许 使 用 经 过 批准 并 存储 在 本 地 NuGet 服务 器 中 的 包 。NuGet 服务 器 的 默认 配置 在 % 
appdata % /nuget 目录 的 文件 NuGet.Config 中 。 

默认 配置 类 似 于 下 面 的 NuGet.Config 文件 . 包 从 https://api.nuget.ore 和 本 地 的 NuGetFallbackFolder 中 加 载 。 


<2xXml] version="1.0" encoding="utf-8"?> 
<cConfiguration> 
<DackadgeSources> 
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" 
protocolVversion="3"™ /> 
<add key="CliFallbackFolder™" 
value="C:\Users\chris\.dotnet\NuGetFallbackFolder™" /> 
</packageSources> 
</configuration> 


可 以 通过 添加 和 删除 包 源 来 更 改 默认 值 。 
微软 并 没有 在 主 NuGet 服务 器 上 的 日 营 构 建 中 存储 包 。 为 了 使 用 NET Core NuGet 包 的 日 常 构建 ， 需 要 配 
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置 其 他 NuGet 服务 器 。 还 可 以 配置 本 地 目录 ， 在 其 中 可 以 放置 定制 的 NuGet 包 。 以 下 NuGet.Config 文件 添加 
了 一 个 本 地 目录 和 .NET Core 包 到 包 源 的 夜间 提要 。 
<cConfiguration> 
<packageSources> 
<add key="local packages"™" value="C:\git\mypackages"™ /> 
<add key="dotnet—core™ 
value="https://dotnet .myget .org/F/dotnet-core/api/v3/index.json™" /> 
</packageSources> 
</confiqguration> 


可 以 将 配置 文件 放置 到 项 目 目录 中 ， 而 不 是 更 改 默 认 配置 文件 。 这 样 ， 配 置 的 包 源 只 对 项 目 有 效 。 
19.3.7 使 用 .NET Framework 库 


如 本 章 前 面 所 述 ，NET Standard 2.0 的 一 大 优点 是 来 自 .NET Framework 的 额外 API。 这 便于 将 旧 .NET 应 用 
程序 迁移 到 新 的 .NET。 

.NET 标准 库 可 以 在 许多 不 同 的 .NET 技术 中 使 用 。 当 然 ， 可 以 从 NET Core 中 引用 .NET 标准 库 ， 也 可 以 从 
Mono 和 .NET Framework 项 目 中 引用 。WPF 应 用 程序 可 以 使 用 NET 标准 库 。 使 用 NET Core 1.0 创建 的 库 已 经 
可 以 实现 这 样 的 场景 。 但 是 现在 ， 在 .NET Standard 2.0 中 ， 扩 展 了 互 操作 场景 。 只 要 NET Framework 库 只 使 用 
可 用 于 .NET 标准 的 API， 也 可 以 从 NET 标准 库 中 引用 旧 的 .NET Framework 库 。 

这 怎么 可 能 ?尝试 使 用 早期 NET Core 版 本 的 互 操作 场景 常常 会 导致 兼容 性 错误 。 例 如 ， 对 象 类 型 定义 了 
两 次 。 这 些 问 题 的 原因 很 容易 解释 。 使 用 老 的 NET 技术 ， 例 如 .NET Framework， 在 mscorlib 中 定义 了 object 
类 等 核心 类 型 。 使 用 诸如 .NET Core 这 样 的 新 技术 ， 对 象 类 型 在 System.Runtime 中 定义 。 使 用 这 两 种 方法 ， 通 
常会 得 到 对 象 和 其 他 核心 类 型 的 副本 。 

.NET Standard 2.0 改变 了 这 种 行为 。.NET 标准 定义 了 一 个 API 集 ， 而 不 是 一 个 实现 。API 的 完整 实现 需要 
在 .NET 平台 (如 .NET Framework 和 .NET Core) 中 完成 。 标 准 是 使 用 类 型 转发 实现 的 ， 它 将 标准 的 类 型 转发 到 具 
体 的 实现 中 。 列 出 .NET 标准 中 类 型 的 新 库 是 NetStandard.dll。 这 个 库 对 每 个 平台 都 不 一 样 。NetStandard.dll 列 出 
类 型 ， 但 不 包含 任何 实现 。 相 反 ， 这 个 库 包 含 了 特定 实现 的 类 型 转发 匿 。 例 如 ， 在 :NET Framework 项 目 中 添 
加 .NET 标准 库 时 ， NetStandard.dll 会 自动 引用 , 并 包含 从 System.Console 类 到 mscorlib 程序 集 的 一 个 类 型 转 
发 器 ; 

.class extern forwarder System.Console 


| 


-assembly extern mscorlib 


因此 ， 对 于 .NET Core 项 目 ，NetStandard.dll 包含 从 System.Console 到 库 System.Console 的 重 定 问 。 


-Class extern forwarder SYyYSstem.cConsole 
{ 
.a5Ssembly extern System.Console 


} 

下 面 使 用 类 Legacy 创建 一 个 旧 NET Framework 库 来 实现 这 一 点 。 方 法 ConsoleMessage 和 WindowsMessage 
只 写 入 输出 。 ConsoleMessage 把 输出 写 进 控制 台 。 WindowsMessage 利用 .NET Framework 库 
System.Windows.Forms， 并 打开 一 个 消 奶 框 。 男 外 ，ShowConsoleType 方法 提供 了 Console 类 来 源 的 信息 (代码 
文件 UsingLegacyLibs/DotnetFrameworkLib/Legacy.cs): 

public class Legacy 


{ 


Public static void ConsoleMessage (string message) 


Console.WriteLine($"From the .NET Framework Lib: {message}"™); 


} 


public static void ShowConsoleType{() 
{ 
Console.WriteLine($"The type {nameof (Console)} is from ™ 十 
s$"{Assembly.GetAssembly (typeof (Console)) .FullName}"); 
} 
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public static void WindowsMessage (string message) 
{ 


MessageBox.Show ($"Windows Forms: {messagel}").; 
} 
} 


在 这 个 场景 中 需要 注意 的 是 ，Console 类 是 .NET 标准 的 一 部 分 ， 但 是 MessageBox 类 不 是 。Windows Forms 
是 特定 于 Windows 的 ， 不 会 成 为 .NET 标准 的 一 部 分 。 

接 下 来 ，.NET 标准 库 引 用 这 个 NET Framework 库 。 通 过 添加 对 项 目的 引用 ， 可 以 以 简单 的 方式 处 理 它 。 
项 目 文 件 包含 一 个 对 .NET Framework 库 的 ProjectReference( 项 目 文件 UsingLegacyLibs/DotnetStandardLiby/ 
DotmetStandardLib.cspro]): 


<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup> 
<TargetFramework>netstandard2.0</TargetFramework> 
</PropertyGroup> 
<ItemGroup> 
<ProjectReference Include="..\DotnetFrameworkLib\DotnetFrameworkLib.csproj" /> 
</ItemGSroup> 
</Project> 


在 .NET 标准 库 中 定义 的 Wrapper 类 只 是 将 方法 调用 转发 到 .NET Framework 库 。 当 引用 .NET Framework 库 
时 ， 构 建 .NET 标准 库 就 没有 编译 错误 (代码 文件 UsingLegacyLibs/DotnetStandardLib/Wrapper.cs): 


public class Wrapper 
{ 
public static void ConsoleMessage (string message) 三 > 
Legacy .ConsoleMessage (message)s 


Public static volid WindowsMessage (string message) => 
Legacy.WindowsMessage (message); 


public static void ShowConsoleType() => Legacy.ShowConsoleType(); 
} 


接 下 来 ， NET Core 控制 台 应 用 程序 使 用 了 Wrapper 类 。Program 类 调用 三 个 方法 。 但 是 ， 当 调用 
WindowsMessage 方法 时 ， 检 查 FileNotFoundException 异常 的 处 理 ( 代 码 文件 UsingLegacyLibs/UsingLegacyLibs/ 
Program.cs): 


static void Main() 
{ 
Wrapper.CconsoleMessage ("Hello from .NET Core™); 
Wrapper.ShowCconsoleType (}); 
try 
{ 
Wrapper.WindowsMessage ("Hello from .NET Core™); 
} 
catch (FileNotFoundException ex) 
{ 
Console.WriteLine (ex.Message)}),; 
} 
} 


应 用 程序 的 运行 结果 如 下 所 示 。Console 类 来 自 System.Console 程序 集 。 调 用 WindowsMessage 会 导致 一 个 
FileNotFoundException， 因 为 找 不 到 System.Windows Forms 程序 集 : 


From the .NET Framework Lib: Hello from .NET Core 

The type Console is from System.Console, Version=4.1.0.0, Culture=neutral., 
PublicFKeyTokKken=b03f5f7flld50a3a 

Could not load file or assembly System.Windows.Forms, Verslon=4.0.0.0, 
Culture=neutral, Pub]licKeYyToken=b77a5c561934e089 ' .- 

The system cannot find the file specified. 


在 创建 .NET Framework 控制 台 应 用 程序 时 ， 不 需要 将 WindowsMessage 方法 的 调用 封装 到 try/catch 处 理 程 
序 中 ， 因 为 System.Windows.Forms 是 可 用 的 (代码 文件 UsineLegacyLibs/DotmetFrameworkApp/Proeram.cs): 
static void Main() 
{ 
Wrapper.ConsoleMessage ("Hello from the .NET Framework™); 
Wrapper.ShowConsoleType (}); 
Wrapper .WindowsMessage ("Hello from the .NET Framework"™); 


} 


第 19 章 库 、 程 序 集 、 包 和 NuGet | 433 


运行 此 应 用 程序 会 表明 ，Console 类 来 自 于 mscorlib 程序 集 并 为 MessageBox 弹出 一 个 窗口 : 
From the -NET Framework Lib: Hello from the .NET Framework 


The type Console is from mscorlib, Version=4.0.0.0, Culture=neutral., 
PublicKeyToken=b77a5Sc561934e089 


二 

很 容易 从 .NET Core 应 用 程序 中 引用 .NET Framework 程 序 集 ， 并 构建 应 用 程序 。 但 是 ， 这 并 不 意味 着 NET 
Framewoik 程 序 集 的 每 个 功能 都 是 可 用 的 一 一 只 有 .NET 标 准 中 定义 的 类 型 可 用 。 使 用 这 些 类 型 就 可 以 在 Linux 上 
使 用 .NET Framework 库 。 

通常 ， 如 果 类 型 不 可 用 ， 则 最 好 选择 编译 错误 。 把 NET Framework 库 重 建 为 .NET 标准 库 ， 就 提供 了 这 个 
特性 。 如 果 没 有 可 用 的 源 代码 ， 比 如 来 自 还 未 提供 .NET 标准 库 的 供应 商 ， 仍 然 可 以 使 用 NET Core 中 的 库 。 要 
检查 二 进 制 文件 , 并 确定 哪些 类 型 与 哪个 NET 标准 版 本 不 兼容 , 可 以 使 用 .NET 可 移植 性 分 析 器 (NET Portability 
Analyzer)， 它 可 用 作 命 令 行 工 具 和 Visual Studio 扩展 (参见 https://github.com/microsoft/dotnet -apiport)。 


在 示例 NET Framework 库 中 运行 .NET 可 移植 性 分 析 器 ， 展 示 了 关于 支持 特定 类 型 和 成 员 的 平台 版 本 的 信 
息 ( 见 表 19-1)。 


表 19-1 支持 特定 类 型 和 成 员 的 平台 版 本 的 信息 


19.4 ”使 用 共享 项 目 


共享 项 目 并 不 是 真正 的 库 ， 但 它们 仍然 有 助 于 共享 代码 。 共 享 项 目 可 以 蔡 代 一 个 库 来 共享 代码 ， 但 是 包含 
代码 和 引用 共享 项 目的 项 目 。 通 过 这 种 方式 ， 可 以 将 特定 于 平台 的 代码 添加 到 共享 项 目 中 。 然 而 ， 这 个 特性 只 
有 在 没有 太 多 代码 差异 的 情况 下 才 有 用 。 当 存在 大 量 的 代码 差异 时 ， 创 建 特定 于 平台 的 库 可 能 更 好 。 

通过 下 面 的 代码 示例 ， 创 建 了 .NET Core 应 用 程序 和 通用 Windows 应 用 程序 ， 它 们 都 引用 了 共享 项 目 。 共 
享 项 目 包 含 可 以 同时 用 于 两 个 平台 的 代码 ， 但 每 个 都 包含 特定 于 平台 的 代码 。 

不 同 之 处 在 于 不 能 用 于 所 有 地 方 的 名 称 空间 。 可 以 使 用 预 处 理 器 指令 来 检查 条 件 编译 从 号 。 预 处 理 器 指令 
Windows_UWP 是 用 通用 Windows 应 用 程序 定义 的 (代码 文件 UsingASharedProject/SharedProject/Message.cs): 

ee 

#if WINDOWS UWP 

using Windows .UI.Popups; 

#endif 

Message 类 定义 Show、ShowAsync 和 Add 方法 。 Add 方法 适用 于 每 个 平台 。 只 有 在 定义 NETCOREAPP2 0 
指令 时 ，Show 方法 才 可 用 ， 而 ShowAsynec 方法 仅 适 用 于 UWP 应 用 程序 。 类 可 以 用 intemal 访问 修饰 符 定义 ， 
因为 它 不 在 程序 集 之 外 使 用 : 

internal class Message 


#9if£f NETCOREAPP2 0 
Public static void Show(string message) 
{ 
Console.WriteLine (message),; 


} 
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#elif WINDOWS UWP 
public static async Task ShowAsync (string message) 


{ 
await new MessageDialog (message) .ShowAsync(); 
} 
#endif 
Public static int Add(int x, int y) => x + y;’ 
} 


使 用 Visual Studio， 可 以 从 Reference Manager 选择 Shared Project， 以 添加 共享 项 目 ， 如 图 19-8 所 示 。 其 中 
包含 了 源 代码 ，Import 元 聚 与 项 目 文件 一 起 使 用 (项 目 文件 UsingASharedProject/UsingASharedProject/ 
UsingAsSharedProjectcsprol); 


<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 


</PropertyGroup> 
<Import Project="..\SharedProject\SharedProject.projitems" Label="Shared" /> 
</Project> 
| Reference Manager - UsingASharedproject ? XK 
bp Projects search [Ctrl+ 日 A- 
a Shared Projects Name Path Name: 
Solubion SharedProlect CProcsharpSsource,.. sharedProject 
PP Browse 


[oes | or [Ca 


图 19-8 


现在 ，Message 类 的 用 法 可 以 与 同一 个 项 目的 类 相似 (代码 文件 UsingASharedProject/UsingASharedProject/ 
Program.cs): 


using SharedProject; 


namespace UsingASharedProject 
{ 
class Program 
{ 
static void Main() 
{ 
Message .Show(™”" .NET Core™).; 
} 
} 
} 


在 UWP 应 用 程序 中 ，Message 类 是 用 法 相同 。 这 里 ， 在 按钮 的 单 击 处 理 程序 中 调用 ShowAsync 方法 (代码 
文件 UsingASharedProject/UniversalApp/MainPage. xaml.cs): 

Private async volid OnButtonClick (object sender, RoutedEventArgs e) 

{ 


awalt Message -Showasync ("Hello from UWP").; 
} 


注意 : 
在 共享 项 目的 源 代 码 中 使 用 Visual Studio 编辑 器 时 ， 可 以 在 编辑 器 顶部 选择 下 拉 视 图 ， 以 选择 要 处 理 的 当 
前 项 目 。 这 会 基于 已 定义 的 预 处 理 器 定义 灰 显 目前 不 可 用 的 代码 。 
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19.5 创建 NuGet 包 


前 面 介 绍 了 共享 项 目 ， 现 在 继续 讨论 库 一 一 从 库 中 创建 NuGet 包 。 使 用 .NET Core CLI 工具 和 Visual Studio 
2017， 可 以 轻松 创建 NuGet 包 。 


19.5.1 NuGet 包 和 命令 行 


关于 NuGet 包 的 元 数据 信息 可 以 添加 到 项 目 文件 csproj 中 。 要 从 命令 行 上 创建 NuGet 包 ， 可 以 使 用 domet 
pack 命令 : 

> dotnet pack --configuration Release 

记 住 要 设置 配置 。 默 认 情 况 下 会 构建 Debug 配置 。 成 功 打 包 后 ，NuGet 包 就 放 在 目录 bin/Release 或 相关 目 
录 中 ， 这 取 诀 于 所 选择 的 扩展 名 为 .nupkg 的 配置 文件 。.nupkg 文件 是 一 个 zip 文件 ， 包 含 带 有 附加 元 数据 的 二 
进 制 文件 。 可 以 将 该 文件 重 命名 为 zip 文件 ， 以 查看 其 内 容 。 

以 将 生成 的 NuGet 包 复 制 到 系统 的 文件 夹 或 网 络 共 享 中 ,使 其 可 用 于 团队 .样本 复制 到 文件 夹 c:/mypackage 
中 。 要 使 用 这 个 文件 夹 ，NuGet.config 文件 可 以 改 为 包含 这 个 包 源 。 也 可 以 使 用 dotnet add package 命令 直接 引 
用 文件 夹 : 


> dotnet add package SampleLib --source c:/MyPackages 
19.5.2 ”支持 多 个 平台 


.NET Standard 2.0 已 经 增强 为 支持 更 多 的 API， 它 们 在 每 个 新 的 NET 平台 上 都 可 用 。 但 是 ， 对 于 茶 些 应 用 
程序 来 说 ， 这 仍然 不 够 。 而 是 可 能 需要 通过 旧 库 来 使 用 NET 标准 中 没有 的 多 个 API, 或 者 可 能 需要 API 之 间 不 
同 的 特性 (如 WPF、UWP 和 Xamarin)。.NET Core 提供 的 特性 也 比 NET 标准 提供 的 功能 多 。 

之 前 探讨 了 如 何 使 用 共享 项 目 来 支持 不 同 的 平台 。 男 一 种 方法 是 使 用 相同 的 源 代码 创建 不 同 的 二 进 制 文件 ， 
如 下 一 个 示例 所 示 。 

示例 库 SampleLib 通过 不 同 的 二 进 制 文件 支持 NET Standard 2.0 和 .NET Framework 4.7。 为 了 构建 多 个 二 进 
制 文件 ， 可 以 将 TargetFramework 元 素 更 改 为 TargetFrameworks， 并 将 目标 框架 中 应 创建 二 进 制 文件 的 所 有 目标 
框架 别名 (target framework monikers) 都 列 在 其 中 。 这 个 例子 添加 了 目标 框架 别名 netstandard2.0 和 net47。 对 于 基 
于 目标 框架 的 代码 差异 ， 定 义 了 不 同 的 条 件 编译 符号 (项 目 文件 CreateNuGet/SampleLib/SampleLib.csproj): 


<Project Sdk="Microsoft.NET.Sdk"> 


<PropertyGroup” 
<TargetFrameworks>netstandard2.0;net47</TargetFrameworks> 
<!l—— Metadata information 一 一 > 

</PropertyGroup> 


<PropertyGroup Condition="'$ (TargetFramework) '=='netstandard2.0'"> 
<DefineConstants>NETSTANDARD2 0</DefineConstants> 
</PropertyGroup> 
<PropertyGroup Condition="'$ (TargetFramework) '=='net47' "> 
<DefineConstants>DOTNETAT</DefineConstants> 
</PropertyGroup> 
</Project> 
注意 : 
目标 框架 别名 的 列表 显示 在 https://docs.microsoft.comy/nuget/schema/target-frameworks 上 。 
在 代码 中 ， 可 以 很 容易 地 看 到 不 同 的 功能 ， 不 同 的 字符 串 用 不 同 的 值 初始 化 ， 这 个 值 从 Show 方法 返回 ( 代 
码 文 件 CreateNuGet/SampleLib/Demo.cs): 
Public class Demo 


#i£ NETSTANDARD2 0 
private static string s info = ".NET Standard 2.0"; 
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#elif DOTNETAT 


private static string s info = "-NET 4.7"; 
#else 

private static string s info = "Unknown"; 
#endif 


public static string Show() => s info; 
} 


通过 这 种 设置 ， 可 以 使 用 多 个 目标 框架 构建 应 用 程序 ， 并 为 每 个 目标 框架 创建 一 个 DLL。 创 建 NuGet 时 ， 
会 创建 一 个 包含 所 有 库 的 包 。 

创建 .NET Core 控制 合 应 用 程序 时 ， 也 可 以 为 多 个 目标 框架 构建 应 用 程序 。 与 之 前 的 库 一 样 ， 使 用 控制 台 
应 用 程序 配置 多 个 目标 框架 。 控 制 台 应 用 程序 将 针对 .NET Core 2.0 和 .NET Framework 4.7 构建 (项 目 文件 
CreateNuGet/DotnetCaller/DotnetCaller.cspro]): 

<TargetFrameworks>netcoreapp2.0;net47</TargetFrameworks> 

还 可 以 为 特定 的 目标 框架 添加 包 。 为 此 ， 可 以 添加 --framework 选项 ， 并 使 用 dotnet add package 命令 : 

> dotnet add package SampleLib -framework net47 -source c:/MyPackages 


这 显示 了 基于 项 目 文件 中 目标 框架 的 条 件 ， 如 下 所 示 : 


<ItemSroup Condition=""'$ (TargetFramework}" == "net47"'"> 
<PackageReference Include="SampleLib" Version="1.2.0" /> 
</ItemGroup> 


对 于 样 例 应 用 程序 ， 需 要 相同 的 包 ， 但 是 需要 选择 包 中 的 不 同 程序 集 。 这 是 根据 项 目 目 动 完 成 的 ， 而 包 只 
需要 添加 到 项 目 中 。 这 里 显示 了 控制 台 应 用 程序 的 完整 项 目 文件 (项 目 文件 CreateNuGet/DometCaller/ 
DotnetCaller.cspro]): 

<Project Sdk="Microsoft.NET.Sdk"> 

<PropertyGroup> 


<OutputType>Exe</OutputType> 
<TargetFrameworks>netcoreapp2.0;net47</TargetFrameworks> 


</PropertyGroup> 
<ItemGroup> 
<PackageReference Include="SampleLib™" Version="1.2.0" /> 
</ItemGroup> 
</Project> 
构建 控制 台 应 用 程序 ， 会 创建 多 个 二 进 制 文件 ， 其 中 包含 对 不 同 库 的 引用 。 
> dotnet run -framework net47 
输出 如 下 : 
-NET 4.71 
使 用 NET Core 变 体 : 
> dotnet run -framework netcoreapp2.0 
输出 如 下 : 


-PT Standard 2.0 

请 注意 ， 选 择 不 同 的 NET Framework 版 本 ， 如 NET4.6.1， 也 会 得 到 NET Standard 2.0。 这 是 因为 使 用 .NET 
Framework 4.7 构建 的 库 与 .NET 4.6.1 不 兼容 (只 有 较 新 版 本 的 .NET Framework 兼容 )， 但 是 NET 4.6.1 与 NET 
Standard 2.0 兼容 ， 所 以 这 个 库 匹 配 。 


19.53 NuGet 包 与 Visual Studio 


Visual Studio 2017 允许 创建 包 。 在 Solution Explorer 中 选择 项 目 时 ， 可 以 打开 上 下 文 菜 单 并 选择 Pack， 来 
创建 NuGet 包 。 在 Package 设置 的 项 目 属性 中 ， 还 可 以 选择 在 每 个 构建 上 创建 一 个 NuGet 包 。 如 果 不 打算 在 每 
个 构建 上 分 上 发包， 那么 这 可 能 是 多 余 的 。 但 是 ， 对 于 这 个 设置 ， 应 该 配置 包 元 数据 、 程 序 集 和 包 版 本 (参见 
图 19-9)。 
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图 19-9 


要 在 Visual Studio 中 使 用 包 , 可 以 在 Solution Explorer 中 选择 Dependencies, 打开 上 下 文 菜单 , 选择 Manage 
NuGet Packages。 这 将 打开 NuGet Package Manager (参见 图 19-10)， 可 以 在 其 中 选择 包 源 (如 果 通 过 单 击 Settings 
图 标 来 配置 该 包 ， 则 可 以 从 本 地 文件 夹 中 选择 包 )。 可 以 浏览 可 用 的 包 ， 盘 看 安装 在 项 目 中 的 包 ， 并 检查 包 的 更 
新 是 否 可 用 。 


NuGet Dotnetcaller = x | 


Browse Installed Updates NuGet Package Manager: DotnetCaller 


search (Ctrl+E Pr | Incude prerelease Package scurce: | Local Packages = 特 


[Pe sampleLib 
Microsoft.NETCore.App by Micrasoft 本 v2.0.0-preview2-25407-01 
A spt ef NET BPI's thvat ars Ineluded in the Inatalled: 126 
Prerease default .NET Core applicatian meadel. 人 


Umirestall 
r Werslomn: 1.2.0 
| SampleLib by Christian Nagel 

Wf) This is a sa mple package for Professional Ce 


fw Options 


Deacription 


This is a sample package for Professional Ca# 


Versienm 12.0 

hunierls): Christian Mageal 

Autherts): Christian Magel 

Date published: Friday, August 11, 2017 
ta 1 2017) 

Preject URL: httpss/github.conm 
Professionaltshamp 


Each package is licensed to you bry its owner. NuGet is met responsible for, nor does it grarnt Tags: Csharp .NET Core MuGet 
arvy licenses to, thiwrd=party packages. 


| | Do not show this 引 9ain Dependencies 
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注意 : 

如 果 要 创建 NuGet 包 ， 不 仅 用 于 内 部 ， 还 需要 在 NuGet 服务 器 上 发 布 ， 仅 将 库 添加 到 NuGet 文件 中 是 不 
够 的 。 还 可 以 添加 一 个 readme 文件 ， 添 加 相关 项 目的 库 ， 定 义 依赖 项 ， 并 创建 构建 脚本 。 为 此 ， 需 要 从 
www.nuget.ore 中 下 载 NuGet 实用 程序 。 访问 https://docs.microsoft.com/nuget 获取 更 多 关于 如 何 操作 的 信息 。 
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19.6 ”小 结 


本 章 解 释 了 DLL、 程序 集 和 NuGet 包 之 间 的 区 别 ， 了 解 了 如 何 使 用 NuGet 包 创 建 和 分 发 库 。 

NET 标准 定义 了 一 个 在 不 同 的 .NET 平台 上 实现 的 API 集 。 讨 论 了 .NET 标准 库 如 何在 ,NET Core 和 .NET 
Framework 中 使 用 ， 以 及 类 型 如 何 来 自 不 同 的 库 ， 如 mscorlib 和 System.Runtime。 

下 一 章 将 详细 讨论 一 个 重要 的 模式 : 依赖 注入 。 该 章 将 介绍 另 一 种 在 不 同 平 台 上 共享 代码 的 方法 : 注入 
特定 于 平台 的 特性 。 


六 


依赖 注入 


本 草 要 扣 

e 定义 依赖 注入 

e 使 用 依赖 注入 和 Microsoft.Extensions.DependencyInjection 
。 处 理 服 务 的 生命 周期 

e 使 用 选项 和 配置 来 初始 化 服务 


使 用 DI 为 WPF、UWP 和 Xamarin 创建 平台 独立 性 
使 用 其 他 依赖 注入 容器 


本 章 源 代码 下 载 : 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 DependencyInjection 目 
录 的 https://github.comy/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 
NoDI 
WithDI 
WI1thDIContamner 
ServicesLitetime 
DIW1thOptions 
DIW1thConfieurations 
PlatformIndependenceSample 
DIVW1ithAutoftac 


20.1 依赖 注入 的 概念 


更 快 的 开发 周期 需要 单元 测试 和 更 好 的 可 更 新 性 。 更 改 一 些 代码 ， 不 应 该 导致 意外 位 置 出 现 错误 。 创 建 更 
模块 化 的 、 减 少 依赖 项 的 应 用 程序 ， 有 助 于 防止 这 种 错误 。 

依赖 注入 (Dependency Injection, DD 允许 从 类 的 外 部 注入 依赖 项 , 因此 注入 依赖 项 的 类 只 需要 知道 一 个 协定 
( 通 剃 是 C# 接 口 )。 这 个 类 可 以 独立 于 其 对 象 的 创建 。 
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依赖 注入 更 便于 进行 单元 测试 。 在 单元 测试 中 ， 只 需要 测试 特定 的 类 ， 需 要 的 依赖 项 可 以 苦 换 为 包含 测试 
数据 的 特殊 模拟 类 。 

还 可 以 使 用 不 同 的 实现 区 分 生产 模式 和 开发 模式 。 例 如 ， 在 生产 过 程 中 ， 可 能 需要 访问 SAP 服务 器 ， 或 者 
可 能 需要 对 所 有 开发 人 员 都 无 法 访问 的 特定 活动 目录 进行 身份 验证 。 在 开发 的 每 个 调试 会 话 期 间 ， 都 不 硕 望 等 
待 成 功 的 身份 验证 ， 也 不 需要 SAP 服务 器 开发 用 户 界 面 。 在 这 里 ， 可 以 给 相同 的 协定 使 用 不 同 的 实现 来 模拟 身 
份 验证 ， 可 以 使 用 测试 数据 而 不 是 访问 SAP 服务 器 。 

也 可 以 在 不 同 的 平台 上 使 用 不 同 的 实现 .例如 ,可 以 创建 一 个 .NET 标准 库 , 在 其 中 为 UWP、WPF 和 Xamarin 
应 用 程序 实现 所 有 公共 功能 ， 并 可 以 根据 需要 重 定 癌 到 特定 于 平台 的 代码 。 

依赖 注入 还 人 允许 用 目 定义 特性 蔡 换 标准 功能 。ASPNET Core 和 Entity Framework Core 主要 基于 依赖 注入 。 
这 些 技术 使 用 数 百 个 协定 一 一 例如 ， 来 找到 控制 器 ,将 HTTP 请 求 映 射 到 控制 器 ， 将 接收 到 的 数据 转换 为 参数 ， 
将 数据 库 表 映射 到 实体 类 型 等 。 使 用 不 同 的 实现 ， 可 以 轻松 地 蔡 换 目 定义 功能 。 

DI 是 敏捷 软件 开发 和 持续 软件 交付 实践 的 核心 模式 。 

依赖 注入 不 需要 依赖 注入 容器 ， 但 该 容器 有 助 于 管理 依赖 项 。 依 赖 注入 容器 管理 的 服务 列表 越 来 越 长 ， 就 
可 以 看 到 它 的 优点 。ASPNET Core 和 Entity Framework Core 使 用 Microsoft.Extensions.DependencyInjection 作为 
容器 来 管理 所 有 依赖 项 ， 以 此 管理 数 百 个 服务 。 

尽管 依赖 注入 和 依赖 注入 容器 在 非常 小 的 应 用 程序 中 会 增加 复杂 性 ， 但 是 一 旦 应 用 程序 变 得 更 大 ， 需 要 多 
个 服务 ， 依 赖 注 入 就 会 降低 复杂 性 ， 并 促进 非 紧 密 绑 定 的 实现 。 

本 章 从 一 个 不 使 用 依赖 注入 的 小 应 用 程序 开始 ; 在 随后 的 示例 中 ， 它 转换 为 使 用 依赖 注入 并 使 用 依赖 注入 容器 
的 应 用 程序 。 本 章 还 介绍 了 服务 的 生命 周期 管理 和 配置 。 本 章 的 最 后 一 节 将 讨论 如 何 使 用 依赖 注入 来 履 兰 与 WPF、 
UWP 和 Xamarin 相关 的 ,特定 于 平台 的 服务 。 最 后 , 本 章 讨论 了 第 三 方 容器 与 Microsoft.Extensions.DependencyJnjection 


20.1.1 使 用 没有 依赖 注入 的 服务 


下 面 的 示例 没有 使 用 依赖 注入 ， 稍 后 将 更 改 它 ， 以 使 用 依赖 注入 。 所 用 的 服务 实现 在 类 GreetingService 中 
定义 。 这 个 类 定义 了 返回 字符 串 的 Greet 方法 (代码 文件 NoDLGreetingService.cs): 


Public class GreetingService 
{ 
public string Greet (string name) => $"Hello, {name}"™; 


} 
类 HomeController 使 用 这 个 服务 。 在 Hello 方法 中 ， 实 例 化 了 GreetingService， 并 且 调 用 Greet 方法 (代码 
文件 NoDLHomeController.cs): 


public class HomeController 
{ 
Public string Hellol(string name) 
{ 
Var SEIrIVice = new GreetingService (}); 
return service.Greet (namey:; 
} 
} 


下 面 看 看 Program 类 的 Main0 方 法 . 其 中 实例 化 了 HomeController, 调用 Hello 方法 , 将 结果 写 入 控制 台 ( 代 
码 文件 NoDLProgram.cs): 


static void Malnr) 

{ 
Var Controller = new HomeControllert(); 
string result = controller.Hello("stephanie™); 
Console .WriteLine (result).; 


} 

程序 运行 时 ， 把 Hello，Stephanie 写 入 控制 台 。 这 有 什么 问题 吗 ? 

HomeController 和 GreetingService 是 紧密 耦合 的 .要 用 不 同 的 实现 取代 HomeController 中 的 GreetingService 
并 不 容易 。 这 个 GreetingService 是 一 个 返回 字符 串 的 简单 服务 。 在 正常 的 应 用 程序 中 ， 场 景 通 闸 更 复杂 一 一 例 
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如 ，GreetingService 可 能 使 用 HTTP 请 求 访问 API 服务 ， 或 者 使 用 Entity Framework 访问 数据 库 。 可 能 要 更 改 
在 一 个 地 方 使 用 的 服务 ， 而 不 是 查找 使 用 服务 的 所 有 位 置 。 

男 外 ， 为 HomeController 创建 单元 测试 时 ， 也 会 测试 GreetingService。 在 单元 测试 中 ， 希 望 仅 测试 单个 类 
的 方法 的 功能 , 而 不 需要 使 用 其 他 依赖 项 .在 HomeController 中 , 不 能 很 容易 地 为 单元 测试 替换 GreetingService。 
从 技术 上 讲 ， 为 单元 测试 蔡 换 GreetingService 方法 的 内 部 实现 是 可 能 的 。 使 用 Microsoft Fakes 框架 ， 可 以 通过 
蔡 换 GreetingService 类 的 特定 方法 和 属性 ， 来 更 改 方法 的 实现 。 这 个 变更 是 在 单元 测试 中 定义 的 ， 并 且 只 有 在 
单元 测试 运行 时 才 会 发 生 : 通过 男 一 个 方法 来 “伪造 ”原来 的 方法 。 其 实 这 有 更 好 的 方法 : 使 用 依赖 注入 。 

下 一 节 将 介绍 如 何 更 改 此 实现 ， 以 使 用 依赖 注入 。 


注意 : 
Entity Framework Core 在 第 26 章 中 详细 介绍 。 第 28 章 讨论 了 更 多 关于 单元 测试 的 信息 。API 服务 在 第 32 
章 解 释 。 


20.1.2 ”使 用 依赖 注入 


下 面 使 HomeController 独立 于 GreetingService 的 实现 。 为 此 ， 可 以 创建 接口 IGreetingService， 它 定义 了 
HomeController 所 需 的 功能 (代码 文件 WithDLIGreetingService.cs): 
Public interface IGreetingService 


| 


string Greet (string name); 


GreetingService 现在 实现 了 接口 IGreetingService( 代 码 文件 WithDLGreetingService.cs): 
public class GreetingService : IGreetingService 


| 


Public string Greet (string name) => S$"Hello, {name}™"; 


HomeController 现在 只 需要 对 一 个 对 象 的 引用 ， 该 对 象 实现 了 接口 IGreetingService。 它 用 HomeController 
的 构造 函数 注入 ， 分 配给 私有 字段 ， 通 过 方法 Hello 来 使 用 (代码 文件 WithDLHomeController.cs): 


Public class HomeController 
{ 

Private readonly IGreetingService greetingService; 

Public HomeController (IGreetingService greetingService) 

{ 

_greetingService = greetingService ?? 

throw new ArgumentNullExceptiocon (nameof (greetingService)).; 

} 


public string Hellol(string name) => greetingService.Greet (name); 


在 这 个 实现 中 ，HomeController 利用 了 控制 反 转 的 设计 原理 。HomeController 没有 像 以 前 那样 实例 化 
GreetingService。 相 有 反 ， 定 义 由 HomeController 使 用 的 具体 类 的 控件 在 外 部 给 出 ; 换 句 话说 ， 控 制 是 反 转 的 。 


注意 : 

控制 反 转 也 被 称 为 好 菜 坞 原则 :不 要 给 我 们 打 电 话 ; 我 们 会 给 你 打 电 话 。 

控制 反 转 也 减少 了 对 不 同 技术 的 依赖 ， 创 建 出 更 通用 的 代码 。 例 如 ， 可 以 在 NET 标准 库 中 为 WPF、UWP 
和 Xamarin 应 用 程序 一 同 使 用 相同 的 视图 模型 和 服务 协定 。 对 于 WPF、UWP 和 Xamarin， 有 些 服务 需要 不 同 
的 实现 。 这 种 服务 的 实现 可 以 来 自 于 托管 应 用 程序 ， 而 协定 是 在 NET 标准 库 中 定义 和 使 用 的 。 阅读 第 34 章 可 
以 获得 关于 视图 模型 的 更 多 信息 。 

类 HomeController 并 没有 依赖 IGreetingService 接口 的 具体 实现 。HomeController 可 以 使 用 实现 了 接口 
IGreetingService 的 任何 类 。 这 个 类 只 需要 实现 这 个 接口 的 所 有 成 员 。 现 在 ， 需 要 从 外 部 注入 依赖 项 ， 将 具体 的 
实现 传递 给 HelloController 类 的 构造 函数 。 在 样 例 代码 中 ， 使 用 构造 函数 注入 的 依赖 注入 模式 实现 了 控制 反 转 
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的 设计 原则 。 它 称 为 构造 函数 注入 ， 因 为 接口 是 在 构造 测 数 中 注入 的 。 需 要 注入 依赖 项 来 创建 一 个 
HomeController 实例 。 

下 面 修改 Main0 方 法 ， 将 IGreetingService 的 具体 实现 传递 给 HomeController。 这 里 , 注入 了 依赖 项 (代码 文 
件 WithDIProgram.cs): 

static void Main() 

var controller = new HomeController (new Greetingservice () ) ; 


string result = controller.Hello("Matthias™); 
Console .WriteLine (result),; 


} 
为 HomeController 的 Hello 方法 创建 一 个 单元 测试 ， 可 以 注入 不 同 的 实现 一 一 例如 ， 执 行 IGreetingService 
的 MockGreetingService。 


示例 应 用 程序 目前 非常 小 。 唯 一 需要 注入 的 是 一 个 实现 协定 的 具体 类 。 这 个 类 在 实例 化 的 同时 实例 化 了 
HomeController。 在 实际 应 用 程序 中 ， 需 要 处 理 许多 接口 和 实现 ， 还 需要 共享 实例 。 这 样 做 的 一 个 简单 方法 是 
使 用 依赖 注入 容器 来 管理 所 有 依赖 项 。 在 下 一 节 中 , 应 用 程序 改 为 使 用 Microsoft.Extensions.DependencyInjection 
容器 。 


20.2 ”使 用 .NET Core DI 容器 


在 依赖 注入 容器 中 ， 可 以 在 应 用 程序 中 有 一 个 位 置 ， 在 其 中 定义 什么 协定 映射 到 哪个 特定 的 实现 上 ， 还 可 
以 指定 是 应 该 将 服务 作为 一 个 单 例 来 使 用 ， 还 是 应 该 在 每 次 使 用 时 创建 一 个 新 实例 。 
在 下 一 个 示例 中 ， 使 用 前 面 创建 的 GreetingService 来 实现 IGreetingService 和 HomeController 类 ， 但 这 族 我 
们 使 用 依赖 注入 容器 。 
示例 WithDIContainer 使 用 了 如 下 NuGet 包 和 名 称 空间 : 
包 
Microsott.Extensions.DependencyInjection 
名 称 空间 
System 
Microsott.Extensions.DependencyInjection 
在 Program 类 中 , 现在 定义 RegisterServices 方法 。 在 这 里 , 实例 化 一 个 新 的 ServiceCollection 对 象 。 在 添加 了 NuGet 
包 Microsoft Extensions DependencyImjection 之 后 ,ServiceCollection 就 在 名 称 空间 Microsof Extensions Depende 
中 定义 。 使 用 AddSingleton 和 AddTransient 时 ，ServiceCollection 的 扩展 方法 用 来 注册 DI 大 器 需要 知道 的 类 型。 在 示 
例 应 用 程序 中 ，GreetingService 和 HomeController 都 在 容器 中 注册 ， 这 允许 从 容器 中 检索 HomeController。 
当 请 求 [GreetingService 接口 时 ， 会 实例 化 GreetingService 类 。HomeController 本 身 没 有 实现 接口 。 通 过 这 
个 DI 容器 配置 ， 当 请 求 HomeController 时 ， 会 实例 化 HomeController。DI 容器 配置 还 定义 了 服务 的 生命 周期 。 
对 于 GreetingService， 请 求 IGreetingService 时 总 是 返回 相同 的 实例 。 这 和 HomeController 是 不 同 的 。 对 于 
HomeController， 每 次 请 求 检 索 HomeController 时 ， 都 会 创建 一 个 新 的 实例 。 使 用 AddSingleton 和 AddTransient 
方法 指定 服务 的 生命 周期 信息 。 本 章 后 面 将 介绍 这 些 服务 的 生命 周期 。 
调用 方法 BuildServiceProvider 会 返回 一 个 ServiceProvider 对 象 , 该 对 象 可 以 用 来 访问 已 注册 的 服务 (代码 文 
件 WithDIContainer/Program .cs): 
static ServiceProvider RegdisterServices() 
人 () ; 
services.addsingleton<IGreetingService，GreetingService>() ; 


services.AddTransient<HomeController>({(); 
return services.BuildServiceProvider(); 
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注意 : 

在 NET Core 1.1 中 , BuildServiceProvider 返回 接口 IServiceProvider, 而 不 是 返回 有 具体 的 类 。, 在 NET Core 1.1 
中 ，ServiceProvider 声明 为 intermal， 因 此 只 能 通过 它 的 公共 接口 [ServiceProvider 从 外 部 使 用 。 在 NET Core 2.0 
中 修改 了 实现 方式 ， 使 ServiceProvider 类 变 成 public， 并 更改 BuildServiceProvider 的 方法 声明 ， 以 返回 
ServiceProvider。 这 允许 直接 访问 ServiceProvider 的 Dispose 方法 ， 而 不 需要 将 返回 的 对 和 象 转 换 为 IDisposable 来 
调用 Dispose。 


注意 : 

如 果 多 次 将 相同 的 接口 合同 添加 到 服务 集合 中 ， 最 后 一 个 增加 的 接口 合同 就 会 从 容器 中 获得 接口 。 如 果 需 
要 一 些 其 他 功能 ， 比 如 使 用 ASP.NET Core 或 Entity Framework Core 实现 的 服务 ， 就 很 容易 用 不 同 的 实现 替换 
协定 。 另 一 方面 ， 对 于 ServiceCollection 类 ， 还 可 以 删除 服务 ， 并 为 特定 的 协定 检索 所 有 服务 的 列表 。 

接 下 来 ， 修 改 Main0 方 法 来 调用 RegisterService 方法 ， 以 便 在 DI 容器 中 注册 ， 然 后 调用 ServiceProvider 
的 GetRequiredService 方法 ， 来 获取 对 HomeController 实例 的 引用 (代码 文件 WithDIContainer/Program.cs): 

static void Maint{) 

| using (ServiceProvider container = RegisterServices!()) 


Var Controller = container.GetRequiredService<HomeController>().; 


string result = controller.Hello ("Katharina™.); 
Console.WriteLine (result). 
} 
} 


在 ServiceProvider 类 中 ,存在 GetService 和 GetRequiredService 的 不 同 重 载 。 在 ServiceProvider 类 中 直接 实 
现 的 方法 是 带 有 Type 参数 的 GetService。 泛 型 方法 GetService< 人 它 是 一 个 扩展 方法 ， 它 采用 泛 型 类 型 参数 ， 并 将 
其 传递 给 GetService 方法 。 

如 果 该 服务 在 容器 中 不 可 用 ， 则 GetService 返回 null。 扩展 方法 GetRequiredService 检查 到 null 结果 ， 如 果 
未 找到 服务 ， 就 抛 出 一 个 InvalidOperationException 异常 。 如 果 服 务 提 供 程 序 实 现 了 接口 
ISupportsRequiredService， 扩 展 方法 GetRequiredService 将 调用 提供 程序 的 GetRequiredService。 .NET Core 2.0 
的 容器 没有 实现 这 个 接口 ， 但 是 一 些 第 三 方 的 容器 实现 了 。 


局 动 应 用 程序 时 ， 在 GetRequiredService 方法 的 请 求 下 ，DI 容器 将 创建 HomeController 类 的 实例 。 
HomeController 构造 函数 需要 一 个 实现 IGreetingService 的 对 象 。 这 个 接口 也 在 容器 中 注册 ; 对 于 
IGreetingService， 需 要 返回 GreetingService 对 象 。GreetingService 类 有 一 个 默认 构造 函数 ， 因 此 容器 可 以 创建 一 
个 实例 ， 并 将 该 实例 传递 给 HomeController 的 构造 函数 。 这 个 实例 与 控制 器 变量 一 起 使 用 ， 与 以 前 一 样 用 来 调 
用 Hello 方法 。 

如 果 不 是 每 个 依赖 项 都 在 DI 容器 中 注册 ， 会 发 生 什 么 情况 ?要 得 看 此 操作 ， 可 以 使 用 DI 容器 删除 
IGreetingService 的 配置 。 在 这 种 情况 下 ， 容 器 会 抛 出 InvalidOperationException 异常 。 此 错误 消 因 显示: 在 符 试 
激活 WithDIContainer HomeController 时 无 法 解析 WithDIContainerIGreetingService 类 型 的 服务 。 


20.3 ”服务 的 生命 周期 


服务 的 生命 周期 定义 了 服务 实例 的 存在 时 间 。 它 是 否 存在 于 应 用 程序 的 生命 周期 中 ? 每 个 请 求 都 创建 了 一 
个 新 实例 吗 ? 中 间 还 有 一 些 东 西 ， 如 后 面 所 述 。 

将 服务 注册 为 单 例 总 是 返回 相同 的 实例 ， 将 服务 注册 为 瞬 态 ， 每 次 注入 服务 时 都 会 返回 一 个 新 对 象 。 还 有 
更 多 的 选择 ， 有 更 多 的 问题 需要 考虑 。 下 面 的 示例 将 显示 生命 周期 的 特性 和 问题 。 该 示例 还 用 服务 实现 了 
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IDisposable 接口 ， 因 此 可 以 看 到 这 是 如 何 处 理 的 。 
示例 ServicesLifetime 使 用 以 下 NuGet 包 和 名 称 空间 : 
包 
Mlcrosoft.Extenslons.DependencyInjection 
名 称 空间 
System 
Microsott.Extensions.DependencyInjection 
为 了 方便 地 区 分 不 同 的 实例 ， 每 个 实例 化 的 服务 都 指定 了 一 个 不 同 的 号 码 。 这 个 号 码 是 由 共享 服务 创建 的 。 这 
个 共享 服务 定义 了 一 个 简单 的 接口 INumberService， 返 回 一 个 号 码 (代码 文件 ServicesLifetime/TINumberService.cs): 


Public interface INumberService 
{ 

Int GetNumber(); 
} 


INumberService 的 实现 总 是 在 GetNumber 方法 中 返回 一 个 新 号 码 。 该 服务 注册 为 一 个 单 例 ， 其 号 码 在 其 他 
服务 之 间 共 享 (代码 文件 ServicesLifetime/NumberService.cs)。 


Public class NumberService : INumberService 
{ 

private int number = 0; 

public int GetNumber() => Interlocked.Increment (ref _PumpeIr) 
} 


下 面 要 介绍 的 其 他 服务 由 接口 协议 IServiceA、IServiceB、IServiceC 等 使 用 相应 的 方法 A、B、C 和 定义。 下 
面 的 代码 片段 显示 了 IServiceA 的 协定 (代码 文件 ServicesLifetime/IServiceA.cs): 


Public interface IServicen 
{ 

VOId BA(})- 
} 


在 ServiceA 的 实现 中 ， 构 造 函 数 需要 注入 INumberService。 通 过 这 个 服务 ， 检 索 号 码 ， 将 其 分 配给 私有 字 
段 n。 在 构造 图 数 、 方 法 A， 以 及 实现 IDisposable 接口 的 Dispose 方法 中 ， 写 入 控制 台 输 出 ， 因 此 可 以 看 到 生 
命 周 期 信息 (代码 文件 ServicesLifetime/ServiceA.cs): 


public class ServiceA : IServiceA, IDisposable 
| 下 站 
private int n; 
Public ServiceaA (INumberService numberService) 
| 
n = numberService.GetNumber():; 
Console .WriteLine ($"ctor {nameof (ServiceAa)}, { n}"™); 


} 
Public void A() => Console.WriteLine($"{nameof (A)}}, { n}"); 


Public void Dispose() => 
Console.WriteLine($"disposing {nameof (ServiceA)}, { n}"); 


} 


注意 : 
第 17 章 详 细 解 释 了 IDiposable 接口 。 


除了 服务 之 外 , 还 实现 了 控制 器 ControllerX。ControllerX 要 求 构造 函数 注入 三 个 服务 : IServiceA、 IServiceB 
和 INumberService。 在 方法 M 中 ， 调 用 了 两 个 注入 的 服务 。 同 时 ， 构 造 函 数 和 Dispose 信息 写 入 控制 台 (代码 文 
件 ServicesLifetime/ControllerX.cs): 


Public class ControllerX : IDisposable 
{ 
private readonly IServiceA SserviceaA; 
private readonly IServiceB serviceB; 
private readonly int ns; 
private int countm = 0; 
public ControllerX(IServiceA serviceA, IServiceB serviceB, 
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INumberService numberService) 
{ 
n= numberService.GetNumber ():; 


Console.WriteLine(s"ctor {nameof (ControllerX})}, { n}"™); 
ServiceA = servicea; 
ServiceB = serviceB; 


} 


public void MI() 

{ 
Console.WriteLine($"invoked {nameof (M)} for the {++ Countml - time"); 
_ serviceA.A(); 
_ serviceB.B(); 


} 


Public void Dispose() => Console .WriteLine{( 
"disposing {nameof (ControllerX)}, { n}"); 


} 
20.3.1 ”使 用 单 例 和 临时 服务 


下 和 面 开 始 注册 单 例 和 临时 服务 。RegisterServices 在 方法 SingletonAndTransient 中 作为 本 地 函数 实现 。 其 中 
注册 了 服务 ServiceA、ServiceB、NumberService 和 控制 器 类 ControllerX。NumberService 需要 注册 为 拥有 共享 
状态 的 单 例 。ServiceA 也 注册 为 单 例 。ServiceB 和 ControllerX 是 注册 的 临时 服务 (代码 文件 
ServicesLifetime/Proeram.cs): 


private static void SingletonAndTransient () 


Console.WriteLine (nameof (SingletonAndTransient)); 


SEIrviceProvider RegisterServices'{() 

{ 
ISeIrviceCollection Services = new ServiceCollection({():; 
services.hddSsingleton<lServiceh, Serviceh>().; 
Services.AddTransient<IServiceB, Serviceb>(); 
Services.LddTransient<Controlleri>().:; 
services.hddSsingleton<INumberService, NumberService>(); 
return services.BuildServiceProvider(); 

} 

| 

} 


AddSingleton 和 AddTransient 都 是 扩展 方法 ， 更 便于 用 MicrosoftExtensions.DependencyInjection 框架 注册 
服务 。 除 了 使 用 这 些 有 用 的 方法 之 外 ， 还 可 以 使 用 Add 方法 注册 服务 ( 它 本 号 由 方便 的 方法 调用 )。Add 方法 需 
要 一 个 包含 服务 类 型 、 实 现 类 型 和 服务 种 类 的 ServiceDescriptor。 服 务 的 种 类 使 用 ServiceLifetime 枚 举 类 型 指 
定 。ServiceLifetime 定义 了 值 Singleton、Transient 和 Scoped。 


SeErvices.Add (new ServiceDescriptor (typeof (ControllerX), 
typeof (ControllerX), ServiceLifetime.Transient)); 


注意 : 

ServiceCollection 类 的 Add 方法 是 为 接口 IServiceCollection 显 式 实现 的 。 对 于 这 个 ， 只 能 在 使 用 接口 
IServiceCollection 时 才能 看 到 方法 , 使 用 ServiceCollection 类 型 的 变量 时 看 不 到 它 。 第 4 章 中 介绍 了 显 式 接口 的 

调用 本 地 函数 RegisterServices 方法 来 检索 ServiceProvider， 获 得 两 次 ControllerX， 并 调用 方法 M， 之 后 释 
放 ServiceProvider( 代 码 文 件 ServicesLifetime/Program.cs): 


private static void SingletonAndTransient () 


| 


/1... 

uSing (ServiceProvider container = RegisterServices()) 

{ 
ControllerX XxX = container.GetRequiredService<ControllerX> () ，; 
XM(}s 


XM(); 
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Console .WIIteLInel(S"Tedguestlino {nameof (ControllerX) }"); 
ControllerX x2 = container.GetRequiredService<ControllerX> (); 
x2.M(); 


Console.WriteLine(}); 


注意 : 
第 13 章 解 释 了 本 地 函数 。 


运行 应 用 程序 时 ， 可 以 看 到 ， 请 求 ControllerX 时 ， 实 例 化 ServiceA 和 ServiceB ， 每 次 调用 GetNumber 方 
法 时 ，NumberService 都 会 返回 一 个 新 的 数字 。 当 第 二 次 请 求 ControllerX 时 ， 不 仅 新 创建 了 ControllerX， 还 创 
建 了 ServiceB， 并 且 注 册 为 暂 态 。 对 于 ServiceB， 相 同 的 实例 会 像 以 前 一 样 使 用 ， 不 会 创建 新 的 实例 : 


SingletonnandTransient 
requesting ControllerXx 
ctor ServiceA, 1 

ctor ServiceB, 2 

ctor ControllerZX, 3 
invoked M for the 1. time 
A, 1 

B, 2 

invoked M for the 2. time 
A, 1 

B, 2 

requesting ControllerXx 
ctor ServiceB, 4 

ctor ControllerX, 3 
invoked M for the 1. time 
A, 1 

B, 4 


disposing ControllerX, 5 
disposing ServiceB, 4 
disposing ControllerX, 3 
dlisposing ServiceB, 2 
disposing ServiceA, 1 


20.3.2 ”使 用 Scoped 服务 


服务 也 可 以 在 一 个 作用 域内 注册 。 这 是 介 于 transient 和 singleton 之 间 的 服务 。 对 于 singleton， 只 创建 一 个 
实例 。 每 次 从 容器 中 请 求 服务 时 ，transient 都 会 创建 一 个 新 实例 。 对 于 Scoped， 总 是 从 相同 的 作用 域 中 返回 相 
同 的 实例 ， 但 是 从 不 同 的 作用 域 中 会 返回 不 同 的 实例 。 作 用 域 默认 用 ASPNET Core Web 应 用 程序 定义 。 这 里 ， 
作用 域 是 一 个 HTTP Web 请 求 。 对 于 scoped 服务 ， 如 果 对 容器 的 请 求 来 目 同一 个 HITP 请 求 ， 则 返回 相同 的 实 
例 。 而 对 于 不 同 的 HITP 请 求 ， 会 返回 其 他 实例 。 这 人 允许 在 HITP 请 求 中 轻松 共享 状态 。 

对 于 非 ASPNET Core Web 应 用 程序 ， 需 要 自己 创建 作用 域 ， 以 获得 scoped 服务 的 优势 。 

下 面 开 始 使 用 本 地 图 数 RegisterServices 注册 服务 ，ServiceA 注册 为 scoped 服务 , ServiceB 注册 为 singleton. 
ServiceC 注册 为 transient( 代 码 文 件 ServicesLifetime/Program.cs): 

private static void Usingscoped!() 

console.WriteLine (nameof (Usingscoped) ) ; 

ServiceProvider RegisterServices () 

> ServiceCollection(); 
services.Addsingleton<INumberService, NumberService> (); 
services.AddScoped<IServiceA, ServiceA>(); 
services.Addsingleton<IServiceB, ServiceB>(); 


Services.AddTransient<IServyviceC, ServiceC>(); 
return services.BulilldSsServiceProvider{(); 


a 
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调用 ServiceProvider 的 CreateScope 方法 可 以 创建 一 个 作用 域 。 这 将 返回 实现 接口 IServiceScope 的 作用 域 
对 象 ， 在 其 中 可 以 访问 属于 这 个 作用 域 的 ServiceProvider， 可 以 在 容器 中 请 求 服 务 。 在 下 面 的 代码 片段 中 ， 
ServiceA 和 ServiceC 被 请 求 两 次 ， 而 ServiceB 只 请 求 一 次 。 然 后 ， 调 用 方法 A、B 和 C: 


private static void Usingscoped() 


{ 
/i-... 
usSing (ServiceProvider container = RegisterServices()) 
{ 
usSing lIServiceScope scopel = container.CreateScope()) 
{ 
IServiceaA al = scopel.ServiceProvider.GetService<IServiceny> (); 
al.A(); 
IServiceA a2 = scopel .ServiceProvider.GetService<IServicen> (); 
az.A(l); 
IServiceB bl = scopel.ServiceProvider.GetService<IServiceB> (); 
bl.B(); 
ISeErvVviceC cl = scopel .ServiceProvider.GetService<IServiceC> () ， 
clc()}s 
IServiceC c2 = scopel.ServiceProvider.GetService<IServiceC> (); 
C2C(}r 
} 


Console.WriteLine("end of scopel™); 
/i... 
} 


释放 第 一 个 作用 域 后 , 就 创建 男 一 个 作用 域 .有 了 第 二 个 作用 域 , 就 再 次 请 求 同 样 的 服务 ServiceA、ServiceB 
和 ServiceC， 调 用 方法 : 


private static void Usingscoped() 
{ 
pe 


Console.WriteLine ("end of scopel"™).; 


uUSing (IServiceScope scope2 = container.CreateScope()) 


{ 
IServicen a3 = scope2.ServiceProvider.GetService<IServiceA> (); 
a3.A()s; 
IServiceB b2 = scope2.ServiceProvider.GetService<IServiceB>(); 
b2.B(); 
IServiceC c3 = scope2.ServiceProvider.GetService<IServiceC> (); 
C3.C()s 

} 


Console.WriteLine ("end of scope2").; 
Console .WriteLine (); 


} 

运行 应 用 程序 时 , 可 以 看 到 , 为 实例 创建 了 服务 , 调用 了 方法 , 并 目 动 释放 它们 。 当 ServiceA 注册 为 scoped 
时 ， 在 相同 的 作用 域内 使 用 相同 的 实例 。ServiceC 注册 为 transient,， 因 此 在 这 里 ， 为 每 个 对 容器 的 请 求 创 建 一 
个 实例 。 在 作用 域 的 末尾 ，transient 和 scoped 服务 会 自动 释放 ， 但 是 没有 释放 ServiceB， 因 为 ServiceB 注册 为 
singleton， 需 要 在 作用 域 的 末尾 也 是 存活 的 ; 


UsingSscoped 

ctor ServiceA, 1 

A, 1 

A, 1 

ctor ServiceB, 2 

B, 2 

ctor ServiceC, 3 

C, 3 

ctor ServiceC, 4 

C, 4 

disposing ServiceC, 4 
disposing ServiceC, 3 
disposing ServiceA, 1 
end of scopel 


在 第 二 个 作用 域 的 开头 , 再 次 实例 化 ServiceA 和 ServiceB。 请求 ServiceB 时 , 将 返回 先前 创建 的 相同 对 象 。 
在 作用 域 的 结尾 ， 再 次 释放 ServiceA 和 ServiceC。ServiceB 在 释放 根 提 供 程 序 后 释放 : 


ctor ServiceA, 5 
A, 5 
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B, 2 

Ctor ServiceC, 6 

C, 6 

disposing ServiceC, 6 
disposing ServiceA, 5 
end of scope2 


disposing ServiceB, 2 


注意 : 
不 需要 在 服务 上 调用 Dispose 方法 来 释放 它们 。 使 用 实现 IDisposable 接口 的 服务 ， 容 器 会 调用 Dispose 方 
法 。 当 释放 作用 域 时 ， 将 释放 Transient 服务 和 scoped 服务 。 在 释放 根 提供 程序 时 ， 将 释放 Singleton 服务 。 

在 .NET Core 2.0 中 ， 服 务实 例 按 照 创建 的 相反 顺序 来 释放 。 当 一 个 服务 需要 注入 另 一 个 服务 时 ， 这 一 点 很 
重要 。 例 如 ，ServiceA 要 求 注入 ServiceB。 因 此 ， 首 先 创建 ServiceB， 然 后 创建 ServiceA。 在 释放 时 ， 首 先 释 
放 ServiceA, 并 且 在 释放 过 程 中 仍然 可 以 访问 ServiceB 中 的 方法 。 这 种 行为 不 同 于 .NET Core 1.0, .NET Core 1.0 
以 创建 服务 实例 的 顺序 释放 它们 。 


20.3.3 ”使 用 目 定义 工厂 


除了 定义 使 用 transient、scoped 和 singleton 之 外 ， 还 可 以 创建 自 定 义工 三 或 将 现 有 实例 传递 给 容器 。 下 面 
的 代码 片段 展示 了 如 何 实 现 这 一 点 。 

可 以 使 用 AddSingleton 方法 的 重 载 版 本 , 将 先前 创建 的 实例 传递 给 容器 。 这里, 在 RegisterServices 方法 中 ， 
首先 创建 一 个 NumberService 对 象 ， 然 后 将 其 传递 给 AddSingleton 方法 。 使 用 GetService 方法 ， 或 者 在 构造 函 
数 中 注入 它 ， 与 前 面 的 代码 没有 什么 不 同 。 只 需要 注意 ， 在 本 例 中 ， 容 器 不 负责 调用 Dispose 方法 。 对 于 创建 
并 传递 到 容器 的 对 象 ， 应 由 开发 人 员 释 放 这 些 对 象 (如 果 对 和 象 需要 释放 )。 还 可 以 使 用 工厂 方法 来 创建 实例 ， 而 
不 是 从 容器 中 创建 服务 。 如 果 服 务 需 要 目 定 义 的 初始 化 或 定义 不 受 DI 容器 支持 的 构造 函数 ， 这 是 一 个 有 用 的 
选项 。 可 以 通过 IServiceProvider 参数 传递 委托 ,并 将 服务 实例 返回 到 AddSingleton、AddScoped 和 AddTransient 
方法 。 使 用 示例 代码 ， 名 为 CreateServiceBFactory 的 本 地 函数 返回 ServiceB 对 象 。 如 果 服 务实 现 的 构造 函数 需 
要 其 他 服务 , 则 可 以 使 用 传递 进来 的 IServiceProvider 实例 检索 这 些 服务 (代码 文件 ServicesLifetime/Program.cs): 


private static void CustomFactories() 
{ 


Console .WriteLine (nameof (CustomFactories)})):; 


lIServiceB CreateServiceBFactory (lServiceProvider provider) => 
new ServiceB(provider.GetService<INumberService>()); 


ServiceProvider ReglsterServices() 
{ 


var numberService = new NumberService():; 


了 TBT SerIVvices = new ServiceCollection({():; 
services.AddSingleton<INumberService> (numberService); // add existing 


services.AddTransient<IServiceB> (CreateServiceBFactory); // use a factory 
Services.Addsingleton<IServiceA, Servicen> (); 
return services.BulildSsServiceProvider(); 


} 


using (ServiceProvider container = RegisterServices()) 
{ 
IServiceA al 
ISeErviceA a2 
IServiceB bl 
IServiceB b2 
} 
Console .WriteLine():; 


} 


container.GetSsService<IServiceA>().: 
container.GetService<IServiceA>(); 
container.GetService<IServiceB>(); 
container.GetService<IServiceB>().; 
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20.4 使 用 选项 初始 化 服务 


如 前 所 述 ， 一 个 服务 可 以 注入 男 一 个 服务 中 。 这 也 可 以 用 来 初始 化 一 个 带 有 选项 的 服务 。 不 能 使 用 服务 的 
构造 函数 定义 非 服 务 协定 来 进行 初始 化 ， 因 为 容器 不 知道 如 何 初始 化 它 。 服 务 是 必要 的 。 但 是 ， 为 了 传递 服务 
的 选项 ， 还 可 以 使 用 已 经 可 用 于 .NET Core 的 服务 。 

示例 DIWithOptions 使 用 这 些 NuGet 包 和 名 称 空间 : 

包 
Microsott.Extensions.DependencyInjection 
Microsott.Extensions.Options 

名 称 空间 

System 
Microsott.Extensions.DependencyInjection 
Microsoft.Extensions.Options 

示例 代码 使 用 之 前 使 用 的 GreetingService 进行 修改 ， 以 传递 选项 。 服 务 所 需 的 配置 值 由 类 
GreetingServiceOptions 定义 。 样 例 代 码 需 要 一 个 融 有 From 属性 的 String 参数 (代码 文件 DIWithOptions/ 
GreetinegServiceOptions.cs): 

public class GreetingServiceOptions 

public string From { get; set; } 

可 以 指定 带 有 IOptions<T> 参 数 的 构造 函数 ， 来 传递 服务 的 选项 。 前 面 定 义 的 类 GreetingServiceOptions 是 
用 于 IOptions 的 泛 型 类 型 。 传 递 给 构造 函数 的 值 用 于 初始 化 字段 ffrom( 代 码 文件 DIWithOptions/ 
GreetingService.cs): 

public class Greetingservice : IGreetingService 

| public GreetingService (IOptions<GreetingServiceOptions> options) => 

from = options.Value .From; 


private readonly string from; 


Public string Greet (string name) => $"Hello, {name}! Greetings from { from}"; 


} 


注意 : 
IOptions 接口 和 用 于 选项 的 服务 在 NuGet 包 Microsoft.Extensions.Options 中 实现 。 


为 了 便于 使 用 DI 容器 注册 服务 ， 定 义 了 扩展 方法 AddGreetingService。 该 方法 扩展 了 IServiceCollection 接 
口 ， 并 人 允许 通过 委托 传递 GreetingServiceOptions。 在 实现 代码 中 ，Configure 方法 用 于 通过 IOptions 接口 指定 配 
置 。Configure 方法 是 NuGet 包 Microsoft.Extensions.Options 中 IServiceCollection 的 扩展 方法 (代码 文件 
DIWithOptions/GITeettmgServViceExtenslons.cS); 


public static class GreetingServiceExtensions 
{ 
Public static IServiceCollection AddGreetingServicel 
this IServiceCollection collection, 
Action<GreetingServiceOptions> setupAction) 


{ 
if (collection == null) 
throw new ArgumentNullException (nameof (collection)); 
if (setupAction == null) 


throw new ArgumentNullException (nameof (setupAction))}); 


collection.configure (setupAction).; 
return collection.AddTransient<IGreetingService, GreetingService> (); 
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通过 构造 函数 注入 使 用 GreetingService 的 HomeController 不 需要 任何 更 改 ( 代 码 文件 DIWithOptions/ 
HomeController.cs): 


public class HomeController 
{ 
private readonly IGreetingService greetingService; 
Public HomeController (IGreetingService greetingService) 
{ 
greetingService = greetingService; 


} 


public string Hellol(string name) => greetingService.Greet (name); 


} 

现在 可 以 使 用 辅助 方法 AddGreetingService 注册 服务 。GreetingService 的 配置 是 通过 传递 所 需 选 项 来 完成 
的 。 还 需要 一 个 实现 IOptions 接口 的 服务 。 在 这 里 ， 可 以 使 用 扩展 方法 Addoptions。 该 方法 添加 了 几 个 接口 ， 
并 将 其 映射 到 与 选项 一 起 使 用 的 实现 (代码 文件 DIWithOptions/Program.cs): 


static ServiceProvider RegisterServices'!() 
{ 
VAaAI SEIVICEeS = New ServiceCollection().; 
Services.Addoptions () ; 
ServVvices.LAddGreetingService (options =»> 
{ 
opticons.From = "Christian™; 
}) i; 
Services.AddTransient<HomeController>(}); 
return services.BuildSserviceProvider().; 


} 
该 服务 现在 可 以 像 以 前 一 样 使 用 ,HomeController 从 容器 中 检索 , 在 使 用 IGreetingService 的 HomeController 
中 使 用 构造 函数 注入 : 


static void Mainil) 
{ 
USing (var container = ReglisterServices!()) 
{ 
Var controller = container.GetService<HomeController>(); 
string result = controller.Hello("Katharina™.); 
Console.WriteLine (resulty}).:; 
} 
} 


运行 应 用 程序 时 ， 现 在 可 以 使 用 以 下 选项 : 


Hello, Katharina! Greetings from Christian 


20.5 ”使 用 配置 文件 


需要 在 配置 文件 中 配置 服务 时 ， 也 可 以 使 用 前 面 所 示 的 选项 。 然 而 ， 有 一 种 更 直接 的 方法 : 可 以 使 用 .NET 
配置 特性 和 对 选项 的 扩展 。 使 用 NuGet 包 Microsoft.Extensions.Options.ConfieurationExtensions 中 的 配置 可 以 扩 
展 选项 。 
样 例 DIWithConfiguration 使 用 如 下 NuGet 包 和 名 称 空间 : 
包 
Microsott.Extensions.Contfieuration 
Microsott.Extensions.Confieuration.Json 
Microsott.ExtensionsDependencyInjection 
Microsott.Extensions.Options 
Microsott.Extensions.Options.ContfieurationExtensions 
名 称 空间 
System 
Microsott.Extensions.Confieuration 
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Microsott.Extensions.DependencyInjection 

Microsott.Extensions.Options 

示例 代码 基于 前 一 节 的 示例 ， 但 是 现在 可 以 使 用 配置 扩展 选项 。 不 需要 更 改 GreetingService 类 ， 它 仍然 使 
用 IOptions 接口 进行 初始 化 。 更 改 的 是 AddGreetingService 扩展 方法 ， 这 就 更 容易 使 用 该 服务 。 该 方法 的 第 二 
个 参数 现在 是 IConfiguration 类 型 ， 以 接收 配置 值 。config 参数 用 于 将 其 传递 给 Configure 扩展 方法 。Configure 
扩展 方法 与 前 面 使 用 的 方法 不 同 ; 这 个 方法 在 NuGet 包 MicrosoftExtensions.Options.ConfigurationExtensions 中 
定义 (代码 文件 DIWithConfiguration/GreetingServiceExtensions.cs): 


Public static class GreetingServiceExtensions 
{ 
Public static IServiceCollection AddGreetingServicel 
this IServiceCollection collection, IConfiguration config) 
{ 
if tcollection == null) 
throw new ArgumentNullException (nameof (collection)); 
if (config == null) throw new ArgumentNullException (nameof (config)); 


Collection.Configure<GreetingServiceOptions> (config); 
return collection.AddTransient<IGreetingService, GreetingService> (); 
} 
} 


可 以 从 环境 变量 、 程 序 参 数 和 不 同 格式 (如 XML、INI 和 JSON 文件 ) 的 文件 中 读 取 配置 。 这 里 ， 用 于 读 取 
JSON 配置 的 提供 程序 可 以 添加 NuGet 包 MicrosoftExtensions.Configuration 和 Microsoft.Extensions.Json。 在 方 
法 DefineConfiguration 中 ， 首 先 创建 一 个 ConfigurationBuilder， 然 后 使 用 fluent API 为 可 以 读 取 JSON 文件 的 目 
录 配 置 基 本 路 径 ， 并 配置 JSON 文件 本 身 。 文 件 appsettings.json 用 于 读 取 配置 。 在 ConfigurationBuilder 设置 之 
后 ， 调 用 Build 方法 来 返回 一 个 对 象 ， 该 对 象 实 现 了 可 访问 配置 值 的 IConfiguration( 代 码 文 件 
DIWithConfiguration/Program.cs): 


static void DefineCconfiguration () 
{ 
IConfigurationBuilder configBuilder = new ConfigurationBuilder{() 
.SetBasePath (Directory.GetCurrentDirectory()) 
.AddJsonFile ("appsettings.j]son™"™); 
Configuration = confijgBullder.Build(); 
} 


Public static IConfiguration Configuration { get; set; } 
配置 文件 指定 GreetingService 配置 的 From 设置 (配置 文件 DIWithConfiguration/appsettings.json): 
{ 


"GreetingService"™: { 
"From": "Matthias™ 
} 
} 


注意 : 
.NET 配置 详 见 第 30 章 。 


ServiceCollection 的 配置 与 以 前 一 样 。 还 需要 指定 IOptions 接口 。 不 同 的 是 ，AddGreetingService 扩展 方法 
的 新 版 本 传递 了 IConfiguration 值 。 这 可 以 通过 访问 Configuration 属性 来 完成 ， 该 属性 以 前 定义 为 读 取 
GreetingService 部 分 ， 它 传递 包含 该 部 分 的 值 (代码 文件 DIWithConfiguration/Program.cs): 


static ServiceProvider ReglsterServices() 

{ 
Var SeErvVvices = new ServiceCollection(); 
Services.Addoptions (}); 
Services.AddSingleton<IGreetingService, GreetingService>(); 
Services.LAddGreetingServicel 

Configuration.GetSection(" "GreetingService"))}).; 

services.AddTransient<HomeController> (); 
return services.BulilldServiceProvidert(); 
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在 注册 服务 之 前 ， 需 要 指定 配置 。 这 在 Main0 方 法 中 完成 ， 如 下 所 示 。 运 行 应 用 程序 时 ， 它 的 行为 就 像 以 
前 一 样 ， 但 是 配置 来 自 一 个 文件 : 


static void Mainil) 


{ 


DefineConfiguration().; 

Var container = RegisterServices(}),; 

Var controller = contaljner.GetServyvice<HomeController>({); 
string result = controller.Hello("Katharina™.); 

Console .WriteLine (resulty).; 


20.6 ”创建 平台 独立 性 


依赖 注入 也 可 在 平台 独立 的 库 中 使 用 特定 于 平台 的 特性 。 例 如， 可 以 创建 一 个 用 于 WPF、UWP 和 Xamarin 
应 用 程序 的 .NET 标准 库 ， 并 将 调用 转换 为 特定 于 平台 的 API。 调 用 Web API 可 以 实现 ， 因 此 它 是 一 个 完全 独立 
的 平台 。 如 打开 消息 对 话 框 这 样 简单 的 事情 ， 是 特定 于 平台 的 。 


注意 : 


MVVM 模式 详 见 第 34 章 . UWP 应 用 程序 的 编写 详 见 第 33~36 章 , 用 Xamarin 编写 应 用 程序 详 见 第 37 章 。 
下 一 个 示例 解决 方案 PlatformIndependenceSample 由 表 20-1 中 的 项 目 组 成 。 


DISampleLib 


WPFClient 


UWPClient 


XamarinClient 


注意 : 


表 20-1 
这 是 一 个 由 服务 、 服 务 协 定 和 视图 模型 组 成 的 .NET 标准 库 。 由 于 消息 服务 是 特定 于 平台 的 ， 因 此 对 于 此 服 
务 ， 只 在 库 中 定义 了 一 个 协定 (IMessageService) 
WPF 客户 端 应 用 程序 引用 了 DISampleLib， 并 包含 了 对 NuGet 包 Microsoft.Extensions.DependencyInjection 
的 引用 。 这 个 应 用 程序 使 用 XAML 定义 了 一 个 用 户 界 和 面 ， 并 利用 了 .NET 标准 库 中 的 视图 模型 和 服务 。 对 于 
接口 IMessageService， 服 务 WPFMessageService 在 WPF 项 目 中 实现 
UWP 客户 应 用 程序 类 似 于 WPF 应 用 程序 。 它 只 是 需要 一 个 不 同 的 IMessageService 实现 : 
UWPMessageService 
使 用 Xamarin 创建 Xamarin.Forms 应 用 程序 。 这 会 得 到 一 个 用 于 Android 的 项 目 、 一 个 用 于 ios 的 项 目 和 
一 个 用 于 UWP 的 项 目 。 公共 代码 (可 以 共享 用 户 界 面 ) 在 一 个 共享 项 目 中 。 对 于 每 个 Xamarin.Forms 项 目 ， 
需要 引用 .NET 标准 库 和 NuGet 包 Microsoft.Extensions.DependencyInjection。 在 共享 项 目 中 ， 用 户 界 面 的 
代码 ,DI 容器 的 设置 以 及 IMessageService 接口 的 实现 XamarinMessageService 在 UWP、Android 和 iPhone 
是 通用 的 


为 了 在 Visual Studio 中 使 用 Xamarin 项 目 模板 , 需要 使 用 Visual Studio 安装 程序 安装 通过 . 
负载 Mobile。 也 可 以 使 用 Wisual Studio for Mac。 为 了 成 功 地 编译 iOS， 还 需要 Mac。 


20.6.1 .NET 标准 库 

下 面 从 实现 服务 和 协定 的 .NET 标准 库 开 始 。 接 口 IMessageAsync 是 一 个 协定 。 该 协定 定义 了 
ShowMessageAsync 方法 ， 调 用 该 方法 时 应 该 显示 弹出 式 窗口 。 如 前 所 述 ， 在 .NET 标准 中 创建 这 些 对 话 框 是 不 
可 能 的 (代码 文件 PlatformIndependenceSample/DISampleLib/IMessageService.cs): 


Public interface IMessageService 


{ 


Task ShowMessageAsync (string message); 


} 


接口 IMessageService 在 类 ShowMessageViewModel 中 使 用 。 实 现 该 接口 的 对 象 将 通过 


第 20 章 信赖 注入 | 453 


ShowMessageViewModel 的 构造 为 数 注入 。 这 个 视图 模型 类 定义 了 从 特定 平台 的 用 户 界 面 中 触发 的 命令 
ShowMessageCommand。 在 执行 此 命令 时 ， 将 调用 IMessageService 的 ShowMessageAsync 方法 (代码 文件 
PlatformIndependenceSample/DISampleLib/ShowMessageViewModel.cs): 


Public class ShowMessageViewModel 
{ 
private readonly IMessageService messageServices 
Public ShowMessageVviewModel (IMessageService messageService) 
{ 
messageService = messageService ?3 
throw new ArgumentNullException (nameof (messageService))}).,; 


ShowMessageCommand = new RelayCommand (ShowMessage); 


} 
public ICommand ShowMessageCommand { get; } 


Public void ShowMessage() 
{ 
messageService.SshowMessageAsync ("A message from the view model"™"); 
} 
} 


20.6.2 WPF 应 用 程序 


使 用 该 库 的 第 一 个 客户 应 用 程序 是 WPF 应 用 程序 。WPFMessageService 类 实现 了 IMessageService 接口 。 
在 WPF 中 ， 可 以 使 用 MessageBox.Show 打开 对 话 框 。 此 类 不 提供 异步 功能 ， 因 此 ， 在 ShowMessageAsync 方 
法 中 返回 完成 的 任务 ， 以 履行 协定 (代码 文件 PlatformIndependenceSample/WPFClient/WPFMessageService.cs): 


PuUublic class WPFMessageService : IMessageService 
{ 
Public Task ShowMessageAsync (string message) 
{ 
MessageBox. Show (message)s 
return Task.completedTask; 
} 
} 


在 App 类 中 ,创建 了 DI 容器 ， 并 注册 了 服务 。WPFMessageService 类 映射 到 IMessageService 接口 上 (代码 
文件 PlatformIndependenceSample/WPFClient/App xaml.cs): 


protected override void Onstartup (StartupEventArgs e) 
{ 

base.onstartup (e); 

ReglsterServices ():; 


} 


Public void RegisterServices{() 

{ 
VaArIL SeEIrVices = new ServiceCollection(); 
Services.Addsingleton<IMessageService, WPFMessageService> (); 
services.AddTransient<ShowMessageViewModel>(); 
Container = services.BuildSserviceprovidert():; 


} 
Public IServiceProvider Container { get; private set; } 


在 用 户 界面 的 代码 隐藏 文件 中 , ViewModel 属性 是 通过 请 求 容器 中 的 ShowIMessageViewModel 来 设置 的 ( 代 
码 文 件 PlatformIndependenceSample/WPFClient/MainWindow.xaml.cs): 


public MalinWindow () 
{ 
InitializeComponent () ; 
ViewModel = (Application.Current as App) 
.Container .GetService<ShowMessageViewModel>().; 
this.Datacontext = this; 
} 


public ShowMessageViewModel ViewModel 1{ get; } 


在 XAML 代码 中 , Button 元 素 定 义 了 一 个 Command 属性 , 该 属性 绑 定 到 视图 模型 的 ShowMessageCommand 
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上 (XAML 文件 PlatformIndependenceSample/WPFClient/MainWindow.xaml): 


<Button Content="Click Me!™ 
Command="{Binding ViewModel .ShowMessageCommand, Mode=oneTime}"™ /> 


运行 应 用 程序 时 ， 单 击 按钮 将 调用 从 容器 中 请 求 的 视图 模型 中 的 命令 ， 而 命令 处 理 程序 将 调用 一 个 服务 ， 
该 服务 由 WPF 应 用 程序 实现 ， 以 显示 如 图 20-1 所 示 的 MessageBox。 


Ah message from the view-model 


Click Mel 


20-1 


20.63 UWP 应 用 程序 


UWP 应 用 程序 与 WPF 应 用 程序 非常 相似 , 但 是 有 一 些 重要 的 区 别 。 第 一 个 区 别 是 通过 UWPMessageService 
类 呈现 的 ; 要 显示 对 话 框 ， 使 用 MessageDialog 类 。 这 个 类 提供 了 异步 方法 ShowAsync( 代 码 文 件 
PlatformIndependenceSample/UWPClient/UWPMessageService.cs): 


Public class UWPMessageService : IMessageService 
{ 
public async Task ShowMessageAsync (string message) 三 > 
awalt new MessageDialog (message) .ShowAsync().; 


} 
DI 容器 的 填充 方式 相同 ， 但 UWPMessageSerivce 现在 用 来 
PlatformIndependenceSample/UWPClient/App.xaml.cs): 


Public void RegisterServices'{() 

{ 
Var SEIVices = new ServiceCollection().; 
services.hddSingleton<IMessageService, UWHPMessageService2>(); 
Services.AddTransient<ShowMessageViewModel> (); 
Container = services.BuildSserviceProvidert(}):; 


} 


要 行 IMessageService 接口 的 协定 (代码 文件 


Public IServiceProvider Container { get; private set; } 
请 求 容 器 中 视图 模型 的 方式 与 WPF 相同 (代码 文件 PlatformIndependenceSample/UWPClient /MainPage.xaml.cs): 


public MainPage () 
{ 
this.InitializeComponent () ; 
ViewModel = (Application.Current as App) 
-Container.GetService<ShowMessageVlewModel>(); 


} 

Public ShowMessageViewModel] ViewModel 1{ get; } 

与 UWP 的 男 一 个 区 别 是 使 用 编译 绑 定 ,但 这 与 依赖 注入 并 不 真正 相关 (XAML 文件 
PlatformIndependenceSample/UWPClient/MainPage.xam!l): 


<Button Content="Click Mel!"™ 
Command="{X:Bind ViewModel .ShowMessageCommand, Mode=OneTime}" /> 


运行 应 用 程序 时 ， 可 以 看 到 相同 的 行为 ， 但 使 用 的 是 UWP 用 户 界 面 ( 见 图 20-2)。 
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A message from the view-model 


Click Mel 


图 20-2 
20.6.4 Xamarin 应 用 程序 


使 用 Xamarin.Forms 应 用 程序 实现 相同 的 特性 时 ， 依 赖 注入 还 有 一 个 有 趣 的 方法 。 在 Xamarin.Forms 中 ， 
显示 消息 对 话 框 的 方法 需要 Page 对 象 ， 因 此 实现 IMessageService 的 XamarinMessageService 需要 配置 为 接收 
Page 对 象 。 不 可 能 更 改 IMessageService， 因 为 Page 类 型 无 法 用 于 NET 标准 库 。 通 过 XamarinMessageService 
类 来 使 用 额外 的 配置 属性 也 是 不 可 能 的 , 因为 这 个 类 是 在 视图 模型 类 型 中 实例 化 , 而 视图 模型 也 是 在 .NET 标准 
库 中 实现 的 。 一 个 好 方法 是 使 用 只 在 XamarinForms 应 用 程序 中 使 用 的 服务 协定 添加 男 一 个 服务 。 
XamarinMessageService 构造 函数 需要 一 个 实现 IPageService 接口 的 对 象 。 然 后 使 用 此 服务 检索 Page， 通 过 它 就 
可 以 调用 DisplayAlert 方法 (代码 文件 PlatformIndependenceSample/XamarinClient/XamarinMessageService.cs): 

class XamarinMessageService : IMessageService 


private readonly IPageService pageService; 
Public XamarinMessageService (IPageService pageService) 
{ 

pageService = pageServices 


} 


Public Task ShowMessageAsync (string message) 
{ 


return pageService.Page.DisplayAlert ("Message", message, "Close™}; 
} 
} 


协定 IPageService 只 是 根据 需要 为 对 话 框 定义 了 Page 属性 (代码 文件 PlatformIndependenceSample/ 
XamarinClient/IPageService.cs): 

Public interface IPageService 

{ 


Page Page {1 get; set; } 
} 


IPageService 的 实现 只 是 一 个 简单 自动 属性 (代码 文件 PlatformIndependenceSample/XamarinClient 
/PageService.cs): 


Public class PageService : IPageService 
| 

Public Page Page { get; set; } 
} 


容器 是 在 App 类 中 创建 的 。 这 次 ，XamarinMessageSerivce 映射 为 IMessageService 协定 的 实现 ， 也 需要 列 
出 IPageService (代码 文件 PlatformIndependenceSample/XamarinClient/App.xaml.cs): 

public App1() 

{ 


InitializeComponent (); 
RegisterServices(); 
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} 


第 中 部 分 .NET Core 与 Windows Runtime 


MainPage = new XamarincCclient .MainPage (}); 


Public void ReglisterServices() 


{ 


} 


Var SeEIVIiCes = new ServiceCollection(); 
services.hddSingleton<IPageService, PageService2>(); 
services.AddSsSingleton<IMessageService, XamarinMessageService>().; 
Services.AddTransient<ShowMessageViewModel>(); 

Container = services.BuildServiceProvidert(}).: 


Public IServiceProvider Container { get; private set; } 
在 代码 隐藏 文件 中 ，Page 属性 需要 与 PageService 相关 联 ( 代 码 文 件 PlatformIndependenceSample/ 
XamarinClient/MainPage.xaml.cs): 


public MainPage{() 


{ 


} 


InitializeComponent () ; 

IServiceProvider container = (Application.current as RMPP) -Container; 
ViewModel = container.GetService<ShowMessageViewModel>(); 
this.BindingContext = this; 
container.GetService<IPageService>() .Page = this; 


Public ShowMessageViewModel ViewModel { get; } 
XAML 代码 与 前 面 的 示例 一 样 (XAML 文件 PlatformIndependenceSample/XamarinClient/MainPage.xam]l): 


<Button Text="Click Mel!l™ 


运行 应 用 程序 时 ， 会 弹出 警告 消息 ， 如 图 20-3 所 示 。 


Command="{Binding ViewModel .ShowMessageCommand, Mode=OneWay}" /> 


llessage 


Message 


A message from the view-model 


图 20-3 


20.7 使 用 其 他 DI 容器 


Microsoft.Extensions.DependencyInjection 是 一 个 简单 的 DI 容器 ;许多 第 三 方 的 容器 都 提供 了 额外 的 功能 。 


例如 ， 


Autofac 允许 在 配置 文件 中 配置 服务 。 


ASPNET Core 使 用 Microsoft.Extensions.DependencyInjection， 除 此 之 外 ， 还 可 以 使 用 适配器 配置 它 一 一 使 
用 其 他 第 三 方 依赖 注入 容器 ， 如 Autofac、Rezolver、Scan、Neleus、CuteAnt、 fm、 Dryloc 、CuteAnt、Stashbox 
等 。 只 需要 以 NuGet 包 的 形式 添加 一 个 适配器 ， 根 据 容 器 的 需求 进行 初始 化 。 

示例 项 目 DIWithAutofac 使 用 和 之 前 的 实现 相同 的 HomeController 和 GreetingService, 但 它 使 用 Autofac 依 
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赖 注入 容器 适配器 。 为 此 ， 需 要 如 下 NuGet 包 和 名 称 空间 : 

包 

Autofac.Extensions.DependencyInjection 

Nicrosott.ExtensionsDependencyInjection 

名 称 空间 

Autotac 

Autofac.Extensions.DependencyInjection 

Microsott.Extensions.DependencyInjection 

System 

为 了 使 用 Autofac 容器 适配器 ， 服 务 应 与 以 前 一 样 ， 在 ServiceCollection 中 注册 。 现 在 不 用 创建 
IServiceProvider， 而 是 使 用 来 自 Autofac 的 ContainerBuilder。 可 以 使 用 调用 Populate 方法 的 ServiceCollection 来 
填充 该 构建 器 。 这 种 方法 可 以 给 这 个 容器 添加 数 百 个 ASPNET Core 服务 。 这 个 容器 还 支持 一 些 Register 方法 来 
添加 托管 服务 。Build 方法 现在 创建 一 个 容器 ， 并 使 用 IContainer 接口 返回 它 ( 代 码 文件 
DIWithAutoFac/Proeram.cs): 

static IContainer RegisterServices () 

Var services = new ServiceCollection(); 


services.Addsingleton<IGreetingService, GreetingsService>(); 
SeErvices.AddTransient<HomeController> (); 


Var builder = new ContainerBuilder().; 
builder.Populate (services).; 
return builder.Build().: 

} 


现在 可 以 使 用 Resolve 方法 来 解析 这 个 容器 中 的 服务 。 除 此 之 外 ， 不 需要 任何 改变 。HomeController 通过 
依赖 注入 接收 GreetingService( 代 码 文件 DIWithAutoFac/Program.cs): 


static void Maint{) 
{ 
UslIno (IContainer container = RegisterServices()) 
{ 
Var Controller = Gontainer.Resolve<HomeController>().; 
string result = controller.Hello ("Katharina™.); 
Console.WriteLine (result). 
} 
} 


20.8 ”小结 


本 章 介 绍 了 依赖 注入 ， 继 续 讨 论 了 使 用 微软 容器 Microsoft.Extensions.DependencyInjection 的 各 种 场景 ， 包 
括 通过 选项 的 配置 和 .NET Core 配置 。 还 讨论 了 如 何 通 过 特定 于 平台 的 特性 与 WPF、UWP、Xamarin， 为 不 同 
的 平台 使 用 依赖 注入 。 

在 本 书 的 几 个 章节 中 ,依赖 注入 具有 重要 的 作用 。 第 26 章 展示 了 如 何 使 用 依赖 注入 与 Entity Framework Core 
以 及 如 何 取代 内 置 功能 ,第 28 章 探 讨 了 如 何 将 依赖 注入 用 于 单元 测试 和 不 应 该 通过 单元 测试 进行 测试 的 模拟 功 
能 。 第 30 章 和 后 续 的 章节 介绍 如 何 使 用 依赖 注入 与 ASPNET Core， 如 何在 容器 中 注册 数 以 百 计 的 服务 。 第 34 
章 显 示 了 MVVM 模式 和 用 于 XAML 应 用 程序 的 其 他 模式 。 在 这 些 应 用 程序 中 ， 依 赖 注 入 是 一 个 重要 的 基础 。 

第 21 章 详细 讨论 Task 和 Parallel 类 的 并 行 编程 ， 以 帮助 在 操作 系统 中 使 用 多 个 核心 。 还 要 阐述 使 用 多 个 任 
务 时 出 现 的 问题 。 


2 


任务 和 并 行 编程 


本 草 要 点 

使 用 Parallel 类 

使 用 任务 

使 用 取消 架构 

使 用 数据 流 库 

使 用 计时 器 

理解 线程 问题 

使 用 lock 关键 字 

用 监视 器 同步 

用 互 斥 同步 

使 用 Semaphore 和 SemaphoreSlim 

使 用 ManualResetEvent、AutoResetEvent 和 CountdownEvent 
处 理 障碍 

用 ReaderWriterLockSlim 管理 读 取 器 和 写 入 器 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 Www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Tasks 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
® Parallel 
Task 
Cancellation 
DataFlow 
Timer 
WinAppTimer 
ThreadimgIssues 
SynchronizationSamples 
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se BaITIeISampjle 
® ReaderWriterLockSample 


21.1 概述 


使 用 多 线程 有 几 个 原因 。 假 设 从 应 用 程序 进行 网 络 调用 需要 一 定 的 时 间 。 我 们 不 希望 用 户 界面 停止 啊 应 ， 
让 用 户 一 直 等 待 ， 直 到 从 服务 器 返回 一 个 响应。 用户 可 以 同时 执行 其 他 一 些 操作 ， 或 者 甚至 取消 发 送 给 服务 器 
的 请 求 。 这 些 都 可 以 使 用 线程 来 实现 。 

对 于 所 有 需要 等 竺 的 操作 ， 例 如 ， 因 为 文件 、 数 据 库 或 网 络 访问 都 需要 一 定 的 时 间 ， 此 时 就 可 以 月 动 一 个 
新 线程 ， 同 时 完成 其 他 任务 。 即 使 是 处 理 密集 型 的 任务 ， 线 程 也 是 有 帮助 的 。 一 个 进程 的 多 个 线程 可 以 同时 运 
行 在 不 同 的 CPU 上 ， 或 多 核 CPU 的 不 同 内 核 上 。 

还 必须 注意 运行 多 线程 时 的 一 些 问 题 。 它 们 可 以 同时 运行 , 但 如 果 线 程 访问 相同 的 数据 ,就 很 容易 出 问题 。 
为 了 避免 出 问题 ， 必 须 实现 同步 机 制 |。 

.NET 提供 了 线程 的 一 个 抽象 机 制 : 任务 。 任 务 允 许 建 立 任 务 之 间 的 关系 ， 例 如 ， 第 一 个 任务 完成 时 ， 应 该 
继续 下 一 个 任务 。 也 可 以 建立 一 个 层次 结构 ， 其 中 包含 多 个 任务 。 

除了 使 用 任务 之 外 ， 还 可 以 使 用 Parallel 类 实现 并 行 活动 。 需 要 区 分 数据 并 行 (在 不 同 的 任务 之 间 同 时 处 理 
一 些 数据 ) 和 任务 并 行 性 (同时 执行 不 同 的 功能 )。 

在 创建 并 行程 序 时 ， 有 很 多 不 同 的 选择 。 应 该 使 用 适合 场景 的 最 简单 选项 。 本 章 首先 介绍 Parallel 类 ， 它 
提供 了 非常 简单 的 并 行 性 。 如 果 这 就 是 需要 的 类 ， 使 用 这 个 类 即 可 。 如 果 和 需要 更 多 的 控制 ， 比 如 需要 管理 任务 
之 间 的 关系 ， 或 定义 返回 任务 的 方法 ， 就 要 使 用 Task 类 。 

本 章 还 包括 数据 流 库 ， 如 果 需 要 基于 操作 的 编程 通过 管道 传送 数据 ， 这 可 能 是 最 简单 的 一 个 库 了 。 

如 果 需 要 更 多 地 控制 并 行 性 ， 如 设置 优先 级 ， 就 需要 使 用 Thread 类 。 


注意 : 
通过 关键 字 async 和 await 来 使 用 异步 方法 参见 第 15 章 。Parallel LINQ 提供 了 任务 并 行 性 的 一 种 变 体 ， 详 
见 第 12 章 。 


创建 一 个 并 发 执行 多 个 任务 的 程序 ， 可 能 导致 争 用 条 件 和 和 死 锁 。 需 要 注意 同步 技术 。 

要 避免 同步 问题 ， 最 好 不 要 在 线程 之 间 共 享 数据 。 当 然 ， 这 并 不 总 是 可 行 的 。 如 果 需 要 共 亩 数据 ， 就 必须 
使 用 同步 技术 ， 确 保 一 次 只 有 一 个 线程 访问 和 改变 共享 状态 。 如 果 不 注意 同步 ， 就 会 出 现 争 用 条 件 和 和 死 锁 。 一 
个 主要 问题 是 错误 会 不 时 地 发 生 。 如 果 CPU 核心 比较 多 ,错误 数量 就 会 增加 。 这 些 错误 通常 很 难 找 到 。 所 以 最 
好 从 一 开始 就 注意 同步 。 

使 用 多 个 任务 是 很 容易 的 ， 只 要 它们 不 访问 相同 的 变量 。 在 茶 种 程度 上 可 以 避免 这 种 情况 ， 但 有 时 ， 一 些 
数据 需要 共享 。 共 享 数据 时 ， 需 要 应 用 同步 技术 。 线 程 访问 相同 的 数据 ， 而 没有 进行 同步 ， 立 即 出 现 问题 是 比 
较 生 运 的 。 但 很 少 会 出 现 这 种 情况 。 本 章 讨论 了 争 用 条 件 和 和 死 锁 ， 以 及 如 何 应 用 同步 机 制 来 避免 它们 。 

.NET Framework 提供 了 同步 的 几 个 选项 。 同步 对 象 可 以 用 在 一 个 进程 中 或 跨 进程 中 。 可 以 使 用 它们 来 同步 
一 个 任务 或 多 个 任务 来 访问 一 个 资源 或 许多 资源 。 同 步 对 象 也 可 以 用 来 通知 完成 的 任务 。 本 章 介 绍 所 有 这 些 同 


注意 : 
尽 可 能 使 用 不 可 变 的 类 型 可 能 部 分 地 避免 同步 问题 。 在 不 可 变 的 数据 结构 中 ， 数 据 只 能 初始 化 ， 以 后 就 不 
能 更 改 了 。 所 以 这 些 类 型 不 需要 同步 。 


在 长 长 的 概述 之 后 ， 下 面 从 Parallel 类 开始 一 一 给 应 用 程序 添加 并 行 性 的 一 种 简单 方式 。 
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21.2 Parallel 类 


Parallel 类 是 对 线程 的 一 个 很 好 的 抽象 。 该 类 位 于 System.Threading.Tasks 名 称 空间 中 ， 提 供 了 数据 和 任务 
并 行 性 。 

Parallel 类 定义 了 并 行 的 for 和 foreach 的 静态 方法 。 对 于 C# 的 for 和 foreach 语句 而 言 ， 循 环 从 一 个 线程 中 
运行 。Parallel 类 使 用 多 个 任务 ， 因 此 使 用 多 个 线程 来 完成 这 个 作业 。 

Parallel For0 和 Parallel ForEach0 方 法 在 每 次 途 代 中 调用 相同 的 代码 ， 而 Parallel.Invoke0 方 法 允许 同时 调用 
不 同 的 方法 。Parallel.Invoke() 用 于 任务 并 行 性 ， 而 ParallelForEachO 用 于 数据 并 行 性 。 


21.2.1 使 用 Parallel.For() 方 法 循环 


Parallel For(0 方 法 类 似 于 C# 的 for 循环 语句 ， 也 是 多 次 执行 一 个 任务 。 使 用 Parallel For0 方 法 ， 可 以 并 行 运 
行 欠 代 。 友 代 的 顺序 没有 定义 。 
ParallelSamples 的 示例 代码 使 用 了 如 下 名 称 空间 : 
名 称 空间 
System 
System.Ling 
System.Threading 
System.Threading.Tasks 


注意 : 

这 个 示例 使 用 命令 行 参数 。 为 了 了 解 不 同 的 特性 ， 应 在 启动 示例 应 用 程序 时 传递 不 同 的 参数 ， 如 下 所 示 ， 
或 检查 Main( 方 法 。 在 Visual Studio 中 , 可 以 在 项 目 属性 的 Debug 选项 中 传递 命令 行 参数 。 使 用 dotnet 命令 行 ， 
传递 命令 行 参数 -p， 则 可 以 启动 命令 dotnet run -- - p。 


有 关 线 程 和 任务 的 信息 ， 下 面 的 Log 方法 把 线程 和 任务 标识 符 写 到 控制 台 ( 代 码 文件 ParallelSamples/ 
Program.cs): 
PuUublic static vold Log(string prefix) => 


Console .WriteLine($"{prefix}, task: {Task.CurrentId}, ™ + 
s"thread: {Thread.CurrentThread.ManagedThreadId}"); 


下 面 看 看 在 Parallel.For0 方 法 中 ， 前 两 个 参数 定义 了 循环 的 开头 和 结束 。 示 例 从 0 迭代 到 9。 第 3 个 参数 是 
一 个 Action<int> 委 托 。 整 数 参数 是 循环 的 友 代 次 数 ， 该 参数 被 传递 给 委托 引用 的 方法 。ParallelFor0 方 法 的 返 
回 类 型 是 ParallelLoopResult 结构 ， 它 提供 了 循环 是 否 结束 的 信息 。 

Public static void ParallelFor() 

ParallelLoopResult result = 

Parallel .For(0, 10, i => 
Log (3"S {1}"); 
Task.Delay (10) .Wait (}); 
0 [1}™")s 
Be le ee completed: {result.IsCcompleted}"); 

} 

在 Parallel.For0 的 方法 体 中 ， 把 索引 、 任 务 标识 符 和 线程 标识 符 写 入 控制 台中 。 从 输 出 可 以 看 出 ， 顺 序 是 
不 能 保证 的 。 如 果 再 次 运行 这 个 程序 ， 可 以 看 到 不 同 的 结果 。 程 序 这 次 的 运行 顺序 是 2-4-0-6-8， 有 9 个 任务 和 
6 个 线程 。 任 务 不 一 定 映射 到 一 个 线程 上 。 线 程 也 可 以 被 不 同 的 任务 重用 。 


号 2 task: 1, thread: 3 
3 4 task: 2, thread: 4 
3 0 task: 4, thread: 2 
3 6 task: 5, thread: 5 
3 8 task: 3, thread: 6 
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E 6 task: 5S5, thread: 5 
E 0 task: 4, thread: 之 
号 1 task: 4, thread: 2 
E 4 task: 2, thread: 4 
号 5 task: 8, thread: 4 
E 2 task: 1, thread: 3 
号 9 task: 9, thread: 3 
E 8 task: 3, thread: 6 
号 3 task: 了 thread: 8 
3 7 task: 6, thread: 35 
E 5 task: 8, thread: 4 
E 1 task: 4, thread: 2 
E 3 task: 1, thread: 8 
E 1 task: 6, thread: 5 
E 9 task: 9, thread: 3 


Is completed: True 
并 行 体 内 的 延迟 等 待 10 上 台 秒 , 会 有 更 好 的 机 会 来 创建 新 线程 。 如 果 删 除 这 行 代 码 ， 就 会 使 用 更 少 的 线程 和 
在 结果 中 还 可 以 看 到 ， 循 环 的 每 个 end-log 使 用 与 start-log 相同 的 线程 和 任务 。 使 用 TaskDelay0 和 WaitO 
方法 会 阻塞 当前 线程 ， 直 到 延迟 结束 。 

修改 前 面 的 示例 ， 现 在 使 用 await 关键 字 和 Task.Delay0 方 法 (代码 文件 ParallelSamples/Program.cs): 
Public static void PaIral1lelLEorWIthasyYyncec () 
ParallelLoopResult result = 

Parallel .For (0, 10, asvync 1 =»> 

Log(*"S {1}"); 

await Task.Delay (10).; 
es {1}"); 


Console.WriteLine($"1is completed: {result.Iscompleted}"); 
} 


其 结果 如 以 下 代码 片段 所 示 。 在 输出 中 可 以 看 到 ， 调 用 Thread.Delay0 方 法 后 ， 线 程 发 生 了 变化 。 例 如 ， 御 
环 迭 代 8 在 延迟 前 的 线程 ID 为 7， 在 延迟 后 的 线程 ID 为 5。 在 输出 中 还 可 以 看 到 ， 任 务 不 再 存在 ， 只 有 线程 
了 ， 而 且 这 里 重用 了 前 面 的 线程 。 另 一 个 重要 的 方面 是 ，Parallel 类 的 For0 方 法 并 没有 等 竺 延迟 ， 而 是 直接 完 
成 。Parallel 类 只 等 待 它 创 建 的 任务 ， 而 不 等 待 其 他 后 台 活 动 。 在 延迟 后 ， 也 有 可 能 完全 看 不 到 方法 的 输出 ， 出 
现 这 种 情况 的 原因 是 主线 程 ( 是 一 个 前 台 线 程 ) 结 束 ， 所 有 的 后 台 线 程 被 终止 。 下 一 章 将 讨论 前 台 线 程 和 后 台 线 
程 。 


号 0, task: 5, thread: 1 
3 8, task: 8, thread: 7 
3 6, task: 7, thread: 8 
号 4, task: 3, thread: & 
3 2, task: 6, thread: 3 
3 11, task: 17, thread: 8 
号 1, task: 5S, thread: 1 
3 53, task: 9, thread: 6 
号 9, task: 8, thread: 7 
3 3, task: 6, thread: 3 
Is completed: True 

E 2, task: , thread: 28 
E 0, task: , thread: 8 
E 8, task: , thread: 5 
E 6, task: , thread: 了 
E 4, task: , thread: 6 
E S55, task: , thread: 1 
E 1, task: , thread: 1 
E 1, task: , thread: & 
E 3, task: . thread: 5 
E 9, task: , thread: 28 


注意 : 
从 这 里 可 以 看 到 ， 虽 然 使 用 NET 和 C# 的 异步 功能 十 分 方便 ， 但 是 知道 后 台 发 生 了 什么 仍然 很 重要 ， 而 且 
必须 留意 一 些 问题 。 
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21.2.2 提前 中 断 Parallel.For 


也 可 以 提前 中 断 ParallelFor0 方 法 ， 而 不 是 完成 所 有 迭代。For0 方 法 的 一 个 重 载 版 本 接受 Action<int, 
ParallelLoopState> 类 型 的 第 3 个 参数 。 使 用 这 些 参 数 定义 一 个 方法 ， 就 可 以 调用 ParallelLoopState 的 Break0 或 
Stop0 方 法 ， 以 影响 循环 的 结果 。 

注意 ， 碗 代 的 顺序 没有 定义 (代码 文件 ParallelSamples/Program .cs)。 


Public static void StopParallelForEarly () 
{ 
ParallelLoopResult result = 
Parallel.For(10, 40, (int i, ParallelLoopSsState Pls) => 
{ 
Log ($"S {1}"); 
if (i > 12) 
{ 
Pls.Break(); 
Log {($"break now... {1}"); 
} 
Task.Delay (10) .Wait (}); 
Log (9"E {1}")s; 
1); 


Fr 
Console .WriteLine{($"Is completed: {result.IsCompleted}"); 
Console .WriteLine($"lowest break iteration: {result.LowestBreakIteration}"™); 


} 

应 用 程序 的 这 次 运行 说 明 ,， 连 代 在 值 大 于 12 时 中 断 , 但 其 他 任务 可 以 同时 运行 ， 有 其 他 值 的 任务 也 可 以 运 
行 。 在 中 断 前 开始 的 所 有 任务 都 可 以 继续 运行 ， 直 到 结束 。 利 用 LowestBreakIteration 属性 ， 可 以 忽略 其 他 不 需 
要 的 任务 的 结果 。 


3 31, task: 6, thread: 8 
3 li1, task: 7, thread: 3 
3 10, task: 5, thread: 1 
3 24, task: 8, thread: 6 
break now 24, task: 8, thread: 6 
3 38, task: 3939, thread: 7 
break now 38, task: 9, thread: 7 
break now 31, task: 6, thread: 
break now 17, task: 7, thread: 35 


CD 


E 1i1, task: 17, thread: 3 
E 10, task: 5, thread: 1 
3 1l1, task: 5, thread: 1 
E 38, task: 9, thread: 7 
E 24, task: 8, thread: 6 
E 31, task: 6, thread: 8 
E 1l1, task: 5, thread: 1 
3 lz2, task: 号 thread: 1 
E lz2, task: 5, thread: 1 
3 13, task: 5353, thread: 1 
break now 13, task: 5, thread: 1 
E 13, task: 5, thread: 1 


Is completed: False 
lowest break iteration: 13 


21.2.3 ”Parallel.For() 方 法 的 初始 化 


Parallel For0 方 法 使 用 几 个 线程 来 执行 循环 。 如 果 需 要 对 每 个 线程 进行 初始 化 ， 就 可 以 使 用 
Parallel.For<TLocal>0 方 法 。 除 了 from 和 to 对 应 的 值 之 外 ，For0 方 法 的 泛 型 版 本 还 接受 3 个 委托 参数 。 第 一 个 
参数 的 类 型 是 Func<TLocal>。 因 为 这 里 的 例子 对 于 TLocal 使 用 字符 串 ， 所 以 该 方法 需要 定义 为 Func<string>， 
即 返回 string 的 方法 。 这 个 方法 仅 对 用 于 执行 运 代 的 每 个 线程 调用 一 次 。 

第 二 个 委托 参数 为 循环 体 定 义 了 委托 。 在 示例 中 ， 该 参数 的 类 型 是 Func<int，ParallelLoopState，string ， 
string>。 其 中 第 一 个 参数 是 循环 迁 代 ， 第 二 个 参数 ParallelLoopState 允许 停止 循环 ， 如 前 所 述 。 循 环 体 方 法 通过 
第 3 个 参数 接收 从 init 方法 返回 的 值 ， 循 环 体 方法 还 需要 返回 一 个 值 ， 其 类 型 是 用 泛 型 For 参数 定义 的 。 

For0 方 法 的 最 后 一 个 参数 指定 一 个 委托 Action<TLocal>; 在 该 示例 中 ， 接 收 一 个 字符 串 。 这 个 方法 仅 对 于 
每 个 线程 调用 一 次 ， 这 是 一 个 线程 退出 方法 (代码 文件 ParallelSamples/Program.cs)。 


Public static void ParallelForWithIinit() 
{ 
Parallel.For<string> (0, 10, () => 
{ 
/i invoked once for each thread 
Log ($"1init thread™); 
return $"t{Thread.CurrentThread.ManagedThreadId}™"; 
}， 
(i, pls, strl)} => 


// invoked for each member 
Log (S$"body 1 {1} strl {strl}"); 
Task.Delay (10) .Wait (); 
return S$"™i {i}"™; 
}, 
{strli)} 一 > 
{ 
// final action on each thread 
Log {($"finally {strl}"); 
7 
} 


运行 一 次 这 个 程序 的 结果 如 下 : 


init thread task: 7, thread: 6 
init thread task: 6, thread: 5 
body i: 4 strl: 七 6 task: 7, thread: 
body 1i: 2 strl: 七 5 task: 6, thread: 
init thread task: 5, thread: 1 
body 1: 0 strl: 七 1 task: 5, thread: 1 
init thread task: 9, thread: 8 

body 1: 8 strl: t8 task: 9, thread: 8 
init thread task: 8, thread: 7 

body 1: 6 strl: 七 7 task: 8, thread: 7 
body 1: 1 strl: 1 0 task: 5, thread: 1 
finally 1 2 task: 6, thread: 5 

init thread task: 16, thread: 5 
finally 1 8 task: 9, thread: 8 

init thread task: 17, thread: 8 

body i: 3 strl: 七 8 task: 17, thread: 8 
finally 1 6 task: 8, thread: 7 

init thread task: 18, thread: 7 

body 1: 7 strl: 七 7 task: 18, thread: 7 
finally 1 4 task: 71, thread: 6 

init thread task: 15, thread: 10 

body 1: 3 Strl: 七 10 task: 15, thread: 10 


Nn 


body 1: 5 strl: 七 5 task: 1é6, thread: 5 
finally 1 1 task: 5, thread: 1 

finally 1 5 task: 16, thread: 5 
finally 1 3 task: 15, thread: 10 
finally 1 7 task: 18, thread: 7 
finally 1 9 task: 11, thread: 8 
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输出 显示 ， 为 每 个 线程 只 调用 一 次 init0 方 法 ; 循环 体 从 初始 化 中 接收 第 一 个 字符 串 ， 并 用 相同 的 线程 将 这 
个 字符 串 传 递 到 下 一 个 迭代 体 。 最 后 ， 为 每 个 线程 调用 一 次 最 后 一 个 动作 ， 从 每 个 体 中 接收 最 后 的 结果 。 


通过 这 个 功能 ， 这 个 方法 完美 地 累加 了 大 量 数据 集合 的 结果 。 
21.2.4 使 用 Parallel.ForEach() 方 法 循环 


Parallel.ForEach( 方 法 裔 历 实现 了 IEnumerable 的 集合 ， 其 方式 类 似 于 foreach 语句 , 但 以 异步 方式 遍历 。 这 


里 也 没有 确定 裔 历 顺 序 ( 代 码 文件 ParallelSamples/Program.cs)。 


public static void ParallelForEach () 
{ 
string[] data = {"zero™, "one™, "two", "three™"., "four™"., "five"™, 
"SX", "Seven™", "eight", "nine™, "ten™.", "eleven™", "twelve™}; 
ParallelLoopResult result = 
Parallel .ForEach<string> (data, 号 三 六 
{ 
Console .WriteLine (s}):; 


}); 
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如 果 需 要 中 断 循环 ， 就 可 以 使 用 ForEach0 方 法 的 重 载 版 本 和 ParallelLoopState 参数 。 其 方式 与 前 面 的 For0 
方法 相同 。ForEach0 方 法 的 一 个 重 载 版 本 也 可 以 用 于 访问 索引 器 ， 从 而 获得 运 代 次 数 ， 如 下 所 示 : 
Parallel .ForEach<string> (data, (s, pls, 1) => 


Console .WriteLine($"{s} {1}"™); 


21.2.5 通过 Parallel.Invoke() 方 法 调用 多 个 方法 


如 果 多 个 任务 将 并 行 运 行 ， 就 可 以 使 用 Parallel.Invoke0 方 法 ， 它 提 供 了 任务 并 行 性 模式 。 Parallel.Invoke() 
方法 允许 传递 一 个 Action 委托 的 数组 ,在 其 中 可 以 指定 将 运行 的 方法 .示例 代码 传递 了 要 并 行 调用 的 Foo0 和 Bar0 
方法 (代码 文件 ParallelSamples/Program.cs): 

public static void ParallelInvoke () 


{ 


Parallel .TInvoke (Foo, Bar).:; 
Public static volid Foo() => 
Console .WriteLine ("foo™).: 


Public static void Bar() 三 > 
Console .WriteLine ("bar™); 


Parallel 类 使 用 起 来 十 分 方便 ， 而 且 既 可 以 用 于 任务 ， 又 可 以 用 于 数据 并 行 性 。 如 果 需 要 更 细致 的 控制 ， 
并 且 不 想 等 到 Parallel 类 结束 后 再 开始 动作 ， 就 可 以 使 用 Task 类 。 当 然 ， 结 合 使 用 Task 类 和 Parallel 类 也 是 
可 以 的 。 


21.3 ”任务 


为 了 更 好 地 控制 并 行 操作 ， 可 以 使 用 System.Threading.Tasks 名 称 空间 中 的 Task 类 。 任 务 表 示 将 完成 的 某 
个 工作 单元 。 这 个 工作 单元 可 以 在 单独 的 线程 中 运行 ,也 可 以 以 同步 方式 局 动 一 个 任务 ， 这 需要 等 待 主 调 线程 。 
使 用 任务 不 仅 可 以 获得 一 个 抽象 层 ， 还 可 以 对 底层 线程 进行 很 多 控制 。 

在 安排 需要 完成 的 工作 时 ， 任 务 提供 了 非常 大 的 灵活 性 。 例 如 ， 可 以 定义 连续 的 工作 一 一 在 一 个 任务 完成 
后 该 执行 什么 工作 。 这 可 以 根据 任务 成 功 与 否 来 区 分 。 男 外 ， 还 可 以 在 层次 结构 中 安排 任务 。 例 如 ， 父 任务 可 
以 创建 新 的 子 任务 。 这 可 以 创建 一 种 依赖 关系 ， 这 样 ， 取 消 父 任务 ， 也 会 取消 其 子 任务 。 


21.3.1 ”启动 任务 


要 启动 任务 ， 可 以 使 用 TaskFactory 类 或 Task 类 的 构造 函数 和 Start0 方 法 。Task 类 的 构造 函数 在 创建 任务 
上 提供 的 灵活 性 较 大 。 
TaskSamples 的 示例 代码 使 用 如 下 名 称 空间 : 
名 称 空间 
System 
System.Linqg 
System.Threading 
System.Threading.Tasks 
在 启动 任务 时 ， 会 创建 Task 类 的 一 个 实例 ， 利 用 Action 或 Action<object> 委 托 (不 带 参 数 或 带 一 个 object 
参数 )， 可 以 指定 将 运行 的 代码 。 下 面 定义 的 方法 TaskMethod 带 一 个 参数 。 在 实现 代码 中 ， 调 用 Log 方法 ， 把 
任务 的 ID 和 线程 的 了 D 写 入 控制 人 台中， 并 且 如 果 线 程 来 自 一 个 线程 池 ， 或 者 线程 是 一 个 后 台 线 程 ， 也 要 写 入 相 
关 信 息 。 把 多 条 消息 写 入 控制 台 的 操作 是 使 用 lock 关键 字 和 s_ logLock 同步 对 象 进行 同步 的 。 这 样 ， 就 可 以 并 
行 调用 Log， 而 且 多 族 写 入 控制 台 的 操作 也 不 会 彼此 交叉 。 否 则 ，title 可 能 由 一 个 任务 写 入 ， 而 线程 信息 由 男 


一 个 任务 写 入 (代码 文件 TaskSamples/Program.cs): 


Public static void TaskMethod (object o) 
{ 

Log (02 .ToString()); 
} 


private static object s logLock = new ob]ect () : 
public static void Logl(string title) 
{ 
lock ({s logLock) 
{ 
Console.WriteLine (title); 
Console.WriteLine($"Task id: {Task.CurrentId?.ToString{() 22 "no task"™}, "+ 
s"thread: {Thread.currentThread.ManagedThreadId}"); 
Console.WriteLine($"1is pooled thread: ™ + 
s"{Thread.currentThread.IsThreadPoolThread}"™"); 
Console.WriteLine($"is background thread: ™ 十 
s"{Thread.currentThread.IsBackground}"); 
Console.WriteLine(); 
} 
} 


接 下 来 的 几 小 节 描 述 了 月 动 新 任务 的 不 同方 法 。 
1. 使 用 线程 池 的 任务 


在 本 节 中 ， 可 以 看 到 月 动 使 用 了 线程 池 中 线程 的 任务 的 不 同方 式 。 线 程 池 提供 了 一 个 后 台 线 程 的 池 。 线 程 
池 独 目 管 理 线程 ， 根 据 需 要 增加 或 减少 线程 池 中 的 线程 数 。 线 程 池 中 的 线程 用 于 实现 一 些 操作 ， 之 后 仍然 返回 
线程 池 中 。 

创建 任务 的 第 一 种 方式 是 使 用 实例 化 的 TaskFactory 类 ， 在 其 中 把 TaskMethod 方法 传递 给 StartNew 方法 ， 
就 会 立即 局 动 任务 。 第 二 种 方式 是 使 用 Task 类 的 静态 属性 Factory 来 访问 TaskFactory, 以 及 调用 StartNew0 方 法 。 
它 与 第 一 种 方式 很 类 似 ， 也 使 用 了 工厂 , 但 是 对 工厂 创建 的 控制 则 没有 那么 全 面 。 第 三 种 方式 是 使 用 Task 类 的 
构造 函数 。 实 例 化 Task 对 象 时 ， 任 务 不 会 立即 运行 ， 而 是 指定 Created 状态 。 接 着 调用 Task 类 的 Start0 方 法 ， 
来 启动 任务 。 第 四 种 方式 调用 Task 类 的 Run 方法 ， 立 即 局 动 任务 。Run 方法 没有 可 以 传递 Action<object> 委 托 
的 重 载 版 本 ， 但 是 通过 传递 Action 类 型 的 lambda 表达 式 并 在 其 实现 中 使 用 参数 ， 可 以 模拟 这 种 行为 (代码 文件 
TaskSamples/Proeram.cs)。 


Public void TasksUsingThreadPool () 

{ 
var tf = new TaskFactory().:; 
Task tl1 = tf.StartNew (TaskMethod, "using a task factory"); 
Task t2 = Task.Factory.StartNew (TaskMethod, "factory via a task"),; 
var t3 = new Task (TaskMethod, "using a task constructor and Start"). 
t3.SsStart():; 
Task t4 = Task.Run(() => TaskMethod("using the Run method")).; 

} 


这 些 版 本 返回 的 输出 如 下 所 示 。 它 们 都 创建 一 个 新 任务 ， 并 使 用 线程 池 中 的 一 个 线程 : 


USing a task factory 

Task id: 1, thread: 4 

is pooled thread: True 

is background thread: True 


factory via a task 

Task id: 2, thread: 3 

is pooled thread: True 

is background thread: True 


USing a task constructor and Start 
Task id: 3, thread: 5 

is pooled thread: True 

is background thread: True 


usSing the Run method 

Task id: 4, thread: 6 

is pooled thread: True 

LS background thread: True 
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使 用 Task 构造 函数 和 TaskFactory 的 StartNew0 方 法 时 ,可 以 传递 TaskCreationOptions 枚 举 中 的 值 。 利 用 这 
个 创建 选项 ， 可 以 改变 任务 的 行为 ， 如 接 下 来 的 小 节 所 示 。 
2. 同步 任务 
任务 不 一 定 要 使 用 线程 池 中 的 线程 ， 也 可 以 使 用 其 他 线程 。 任 务 也 可 以 同步 运行 ， 以 相同 的 线程 作为 
主 调 线程 。 下 面 的 代码 段 使 用 了 Task 类 的 RunSynchronously0 方 法 (代码 文件 TaskSamples/Program.cs): 
private static void RunSsynchronousTask() 
TaskMethod ("just the main thread™); 
var tl = new Task (TaskMethod, "run SYnmCc") : 


tl .RunSynchronously().,; 
} 


这 里 ，TaskMethod0 方 法 首先 在 主线 程 上 直接 调用 ， 然 后 在 新 创建 的 Task 上 调用 。 从 如 下 所 示 的 控制 台 输 
出 可 以 看 到 ， 主 线程 没有 任务 态 ， 也 不 是 线程 池 中 的 线程 。 调 用 RunSynchronously0 方 法 时 ， 会 使 用 相同 的 线 
程 作 为 主 调 线程 ， 但 是 如 果 以 前 没有 创建 任务 ， 就 会 创建 一 个 任务 : 

Just the main thread 

Task id: no task, thread: 2 

is pooled thread: False 

is background thread: False 

run sync 

Task 1d: 1, thread: 2 


is pooled thread: False 
is background thread: False 


3. 使 用 单独 线程 的 任务 

如 果 任 务 的 代码 将 长 时 间 运 行 ， 就 应 该 使 用 TaskCreationOptions.LongRunning 告诉 任务 调度 器 创建 一 个 新 
线程 ， 而 不 是 使 用 线程 池 中 的 线程 。 此 时 ， 线 程 可 以 不 由 线程 池 管 理 。 当 线程 来 和 目 线 程 池 时 ， 任 务 调度 器 可 以 
决定 等 竺 已 经 运行 的 任务 完成 ， 然 后 使 用 这 个 线程 ， 而 不 是 在 线程 池 中 创建 一 个 新 线程 。 对 于 长 时 间 运 行 的 线 
程 ， 任 务 调度 器 会 立即 知道 等 竺 它们 完成 没有 意义 。 下 面 的 代码 片段 创建 了 一 个 长 时 间 运 行 的 任务 (代码 文件 
TaskKkSamples/Program.cs): 

private static void LongRunningTask 1() 

var tl = new Task (TaskMethod, "long running", 
TaskCreationOptions .LongRunning); 


tl1.SsStarti(}); 
} 


实际 上 ， 使 用 TaskCreationOptions.LongRunning 选项 时 ， 不 会 使 用 线程 池 中 的 线程 ， 而 是 创建 一 个 新 线程 : 
ee > 1 


1is pooled thread: False 
is background thread: True 


21.3.2 ”Future 一 一 任务 的 结果 


当 任务 结束 时 ， 它 可 以 把 一 些 有 用 的 状态 信息 写 到 共享 对 象 中 。 这 个 共享 对 象 必须 是 线程 安全 的 。 另 一 个 
选项 是 使 用 返回 某 个 结果 的 任务 。 这 种 任务 也 称 为 future, 因为 它 在 将 来 返回 一 个 结果 。 早期 版 本 的 Task Parallel 
Library(TPL) 的 类 名 也 称 为 Future， 现 在 它 是 Task 类 的 一 个 泛 型 版 本 。 使 用 这 个 类 时 ， 可 以 定义 任务 返回 的 结 
果 的 类 型 。 

由 任务 调用 返回 结果 的 方法 可 以 声明 为 任何 返回 类 型 。 下面 的 示例 方法 TaskWithResult0 利 用 一 个 元 组 返回 
两 个 int 值 。 该 方法 的 输入 可 以 是 void 或 object 类 型 ， 如 下 所 示 ( 代 码 文 件 TaskSamples/Program.cs): 

二 static (int Result, int Remainder) TaskWithResult (object division) 


(int , int vy) = ((int x, int vy}))division; 
int result = xXx/ Yi 
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int remainder = X 和 yY; 
Console.WriteLine ("task creates a result...™"™).: 
return (result, remainder).; 


注意 : 
元 组 允许 把 多 个 值 组 合 为 一 个 ， 参 见 第 13 章 。 


当 定 义 一 个 调用 TaskWithResult0 方 法 的 任务 时 ， 要 使 用 泛 型 类 Task<TResult>。 泛 型 参数 定义 了 返回 类 型 。 
通过 构造 函数 ， 把 这 个 方法 传递 给 Func 委托 ， 第 二 个 参数 定义 了 输入 值 。 因 为 这 个 任务 在 object 参数 中 需要 两 
个 输入 值 ， 所 以 还 创建 了 一 个 元 组 。 接 着 启动 该 任务 。Task 实例 tl 块 的 Result 属性 被 禁用 ， 并 一 直 等 到 该 任务 
完成 。 任 务 完 成 后 ，Result 属性 包含 任务 的 结果 。 


Public static vold TaskWithResultDemo() 
{ 
Var 七 = new Task<(int Result, int Remainder)> (TaskWithResult, (8, 3)); 
tl1.SsStart(); 
Console.WriteLine (七 .Result) : 
七 1 .Wait()s; 
Console.WriteLine (SmTESULL from task: {tl1.Result.Result} ™ + 
s"{t1] .Result.Remainder}").: 
} 


21.3.3 连续 的 任务 


通过 任务 ， 可 以 指定 在 任务 完成 后 ， 应 开始 运行 男 一 个 特定 任务 ， 例 如 ， 一 个 新 任务 使 用 前 一 个 任务 的 结 
果 ， 如 果 前 一 个 任务 失败 了 ， 这 个 任务 就 应 执行 一 些 清理 工作 。 

任务 处 理 程序 或 者 不 带 参 数 ， 或 者 带 一 个 对 象 参 数 ， 而 连续 处 理 程序 有 一 个 Task 类 型 的 参数 ， 这 里 可 以 访 
问 起 始 任务 的 相关 信息 (代码 文件 TaskSamples/Program.cs): 

private static void DoonFirst1() 


Console.WriteLine ($s$"doing some task {Task.CurrentId}").; 
Task.Delay (3000) .Wait (}); 
} 


private static void Doonsecond (Task t) 

{ 
Console.WriteLine ($s"task {t.Id} finished™}).:; 
Console.WriteLine(s$"this task id {Task.CurrentId}"™);: 
Console.WriteLine ("do Some cleanup"); 
Task.Delay (3000) .Wait (); 

} 


连续 任务 通过 在 任务 上 调用 ContinueWith0 方 法 来 定义 。 也 可 以 使 用 TaskFactory 类 来 定义 。 
tLOnContinueWith(DoOnSecond) 方 法 表示 ， 调 用 DoOnSecond0 方 法 的 新 任务 应 在 任务 tl 结束 时 立即 启动 。 在 一 
个 任务 结束 时 ， 可 以 局 动 多 个 任务 ， 连 续 任 务 也 可 以 有 另 一 个 连续 任务 ， 如 下 面 的 例子 所 示 ( 代 码 文件 
TaskSamples/Program.cs): 
public static void ContinuationTasks () 
Task tl1 = new Task (DooOnFirst}).; 
Task t2 = tl1.ContinueWith (DoOnSecond); 
Task t3 = tl1.ContinueWith (DoOnSecond) : 
Task t4 = t2.ContinueWith (DoOnSecond) : 


tl1 .Startr(y):; 
} 


无 论 前 一 个 任务 是 如 何 结 束 的 ， 前 面 的 连续 任务 总 是 在 前 一 个 任务 结束 时 启动。 使 用 
TaskContinuationOptions 枚 举 中 的 值 可 以 指定 ， 连 续 任 务 只 有 在 起 始 任务 成 功 (或 失败 ) 结 束 时 启动 。 一 些 可 能 的 
值 是 OnlyOnFaulted、NotOnFaulted、OQOnlyOnCanceled、NotOnCanceled 以 及 OnlyOnRanToCompletion。 


Task t5 = tl1.ContinueWith (DoOnError, TaskContinuationOptions.OnlyOnFaulted).; 
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注意 : 
使 用 第 15 章 介 绍 过 的 await 关键 字 时 ， 编 译 器 生成 的 代码 会 使 用 连续 任务 


21.3.4 任务 层次 结构 


利用 任务 连续 性 ， 可 以 在 一 个 任务 结束 后 启动 男 一 个 任务 。 任 务 也 可 以 构成 一 个 层次 结构 。 一 个 任务 启动 
一 个 新 任务 时 ， 就 启动 了 一 个 父 / 子 层次 结构 。 
下 面 的 代码 段 在 父 任 务 内 部 新 建 一 个 任务 对 象 并 启动 任 务 。 创 建 子 任务 的 代码 与 创建 父 任务 的 代码 相同 ， 
唯一 的 区 别 是 这 个 任务 从 另 一 个 任务 内 部 创建 (代码 文件 TaskSamples/Program.cs): 
Public static void ParentandchIla() 
> = new Task (ParentIlask).; 
Parent . Start() : 
Task.Delay (2000) .Wait 1() ; 
Console .WriteLine (parent.Sstatus); 
Task.Delay (4000) .Wait (); 


Console.WriteLine (parent.status); 


} 
private static void ParentTask() 
Console .WriteLine (S$"task id {Task.CcurrentId}"™).; 
var child = new Task (ChildTask).; 
Child.start().:; 
Task.Delay (1000) .Wait (); 


Console.WriteLine ("parent started child"™).; 


} 

private static void ChildTask{() 
Console .WriteLine ("child™"); 
Task.Delay (5000) .Wait (); 


Console .WriteLine ("child finished™}.: 


} 

如 果 父 任务 在 子 任务 之 前 结束 ， 父 任务 的 状态 就 显示 为 WaitingForChildrenToComplete。 所 有 的 子 任务 也 续 
束 时 ， 父 任务 的 状态 就 变 成 RanToCompletion。 当 然 ， 如 果 父 任务 用 TaskCreationOptionDetachedFromParent 创 
建 一 个 任务 时 ， 这 就 无 效 。 

取消 父 任务 ， 也 会 取消 子 任务 。 接 下 来 就 讨论 取消 架构 。 


21.3.5 ”从 方法 中 返回 任务 
返回 任务 和 结果 的 方法 声明 为 返回 Task<T>， 例如， 方法 返回 一 个 任务 和 字符 串 集 合 : 


Public Task<IEnumerable<string>> TaskMethodAsync () 

{ 

} 

创建 访问 网 络 或 数据 的 方法 通常 是 异步 的 , 这 样 , 就 可 以 使 用 任务 特性 来 处 理 结果 (例如 使 用 async 关键 字 ， 
参见 第 15 章 )。 如 果 有 同步 路 径 ， 或 者 需要 实现 一 个 用 同步 代码 定义 的 接口 ， 就 不 需要 为 了 结果 的 值 创 建 一 个 
任务 。Task 类 使 用 方法 FromResult0 创 建 已 完成 任务 的 结果 ， 该 任务 用 状态 RanToCompletion 表示 完成 : 


return Task.FromResult<IEnumerable<string>>( 
new List<string>() { "one™, "two™ }); 


21.3.6 ”等待 任务 

也 许 读者 学 习 过 Task 类 的 WhenAll0 和 WaitA10 方 法 ， 想 知道 它们 之 间 的 区 别 。 这 两 个 方法 都 等 待 传递 给 
它们 的 所 有 任务 的 完成 。WaitAll0 方 法 阻塞 调用 任务 ， 直 到 等 待 的 所 有 任务 完成 为 止 。WhenAll0 方 法 返回 一 个 
任务 ， 从 而 允许 使 用 async 关键 字 等 待 结果 ， 它 不 会 阻塞 等 待 的 任务 。 

在 等 竺 的 所 有 任务 都 完成 后 ，WhenAll0 和 WaitAll0 方 法 才 完 成 ， 而 使 用 WhenAny0 和 WaitAny0 方 法 ， 可 以 
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等 待 任务 列表 中 的 一 个 任务 完成 。 类 似 于 WhenAll0 和 WaitAl10 方 法 ，WaitAny0 方 法 会 阻塞 任务 的 调用 ， 而 
WhenAny0 返 回 可 以 等 待 的 任务 。 

前 面 几 个 示例 已 经 使 用 了 Task.Delay0 方 法 。 可 以 指定 这 个 方法 返回 的 任务 完成 前 要 等 待 的 毫秒 数 。 

如 果 将 释放 CPU， 从 而 允许 其 他 任务 运行 ， 就 可 以 调用 Task.Yield0 方 法 。 该 方法 释放 CPU， 让 其 他 任务 
运行 。 如 果 没 有 其 他 的 任务 等 待 运行 , 调用 Task Yield 的 任务 就 立即 继续 执行 。 否 则 ， 需 要 等 到 再 次 调度 CPU， 
以 调用 任务 。 


Value [Task 

如 果 方 法 有 时 是 异步 运行 的 ， 但 并 不 总 是 这 样 ，Task 类 可 能 有 一 些 不 需要 的 开销 。.NET 现在 提供 了 
ValueTask， 它 是 一 个 结构 ， 相 对 于 Task 类 ， 这 样 ValueTask 就 没有 堆 中 对 象 的 开销 了 。 通 常 调用 异步 方法 ， 例 
如 对 API 服务 器 或 数据 库 进 行 调用 ， 与 需要 完成 工作 的 时 间 相 比 ，Task 类 型 的 开销 可 以 忽略 。 然 而 ， 在 某 些 情 
况 下 ,不 能 忽略 开销 , 例如 , 方法 被 调用 数 干 次 时 , 很 少 真 正 需 要 通过 网 络 进 行 调用 。 在 这 个 场景 中 ，ValueTask 
变 得 非常 方便 。 

下 面 看 一 个 例子 。 方 法 GetTheRealData 模拟 通 稼 需要 很 长 时 间 的 方法 ， 在 网 络 或 数据 库 上 访问 数据 。 在 这 
里 ， 使 用 Enumerable 类 生成 示例 数据 。 随 着 时 间 的 推移 ， 检 索 数 据 ， 结 果 以 元 组 的 形式 返回 。 该 方法 返回 我 们 
常用 的 Task( 代 码 文 件 ValueTaskSample/Program.cs): 

public static Task<(IEnumerable<string> data, DateTime retrievedTime)> 

GetTheRealData() => 
Task.FromResult( 


(Enumerable.Range (0, 10) 
-Select (x => S$"item {x}") .AsEnumerable()}, DateTime .Now)); 


有 趣 的 部 分 现在 在 方法 GetSomeData 中 。 这 个 方法 声明 为 返回 一 个 ValueTask。 在 实现 中 ， 如 果 缓 存 的 数 
据 不 超过 5 秒 ， 则 首先 进行 检查 。 如 果 缓 存 的 数据 没有 变 旧 ， 就 直接 返回 缓存 的 数据 ， 并 传递 给 ValueTask 构 
造 函 数 。 这 并 不 需要 后 台 线 程 ， 数据 可 以 直接 返回 。 如 果 缓 存 较 老 ， 则 调用 GetTheRealData 方法 。 这 个 方法 需 
要 一 个 真正 的 任务 ， 并 且 可 能 会 出 现 一 些 延 返 (代码 文件 ValueTaskSample/Program.cs): 


private static DateTime retrieved; 
private static IEnumerable<string> cachedData; 
Public static async ValueTask<IEnumerable<string>> GetSomeDataasyYync (1) 
{ 
if ( retrieved >= DateTime.Now.AddSeconds (-5) ) 
{ 
Console.WriteLine{"data from the cache™).; 
return await new ValueTask<IEnumerable<string>>( cachedData); 
] 
Console.WriteLine ("data from the SETVLCETm) ; 
{ cachedData, retrieved) = await GetTheRealData()}); 
return cachedDatas 


} 


注意 : 
ValueTask 的 构造 函数 要 为 返回 的 数据 接受 类 型 TResult 或 Task<TResulf>， 来 提供 从 异步 运行 的 方法 中 返 
回 的 Task。 


Main0 方法 包括 一 个 循环 ， 在 每 次 迭代 之 后 ， 多 次 调用 GetSomeDataAsync0 方法 (代码 文件 
ValueTaskSample/Proeram.cs): 


static async Task Main(string[] args) 
for {int i = 0; i < 20; i++) 
IEnumerable<string> data = await GetSomeDataAsync (); 
awalit Task.Delay (1000); 
-Sy 


} 


运行 应 用 程序 时 ， 可 以 看 到 数据 从 缓存 中 返回 ， 并 且 在 缓存 失效 之 后 ， 在 再 次 使 用 缓存 之 前 访问 服务 。 


470 | 第 中 部 分 .NET Core 与 Windows Runtime 


data from the 
data from the 
data from the 
data from the 
data from the 
data from the 
data from the 
data from the 
data from the 


SErVvice 
cache 
cache 
Cache 
Cache 
SErVvice 
Cache 
cache 
Cache 


Cache 
SEeEIT1CEe 
cache 


data from the 
data from the 
data from the 


注意 ; 
与 ValueTask 相 比 ， 可 能 不 能 忽略 任务 的 开销 。 但是， 在 框架 中 拥有 这 个 核心 功能 ， 可 以 在 未 来 的 C# 版 本 
中 实现 异步 流 或 异步 操作 符 等 未 来 特性 。 


21.4 ”取消 架构 


.NET 包含 一 个 取消 架构 ， 人 允许 以 标准 方式 取消 长 时 间 运 行 的 任务 。 每 个 阻塞 调用 都 应 支持 这 种 机 制 。 当 然 
目前 并 不 是 所 有 阻塞 调用 都 实现 了 这 个 新 技术 ， 但 越 来 越 多 的 阻塞 调用 部 支持 它 。 已 经 提供 了 这 种 机 制 的 技术 
有 任务 、 并 发 集合 类 、 并 行 LINQ 和 几 种 同步 机 制 。 
取消 架构 基于 协作 行为 ， 它 不 是 强制 的 。 长 时 间 运 行 的 任务 会 检查 它 是 否 被 取消 ， 并 相应 地 返回 控制 权 。 
支持 取消 的 方法 接受 一 个 CancellationToken 参数 。 这 个 类 定义 了 IsCancellationRequested 属性 ， 其 中 长 时 间 
运行 的 操作 可 以 检查 它 是 否 应 终止 。 长 时 间 运 行 的 操作 检查 取消 的 其 他 方式 有 : 取消 标记 时 ， 使 用 标记 的 
WaitHandle 属性 , 或 者 使 用 Register0 方 法 .Register0) 方 法 接受 Action 和 ICancelableOperation 类 型 的 参数 .Action 
委托 引用 的 方法 在 取消 标记 时 调用 。 这 类 似 于 ICancelableOperation， 其 中 实现 这 个 接口 的 对 象 的 Cancel0 方 法 
在 执行 取消 操作 时 调用 。 
CancellationSamples 的 示例 代码 使 用 如 下 名 称 空间 : 
名 称 空间 
System 
System.Threading 
System.Threading.Tasks 


21.4.1 Parallel.For() 方 法 的 取消 


本 节 以 一 个 使 用 Parallel.For0 方 法 的 简单 例子 开始 。Parallel 类 提供 了 For0) 方 法 的 重 载 版 本 ， 在 重 载 版 本 中 ， 
可 以 传递 ParallelOptions 类 型 的 参数 。 使 用 ParallelOptions 类 型 ， 可 以 传递 一 个 CancellationToken 参数 。 
CancellationToken 参数 通过 创建 CancellationTokenSource 来 生成 。 由 于 CancellationTokenSource 实现 了 
ICancelableOperation 接口 ， 因 此 可 以 用 CancellationToken 注册 ， 并 人 允许 使 用 Cancel0 方 法 取消 操作 。 本 例 没 有 
直接 调用 Cancel0 方 法 ， 而 是 使 用 了 方法 CancelAfter0， 在 500 毫秒 后 取消 标记 。 

在 For0 循 环 的 实现 代码 内 部 ，Parallel 类 验证 CancellationToken 的 结果 ， 并 取消 操作 。 一 旦 取消 操作 ，For0 
方法 就 抛 出 一 个 OperationCanceledException 类 型 的 异常 ， 这 是 本 例 捕 获 的 异常 。 使 用 CancellationToken 可 以 注 
册 取 消 操作 时 的 信息 。 为 此 ， 需 要 调用 Register0 方 法 ， 并 传递 一 个 在 取消 操作 时 调用 的 委托 (代码 文件 
CancellationSamples/Proeram.cs)。 


Public static void CancelParallelFor() 
{ 
var cts = new CancellationTokenSource(}).; 
cts.Token.Register(()} => Console.WriteLine("*** token cancelled™)):; 
// send a cancel after 500 ms 
ctas.Cancelhfter (500).; 
try 
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{ 
ParallelLoopResult result = 
Parallel.For(0, 100, new ParallelOptions 


CancellationToken = cts.Token, 


}, 
到 ”一 六 
{ 
Console .WIIteLInme (55"1oopP {x} started™); 
int sum = 0; 
for (nt i = 0; 1 < 100; 工 ++) 
| 


Task.Delay (2) .Wait (); 
sum += 1i; 
} 
Console.WriteLine($"loop {x} finished™); 
1) 5 
} 
catch (OperationCanceledException ex) 
{ 
Console.WriteLine (ex.Message);} 
} 
} 


运行 应 用 程序 , 会 得 到 类 似 如 下 的 结果 , 第 0、50、25、75 和 1 次 迭代 都 启动 了 。 这 在 一 个 有 4 个 内 核 CPU 
的 系统 上 运行 。 通 过 取消 操作 ， 所 有 其 他 的 欠 代 操作 都 在 局 动 之 前 就 取消 了 。 局 动 的 欠 代 操作 允许 完成 ， 因 为 
取消 操作 总 是 以 协作 方式 进行 ， 以 避免 在 取消 迭代 操作 的 中 间 汇 漏 资源 。 


loop 0 started 

loop 50 started 
loop 25 started 
loop 715 started 
loop 1 started 

*## token cancelled 
loop 75 finished 
loop 50 finished 
loop 1 finished 
loop 0 finished 
loop 25 finished 
The operation was canceled. 


21.4.2 任务 的 取消 


同样 的 取消 模式 也 可 用 于 任务 。 首 先 ， 新 建 一 个 CancellationTokenSource。 如 果 仅 需要 一 个 取消 标记 ， 就 可 
以 通过 访问 Task.Factory.CancellationToken 以 使 用 默认 的 取消 标记 。 接 着 , 与 前 面 的 代码 类 似 ， 在 500 坚 秒 后 取 
消 任务 。 在 循环 中 执行 主要 工作 的 任务 通过 TaskFactory 对 象 接受 取消 标记 。 在 构造 函数 中 ， 把 取消 标记 赋予 
TaskFactory。 这 个 取消 标记 由 任务 用 于 检查 CancellationToken 的 CancellationRequested 属性 ， 以 确定 是 否 请 求 
了 取消 (代码 文件 CancellationSamples/Program.cs)。 


Public void CancelTask() 
{ 
var cts = new CancellationTokKkenSsSourcel().; 
cts.Token.Register(() => Console .WriteLine (六 太太 task cancelled™)).; 
/i send a cancel after 500 ms 
cts.CancelAfter (S00}; 
Task 七 = Task.Run(() => 
{ 
Console.WriteLine{("in task"™); 
for (int 1 = 0; 1 < 20:; 1++) 
{ 
Task.Delay (100) .Wait (); 
CancellationToken token = cts. Token,; 
1f (token.IsCancellationRecquested) 
{ 
Console.WriteLine ("cancelling was requested, "+ 
"cancelling from within the task™); 
token.ThrowlfCancellationRequested (}); 
break; 
} 
Console .WriteLine ("in loop"™); 
} 


Console.WriteLine{("task finished without cancellation™).; 
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}, cts.Token); 


try 
{ 
tl1 .Waitl(ly); 
} 
catch (AggregateException ex) 
| 
Console.WriteLine ($s$"exception: {ex.GetType() .Name}, {ex.Message}™"); 
foreach (Var innerException in ex.InnerExceptions) 
{ 
Console .WriteLine ($"jinner exception: {ex.InnerException.GetType()}," + 
$s"{ex. INNerException.Message}™),;} 
} 
} 
} 
运行 应 用 程序 ， 可 以 看 到 任务 启动 了 ， 运 行 了 几 个 循环 ， 并 获得 了 取消 请 求 。 之 后 取消 任务 ， 并 抛 出 
TaskCanceledException 异常 ， 它 是 从 方法 调用 ThrowlIfCancellationRequestedO 中 局 动 的 。 调 用 者 等 待 任务 时 ,会 
捕获 AggregateException 异常 ， 它 包含 内 部 异常 TaskCanceledException。 例如， 如 果 在 一 个 也 被 取消 的 任务 中 
运行 Parallel.For() 方 法 ， 这 就 可 以 用 于 取消 的 层次 结构 。 人 和 任务 的 最 终 状 态 是 Canceled。 
in task 
In loop 
in loop 
in loop 
Im loop 
太吉 元 task cancelled 
cancelling Was regquested, cancelling from within 七 he task 


excCeption: AggregateException, One or more errors occurred. 
inner exceptlon: TaskCanceledException, A task was canceled. 


21.5 ”数据 流 


Parallel 类 、Task 类 和 Parallel LINQ 为 数据 并 行 性 提供 了 很 多 帮助 。 但 是 ， 这 些 类 不 能 直接 文 持 数据 流 的 
处 理 ， 以 及 并 行 转换 数据 。 此 时 ， 需 要 使 用 Task Parallel Library Data Flow(TPL Data Flow)。 
数据 流 示例 的 代码 使 用 了 如 下 名 称 空间 : 
名 称 空间 
System 
System.IO 
System.Threading 
System.Threadine.Tasks 
System.Threading.Tasks.DataFlow 


21.5.1 使 用 动作 块 


TPL Data Flow 的 核心 是 数据 块 ， 这 些 数据 块 作为 提供 数据 的 源 或 者 接收 数据 的 目标 , 或 者 同时 作为 源 和 目 
标 。 下 面 看 一 个 简单 的 示例 ， 其 中 用 一 个 数据 块 来 接收 一 些 数据 并 把 数据 写 入 控制 台 。 下 面 的 代码 段 定 义 了 一 
个 ActionBlock， 它 接收 一 个 字符 串 ， 并 把 字符 串 中 的 信息 写 入 控制 台 。Main0 方 法 在 一 个 while 循 坏 中 读 取 用 户 
输入 ， 然 后 调用 Post0 方 法 把 读 入 的 所 有 字符 串 写 入 ActionBlock，Post0 方 法 把 一 项 传递 给 ActionBlock。 
ActionBlock 异步 处 理 消 息 ， 把 信息 写 入 控制 全 (代码 文件 SimpleDataFlowSample/Program.cs): 


static woid MalInr) 
{ 
Var processInput = new ActionBlock<string>(s 三 > 
{ 
Console.WriteLine($"user input: {s}"); 
}); 
bool exit = false; 
while (!exit) 
{ 


string Input = ReadLine (); 
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if (string.Compare (input, "exit", jgnoreCase: true) == 0) 
{ 
exit = true,; 
} 
全 三 全 
{ 
processInput.Post (InPUt) ; 
} 
} 
} 


21.5.2 ” 源 和 目标 数据 块 


以 前 示例 中 分 配给 ActionBlock 的 方法 执行 时 ，ActionBlock 会 使 用 一 个 任务 来 并 行 执 行 。 通 过 检查 任务 和 
线程 标识 从 ， 并 把 它们 写 入 控制 台 可 以 验证 这 一 点 。 每 个 块 都 实现 了 IDataflowBlock 接口 ， 该 接口 包含 了 返回 
一 个 Task 的 属性 Completion， 以 及 Complete0 和 Fault0 方 法 。 调 用 Complete0 方 法 后 ， 块 不 再 接受 任何 输入 ， 
也 不 再 产生 任何 输出 。 调 用 Fault0 方 法 则 把 块 放 入 失败 状态 。 

如 前 所 述 , 块 既 可 以 是 源 , 也 可 以 是 目标 , 还 可 以 同时 是 源 和 目标 。 在 示例 中 ，ActionBlock 是 一 个 目标 块 ， 
所 以 实现 了 ITargetBlock 接口 。ITargetBlock 派生 自 IDataflowBlock， 除 了 提供 IDataBlock 接口 的 成 员 以 外 ， 还 
定义 了 OfferMessage0 方 法 。OfferMessage0 发 送 一 条 由 块 处 理 的 消息 。Post 是 比 OfferMessage 更 方便 的 一 个 方 
法 ， 它 实现 为 IIargetBlock 接口 的 扩展 方法 。 示 例 应 用 程序 中 也 使 用 了 Post0 方 法 。 

ISourceBlock 接口 由 作为 数据 源 的 块 实现 。 除 了 IDataBlock 接口 的 成 员 以 外 ，ISourceBlock 还 提供 了 链接 
到 目标 块 以 及 处 理 消 息 的 方法 。 

BufferBlock 同时 作为 数据 源 和 数据 目标 ， 它 实现 了 ISourceBlock 和 ITargetBlock。 在 下 一 个 示例 中 ， 就 使 
用 这 个 BufferBlock 收发 消 恩 (代码 文件 SimpleDataFlowSample/Program.cs): 

Producer0 方 法 从 控制 台 读 取 字符 串 ， 并 通过 调用 Post0 方 法 把 字符 串 写 到 BufferBlock 中 : 


public static woid Producer () 


| 


bool exit = false; 
While (!exlit) 
{ 
string input = ReadLine(); 
if (string.Compare (input, "exit", ignoreCase: true) == 0) 
{ 
eXit = true; 
} 
else 
{ 
s buffer.Post (InpPut) :; 
} 
} 


Consumer0 方 法 在 一 个 循环 中 调用 ReceiveAsync0 方 法 来 接收 BufferBlock 中 的 数据 。ReceiveAsync 是 
ISourceBlock 接口 的 一 个 扩展 方法 : 


Public static async Task ConsumerAsync{() 
{ 


while (true) 


string data = await s buffer.RecelveAsync(); 
Console.WriteLine($"user input: {data}™); 
} 
} 


现在 ， 只 需要 启动 消息 的 产生 者 和 使 用 者 。 在 Main0 方 法 中 通过 两 个 独立 的 任务 完成 启动 操作 : 


static woild Maint{) 


{ 
Task tl1 = Task.Run{(() => Producer())}); 
Task t2 = Task.Run(async () => awalt ConsumerAsync ()); 
Task.WaitAll (tl, t2); 

} 


运行 应 用 程序 时 ， 产 生 者 从 控制 台 读 取 数据 ， 使 用 者 接收 数据 并 把 它们 写 入 控制 台 。 
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21.5.3 ”连接 块 


本 节 将 连接 多 个 块 ， 创 建 一 个 管道 。 首 先 ， 创 建 由 块 使 用 的 3 个 方法 。GetFileNames0) 方 法 接收 一 个 目录 路 
径 作为 参数 ， 得 到 以 .cs 为 扩展 名 的 文件 名 (代码 文件 DataFlowSample/Program_cs): 
Public static IEnumerable<string> GetFileNames (string path) 
{ 
foreach (var fileName in Directory.EnumerateFiles (path, "*.cs")) 
{ 
yield return fileName; 
} 
} 
LoadLines0 方 法 以 一 个 文件 名 列表 作为 参数 ， 得 到 文件 中 的 每 一 行 : 
Public static IEnumerable<string> LoadLines (IEnumerable<string> fileNames) 
{ 
foreach (var fileName in fileNames) 
{ 
using (FileSstream Stream = File.OpenRead (fileName)) 
{ 
Var reader = new StreamReader (stream); 
string line = null; 
While {({line = reader.ReadLine{(}} != null) 
{ 
/7 WriteLine(SnLoadILines {1Lneln”) ， 
yield return line; 
} 
} 
} 
} 


GetWords0 方 法 接收 一 个 lines 集合 作为 参数 ， 将 其 逐 行 分 割 ， 从 而 得 到 并 返回 一 个 单词 列表 : 


Public static IEnumerable<string> GetWords (IEnumerable<string> lines) 
{ 
foreach (var line in lines) 


{ 
string[] words = line.split({"” ", i, ES, ,0)s 
foreach (var word in words) 
{ 
if (!string.IsNullorEmpty (word)) 
ylield return word; 


} 
} 
} 


为 了 创建 管道 ，SetupPipeline0 方 法 创建 了 3 个 TransformBlock 对 象 。TransformBlock 是 一 个 源 和 目标 块 ， 
通过 使 用 委托 来 转换 源 。 第 一 个 TransformBlock 被 声明 为 将 一 个 字符 串 转 换 为 IEnumerable<string>。 这 种 转换 
是 通过 GetFileNames(0 方 法 完成 的 ，GetFileNames() 方 法 在 传递 给 第 一 个 块 的 构造 函数 的 lambda 表达 式 中 调用 。 
类 似 地 ， 接 下 来 的 两 个 TransformBlock 对 象 用 于 调用 LoadLines0 和 GetWords(0) 方 法 : 


Puplic static ITargetBlock<string> SetupPipeline{() 
{ 


Var fileNamesForPath = new TransformBlock<string, IEnumerable<string>>!( 
path => GetFileNames (path)})); 


Var lines = new TransformBlock<IEnumerable<string>, IEnumerable<string>>{ 
fileNames => LoadLines (fileNames)).:; 


Var Words = new TransformBlock<IEnumerable<string>, IEnumerable<string>>( 
lines2 => GetWords (lines2)); 


定义 的 最 后 一 个 块 是 ActionBlock。 这 个 块 只 是 一 个 用 于 接收 数据 的 目标 块 ， 前 面 已 经 用 过 : 


Var display = new ActionBlock<IEnumerable<string>>!{ 

Coll =¥ 
{ 

foreach (var SS in coll) 

{ 

Console .WriteLine (s):; 

} 

}) 5 
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最 后 ， 将 这 些 块 彼 此 连接 起 来 。fileNamesForPath 被 链接 到 lines 块 ， 其 结果 被 传递 给 lines 块 。lines 块 链接 
到 words 块 ，words 块 链 接 到 display 块 。 最 后 ， 返 回 用 于 局 动 绾 道 的 块 : 
fileNamesForPath.LinkTo(lines); 
lines.LinkTo (words).: 
words.LinkTo (display); 
return fileNamesForPath; 
} 
现在 ，Main0 方 法 只 需要 启动 管道 。 调 用 Post0 方 法 传递 目录 时 ， 管 道 就 会 启动， 并 最 终 将 单词 从 C# 源 代 
码 写 入 控制 台 。 这 里 可 以 发 出 多 个 局 动 管道 的 请 求 ， 传 递 多 个 目录 ， 并 行 执行 这 些 任务 : 


static void Maint{) 

{ 
var target = 和 
七 己 工 Ge 七 - POS 七 (" -") 7; 
Console.ReadLine (); 


} 

通过 对 TPL Data Flow 库 的 简单 介绍 ， 可 以 看 到 这 种 技术 的 主要 用 法 。 该 库 还 提供 了 其 他 许多 功能 ， 例 如 
以 不 同方 式 处 理 数据 的 不 同 块 。BroadcastBlock 允许 癌 多 个 目标 传递 输入 源 (例如 将 数据 写 入 一 个 文件 并 显示 该 
文件 ), JoinBlock 将 多 个 源 连 接 到 一 个 目标 , BatchBlock 将 输入 作为 数组 进行 批 处 理 。 使 用 DataflowBlockOptions 
选项 可 以 配置 块 ， 例 如 一 个 任务 中 可 以 处 理 的 最 大 项 数 ， 还 可 以 癌 其 传递 取消 标记 来 取消 管道 。 使 用 链接 技术 ， 
可 以 对 消息 进行 科 选 ， 只 传递 满足 指定 条 件 的 消息 。 


21.6 Timer 类 


使 用 计时 器 ， 可 以 重复 调用 方法 。 本 节 介 绍 两 个 计时 器 : System.Threading 名 称 空间 中 的 Timer 类 和 用 于 基 
于 XAML 应 用 程序 的 DispatcherTimer。 

使 用 System.Threading.Timer 类 , 可 以 把 要 调用 的 方法 作为 构造 函数 的 第 一 个 参数 传递 。 这 个 方法 必须 满足 
TimeCallback 委托 的 要 求 ， 该 委托 定义 一 个 void 返回 类 型 和 一 个 object 参数 。 通 过 构造 函数 的 第 二 个 参数 ， 可 
以 传递 任意 对 象 ， 用 回调 方法 中 的 object 参数 接收 对 应 的 对 象 。 例 如 ， 可 以 传递 Event 对 象 ， 向 调用 者 发 送信 
号 。 第 3 个 参数 指定 第 一 次 调用 回调 方法 时 的 时 间 段 。 最 后 一 个 参数 指定 回调 的 重复 时 间 间 隔 。 如 果 计 时 器 应 

只 触发 一 次 ， 就 把 第 4 个 参数 设置 为 值 -1。 

如 果 创 建 Timer 对 象 后 应 改变 时 间 间 隔 ， 就 可 以 用 Change0 方 法 传递 新 值 (代码 文件 
TimerSample/Proeram.cs): 

private static void ThreadingTimer () 


void TimeAction (object D) 三 > 
Console.WriteLine ($s$"System.Threading.Timer {DateTime.Now:T}"); 


using (var tl1 = new Timer (TimeAction, null, 
TimeSpan.FromSeconds (2), TimeSpan. FromSeconds ld 


Task.Delay (15000) .Wait(}); 
} 
} 


Windows.ULXaml 名 称 空间 (用 于 UWP 应 用 程序 ) 中 的 DispatcherTimer 是 一 个 基于 XAML 的 应 用 程序 的 计时 
器 ， 其 中 的 事件 处 理 程 序 在 UI 线程 中 调用 ， 因 此 可 以 直接 访问 用 户 界 面 元 素 。 
演示 DispatcherTimer 的 示例 应 用 程序 是 一 个 Windows 应 用 程序 ， 显 示 了 切换 每 一 秒 的 时 钟 指 针 。 下 面 的 
XAML 代码 定义 的 命令 允许 开始 和 停止 时 钟 (代码 文件 WinAppTimer/MainPage.xam]l): 
<Padge. TOoPAPDPBAar> 
<COMmMMmandBar ISOpen="True"> 
<AppBarButton Icon="Play™" Click="{xXx:Bind OnTimer}™" /> 
<AppBarButton Icon="Stop" Click="{x:Bind CnstopTimer}" /> 


</CommandBar> 
</Page. TopPAPpPBar> 
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时 钟 的 指针 使 用 形状 Line 定义 。 要 旋转 该 指针 ， 请 使 用 RotateTransform 元 素 : 


<Canvas 而 LIQth="300"” Height="300"> 
<Ellipse Width="10™" HeIght="10"” Fill="Red™" Canvas.Left="145" 
Canvas .Top="145" /> 
<Line Canvas.Left="150" Canvas.Top="150" Fill="Green" StrokeThickness="3" 
Stroke~—~"Blue™ Xl1="0"™" Yl1="0"™" X2="120" Y2="0"™ > 
<Line.RenderTransform> 
<RotateTransform CenterX="0" CenterY¥="0" Angle="270" x:Name="rotate™" /> 
</Line.RenderTransform> 
</Line> 
</Canvas> 


注意 : 

XAML 形状 参见 第 35 章 。 

DispatcherTimer 对 象 在 MainPage 类 中 创建 。 在 构造 函数 中 ， 处 理 程序 方法 分 配给 Tick 事件 ，Interval 指定 
为 1 秒 。 在 OnTimer 方法 中 局 动 计时 器 ， 该 万 法 在 用 户 单 击 CommandBar 中 的 Play 按钮 时 调用 (代码 文件 
WinAppTimer/MainPage.xaml.cs): 


private DispatcherTimer timer = new DispatcherTimer (); 
Public MainPage () 
{ 


this.InitializeComponent(); 
timer.Tick += OnTick; 


timer.Interval = TimeSpan.FromSsSeconds (1) ; 
} 
private void OnTimer () 
{ 
七 ImeT -Start() ; 
} 


private void OnTick (object sender, object e) 
{ 
double newAngle = rotate.Angle + 6s 
1If (newAngle >= 360) newAngle = 0; 
rotate.Angle = newAhAngle,; 
} 


private void OnstopTimer () 
{ 
timer.SsStop(); 


一 一 


运行 应 用 程序 ， 就 会 显示 时 钟 ， 如 图 21-1 所 示 。 


WinAppTimer 一 口 并 


图 21-1 
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21.7 ”线程 问题 


用 多 个 线程 编程 并 不 容易 。 在 启动 访问 相同 数据 的 多 个 线程 时 ， 会 间歇 性 地 遇 到 难以 发 现 的 问题 。 如 果 使 
用 任务 、 并 行 LINQ 或 Parallel 类 ， 也 会 遇 到 这 些 问 题 。 为 了 避免 这 些 问题 ， 必 须 特别 注意 同步 问题 和 多 个 线程 
可 能 发 生 的 其 他 问题 。 下 面 探讨 与 线程 相关 的 问题 ， 争 用 条 件 和 死 锁 。 


注意 : 
在 用 这 里 显示 的 同步 类 型 同步 自 定义 集合 类 之 前 ， 还 应 该 阅读 第 11 章 ， 了 解 线 程 安全 的 集合 : 并 发 集合 。 
ThreadingIssues 示例 的 代码 使 用 了 如 下 名 称 空间 : 
System.Diaenostics 
System.Threadine 
System.Threadine.Tasks 
static System.Console 
可 以 使 用 命令 行 参数 启动 ThreadingIssues 示例 应 用 程序 ， 来 模拟 争 用 条 件 或 死 锁 。 


21.7.1 和 争 用 条 件 


如 果 两 个 或 多 个 线程 访问 相同 的 对 象 ， 并 且 对 共享 状态 的 访问 没有 同步 ， 就 会 出 现 争 用 条 件 。 为 了 说 明 争 用 
条 件 ， 下 面 的 例子 定义 一 个 StateObject 类 ， 它 包含 一 个 int 字段 和 一 个 ChangeState0 方 法 。 在 ChangeState0 方 
法 的 实现 代码 中 ， 验 证 状态 变量 是 否 包含 5。 如 果 它 包含 ， 就 递增 其 值 。 下 一 条 语句 是 Trace.Assert， 它 立刻 验 
证 state 现在 是 包含 6。 

在 给 包含 5 的 变量 递增 了 1 后 ， 可 能 认为 该 变量 的 值 就 是 6。 但 事实 不 一 定 是 这 样 。 例 如 ， 如 果 一 个 线程 
刚刚 执行 完 寺 (_state 一 5) 语句 ， 它 就 被 其 他 线程 抢占 ,调度 器 运行 男 一 个 线程 。 第 二 个 线程 现在 进入 于 体 ， 因 
为 state 的 值 仍 是 5， 所 以 将 它 递 增 到 6。 第 一 个 线程 现在 再 次 被 调度 ， 在 下 一 条 语句 中 ，state 递增 到 7。 这 时 
就 发 生 了 争 用 条 件 ， 并 显示 断言 消息 (代码 文件 ThreadingIssues/SampleTask.cs)。 


Public class StateOb]ject 
{ 
private int state = 5; 
public void Changestate (int loop) 
{ 
if ( state == 5) 
{ 
_statet++; 
if ( state != 6) 
{ 
Console.WriteLine (35"Race condition occurred after {loop} Loops") ; 
Trace.Fail ("race condition™); 


} 
state = Sr 
} 
} 
下 面 通 过 给 任务 定义 一 个 方法 来 验证 这 一 点 。SampleTask 类 的 RaceCondition0 方 法 将 一 个 StateObject 类 作 
为 其 参数 。 在 一 个 无 限 while 循环 中 ， 调 用 ChangeState0) 方 法 。 变 量 i 仅 用 于 显示 断言 消息 中 的 循环 次 数 。 
public class SampleTask 
{ 
Public void RaceCondition (object o) 
{ 
Trace.Assert(o 1is StateOb]ect，"D must be of type StateOQbject"); 
stateoObject state = 0 as StateObject; 
int i = 0:; 
while (true)} 


state.Changestate (1++); 
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在 程序 的 Main0 方 法 中 ， 新 建 了 一 个 StateObject 对 象 ， 它 由 所 有 任务 共享 。 通 过 使 用 传递 给 Task 的 Run 方 
法 的 lambda 表达 式 调 用 RaceCondition 方法 来 创建 Task 对 象 。 然 后 ， 主 线程 等 待 用 户 输入 。 但 是 ， 因 为 可 能 出 现 
争 用 ， 所 以 程序 很 有 可 能 在 读 取 用 户 输入 前 就 挂 起 : 

public void RaceConditions () 

| Var state = 卫 已 而 StateOb]ect (); 

for (lint 1 = 0; 1 < 2; 1++) 
| Task.Run(() => new SampleTask(}) .RaceCondition (state)).; 

} 

启动 程序 ， 就 会 出 现 争 用 条 件 。 多 久 以 后 出 现 第 一 个 争 用 条 件 要 取决 于 系统 以 及 将 程序 构建 为 发 布 版 本 还 
是 调试 版 本 。 如 果 构 建 为 发 布 版 本 , 该 问题 的 出 现 次 数 就 会 比较 多 , 因为 代码 被 优化 了 。 如果 系统 中 有 多 个 CPU 
或 使 用 双核 /四 核 CPU, 其 中 多 个 线程 可 以 同时 运行 , 则 该 问题 也 会 比 单 核 CPU 的 出 现 次 数 多 。 在 单 核 CPU 中 ， 
因为 线程 调度 是 抢占 式 的 ， 也 会 出 现 该 问题 ， 只 是 没有 那么 频繁 。 

在 我 的 系统 上 运行 程序 时 ， 显 示 在 85232 个 循环 后 出 现 错误 ; 在 另 一 次 运行 程序 时 ， 显 示 在 70037 个 循环 
后 出 现 错误 。 多 次 启动 应 用 程序 ， 总 是 会 得 到 不 同 的 结果 。 

要 避免 该 问题 ， 可 以 锁定 共享 的 对 象 。 这 可 以 在 线程 中 完成 : 用 下 面 的 lock 语句 锁定 在 线程 中 共享 的 state 
变量 。 只 有 一 个 线程 能 在 锁定 块 中 处 理 共享 的 state 对 象 。 由 于 这 个 对 象 在 所 有 的 线程 之 间 共 享 ， 因 此 ， 如 果 一 
个 线程 锁定 了 state， 男 一 个 线程 就 必须 等 待 该 锁定 的 解除 。 一 旦 接受 锁定 ， 线 程 就 拥有 该 锁定 ， 直 到 该 锁定 块 
的 末尾 才 解 除 锁定 。 如 果 改 变 state 变量 引用 的 对 象 的 每 个 线程 都 使 用 一 个 锁定 ， 就 不 会 出 现 争 用 条 件 。 

public class SampleTask 

| public void RaceCondition (obpject o) 

Trace.Assert{(o is StateObject, "o must be of type StateObject"); 
StateObject state = D as StateOblject; 


int 1 = 0:; 
While (true) 


{ 
look (state) // no race condition with this lock 
state.cChangestate (1++); 


} 
} 
} 


注意 : 
在 下 载 的 示例 代码 中 ， 需 要 取消 锁定 语句 的 注释 ， 才 能 解决 争 用 条 件 的 问题 . 


在 使 用 共享 对 象 时 ， 除 了 进行 锁定 之 外 ， 还 可 以 将 共享 对 象 设置 为 线程 安全 的 对 象 。 在 下 面 的 代码 中 ， 
ChangeState0 方 法 包含 一 条 lock 语句 。 由 于 不 能 锁定 state 变量 本 身 ( 只 有 引用 类 型 才能 用 于 锁定 )， 因 此 定义 一 
个 object 类 型 的 变量 sync， 将 它 用 于 lock 语句 。 如 果 每 次 state 的 值 更 改 时 ， 都 使 用 同一 个 同步 对 象 来 锁定 ， 
就 不 会 出 现 争 用 条 件 。 

public class StateObject 

private int state = 5; 

Private _object sync = new object (); 
Public vold Changestate (Jnt loop) 


{ 
lock ( sync) 
{ 


if ( state == 5) 
{ 
Statetts 
if ( state != 6) 
{ 
Console.WriteLine ($"Race condition occured after {loop} loops"™); 
Trace.Fail($"race condition at {loop}"™); 


} 
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state = Sr 


21.7.2” 死 锁 


过 多 的 锁定 也 会 有 厅 烦 。 在 死 锁 中 ， 至 少 有 两 个 线程 被 挂 起 ， 并 等 竺 对方 解除 锁定 。 由 于 两 个 线程 都 在 等 
竺 对方 ， 就 出 现 了 死 锁 ， 线 程 将 无 限 等 待 下 去 。 

为 了 说 明 死 锁 ， 下 面 实例 化 StateObject 类 型 的 两 个 对 象 ， 并 把 它们 传递 给 SampleTask 类 的 构造 函数 。 创建 
两 个 任务 ， 其 中 一 个 任务 运行 Deadlock10 方 法 ， 男 一 个 任务 运行 Deadlock20 方 法 (代码 文件 


ThreadineIssues/Proeram.cs): 
var Statel = new StateObject(); 
Var state2 = new StateObject(); 


new Task{(new SampleTask(statel, state2) .Deadlockil)}) .start()}.; 
new Task (new SampleTasklstatel, state2) .Deadlock2) .Start (}; 


Deadlock10 和 Deadlock20 方 法 现在 改变 两 个 对 象 sl 和 s2 的 状态 ， 所 以 生成 了 两 个 锁 。Deadlock10 方 法 先 
锁定 s1， 接 着 锁定 s2。Deadlock20 方 法 先 锁定 s2， 再 锁定 s1。 现 在 ， 有 可 能 Deadlock10 方 法 中 sl 的 锁定 会 被 
解除 。 接 独 ， 出 现 一 次 线程 切换 ，Deadlock20 方 法 开始 运行 ， 并 锁定 s2。 第 二 个 线程 现在 等 待 sl 锁定 的 解除 。 因 
为 它 需 要 等 每 ， 所 以 线程 调度 器 再 次 调度 第 一 个 线程 ,但 第 一 个 线程 在 等 待 s2 锁定 的 解除 。 这 两 个 线程 现在 都 在 
等 待 ， 只 要 锁定 块 没有 结束 ， 就 不 会 解除 锁定 。 这 是 一 个 典型 的 死 锁 (代码 文件 ThreadingIssues/SampleTask.cs)。 


public class SampleTask 

{ 
public SampleTask (StateObject sl, StateObject s2) 
{ 


} 
private StateObject sil; 
private StateQbject 性 
PUublic void Deadlockl () 
{ 
int 1 = OQ; 
while (true) 
{ 
lock ( sl1) 
{ 
lock ( s2) 
{ 
sl.changestate (1); 
ss2.Changestate (i++); 
Console .WriteLine(s$"still running, {1}"); 
} 
} 
} 
} 


public void Deadlock2 () 
{ 


int i = 0.; 
while (true) 
{ 
lock ( sz) 
{ 


lock ( sl1) 
{ 
sl1.changestate (1); 

52.ChangeState (i++); 

Console .WriteLine(s$"still running, {1}"); 
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结果 是 ， 程 序 运 行 了 许多 次 循环 ， 不 久 就 没有 响应 了 。“ 仍 在 运行 ”的 消息 仅 写 入 控制 台中 几 次 。 同 样 ， 死 
锁 问 题 的 发 生 频 率 也 取决 于 系统 配置 ， 每 次 运行 的 结果 都 不 同 。 

死 锁 问题 并 不 总 是 像 这 样 那么 明显 。 一 个 线程 锁定 了 s1， 接 着 锁定 s2; 男 一 个 线程 锁定 了 s2， 接 着 锁定 
s1。 在 本 例 中 只 需要 改变 锁定 顺序 ， 这 两 个 线程 就 会 以 相同 的 顺序 进行 锁定 。 但 是 ， 在 较 大 的 应 用 程序 中 ， 锁 
定 可 能 隐藏 在 方法 的 深 处 。 为 了 避免 这 个 问题 ， 可 以 在 应 用 程序 的 体系 架构 中 ， 从 一 开始 就 设计 好 锁定 顺序 ， 
也 可 以 为 锁定 定义 超时 时 间 。 如 何 定义 超时 时 间 详 见 下 一 节 的 内 容 。 


21.8 lock 语句 和 线程 安全 


C# 为 多 个 线程 的 同步 提供 了 目 己 的 关键 字 : lock 语句 。lock 语句 是 设置 锁定 和 解除 锁定 的 一 种 简单 方式 。 
在 添加 lock 语句 之 前 ， 先 进入 另 一 个 争 用 条 件 。SharedState 类 说 明了 如 何 使 用 线程 之 间 的 共享 状态 ， 并 共享 一 
个 整数 值 ( 代 码 文件 SynchronizationSamples/SharedState.cs)。 


public class Sharedstate 
{ 


public int State { get; set; |】 

} 

下 述 所 有 同步 示例 的 代码 (SingletonWPF 除外 ) 都 使 用 如 下 名 称 空间 : 
System 
System.Collections.Generic 
System.LInq 
System. Text 
System.TIhreadimg 
System.TIhreadimg.IasKs 


Job 类 包含 DoTheJob0 方 法 ,该 方法 是 新 任务 的 入 口 点 。 通 过 其 实现 代码 ， 将 SharedState 对 象 的 State 递增 
50 000 次 。sharedState 变量 在 这 个 类 的 构造 函数 中 初始 化 (代码 文件 SynchronizationSamples/Job.cs): 
Public class Job 
private Sharedstate sharedstate:; 
public Job (ShareaState sharedstate) 
sharedstate = sharedstater-; 
} 


public void DoTheJob() 
{ 


for (int i = 0; i < 50000; i++) 


sharedSstate.state += 1; 
} 
} 
} 


在 Main0 方 法 中 ， 创 建 一 个 SharedState 对 象 ， 并 把 它 传 递 给 20 个 Task 对 象 的 构造 函数 。 在 局 动 所 有 的 任 
务 后 ，Main0 方 法 进入 另 一 个 循环 ， 等 待 20 个 任务 都 执行 完毕 。 任 务 执行 完毕 后 ， 把 共享 状态 的 合计 值 写 入 控 
制 合 中 。 因 为 执行 了 50 000 次 循环 ， 有 20 个 任务 ， 所 以 写 入 控制 台 的 值 应 是 1 000 000。 但 是 ， 事 实 靖 稍 并 非 
如 此 (代码 文件 SynchronizationSamples/Program.cs)。 

Class Program 

{ 

static Vola Main{() 
{ 
Int numTasks = 20; 
var state = new Sharedstate (); 
var tasks = new Task[numTasks]; 
for {int i = 0; 1 < numTasks; 1++) 
{ 
tasks[1i] = Task.Run({}) => new Job (state}) .DoTheJob()})); 
} 
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Task.WaitAll (tasks):; 
Console.WriteLine (S$"summarized {state.state}™).: 
} 
} 


多 次 运行 应 用 程序 的 结果 如 下 所 示 : 
summarized 424687 
summarlized 465708 
summarized 581754 


summarlized 395571 
summarlzed 633601 


每 次 运行 的 结果 都 不 同 ， 但 没有 一 个 结果 是 正确 的 。 如 前 所 述 ， 调 试 版 本 和 发 布 版 本 的 区 别 很 大 。 根 据 使 
用 的 CPU 类 型 , 结果 也 不 一 样 。 如 果 将 循环 次 数 改 为 比较 小 的 值 , 就 会 多 次 得 到 正确 的 值 , 但 不 是 每 次 都 正确 。 
这 个 应 用 程序 非常 小 ， 很 容易 看 出 问题 ， 但 该 问题 的 原因 在 大 型 应 用 程序 中 就 很 难 确定 。 

必须 在 这 个 程序 中 添加 同步 功能 ， 这 可 以 用 lock 关键 字 实现 。 用 lock 语句 定义 的 对 象 表示 ， 要 等 竺 指定 对 
象 的 锁定 。 只 能 传递 引用 类 型 。 锁 定 值 类 型 只 是 锁定 了 一 个 副本 ， 这 没有 什么 意义 。 如 果 对 值 类 型 使 用 了 lock 
语句 ，C# 编 译 器 就 会 故 出 一 个 错误 。 进 行 了 锁定 后 一 一 只 锁定 了 一 个 线程 ， 就 可 以 运行 lock 语句 块 。 在 lock 
语句 块 的 最 后 ， 对 象 的 锁定 被 解除 ， 另 一 个 等 竺 锁定 的 线程 就 可 以 获得 该 锁定 块 了 。 


lock (ob]j) 
{ 


// synchronized region 


} 
要 锁定 静态 成 员 ， 可 以 把 锁 放 在 object 类 型 或 静态 成 员 上 : 


lock (typeof (StaticClass)) 


{ 

} 

使 用 lock 关键 字 可 以 将 类 的 实例 成 员 设 置 为 线程 安全 的 。 这 样 ， 一 次 只 有 一 个 线程 能 访问 相同 实例 的 
DoThisO0 和 DoThat0 方 法 。 

public class Demo 

{ 


PUublic void DoThis () 
{ 
lock (this) 
i:/ only one thread at a time can access the DoThis and DoThat methods 
} 
} 
public void DoThat{() 
lock (this) 
{ 
} 


} 
} 


但 是 ， 因 为 实例 的 对 象 也 可 以 用 于 外 部 的 同步 访问 ， 而 且 我 们 不 能 在 类 目 身 中 控制 这 种 访问 ， 所 以 应 采用 
SyncRoot 模式 。 通 过 SyncRoot 模式 ， 创 建 一 个 私有 对 象 syncRoot， 将 这 个 对 象 用 于 lock 语句 。 


Public class Demo 


{ 
private object syncRoot = new object(); 
public void DoThis() 
{ 
lock ( syncRoot)} 
{ 
:i only one thread at a time can access the DoThis and DoThat methods 
} 
} 


PUublic void DoThat () 
lock ( syncRoot)} 
{ 
} 
} 
} 
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使 用 锁定 需要 时 间 ， 且 并 不 总 是 必要 的 。 可 以 创建 类 的 两 个 版 本 ， 一 个 同步 版 本 ， 一 个 异步 版 本 。 下 一 个 
示例 通过 修改 Demo 类 来 说 明 。Demo 类 本 向 并 不 是 同步 的 ， 这 可 以 在 DoThisO 和 DoThat0 方 法 的 实现 中 看 出 和 
该 类 还 定义 了 IsSynchronized 属性 ， 客 户 可 以 从 该 属性 中 获得 类 的 同步 选项 信息 。 为 了 获得 该 类 的 同步 版 本 ， 
可 以 使 用 静态 方法 Synchronized0 传 递 一 个 非 同步 对 象 ， 这 个 方法 会 返回 SynchronizedDemo 类 型 的 对 象 。 
SynchronizedDemo 实现 为 派生 自 基 类 Demo 的 一 个 内 部 类 ， 并 重 写 基 类 的 虚 成 员 。 重 写 的 成 员 使 用 了 SyncRoot 
模式 。 

public class Demo 

private class SynchronizedDemo: Demo 

| private object syncRoot = new object (); 
private Demo d; 
public synchronizedDemo (Demo dl) 
和 d; 


} 
Public override bool IsSynchronized => true; 


Public override void DoThis'() 
{ 
lock ( syncRoot) 
{ 
_d-.DoThis (}); 
} 
} 


Public override void DoThat  () 
{ 

lock ( syncRoot) 

{ 

dd.DoThat () 7 

} 

} 
} 


public virtual bool IsSynchronized => false; 


public static Demo Synchronized(Demo d) 
| 
if (i'd.IsSynchronized) 
{ 
return new SynchronizedDemo (d}); 
} 
return d; 


} 


Public virtual void DoThis() 
{ 
} 


Public virtual void DoThat () 
{ 
} 

} 


必须 注意 ， 在 使 用 SynchronizedDemo 类 时 ， 只 有 方法 是 同步 的 。 对 这 个 类 的 两 个 成 员 的 调用 并 没有 同步 。 
首先 修改 异步 的 SharedState 类 ， 以 使 用 SyncRoot 模式 。 如 果 试 图 用 SyncRoot 模式 锁定 对 属性 的 访问 ,使 
SharedState 类 变 成 线程 安全 的 ， 就 仍 会 出 现 前 面 描述 的 争 用 条 件 。 


Public class Sharedstate 
{ 
private int state = 0; 
private object syncRoot = new COb]Ject () -7 
public int State // there's still a race condition, 
// don't do this! 
{ 
Get { lock ( syncRoot) 1{ return state; }} 
set { lock ( syncRoot) {1 state = Valuer |}} 
} 
} 
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调用 方法 DoTheJob0 的 线程 访问 SharedState 类 的 get 存 取 器 , 以 获得 state 的 当前 值 ,接着 get 存 取 器 给 state 
设置 新 值 。 在 调用 对 象 的 get 和 set 存 取 嚣 期间， 对象 没有 锁定 ， 男 一 个 线程 可 以 获得 临时 值 (代码 文件 
SynchronizationSamples/Job.cs)。 


public void DoTheyJob () 
{ 
for (int i = 0; i < 50000; i++) 


sharedSstate.State 二 一 1; 
} 
} 


所 以 ， 最 好 不 改变 Sharedstate 类 ， 让 它 依旧 没有 线程 安全 性 (代码 文件 SynchronizationSamples/ 
Sharedstate.cs)。 


public class SharedSstate 
{ 
Public int State { get; set; } 


然后 在 DoTheJob 方法 中 ， 将 lock 语句 添加 到 合适 的 地 方 (代码 文件 SynchronizationSamples/Job.cs): 
public void DoTheJob() 
{ 

for (Int 1 = 0; 1 < 50000; i++) 


lock ( sharedSstate) 
{ 


sharedstate.state 1+= 1; 
} 
} 
} 


这 样 ， 应 用 程序 的 结果 就 总 是 正确 的 。 


注意 : 
在 一 个 地 方 使 用 lock 语句 并 不 意味 着 , 访问 对 象 的 其 他 线程 都 正在 等 待 。 必 须 对 每 个 访问 共享 状态 的 线程 
显 式 地 使 用 同步 功能 。 


当然 ， 还 必须 修改 SharedState 类 的 设计 ， 并 作为 一 个 原子 操作 提供 递增 方式 。 这 是 一 个 设计 问题 一 一 把 什 
么 实现 为 类 的 原子 功能 ? 下 面 的 代码 片段 锁定 了 递增 操作 。 

Public class Sharedstate 
private int state = 0; 
private object syncRoot = new object(); 
Public int State => state; 
Public int Incrementstate()} 
{ 

lock ( syncRoot) 


Ieturn ++ stater 
} 
} 
} 


锁定 状态 的 递增 还 有 一 种 更 快 的 方式 ， 如 下 节 所 示 。 


21.9 ”Interlocked 类 


Interlocked 类 用 于 使 变量 的 简单 语句 原子 化 。i++ 不 是 线程 安全 的 ， 它 的 操作 包括 从 内 存 中 获取 一 个 值 ， 给 
该 值 递增 1， 再 将 它 存储 加 内存。 这些 操 作 都 可 能 会 被 线程 调度 器 打 断 。Interlocked 类 提供 了 以 线程 安全 的 方 
式 递增 、 递 减 、 交 换 和 读 取 值 的 方法 。 

与 其 他 同步 技术 相 比 ， 使 用 Interlocked 类 会 快 得 多 。 但 是 ， 它 只 能 用 于 简单 的 同步 问题 。 

例如 ， 这 里 不 使 用 lock 语句 锁定 对 someState 变量 的 访问 ， 把 它 设置 为 一 个 新 值 ， 以 防 它 是 空 的 ， 而 可 以 
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使 用 Interlocked 类 ， 它 比较 快 ; 


lock (this) 
{ 


if ( SomeState == null) 
{ 

someState = newSstate; 
} 


} 
这 个 功能 相同 但 比较 快 的 版 本 使 用 了 Interlocked.CompareExchange0 方 法 。 
不 是 像 下 面 这 样 在 lock 语句 中 执行 递增 操作 : 
Public int State 
det 
{ 

lock (this) 

return ++ state; 

: a 


} 
} 


而 使 用 较 快 的 Interlocked.Increment0 方 法 : 
public int State 


{ 
get => Interlocked.Increment(ref _S 七 ate) 
} 


21.10 ”Monitor 类 
lock 语句 由 C# 编 译 器 解析 为 使 用 Monitor 类 。 下 面 的 lock 语句 ]: 


lock (ob]) 


/i synchronized region for ob] 


被 解析 为 调用 Enter0 方 法 ， 该 方法 会 一 直 等 待 ， 直 到 线程 锁定 对 象 为 止 。 一 次 只 有 一 个 线程 能 锁定 对 象 。 只 要 
解除 了 锁定 ， 线 程 就 可 以 进入 同步 阶段 。Monitor 类 的 Exit0 方 法 解除 了 锁定 。 编 译 器 把 Exit0 方 法 放 在 try 块 的 
finally 处 理 程序 中 ， 所 以 如 果 抛 出 了 异 弟 ， 就 会 解除 该 锁定 。 


注意 : 
try/finally 块 详 见 第 14 章 。 


Monitor.Enter (ob] ) ; 
try 
{ 
/i synchronized region for obj 
} 
finally 


Monitor.Exit (ob]); 
} 


与 C# 的 lock 语句 相 比 ，Monitor 类 的 主要 优点 是 : 可 以 添加 一 个 等 待 被 锁定 的 超时 值 。 这 样 就 不 会 无 限期 
地 等 待 被 锁定 , 而 可 以 像 下 面 的 例子 那样 使 用 TryEnter0 方 法 ， 其 中 给 它 传递 一 个 超时 值 ， 指 定 等 待 被 锁定 的 最 
长 时 间 。 如 果 obj 被 锁定 ，TryEnter0 方 法 就 把 布尔 型 的 引用 参数 设置 为 hue， 并 同步 地 访问 由 对 象 obj 锁定 的 
状态 。 如 果 另 一 个 线程 锁定 obj 的 时 间 超 过 了 500 毫秒 ，TryEnter0 方 法 就 把 变量 lockTaken 设置 为 false， 线 程 
不 再 等 待 ， 而 是 用 于 执行 其 他 操作 。 也 许 在 以 后 ， 该 线程 会 尝试 再 次 获得 锁定 。 

bool lockTaken = false; 

Monitor.TryEnter( ob]j], S00, ref lockTaken); 

if ( lockTaken) 


{ 
try 
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{ 
/acquired the lock 
// synchronized region for ob] 
} 
finally 
{ 


Monitor.Exit (ob]); 
} 
} 


全 ] Se 


// didn't get the lock, do something else 


21.11 SpinLock 结构 


如 果 基 于 对 象 的 锁定 对 象 (Monitor) 的 系统 开销 由 于 垃圾 收集 而 过 高 ,就 可 以 使 用 SpinLock 结构 。 如 果 有 大 
量 的 锁定 (例如 ， 列 表 中 的 每 个 节点 都 有 一 个 锁定 )， 且 锁定 的 时 间 总 是 非常 短 ，SpinLock 结构 就 很 有 有 用。 应 避 
免 使 用 多 个 SpinLock 结构 ， 也 不 要 调用 任何 可 能 阻塞 的 内 容 。 

除了 体系 结构 上 的 区 别 之 外 ，SpinLock 结构 的 用 法 非常 类 似 于 Monitor 类 。 使 用 Enter0 或 TryEnter0 方 法 获得 锁 
定 ， 使 用 Exit0 方 法 释放 锁定 。SpinLock 结构 还 提供 了 属性 IsHeld 和 IsHeldByCurrentThread， 指 定 它 当 前 是 否 是 锁 
定 的 。 


注意 : 
传送 SpinLock 实例 时 要 小 心 。 因 为 SpinLock 定义 为 结构 ， 把 一 个 变量 赋予 另 一 个 变量 会 创建 一 个 副本 。 
总 是 通过 引用 传送 SpinLock 实例 。 


21.12 ”WaitHandle 基 类 


WaitHandle 是 一 个 抽象 基 类 ， 用 于 等 竺 一 个 信号 的 设置 。 可 以 等 竺 不同 的 信号 ， 因 为 WaitHandle 是 一 个 基 
类 ， 可 以 从 中 派生 一 些 类 。 

使 用 WaitHandle 基 类 可 以 等 竺 一 个 信号 的 出 现 CWaitOne0 方 法 )、 等 待 必 须发 出 信号 的 多 个 对 象 (WaitAll0 
方法 )， 或 者 等 待 多 个 对 象 中 的 一 个 (WaitAny0 方 法 )。WaitAl10 和 WaitAny0 是 WaitHandle 类 的 静态 方法 ， 接 收 
一 个 WaitHandle 参数 数组 。 

WaitHandle 基 类 有 一 个 SafeWaitHandle 属性 ， 其 中 可 以 将 一 个 本 机 句柄 赋予 一 个 操作 系统 资源 ， 并 等 竺 该 
句柄 。 例 如 ， 可 以 指定 一 个 SafeFileHandle 等 待 文件 IO 操作 的 完成 。 

因为 Mutex、EventWaitHandle 和 Semaphore 类 派生 目 WaitHandle 基 类 ， 所 以 可 以 在 等 待 时 使 用 它们 。 


21.13 Mutex 类 


Mutex(mutual exclusion， 互 斥 ) 是 NET Framework 中 提供 跨 多 个 进程 同步 访问 的 一 个 类 。 它 非常 类 似 于 
Monitor 类 ， 因 为 它们 都 只 有 一 个 线程 能 拥有 锁定 。 只 有 一 个 线程 能 获得 互 斥 锁定 ， 访 问 受 互 斥 保护 的 同步 代 
码 区 域 。 

在 Mutex 类 的 构造 函数 中 ， 可 以 指定 互 斥 是 否 最 初 应 由 主 调 线程 拥有 ， 定 义 互 斥 的 名 称 ， 获 得 互 斥 是 否 已 
存在 的 信息 。 在 下 面 的 示例 代码 中 ， 第 3 个 参数 定义 为 输出 参数 ， 接 收 一 个 表示 互 斥 是 否 为 新 建 的 布尔 值 。 如 
果 返 回 的 值 是 包 lse， 就 表示 互 斥 已 经 定义 。 互 斥 可 以 在 另 一 个 进程 中 定义 ， 因 为 操作 系统 能 够 识别 有 名 称 的 互 
斤 ， 它 由 不 同 的 进程 共享 。 如 果 没 有 给 互 斥 指定 名 称 ， 互 斥 就 是 未 命名 的 ， 不 在 不 同 的 进程 之 间 共 享 。 


bool createdNew; 
var mutex = new Mutexlfalse, "ProcsharpMutex™", out createdNew})s; 


要 打开 已 有 的 互 斥 ， 还 可 以 使 用 Mutex.OpenExisting0 方 法 ， 它 不 需要 用 构造 国 数 创建 互 斥 时 需要 的 相 
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同 NET 权限 。 
由 于 Mutex 类 派生 自 基 类 WaitHandle， 因 此 可 以 利用 WaitoOne0 方 法 获得 互 斥 锁定 ， 在 该 过 程 中 成 为 该 互 
斥 的 拥有 者 。 通 过 调用 ReleaseMmutex0 方 法 ， 即 可 释放 互 斥 。 
if (mutex.WaitOne()) 
{ 
{ 
/i synchronized region 


finally 
{ 


mutex.ReleaseMutex(); 
} 
} 


已] 号 已 


fsome problem happened while waiting 

} 

由 于 系统 能 识别 有 名 称 的 互 斥 ， 因 此 可 以 使 用 它 禁 止 应 用 程序 局 动 两 次 。 在 下 面 的 控制 台 应 用 程序 中 ， 调 
用 了 Mutex 对 象 的 构造 函数 。 接 着 ， 验 证 名 称 为 SingletonAppMutex 的 互 斥 是 否 存在 。 如 果 存 在 ， 应 用 程序 就 
退出 (代码 文件 SingletonUsingMutex/Program.cs)。 

static void Mainl() 

{ 

bool mutexCreated; 
var mutex = new Mutex(false, "SingletonAppMutex", out mutexCreated); 
if (ImutexCreated) 
| 
Console.WriteLine ("You can only start one instance of the application.™); 
Console.WriteLine ("ExXiting.").; 
return;s 
} 
Console.WriteLine ("Application running™); 
Console .WriteLine("Press return to exit™).;: 
Console.ReadLine ();} 


21.14 Semaphore 类 


信号 量 非常 类 似 于 互 斥 ， 其 区 别 是 ， 信 号 量 可 以 同时 由 多 个 线程 使 用 。 信 号 量 是 一 种 计数 的 互 扩 锁定。 使 
用 信号 量 ， 可 以 定义 允许 同时 访问 受 旗 语 锁定 保护 的 资源 的 线程 个 数 。 如 果 需 要 限制 可 以 访问 可 用 资源 的 线程 
数 ， 信 号 量 就 很 有 用 。 例 如， 如 果 系 统 有 3 个 物理 端口 可 用 ， 就 允许 3 个 线程 同时 访问 IO 辣 口 ， 但 第 4 个 线 
程 需 要 等 待 前 3 个 线程 中 的 一 个 释放 资源 。 

.NET Core 为 信号 量 功 能 提供 了 两 个 类 Semaphore 和 SemaphoreSlim。Semaphore 类 可 以 命名 ， 使 用 系统 范 
围 内 的 资源 ， 允 许 在 不 同 进 程 之 间 同 步 。SemaphoreSlim 类 是 对 较 短 等 待 时 间 进 行 了 优化 的 轻型 版 本 。 

在 下 面 的 示例 应 用 程序 中 ， 在 Main0 方 法 中 创建 了 6 个 任务 和 一 个 计数 为 3 的 信号 量 。 在 Semaphore 类 的 
构造 函数 中 ， 定 义 了 锁定 个 数 的 计数 ， 它 可 以 用 信号 量 (第 二 个 参数 ) 来 获得 ， 还 定义 了 最 初 释放 的 锁定 数 ( 第 一 
个 参数 )。 如 果 第 一 个 参数 的 值 小 于 第 二 个 参数 ， 它 们 的 差 就 是 已 经 分 配 线程 的 计数 值 。 与 互 太 一样， 也 可 以 给 
信号 量 指定 名 称 ， 使 之 在 不 同 的 进程 之 间 共 享 。 这 里 定义 信号 量 时 没有 指定 名 称 ， 所 以 它 只 能 在 这 个 进程 中 使 
用 。 在 创建 了 SemaphoreSlim 对 象 之 后 ， 启 动 6 个 任务 ， 它 们 都 获得 了 相同 的 信号 量 ( 代 码 文 件 
Semaphoresample/Program.cs)。 

class Program 

村 

static void Main() 
int taskCount = 6; 
int semaphoreCount = 3; 
var semaphore = new SemaphoreSlim(semaphoreCount, semaphoreCount); 


Var tasks = new Task[taskcountl]l:; 
for (int 1 = 0; 1 < taskCount; 1++) 
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{ 
tasks[i] = Task.Run(() => TaskMain (semaphore)); 
} 
Task.WaitAll (tasks); 
Console.WriteLine{("All tasks finished™}).; 


} 
ff 
在 任务 的 主 方法 TaskMain0 中 ,任务 利用 Wait0 方 法 锁定 信号 量 。 信 号 量 的 计数 是 3， 所 以 有 3 个 任务 可 以 
获得 锁定 。 第 4 个 任务 必须 等 等， 这 里 还 定义 了 最 长 的 等 待 时 间 为 600 毫秒 。 如 果 在 该 等 待 时 间 过 后 未 能 获得 
锁定 ， 任 务 就 把 一 条 消 奶 写 入 控制 台 ， 在 循环 中 继续 等 待 。 只 要 获得 了 锁定 ， 线 程 就 把 一 条 消 恩 写 入 控制 台 ， 
睡眠 一 段 时 间 ， 然 后 解除 锁定 。 在 解除 锁定 时 ， 在 任何 情况 下 一 定 要 解除 资源 的 锁定 ， 这 一 点 很 重要 。 这 就 是 
在 finally 处 理 程序 中 调用 SemaphoreSlim 类 的 Release0 方 法 的 原因 (代码 文件 SemaphoreSample/Program.cs)。 
FE ss 


public static void TaskMain (SemaphoreSlim semaphore) 
{ 
bool isCcompleted = false; 
while (!isCcompleted) 
{ 
if (semaphore.Wait (600)) 
{ 
try 
{ 
Console.WriteLine ($"Task {Task.CurrentId} locks the semaphore™); 
Task.Delay (2000) .Wait (}); 
} 
finally 
{ 
Console.WriteLine ($"Task {Task.CurrentId} releases the semaphore™); 
semaphore.Release().; 
isCcompleted = true; 
} 
} 
lse 
{ 
Console .WriteLine ($"Timeout for task {Task.CurrentId}; wait again™); 
} 
} 
} 


运行 应 用 程序 ， 可 以 看 到 有 4 个 线程 很 快 被 锁定 。ID 为 7、8 和 9 的 线程 需要 等 待 。 该 等 待 会 重复 进行 ， 
直到 其 中 一 个 被 锁定 的 线程 解除 了 信号 量 。 


Task 4 locks the semaphore 
Task 5 locks the semaphore 
Task 日 locks the semaphore 
Timeout for task 7; wait again 
Timeout for task 7; wait again 
Timeout for task 8; wait again 
Timeout for task 7; wait again 
Timeout for task 8; wait again 
Timeout for task 7; wait again 
Timeout for task 9; wait again 
Timeout for task 8; wait again 
Task 5 releases the semaphore 


Task 7 locks 七 he semaphore 

Task 6&6 releases the semaphore 

Task 4 releases the semaphore 

Task 8 locks the semaphore 

Task 9 locks the semaphore 

Task 8 releases the semaphore 
7 


Task releases the semaphore 
Task 9 releases the semaphore 
All tasks finished 


21.15 Events 类 


与 互 矿 和 信号 量 对 象 一 样 , 事件 也 是 一 个 系统 范围 内 的 资源 同步 方法 .为 了 从 托管 代码 中 使 用 系统 事件 , NET 
Framework 在 System.Threading 名 称 空 间 中 提供 了 ManualResetEvent、AutoResetEvent、ManualResetEventSlim 和 
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第 8 章 介 绍 了 C# 中 的 event 关键 字 ， 它 与 System.Threading 名 称 空 间 中 的 event 类 没有 关系 。event 关键 字 
基于 委托 ， 而 上 述 两 个 event 类 是 NET 封装 器 ， 用 于 系统 范围 内 的 本 机 事件 资源 的 同步 。 


可 以 使 用 事件 通知 其 他 任务 : 这 里 有 一 些 数 据 ， 并 完成 了 一 些 操作 等 。 事 件 可 以 发 信号 ， 也 可 以 不 发 信和 号。 
使 用 前 面 介 绍 的 WaitHandle 类 ， 任 务 可 以 等 待 处 于 发 信号 状态 的 事件 。 

调用 SetO 方 法 ， 即 可 向 ManualResetEventSlim 发 信号 。 调 用 Reset0 方 法 ， 可 以 使 之 返回 不 发 信号 的 状态 。 
如 果 多 个 线程 等 竺 同一 个 事件 发 信号 ， 并 调用 了 Set0 方 法 ， 就 释放 所 有 等 待 的 线程 。 男 外 ， 如 果 一 个 线程 刚刚 
调用 了 WaitOne0 方 法 ， 但 事件 已 经 发 出 信号 ， 等 待 的 线程 就 可 以 继续 等 待 。 

也 通过 调用 Set0 方 法 同 AutoResetEvent 发 信号 。 也 可 以 使 用 Reset0 方 法 使 之 返回 不 发 信号 的 状态 。 但 是 ， 
如 果 一 个 线程 在 等 竺 目 动 重 置 的 事件 发 信号 ， 当 第 一 个 线程 的 等 竺 状态 结束 时 ， 该 事件 会 目 动 变 为 不 发 信号 的 
状态 。 这 样 ， 如 果 多 个 线程 在 等 待 癌 事件 发 信号 ， 就 只 有 一 个 线程 结束 其 等 待 状态 ， 它 不 是 等 竺 时间 最 长 的 线 
程 ， 而 是 优先 级 最 高 的 线程 。 

为 了 说 明 ManualResetEventSlim 类 的 事件 ， 下 面 的 Calculator 类 定义 了 Calculation0 方 法 ， 这 是 任务 的 入 口 
点 。 在 这 个 方法 中 ,该 任务 接收 用 于 计算 的 输入 数据 ， 将 结果 写 入 变量 result， 该 变量 可 以 通过 Result 属性 来 访 
问 。 只 要 完成 了 计算 (在 随机 的 一 段 时 间 过 后 )， 就 调用 ManualResetEventSlim 类 的 Set 方法 ， 回 事件 发 信号 ( 代 
码 文 件 EventSample/Calculator.cs)。 


Public class Calculator 

{ 
Private ManualResetEventSlim mEvent,; 
public int Result { get; private set; } 


public Calculator (ManualResetEventSlim ev) 
{ 
mEvent = eVTr 


} 


public void Calculation (int x, int Y) 

{ 
Console.WriteLine($"Task {Task.CcurrentId} starts calculation™.); 
Task.Delay (new Random() .Next (3000)) .Wait (); 
Result = x+ Wi 
// signal the event—-completed! 
Console.WriteLine($"Task {Task.CurrentId} is ready™); 
_mEvent.Set(); 

} 

} 


程序 的 Main0 方 法 定义 了 包含 4 个 ManualResetEventSlim 对 象 的 数组 和 包含 4 个 Calculator 对 象 的 数组 。 
每 个 Calculator 在 构造 函数 中 用 一 个 ManualResetEventSlim 对 象 初始 化 ， 这 样 每 个 任务 在 完成 时 都 有 目 己 的 事 
件 对 象 来 及 信号 。 现 在 使 用 Task 类 ， 让 不 同 的 任务 执行 计算 任务 (代码 文件 EventSample/Program.cs)。 
Class Program 
{ 
static void Main'() 
{ 
const int taskCount = 4; 
var mEvents = new ManualResetEventSlim[ltaskCountl].; 
var waitHandles = new WaitHandle [taskCount]; 
Var Calcs = new Calculator[taskCountl]; 
for {int 1 = 0; i < taskCount; 工 ++) 
{ 
an 二 11 = 工 ; 
mEvents[i] = new ManualResetEventSl1lim(false); 
waitHandles[i] = mEvents[i] .WaitHandle:; 
calcs[i] = new Calculator (mEvents[il]); 
Task.Run(({(})} => calcs[11] .calculation(il + 1, il1 + 3)); 
} 
pf 


WaitHandle 头 现在 用 于 等 竺 数组 中 的 任意 一 个 事件 。WaitAny0 方 法 等 待 癌 任意 一 个 事件 发 信号 。 与 
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ManualResetEvent 对 象 不 同 ，ManualResetEventSlim 对 象 不 派生 目 WaitHandle 类 。 因 此 有 一 个 WaitHandle 对 象 
的 集合 , 它 在 ManualResetEventSlim 类 的 WaitHandle 属性 中 填充 。 从 WaitAny0 方 法 返回 的 index 值 匹 配 传递 给 
WaitAny0 方 法 的 事件 数组 的 索引 ， 以 提供 发 信号 的 事件 的 相关 信息 ， 使 用 该 索引 可 以 从 这 个 事件 中 读 取 结 果 。 
for {int 1 = 0; 1 < taskCount; 1++) 
{ 
int index = WaitHandle .WaitAnyv (waitHandles). 
if (index == WaitHandle .WaitTimeout) 
{ 
Console.WriteLine{({"Timeout!!"™). 
} 
全 ] Se 
{ 
mEwvents[index] .Reset().; 
Console.WriteLine($"finished task for {index}, result: 
{calcs[index] .Result}").; 
} 
} 


局 动 应 用 程序 时 ， 可 以 看 到 任务 在 进行 计算 并 设置 事件 ， 以 通知 主线 程 ， 它 可 以 读 取 结 果 了 。 在 任意 时 间 ， 
依据 是 调试 版 本 还 是 发 布 版 本 ， 以 及 硬件 的 不 同 ， 会 看 到 执行 调用 的 任务 有 不 同 的 顺序 和 不 同 的 数量 。 


Task 4 starts calculation 
Task 5 starts calculation 
Task 6 starts calculation 
Task 7 starts calculation 
Task 7 is ready 

finished task for 3, result: 10 
Task 4 is ready 

finished task for 0, result: 4 
Task 6 is ready 

finished task for 1, result: 6 
Task 5 is ready 

finished task for 2, result: 8 


在 一 个 类 似 的 场景 中 ， 为 了 把 一 些 工 作 分 文 到 多 个 任务 中 ， 并 在 以 后 合并 结果 ， 使 用 新 的 CountdownEvent 
类 很 有 用 。 不 需要 为 每 个 任务 创建 一 个 单独 的 事件 对 象 ， 而 只 需要 创建 一 个 事件 对 象 。CountdownEvent 类 为 所 
有 设置 了 事件 的 任务 定义 一 个 初始 数字 ， 在 到 达 该 计数 后 ， 就 器 CountdownEvent 类 发 信号 。 

修改 Calculator 类 ， 以 使 用 CountdownEvent 类 蔡 代 ManualResetEvent 类 。 不 使 用 Set0 方 法 设置 信和 号， 而 使 
用 CountdownEvent 类 定义 Signal0 方 法 (代码 文件 EventSampleWithCountdownEvent /Calculator.cs)。 


Public class Calculator 
{ 
Private CountdownEvent cEvent.; 
Public int Result { get; private set; } 


Public Calculator (CountdownEvent ev) 
{ 

_CEvent = ev; 
} 


Public void Calculation(int x, int vy) 

{ 
Console.WriteLine{(s$"Task {Task.CurrentId} starts calculation™).: 
Task.Delay (new Random() .Next (3000)) .Wait (); 
Result = + yr 
// signal the event-completed! 
Console.WriteLine($"Task {Task.CurrentId} is ready"™); 
_cEvent.Signal(); 

} 

} 


Main0 方 法 现在 可 以 简化 ， 使 它 只 需要 等 待 一 个 事件 。 如 果 不 像 前 面 那样 单独 处 理 结果 ， 这 个 新 版 本 就 很 
不 错 。 


const Int taskCount = 4; 
var CEvent = new CountdownEvent (taskCount).: 


var Calcs = new Calculator[ltaskCountl:; 
for (nt 1 = 0; 1 < taskCount; 1i++) 
{ 

CAaAlcs[i] = new Calculator (cEvent).; 


int 11 = 1; 
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Task.Run(() => calcs[11] Calculation，Tuple-Create(il + 1，11 + 3)) 7 
} 
cEvent .Wait().; 


Console .WriteLine ("all finished™).: 
for (nt 1 = 0; 1 < taskCount; 1i++) 
{ 
Console.WriteLine($"task for {i}, result: {calcs[1i] .Result}"); 


} 


21.16 Barrier 类 


对 于 同步 ，Barrier 类 非常 适用 于 其 中 工作 有 多 个 任务 分 支 且 以 后 义 需 要 合并 工作 的 情况 。Barrier 类 用 于 需 
要 同步 的 参与 者 。 激 活 一 个 任务 时 ， 就 可 以 动态 地 添加 其 他 参与 者 ， 例 如 ， 从 父 任务 中 创建 子 任务 。 参 与 者 在 
继续 之 前 ， 可 以 等 等 所 有 其 他 参与 者 完成 其 工作 。 

BarrierSample 有 所 复杂 ， 但 它 展示 了 Bamier 类 型 的 功能 。 下 面 的 应 用 程序 使 用 一 个 包含 2 000 000 个 随机 字 
符 串 的 集合 。 使 用 多 个 任务 遍历 该 集合 ， 并 统计 以 a、b、c 等 开头 的 字符 串 个 数 。 工 作 不 仅 分 布 在 不 同 的 任务 
之 间 ， 也 放 在 一 个 任务 中 。 上 毕竟 所 有 的 任务 者 迭代 字符 串 的 第 一 个 集合 ， 汇 总 结果 ， 以 后 任务 会 继续 处 理 下 一 


个 集合 。 


FillData0 方 法 创建 一 个 集合 ， 并 用 随机 字符 串 填 充 它 (代码 文件 BarrierSample/Proegram.cs): 


public static IEnumerable<string> FillDatal(Int size) 
{ 

Var I = new Randoml().; 

return Enumerable.Range (0, size) .Select (x => GetStrIng(I) ) ; 
} 


private static string GetSstring (Random IT) 
: Var sb = new StringBuilder (6); 
for (int i = 0O; 1 < 6; i++) 
| sb.Append({ (char) (rr.Next (26) + 97)).; 
J sb.ToString(}); 


} 
在 LogBarrierInformation 方法 中 定义 一 个 辅助 方法 ， 来 显示 Barrier 的 信息 : 


private static void LogBarrierinformation(string info, Barrier barrier) 
{ 

Console .WriteLine ($s$"Task {Task.currentIid}: {info}. ™ + 
$s"{barrier.ParticipantCount} current and ™ + 
$s"{barrier.ParticipantsRemaining} remaining participants, ™ 十 
s"phase {barrier.CurrentPhaseNumber}").; 

} 


CalculationInTask0 方 法 定义 了 任务 执行 的 作业 。 通 过 参数 ， 第 3 个 参数 引用 Barrier 实例 。 用 于 计算 的 数据 
是 数组 IList<string>。 最 后 一 个 参数 是 int 锯齿 数组 ， 用 于 在 任务 执行 过 程 中 写 出 结果 。 

任务 把 处 理 放 在 一 个 循环 中 。 每 一 次 循环 中 ， 都 处 理 IList<string>[] 的 数组 元 素 。 每 个 循环 完成 后 ,任务 通过 
调用 SignalAndWait 方法 ， 发 出 做 好 了 准备 的 信号 ， 并 等 每 ， 直 到 所 有 的 其 他 任务 也 准备 好 处 理 为 止 。 这 个 循 
环 会 继续 执行 ， 直 到 任务 完全 完成 为 止 。 接 着 ， 任 务 就 会 使 用 RemoveParticipant0 方 法 从 Barrier 类 中 删除 它 目 
己 (代码 文件 BarrierSample/Program.cs): 


private static void CalculationIinTask (int jobNumber, int partitionSsize, 
Barrier barrier, IList<string>[] coll, int loops, int[][] results) 
{ 
LogBarrierIinformation("CalculationIinTask started™", barrier); 
for (int 1 = 0; 1 < loops; I++) 
{ 
Var data = new List<string> (coll[1i]); 
int start = jobNumber * partitionsize; 
int end = start + partitionSsize; 
Console.WriteLine($"Task {Task.CurrentId} In loop {i}: partition ™ + 
s"from {start} to {end}"™y).-: 
for (int J] = start; ] < end; j++) 


一 5 


{ 
char c = aata[]][0]:; 
results[il[c 一 97]++; 
} 
Console.WriteLine($"Calculation completed from task {Task.currentId} ™ + 
s"in loop {i}. {results[i] [0]} times a, {results[i] [25]} times z"); 
LogBarrierinformation("sending signal and wait for all", barrier); 
barrier.SignalAndWait(); 
LogBarrierinformation ("waiting completed", barrier); 
} 
barrier .RemoveParticipant(); 
LOgBarrierinformation("finished task, removed participant™", barrier); 


} 

在 Main0 方 法 中 创建 一 个 Barier 实例 。 在 构造 函数 中 ， 可 以 指定 参与 者 的 数量 。 在 该 示例 中 ， 这 个 数量 是 
3(numberTasks + 1)， 因 为 该 示例 创建 了 两 个 任务 ，Main0 方 法 本 和 冉 也 是 一 个 参与 者 。 使 用 Task.Run 创建 两 个 任 
务 ， 把 授 历 集合 的 任务 分 为 两 个 部 分 。 启 动 该 任务 后 ， 使 用 SignalAndWait() 方 法 ，Main0 方 法 在 完成 时 发 出 信 
号 ， 并 等 待 所 有 其 他 参与 者 或 者 发 出 完成 的 信号 ， 或 者 从 Barrier 类 中 删除 它们 。 一 旦 所 有 的 参与 者 都 准备 好 ， 
就 提取 任务 的 结果 ， 并 使 用 Zip0 扩 展 方法 把 它们 合并 起 来 。 接 着 进 行 下 一 次 友 代 ， 等 竺 任务 的 下 一 个 结果 ( 代 
码 文 件 BarrierSample/Program.cs): 


static void Maln 1) 
{ 
const int numberTasks = 2; 
const int partitionSize = 
const int loops = 5; 
var taskResults = new Dictionary<int, int[][]>(); 
Var data = new List<string>[loops]; 
for (In 1 = 0; 1 < loops; 1++) 
{ 
data[i] = new List<string> (FillData (partitionsize * numberTasks)}); 
} 


10000005; 


var barrier = new Barrier (numberTasks + 1).: 
LogBarrierIinformation("initial participants in barrier™", barrier); 
for (int 1 = 0; i < numberTasks; 1i++) 
{ 
barrier.AddParticipant(); 
int JobNumber = 工 ; 
taskResults.Add (i, new int[loops] []); 
for (Int loop = 0; loop < loops; loopt++) 
{ 
taskResult[i, loop] = new int[26]; 
} 
Console.WriteLine("Main — starting task job {jobNumber}"); 
Task.Runt(() => CalculaticonInTask (jobNumber, partitionSize, 
barrier, data, loops, taskResults[jJobNumber]}))}); 
} 


for (int loop = 0; loop < 5; loop++) 
{ 
LogBarrierInformation("main task, start signaling and wait"”, barrier).; 
barrier.SignalAndWait().; 
LogBarrierInformationt("main task waiting completed", barrier).; 
int[][] resultcCcollectionl = taskResults[0]:; 
int[][] resultcollection?2 = taskResults[1]:; 
var resultCollection = resultCollection]l [loop] .2ip'{ 
resultCollection2[loop], {cl, c2)} => cl + C2) 7; 


char ch = a; 

int sum = 0- 

foreach (var KX lin resultcollection) 
{ 


Console .WriteLine ($"{cht++}, count: {zx}"); 
sum 十 一 xX; 

} 

LogBarrierinformation(s$"main task finished loop {loop}, sum: {sum}", 
barrier}).: 


} 


Console.WriteLine ("finished all iterations™); 
Console.ReadLine (); 


} 
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注意 : 
锯齿 数组 参见 第 7 章 ，zip 扩展 方法 参见 第 13 章 ， 


运行 应 用 程序 ， 输 出 如 下 所 示 。 在 输出 中 可 以 看 到 ， 每 个 AddParticipant 调用 都 会 增加 参与 者 的 数量 和 剩 
下 的 参与 者 数量 。 只 要 一 个 参与 者 调用 SignalAndWait， 剩 下 的 参与 者 数 就 会 递减 。 当 剩 下 的 参与 者 数量 达到 0 
时 ， 所 有 参与 者 的 等 待 就 结束 ， 开 始 下 一 个 阶段 : 


Task : initial participants in barrier. 1 current and 1 remaining participants, 
phase 0. 

Main 一 starting task Job 0 

Main — starting task job 1 

Task : main task, starting signaling and wait. 3 current and 

3 remaining participants, phase 0. 

Task 4: CalculationInTask started. 3 current and 2 remaining participants, phase 0. 
Task 5: CalculationInTask started. 3 current and 2 remaining participants, phase 0. 
Task 4 in loop 0: partition from 0 to 1000000 

Task 5 in loop 0: partition from 1000000 to 2000000 

Calculation completed from task 4 in loop 0. 38272 times a, 38637 times Zz 

Task 4: sending signal and wait for all. 3 current and 

2 remaining participants, phase 0. 

Calculation completed from task 5 in loop 0. 38486 times a, 38781 times Zz 

Task 5: sending signal and wait for all. 3 current and 

1 remaining participants, phase 0. 

Task 5: waiting completed. 3 current and 3 remaining participants, phase 1 

Task 4: waiting completed. 3 current and 3 remaining participants, phase 1 

Task : main waiting completed. 3 current and 3 remaining participants, phase 1 


21.17 ReaderWriterLockSlim 类 


为 了 使 锁定 机 制 允许 锁定 多 个 读 取 器 (而 不 是 一 个 写 入 器 ) 访 问 某 个 资源 ， 可 以 使 用 ReaderWriterLockSlim 
类 。 这 个 类 提供 了 一 个 锁定 功能 ， 如 果 没 有 写 入 器 锁定 资源 ， 就 允许 多 个 读 取 器 访问 资源 ， 但 只 能 有 一 个 写 入 
器 锁定 该 资源 。 

ReaderWriterLockSlim 类 有 阻塞 或 不 阻塞 的 方法 来 获取 读 取 锁 ， 如 阻塞 的 EnterReadLock0 和 不 阻塞 的 
TiyEnterReadLockO 方 法 , 还 可 以 使 用 阻塞 的 EnterWriteLock0O 和 不 阻塞 的 TyEnterWriteLock0 方 法 获得 写 入 锁定 。 
如 果 任 务 先 读 取 资 源 , 之 后 写 入 资源 , 它 就 可 以 使 用 EnterUpgradableReadLock0 或 TryEnterUperadableReadLock0O 
方法 获得 可 升级 的 读 取 锁 定 。 有 了 这 个 锁定 ， 就 可 以 获得 写 入 锁定 ， 而 不 需要 释放 读 取 锁 定 。 

这 个 类 的 几 个 属性 提供 了 当前 锁定 的 相关 信息 ， 如 CurentReadCount 、 WaitingReadCount 、 
WaitineUperadableReadCount 和 Waitine WriteCount。 

下 面 的 示例 程序 创建 了 一 个 包含 6 项 的 集合 和 一 个 ReaderWriterLockSlim0O 对 象 。ReaderMethod0O 方 法 获得 
一 个 读 取 锁定 ， 读 取 列 表 中 的 所 有 项 ， 并 把 它们 写 到 控制 台中 。WriterMethod() 方 法 试图 获得 一 个 写 入 锁定 ， 
以 改变 集合 的 所 有 值 。 在 Main0 方 法 中 ， 局 动 6 个 任务 ， 以 调用 ReaderMethod0 或 WriterMethod0 方 法 (代码 文 
件 ReaderWriterSample/Proeram.cs)。 


Class Program 
{ 
private static List<int> 1Items = new List<int>{} { 0, 1, 2, 3, 4, 5}; 
Private static ReaderWriterLockSslim rwl = 
new ReaderWriterLockSlim(LockRecursionPolicy.SupportsRecursion).; 


public static void ReaderMethod (object reader) 
{ 


try 

{ 
_ 工 WwW .EnterReadLock (); 
for (int i = 0; i < items.Count; I++) 
{ 


Console.WriteLine ($"reader {reader}, loop: {1i}, item: { items[1]}"); 
Task.Delay (40) .Wait (); 加 
} 
} 
finally 
{ 
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_rwl .ExitReadLock () : 
} 
} 


Public static void WriterMethod(object writer) 
{ 
try 
{ 
while (! rwl.TryEnterWriteLock (50) ) 
{ 
Console.WriteLine ($"Writer {writer} waiting for the write Lock") ; 
Console.WriteLine ("current reader count: { rwil.currentReadCount}"); 
} 
Console .WriteLine ($"Writer {writer} acaquired the lock"™).; 
for (int i = 0; i < items.Count; i+t+) 
{ 
_ 工 上 ems [ 工 ] 十 十 7 
Task.Delay (50) .Wait(}); 
} 
Console .WriteLine (S$"Writer {writer} finished™}):; 
} 
finally 
{ 
_rwl .ExitWriteLock(); 
} 
} 


static void Maint{) 

{ 
var taskFactory = new TaskFactory (TaskCreationoptions .LongRunning, 

TaskContinuationOoptions .None).,; 

var tasks = new Task[él]:; 
tasks[0] = taskFactory.StartNew (WriterMethod, 1); 
tasks[l1] = taskFactory.StartNew (ReaderMethod, 1).; 
tasks [2z] taskFactory.StartNew (ReaderMethod, 2); 
tasks[3] = taskFactory.SsStartNew (WriterMethod, 2); 
tasks[4] = taskFactory.StartNew (ReaderMethod, 3) 
tasks[3] = taskFactory.StartNew (ReaderMethod, 4).; 
Task.WaitAll (tasks); 

} 

} 


运行 这 个 应 用 程序 ， 可 以 看 到 第 一 个 写 入 器 先 获 得 锁定 。 第 二 个 写 和 人 器 和 所 有 的 读 取 器 需要 等 待 。 接 独 ， 
读 取 器 可 以 同时 工作 ， 而 第 二 个 写 入 器 仍 在 等 待 资源 。 


Writer 1 acgquired the lock 

Writer 2 waiting for the write lock 
current reader count: 0 

Writer 2 waiting for the write lock 
current reader count: 0 

Writer 2 waiting for the write lock 
current reader count: 0 

Writer 2 waiting for the write lock 
current reader count: 0 

Writer 1 finished 

reader 4, loop: 0, item: 1 

reader 1, loop: 0, item: 1 

Writer 2 waiting for the write lock 
current reader count: 4 


reader 2, loop: 0, item: 1 
reader 3, loop: 0, item: 1 
reader 4, loop: 1, item: 2 
reader 1, loop: 1, item: 2 
reader 3, loop: 1, item: 2 
reader 2, loop: 1, item: 2 


Writer 2 waiting for the write lock 
current reader count: 4 

reader 4, loop: 2, item: 3 

reader 1, loop: 2, item: 3 

reader 2, loop: 2, item: 3 

reader 3, loop: 2, item: 23 

Writer 2 waiting for the write lock 
current reader count: 4 

reader 4, loop: 3, item: 4 
reader 1, loop: 3, item: 4 
reader 2, loop: 3, item: 4 
reader 3, loop: 3, item: 4 
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reader 4, loop: 4, item: 5 

reader 1, loop: 4, item: 5 

Writer 2 waiting for the write lock 
CUIrrent reader count: 4 


reader 2, loop: 4, item: 5 
reader 3, loop: 4, item: 5 
reader 4, loop: 5, item: 6 
reader 1, loop: 5, item: 6 
reader 2, loop: 5, item: 6 
reader 3, loop: 5, item: 6 


Writer 2 waiting for the write lock 
CUIrrent reader count: 4 

Writer 2 acquired the lock 

Writer 2 finished 


21.18 Lock 和 await 


如 果 试 图 在 lock 块 中 使 用 async 关键 字 时 使 用 lock 关键 字 , 会 得 到 这 个 编译 错误 : cannot await in the body 
of a lock statement。 原 因 是 在 async 完成 之 后 ， 该 方法 可 能 会 在 一 个 不 同 的 线程 中 运行 ， 而 不 是 在 async 关键 字 
之 前 。lock 关键 字 需 要 同一 个 线程 中 获取 锁 和 释放 锁 。 

下 面 的 代码 块 会 导致 编译 错误 : 

static async Task IncorrectLockasync () 


lock (s syncLock) 

{ 
Console.WriteLine($"{nameof (IncorrectLockAsync)} started"™).,; 
await Task.Delay (500})}; // compiler error: cannot await in the body 

/i of a lock statement 

Console.WriteLine($"{nameof (IncorrectLockAsync)} ending"); 

} 

} 


如 何 解决 这 个 问题 ? 不 能 为 此 使 用 Monitor， 因 为 Monitor 需要 从 它 获取 锁 的 同一 线程 中 释放 锁 。lock 关键 
字 基 于 Monitor。 

虽然 Mutex 对 象 可 以 用 于 不 同 进程 之 间 的 同步 ， 但 它 有 相同 的 问题 : 它 为 线程 授予 了 一 个 锁 。 从 不 同 的 线 
程 中 释放 锁 是 不 可 能 的 。 相 反 ， 可 以 使 用 Semaphore 或 SemaphoreSlim 类 。Semaphore 可 以 从 不 同 的 线程 中 释 
放 信 号 量 。 

下 面 的 代码 片段 使 用 SemaphoreSlim 对 象 上 的 WaitAsync 等 竺 获得 一 个 信号 量 . SemaphoreSlim 对 象 初始 化 
为 计数 1， 因 此 对 信号 量 的 等 待 只 授予 一 次 。 在 finally 代码 块 中 ， 通 过 调用 Release 方法 释放 信号 量 (代码 文件 
LockAcrossAWwait/Program.cs): 


Private static SemaphoreSlim s asyncLock = new SemaPhoreSlim(1) :; 
static async Task LockWithsemaphore (string title) 
{ 
Console .WriteLine($"{title} waiting for lock"™"); 
await s asyncLock .WaitAsync().; 
try 
| 
Console.WriteLine($"{title} {nameof (LockWithSemaphore)} started™).; 
await Task.Delay (500);} 
Console.WriteLine($"{title} {nameof (LockWithSemaphore)} ending™"™); 
} 
finally 
{ 
s asyncLock .Release() 
} 


} 
下 面 尝 试 在 多 个 任务 中 同时 调用 此 方法 。 该 方法 RunUseSemaphoreAsync 启动 6 个 任务 ， 并 发 地 调用 
LockWithSemaphore 方法 : 
static async Task RunUseSemaphoreasync () 
Console .WriteLine (nameof (RunUseSemaphoreAsync) ) ; 
string[] messages = { "one", "two", "three"™, "four"™, "five", "six"™ }; 


Task[] tasks = new Task[messages.Lengthl]; 
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for (int i = 0; 1 < messages.Length; 1i++) 
{ 

string message = messages{[1i]; 

tasks[i] = Task.Runlasync () => 

{ 


await LockWithSemaphore (message); 
})s 
} 


await Task.WhenBll (tasks).:; 
Console .WriteLine (}); 


| 
运行 该 程序 ， 可 以 看 到 多 个 任务 同时 局 动 ， 但 是 在 信和 号 量 被 锁定 后 ， 所 有 其 他 任务 都 需要 等 竺 信号 量 再 次 
释放 : 


RunLockKWithAwaitAsync 

two waiting for lock 

two LockWithsemaphore started 
three walting for lock 

five waiting for lock 

four waiting for lock 

Six waliting for lock 

one walting for lock 

two LockWithSsSemaphore ending 
three LockWithSemaphore started 
three LockWithSemaphore ending 
five LockWithSemaphore started 
fijve LockWithSemaphore ending 
four LockWithSemaphore started 
four LockWithSemaphore ending 
six LockWithSsemaphore started 
Six LockWithSsSemaphore ending 
one LockWithsemaphore started 
one LockWIthSemaphore ending 


为 了 更 容易 地 使 用 锁 ， 可 以 创建 一 个 实现 IDisposable 接口 的 类 来 管理 资源 。 对 于 这 个 类 ， 可 以 使 用 using 
语句 ， 就 像 使 用 lock 状态 来 锁定 和 释放 信号 量 一 样 。 

下 面 的 代码 片段 实现 了 AsyncSemaphore 类 ,该 类 在 构造 阔 数 中 分 配 一 个 SemaphoreSlim, 在 AsyncSemaphore 
上 调用 WaitAsync 方法 时 ， 人 返回 实现 接口 IDisposable 的 内 部 类 SemaphoreReleaser。 调 用 Dispose 方法 时 ， 释 放 
信号 量 ( 代 码 文件 LockAcrossAwait /AsyncSemaphore.cs): 


Public sealed class AsyncSemaphore 
{ 
private class SemaphoreReleaser : IDisposable 


{ 


private SemaphoreSlim semaphore; 


Public SemaphoreReleaser (SemaphoreSslim semaphore}) 三 > 
semaphore = semaphore; 


public void Dispose() => semaphore.Release().; 
} 


private SemaphoreSlim semaphore; 
public AsyncSemaphore() => 
_ semaphore = new SemaphoreSlim(1); 


Public async Task<IDisposable> WaitAsync() 
1 
await semaphore.WaitAsync(); 
return new SemaphoreReleaser( semaphore) as IDisposable; 
} 
} 


从 前 面 所 示 的 LockWithSemaphore 方法 中 更 改 实现 ， 现 在 可 以 使 用 using 语句 锁定 信号 量 。 记 住 ，using 语 
句 创建 一 个 catchyfinally 块 ， 在 finally 块 中 调用 Dispose 方法 (代码 文件 LockAcrossAwait/Program.cs): 


private static AsyncSemaphore s asyncSemaphore = new AsyncSemaphore(); 
static async Task UseAsyncSemaphore (string title) 
{ 


using (awalt s asyncSemaphore .WaitAsync()) 
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{ 
Console.WriteLine($"{title} {nameof (LockWithSsemaphore)} started"™); 
await Task.Delay (500);} 
Console.WriteLine(s$"{title} {nameof (LockWithSemaphore)} ending™"™); 
} 
} 


使 用 类 似 于 LockWithSemaphore 方法 的 UseAsyncSemaphore 方法 会 执行 相同 的 行为 。 然而 , 类 只 编写 一 次 ， 
等 待 过 程 中 的 锁定 就 变 得 更 简单 。 


21.19 小结 


本 章 介绍 了 如 何 通 过 System.Threading.Tasks 名 称 空间 编写 多 任务 应 用 程序 。 在 应 用 程序 中 使 用 多 线程 要 仔 
细 规 划 。 太 多 的 线程 会 导致 资源 问题 ， 线 程 不 足 又 会 使 应 用 程序 执行 缓慢 ， 执 行 效果 也 不 好 。 使 用 任务 可 以 获 
得 线程 的 抽象 。 这 个 抽象 有 助 于 避免 创建 过 多 的 线程 ， 因 为 线程 是 在 池 中 重用 的 。 

我 们 探讨 了 创建 多 个 任务 的 各 种 方法 ， 如 Parallel 类 。 通 过 使 用 Parallel.Invoke、Parallel.ForEach 和 
Parallel For， 可 以 实现 任务 和 数据 的 并 行 性 。 还 介绍 了 如 何 使 用 Task 类 来 获得 对 并 行 编程 的 全 面 控制 。 任 务 可 
以 在 主 调 线程 中 异步 运行 ， 使 用 线程 池 中 的 线程 ， 以 及 创建 独立 的 新 线程 。 任 务 还 提供 了 一 个 层次 结构 模型 ， 
允许 创建 子 任务 ， 并 且 提 供 了 一 种 取消 完整 层次 结构 的 方法 。 

取消 架构 提供 了 一 种 标准 机 制 ， 不 同 的 类 可 以 以 相同 的 方法 使 用 它 来 提前 取消 茶 个 任务 。 

本 章 讨论 了 几 个 可 用 于 .NET 的 同步 对 象 ， 以 及 适合 使 用 同步 对 象 的 场合 。 简 单 的 同步 可 以 通过 lock 关键 
字 完 成 。 在 后 台 ，Monitor 类 型 允许 设置 超时 ， 而 lock 关键 字 不 允许 。 为 了 在 进程 之 间 进 行 同 步 ，Mutex 对 象 
提供 了 类 似 的 功能 。Semaphore 对 象 表示 市 有 计数 的 同步 对 象 ， 该 计数 是 允许 并 发 运行 的 任务 数量 。 为 了 通知 
其 他 任务 已 准备 好 , 讨论 了 不 同类 型 的 事件 对 象 ， 比 如 AutoResetEvent、 ManualResetEvent 和 CountdownEvent。 
拥有 多 个 读 取 器 和 写 入 器 的 简单 方法 由 ReaderWriterLock 提供 。Barrier 类 型 提供 了 一 个 更 复杂 的 场景 ， 其 中 可 
以 同时 运行 多 个 任务 ， 直 到 达到 一 个 同步 点 为 止 。 一 旦 所 有 任务 达到 这 一 点 ， 它 们 就 可 以 继续 同时 满足 于 下 一 


个 同步 点 。 
下 面 是 有 关 线 程 的 几 条 规则 : 
se 尺 力 使 同步 要 求 最 低 。 同 步 很 复杂 ， 且 会 阻塞 线程 。 如 果 尝 试 避免 共享 状态 ， 就 可 以 避免 同步 。 当 然 ， 
这 不 总 是 可 行 。 


e 类 的 静态 成 员 应 是 线程 安全 的 。 通 常 ，.NET Framework 中 的 类 满足 这 个 要 求 。 

e 实例 状态 不 需要 是 线程 安全 的 。 为 了 得 到 最 佳 性 能 ， 最 好 在 类 的 外 部 使 用 同步 功能 ， 且 不 对 类 的 每 个 
成 员 使 用 同步 功能 ..NET Framework 类 的 实例 成 员 一 般 不 是 线程 安全 的 .在 MSDN API 库 中 , 对 于 .NET 
Framework 的 每 个 类 在 “线程 安全 性 ”部 分 中 可 以 找到 相应 的 归档 信息 。 

第 23 章 介绍 另 一 个 NET 核心 主题 ， 文件 和 流 。 


入 


文件 和 流 


本 章 要 点 

e 介绍 目录 结构 

移动 、 复 制 、 删 除 文 件 和 文件 夹 
读 写 文本 文件 

使 用 流 读 写 文 件 

使 用 阅读 器 和 写 入 器 读 写 文件 
压缩 文件 

监控 文件 的 变化 

使 用 管道 进行 通信 

使 用 Windows Runtime 流 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 WWW.Wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 FilesAndStreams 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 

本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

® DIVveImntormnation 
WorkineWithFilesAndFolders 
StreanmSamples 


ReaderWriterSamples 
CompressFileSample 
FileMonitor 
MemoryMappedFlles 
NamedPipes 
AnonymousPipes 
WmdowsAppEditor 
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22.1 


当 读 写 文件 和 目录 时 ， 可 以 使 用 简单 的 API， 也 可 以 使 用 先进 的 API 来 提供 更 多 的 功能 。 还 必须 区 分 
Windows Runtime 提供 的 NET 类 和 功能 。 在 通用 Windows 平台 (UWP)Windows 应 用 程序 中 , 不 能 在 任何 目录 中 
访问 文件 系统 ， 只 能 访问 特定 的 目录 。 或 者 ， 可 以 让 用 户 选 择 文件 。 本 章 涵 盖 了 所 有 这 些 选项 ， 包 括 使 用 简单 的 
API 读 写 文件 并 使 用 流 得 到 更 多 的 功能 ; 利用 NET 类 型 和 Windows Runtime 提供 的 类 型 ， 混 合 这 两 种 技术 以 利 
用 NET 功能 和 Windows 运行 库 。 

使 用 流 ， 也 可 以 压缩 数据 ， 并 且 利 用 内 存 映射 的 文件 和 管道 在 不 同 的 任务 间 共 享 数据 。 


22.2 ”管理 文件 系统 


图 22-1 中 的 类 可 以 用 于 浏览 文件 系统 和 执行 操作 ， 如 移动 、 复 制 和 删除 文件 。 
这 些 类 的 作用 是 : 


FileSystemlInfo 一 一 这 是 表示 任何 文件 系统 对 象 的 基 类 。 

FileInfo 和 File 一 一 这 些 类 表示 文件 系统 上 的 文件 。 
DirectoryInfo 和 Directory 一 一 这 些 类 表示 文件 系统 上 的 文件 夹 。 
Path 一 一 这 个 类 包含 的 静态 成 员 可 以 用 于 处 理 路 径 名 。 
DriveInfo 一 一 它 的 属性 和 方法 提供 了 指定 驱动 器 的 信息 。 


注意 : 
目录 或 文件 夹 这 两 个 术语 经 常 可 以 互 挽 。 目录 是 文件 系统 对 象 的 经 典 术语 。 目 录 和 包含 文件 和 其 他 目录 。 文 
件 夹 起 源 于 苹果 的 Lisa， 是 一 个 GUI 对 象 。 它 通常 与 映射 到 目录 的 图 标 相关 联 。 


下 


Y FileSystemlnfo Drivelnfo 
| | 
¥ DirectorylInfo lw Filelnfe : 
¥ <<utility>> | E <<utility>> <<utility>> 
Directory File Path 
图 22-1 


注意 ， 上 面 的 列表 有 两 个 用 于 表示 文件 夹 的 类 ， 和 两 个 用 于 表示 文件 的 类 。 使 用 哪个 类 主要 依赖 于 访问 该 
文件 夹 或 文件 的 次 数 : 
® Directory 类 和 File 类 只 包含 静态 方法 ， 不 能 被 实例 化 。 只 要 调用 一 个 成 员 方 法 ， 提 供 合适 文件 系统 对 


象 的 路 径 ， 就 可 以 使 用 这 些 类 。 如 果 只 对 文件 夹 或 文件 执行 一 个 操作 ， 使 用 这 些 类 就 很 有 效 ， 因 为 这 
样 可 以 省 去 创建 NET 对 象 的 系统 开销 。 

DirectoryInfo 类 和 FileInfo 类 实现 与 Directory 类 和 File 类 大 致 相同 的 公共 方法 ， 并 拥有 一 些 公 共 属 性 
和 构造 函数 ， 但 它们 都 是 有 状态 的 ， 并 且 这 些 类 的 成 员 都 不 是 静态 的 。 需 要 实例 化 这 些 类 ， 之 后 把 每 
个 实例 与 特定 的 文件 夹 或 文件 关联 起 来 。 如 果 使 用 同一 个 对 象 执行 多 个 操作 ， 使 用 这 些 类 就 比较 有 效 。 
这 是 因为 在 构造 时 它们 将 读 取 合适 文件 系统 对 象 的 号 份 验证 和 其 他 信息 , 无 论 对 每 个 对 象 (类 实例 ) 调 用 
了 多 少 方法 ， 都 不 需要 再 次 读 取 这 些 信息 。 比 较 而 言 ， 在 调用 每 个 方法 时 ， 相 应 的 无 状态 类 需要 再 次 
检查 文件 或 文件 夹 的 详细 内 容 。 
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22.2.1 检查 驱动 器 信息 


在 处 理 文件 和 目录 之 前 ， 先 检查 驱动 器 信息 。 这 使 用 DriveInfo 类 实现 。DriveInfo 类 可 以 扫描 系统 ， 提 供 
可 用 驱动 器 的 列表 ， 还 可 以 进一步 提供 任何 驱动 器 的 大 量 细节 。 
为 了 举例 说 明 DriveInfo 类 的 用 法 ， 创 建 一 个 简单 的 Console 应 用 程序 ， 列 出 计算 机 上 的 所 有 可 用 的 驱 
动 器 。 
DriveInformation 的 示例 代码 使 用 了 以 下 名 称 空间 : 
System 
System.IO 
下 面 的 代码 片段 调用 静态 方法 DriveInfo.GetDrives。 这 个 方法 返回 一 个 DrivelInfo 对 象 的 数组 。 通 过 这 个 数 
组 ， 访 问 每 个 驱动 器 ， 准 备 写 入 驱动 器 的 名 称 、 类 型 和 格式 信息 ， 它 还 显示 大 小 信息 (代码 文件 
DriveInformation/Program.cs): 


DriveInfo[] drives = DriveInfo.GetDrivest().: 
foreach (DrivelInfo drive in drives) 
{ 
if (drive.IsReady) 
{ 
Console.WriteLine{({$"Drive name: {drive.Name}").; 
Console.WriteLine($"Format: {drive.DriveFormat}™); 
Console.WriteLine($"Type: {drive.DriveType}"™); 
Console.WriteLine($"Root directory: {drive.RootDirectory}"); 
Console.WriteLine{(s$"Volume label: {drive.VolumeLabel}"™).: 
Console.WriteLine($"Free space: {drive.TotalFreeSpace}"); 
Console.WriteLine($"Available space: {drive.AvailableFreeSpace}"); 
Console.WriteLine($"Total size: {drive.TotalSsize}"™):; 
Console.WriteLine():; 
} 
} 


在 没有 DVD 光驱 、 但 有 固态 硬盘 (solid-state disk，SSD) 和 内 存 卡 的 系统 上 ,运行 这 个 程序 ， 得 到 如 下 信息 : 


Drive name: C:\ 

FOIrmat: NTFS 

Type: Fixed 

Root directory: C:\ 

Volume label: Windows 

Free space: 289063882752 
Avallable space: 289063882752 
Total size: 509571969024 


Drive name: D:\ 

Format: exFAT 

TyYpe: Removable 

Root directory: D:\ 

Volume label: 

Free space: 196831477760 
Avallable space: 196831477760 
Total size: 196832395264 


的 系统 上 的 文件 API 来 访问 : 


Drive name: / 

Format: hfs 

Type: Fixed 

Root directory: / 

Volume label: / 

Free space: 110332930048 
Available space: 170070786048 
Total size: 249769230336 


Drive name: /dev 
Format: devs 

TYPe: 及 am 

Root directory: /dev 
Volume label: /dev 
Free space: 0 
Avalilable space: 0 
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Total size: 1984832 


Drive name: /net 
Format: autofs 

Type: Network 

Root directory: /net 
Volume label: /net 
Free space: 0 
Available space: 0 
Total size: 0 


22.2.2 使 用 Path 类 


为 了 访问 文件 和 目录 ， 需 要 定义 文件 和 目录 的 名 称 ， 包 括 父 文件 夹 。 使 用 字符 串 连 接 操作 符合 并 多 个 文件 
夹 和 文件 时 ， 很 容易 遗漏 单个 分 隔 符 或 使 用 太 多 的 字符 。 为 此 ，Path 类 可 以 提供 帮助 ， 因 为 这 个 类 会 添加 缺少 
的 分 隔 符 ， 它 还 在 基于 Windows 和 Unix 的 系统 上 处 理 不 同 的 平台 需求 。 

Path 类 提供 了 一 些 静 态 方法 ， 可 以 更 容易 地 对 路 径 名 执行 操作 。 例 如 ， 假 定 要 显示 文件 夹 Di\Projects 中 
ReadMe.txt 文件 的 完整 路 径 名 ， 可 以 用 下 述 代 码 查 找 文件 的 路 径 : 

Console.WriteLine (Path.Combine (@"D:\Projects", "ReadMe .txt")); 

Path.Combine0O 是 这 个 类 最 常用 的 一 个 方法 ，Path 类 还 实现 了 其 他 方法 ， 这 些 方法 提供 路 径 的 信息 ， 或 者 以 
要 求 的 格式 显示 信息 。 

使 用 公共 字段 VolumeSeparatorChar、DirectorySeparatorChar、AltDirectorySeparatorChar 和 PathSeparator， 
可 以 得 到 特定 于 平台 的 字符 ， 用 于 分 隔 开 硬 盘 、 文 件 光 和 文件 ， 以 及 分 隔 开 多 个 路 径 。 在 Windows 中 ， 这 些 字 
和 从 是 冒号 (: )、 反 和 斜 线 作 、 正 斜 线 (D) 和 分 号 (; )。 

Path 类 也 帮助 访问 特定 于 用 户 的 临时 文件 夹 (GetTempPath)， 创 建 临 时 (GetTempFileName) 和 随机 文件 名 
(GetRandomFileName)。 注 意 ， 方 法 GetTempFileName() 包 括 文件 来， 而 GetRandomFileName0 只 返回 文件 名 ， 
不 包括 任何 文件 夹 。 

WorkingWithFilesAndDirectories 的 示例 代码 使 用 了 下 面 的 名 称 空间 : 

System 
System.Collections.Generic 
System.IO 

这 个 示例 应 用 程序 提供 了 几 个 命令 行 参数 ， 来 局 动 程序 的 不 同 功 能 。 只 是 局 动 程序 ， 没 有 命令 行 参数 ， 或 
检查 源 代码 ， 碍 看 所 有 不 同 的 选项 。 

Environment 类 定义 了 一 组 特殊 的 文件 淆 。 下 面 的 代码 片段 通过 把 枚 举 值 SpecialFolder. MyDocuments 传 
递 给 GetFolderPath 方法 ， 返 回 documents 文件 夹 (代码 文件 WorkingWithFilesAndDirectories/Program.cs): 


private Stat1lICc string GetDocumentsFolder() => 
Environment.GetFolderPath (Environment.SpecialFolder.MyDocuments); 


Environment.SpecialFolder 是 一 个 巨大 的 枚 举 ， 提 供 了 音乐 、 图 片 、 程 序 文 件 、 应 用 程序 数据 ， 以 及 许多 其 
他 文件 夹 的 值 。 


22.2.3 创建 文件 和 文件 夹 


下 面 开 始 使 用 File、FileInfo、Directory 和 DirectoryInfo 类 。 首 先 ， 方 法 CreateAFile 创建 文件 Samplel .txt， 
给 文件 添加 字符 串 Hello，World!。 创 建文 本 文件 的 简单 方式 是 调用 File 类 的 WriteAllText 方法 。 这 个 方法 的 参 
数 是 文件 名 和 应 该 写 入 文件 的 字符 串 。 一 切 都 在 一 个 调用 中 完成 (代码 文件 WorkingWithFilesAnd- 
Directories/Proeram.cs): 

const string SamplelFileName = "Samplel .md"™"; 

Fh as 

Public static void CreateArFile'() 


{ 
string fileName = Path.cCombine (GetDocumentsFolder(), SamplelFileName); 
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File.WriteAllText (fileName, "Hello, World!™); 


} 
要 复制 文件 ， 可 以 使 用 File 类 的 Copy 方法 或 FileInfo 类 的 CopyTo 方法 : 
var file = new FlileInfo (fileNamel). 


file.copyTo (fileName2); 
File.Ccopy (fileNamel™", fileName?2); 


第 一 个 代码 片段 使 用 FileImnfo， 执 行 的 时 间 略 长 ， 因 为 需要 实例 化 fle 对 象 ， 但 是 fine 已 经 准备 好 ， 可 以 在 
同一 文件 上 执行 进一步 的 操作 。 使 用 第 二 个 例子 时 ， 不 需要 实例 化 对 象 来 复制 文件 。 

给 构造 函数 传递 包含 对 应 文件 系统 对 象 的 路 径 的 字符 串 ， 就 可 以 实例 化 FileInfo 或 DirectoryInfo 类 。 刚 才 
是 处 理 文 件 的 过 程 。 处 理 文件 夹 的 代码 如 下 : 

var myFolder = new DirectoryInfo(directory1) ; 

如 果 路 径 代 表 的 对 象 不 存在， 那么 构建 时 不 抛 出 一 个 异 弟 :， 而 是 在 第 一 次 调用 茶 个 方法 ， 实 际 需 要 相应 的 
文件 系统 对 象 时 抛 出 该 异常 。 检 查 Exists 属性 ， 可 以 确定 对 象 是 否 存 在， 是 否 具 有 适当 的 类 型 ， 这 个 功能 由 两 
个 类 实现 : 


var test = new FileInfolR"cC: Windows"™); 
Console .WriteLine (test.Exists).; 


请 和 注意， 这 个 属性 要 返回 ttue， 相 应 的 文件 系统 对 象 必须 具备 适当 的 类 型 。 换 句 话 说 ， 如 果实 例 化 FileInfo 
对 象 时 提供 了 文件 夹 的 路 径 ， 或 者 实例 化 DirectoryInfo 对 象 时 提供 了 文件 的 路 径 ，Exists 的 值 就 是 锯 lse。 如 果 
有 可 能 ， 这 些 对 象 的 大 部 分 属性 和 方法 都 返回 一 个 值 一 一 它们 不 一 定 会 抛 出 异 肖 ， 仪 因为 调用 了 类 型 错误 的 对 
象 ， 除 非 它们 要 求 执行 不 可 能 的 操作 。 例 如 ， 前 面 的 代码 片段 可 能 会 首先 显示 false( 因 为 C:\Windows 是 一 个 文 
件 夹 )， 但 它 还 显示 创建 文件 夹 的 时 间 ， 因 为 文件 来 市 有 该 信息 。 然 而 ， 如 果 想 使 用 Filemfo.Open0O 方 法 打开 文 
件 夹 ， 就 好像 它 是 一 个 文件 那样 ， 就 会 得 到 一 个 异常 。 

使 用 FileInfo 和 DirectoryInfo 类 的 MoveTo0 和 Delete0 方 法 , 可 以 移动 、 删 除 文 件 或 文件 夹 。 File 和 Directory 
类 上 的 等 效 方法 是 Move0 和 Delete()。FileInfo 和 File 类 也 分 别 实现 了 方法 CopyTo0 和 Copy0。 但 是 ， 没 有 复 
制 完 整 文件 夹 的 方法 一 一 必须 复制 文件 夹 中 的 每 个 文件 。 

所 有 这 些 方 法 的 用 法 都 非常 直观 。MSDN 文档 带 有 详细 的 描述 。 


22.2.4 访问 和 修改 文件 属性 


下 面 获取 有 关 文 件 的 一 些 信 息 。 可 以 使 用 File 和 FileInfo 类 来 访问 文件 信息 。File 类 定义 了 静态 方法 ， 而 
FileInfo 类 提供 了 实例 方法 。 以 下 代码 片段 展示 了 如 何 使 用 FileInfo 检索 多 个 信息 。 如 果 使 用 File 类 ， 访 问 速度 
将 变 慢 ， 因 为 每 个 访问 都 意味 着 进行 检查 ， 以 确定 用 户 是 否 人 允许 得 到 这 个 信息 。 而 使 用 FileInfo 类 ， 则 只 有 调 
用 构造 函数 时 才 进 行 检查 。 

示例 代码 创建 了 一 个 新 的 FileInfo 对 象 ， 并 在 控制 人 台 上 写 入 属性 Name、DirectoryName、IsReadOnly、 
Extension 、 Length 、 CreationTime 、 LastAccessTime 和 Attributes 的 结果 (代码 文件 WorkngWith- 
FilesAndDIirectories/Program.cs): 

private static void FileInformation(string fileName) 


var file = new FileInfo(fileName); 
Console .WriteLine (S$"Name: {file.Name}").: 
Console.WriteLine ($"Directory: {file.DirectoryName}"); 
Console.WriteLine ($"Read only: {file.IsReadonly}"); 
Console.WriteLine ($s$"Erxtension: {file.Extension}").; 
Console.WriteLine ($s$"Length: {file.Length}").; 
Console .WriteLine (S$"Creation time: {file.CreationTime:F}").: 
Console .WriteLine ($$"Access time: {file.LastAccessTime:F}"). 
Console.WriteLine($"File attributes: {file.Zttributes}").;: 

} 


把 当前 目录 中 的 Program.cs 文件 名 传 入 这 个 方法 : 


FileInformation("./Program.cs"); 
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在 某 台 机 器 上 ， 输 出 如 下 : 


Name: Program.cs 

Directory: C:\ProcsharpSources\files\ProfessijonalCSsSharpi\FilesAndstreams\ 
FileshAndstreamsSamples\WorkingWithFileshAndDirectories 

Read only: False 

Extension: .cs 

Length: 7637 

Creation time: Friday, September 1, 2017 12:48:51 PM 

Access time: Friday, September 1, 2017 4:07:12 PM 

File attributes: Archive 


不 能 设置 FileInfo 类 的 几 个 属性 ， 它 们 只 定义 了 get 访问 器 。 不 能 检索 文件 名 、 文 件 扩展 名 和 文件 的 长 度 。 
可 以 设置 创建 时 间 和 最 后 一 次 访问 的 时 间 。 方 法 ChangeFileProperties0 向 控制 台 写 入 文件 的 创建 时 间 ， 以 后 把 
创建 时 间 改 为 2025 年 的 一 个 日 期 。 


private static void ChangeFileProperties'() 


{ 

string fileName = Path.Combine (GetDocumentsFolder(), SamplelFileName).; 

var file = new FileInfo (fileName).; 

1if (!file.Exists) 

{ 
Console.WriteLine($"Create the file {SamplelFileName} before calling this method™); 
Console.WriteLine ("You can do this by invoking this program with the -cc argument™); 
returns 

} 


Console .WriteLine (S$"creation time: {file.creationTime:F}"):; 
file.creationTime = new DateTime (2025, 12, 24, 15, 0, 0); 
Console .WriteLine ($"creation time: {file.creationTime:F}").; 


} 
运行 程序 ， 显示 文件 的 初始 创建 时 间 以 及 修改 后 的 创建 时 间 。 将 来 可 以 用 这 项 技术 创建 文件 (至 少 可 以 指定 
创建 时 间 )。 


creation time: Sunday, December 20, 2015 9:41:49 AM 
creation time: Wednesday, December 24, 2025 3:00:00 PM 


注意 : 

初 看 起 来 ， 能 够 手动 修改 这 些 属性 可 能 很 奇怪 ， 但 是 它 非常 有 用 。 例 如 ， 如 果 程 序 只 需要 读 取 文件 、 删 除 
它 ， 再 用 新 内 容 创 建 一 个 新 文件 ， 就 可 以 有 效 地 修改 文件 ， 就 可 以 通过 修改 创建 日 期 来 匹配 旧 文 件 的 原始 创建 
日 期 。 


22.2.5 ”使 用 File 执行 读 写 操作 


通过 File.ReadAllText 和 File.WriteAllText， 引 入 了 一 种 使 用 字符 串 读 写 文件 的 方法 。 除 了 使 用 一 个 字符 串 
之 外 ， 还 可 以 给 文件 的 每 一 行使 用 一 个 字符 串 。 

不 是 把 所 有 行 读 入 一 个 字符 串 ， 而 是 从 方法 File ReadAllLines 中 返回 一 个 字符 串 数 组 。 使 用 这 个 方法 ， 可 以 
对 每 一 行 执行 不 同 的 处 理 , 但 仍然 需要 将 完整 的 文件 读 入 内 存 (代码 文件 WorkingWithFilesAndFolders/Program.cs): 


Public static volid ReadingAFileLineByLine (string fileName) 


{ 
string[] lines = File.ReadAllLines (fileName).:; 
int 1 = 1- 
foreach (var line in lines) 
{ 
Console.WriteLine{(s$"{1i++}. {line}™); 
} 
Fo 
} 


要 逐 行 读 取 , 不 需要 等 待 所 有 行 都 读 取 完 ， 可 以 使 用 方法 File.ReadLines。 该 方法 返回 IEnumerable<string>， 
在 读 取 完 整个 文件 之 前 ， 就 可 以 过 历 它 ; 
Public static volid ReadingAFileLineByLine (string fileName) 
{ 
Fy 
IEnumerable<string> lines = File.ReadLines (fileName); 
了 = 时 > 
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foreach (var line in lines) 
{ 
Console.WriteLine($"{i++}. {line}™).; 
} 
} 
要 写 入 字符 串 集 合 ， 可 以 使 用 方法 File.WriteAllLines。 该 方法 接受 一 个 文件 名 和 IEnumerable<string> 类 型 
作为 参数 : 
public static void WriteArile() 
{ 
string fileName = Path.Combine (GetDocumentsFolder(), "movies.txt"); 
string[] movies = 
{ 
"Snow White And The Seven Dwarfs" ， 
"Gone With The Wind"™, 
"Casablanca™, 
"The Bridge On The River Ewal"™, 
"Some Like It Hot™ 
1 
File.WriteAllLines(fileName, movies); 
} 
为 了 把 字符 串 退 加 到 已 有 的 文件 中 ， 应 使 用 File.AppendAllLines: 
string[] moreMovies = 
{ 
"Psycho™, 
"Easy Rider"., 
"Star Wars™, 
"The Matrix”™ 


更 
File.AppendAllLines (fileName, moreMoviles); 


22.3 ” 枚 举 文件 


处 理 多 个 文件 时 ， 可 以 使 用 Directory 类 。Directory 定义 了 GetFiles0 方 法 ， 它 返回 一 个 包含 目录 中 所 有 文 
件 的 字符 串 数组 。GetDirectories0 方 法 返回 一 个 包含 所 有 目录 的 字符 串 数 组 。 

所 有 这 些 方法 都 定义 了 重 载 方法 ， 人 允许 传送 搜索 模式 和 SearchOption 枚 举 的 一 个 值 。SearchOption 通过 使 
用 AllDirectories 或 TopDirectoriesOnly 值 ， 可 以 遍历 所 有 子 目 录 ， 或 留 在 顶级 目录 中 。 搜 索 模式 不 允许 传递 正 
则 表达 式 (参见 第 9 章 );， 它 只 传递 简单 的 表达 式 ， 其 中 使 用 * 表 示 任 意 字 符 ， 使 用 ?表示 单个 字符 。 

遍历 很 大 的 目录 (或 子 目 录 ) 时 ，GetFiles0 和 GetDirectories0 方 法 在 返回 结果 之 前 需要 完整 的 结果 。 另 一 种 方 
式 是 使 用 方法 EnumerateDirectories0 和 EnumerateFiles0。 这 些 方法 为 搜索 模式 和 选项 提供 相同 的 参数 ， 但 是 它 
们 使 用 IEnumerable<string> 立 即 开 始 返回 结果 。 

下 面 是 一 个 例子 : 在 一 个 目录 及 其 所 有 子 目 录 中 ， 删 除 所 有 以 Copy 结尾 的 文件 ， 以 防 存 在 男 一 个 具有 相 
同名 称 和 大 小 的 文件 。 为 了 模拟 这 个 操作 ， 可 以 在 键盘 上 按 Ctrl+A， 选 择 文 件 夹 中 的 所 有 文件 ， 在 键盘 上 按 下 
Ctrl + C， 进 行 复制 ， 再 在 鼠标 仍 位 于 该 文件 夹 中 时 ， 在 键盘 上 按 下 Chl + V， 粘 贴 文件 。 新 文件 会 使 用 Copy 
作为 后 组 。 

DeleteDuplicateFiles0 方法 迭代 作为 第 一 个 参数 传递 的 目录 中 的 所 有 文件 ， 使 用 选项 SearchOption. 
AllDirectories 裔 历 所 有 子 目 录 。 在 foreach 语句 中 ， 所 帮 代 的 当前 文件 与 上 一 次 友 代 的 文件 做 比较 。 如 果 文 件 名 
相同 ， 只 有 Copy 后 缀 不 同 ， 文 件 的 大 小 也 一 样 ， 就 调用 FileInfo.Delete 删除 复制 的 文件 (代码 文件 
Workine WithFilesAndFolders/Proeram.cs): 

private void DeleteDuplicateFiles (string directory, bool checkonly) 

IEnumerable<string> fileNames = Directory.EnumerateFiles (directory, 
"*", SearchOption.AllDirectories) ; 
string previousFileName = string.Empty; 
foreach (string fileName in fileNames) 
, string previousName = Path.GetFileNameWithoutExtension (previousFileName); 


If ('!'string.IsNullorEmty (previousFileName) && 
previousName .EndsWith ("Copy") && 
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fileName.StartsWith (previousFileName.Substringl! 
0, previousFileName.LastIndexOf ("” 一 Copy")))) 
{ 
Var CopiedFile = new Filelnfo(previousFileName).; 
Var originalFile = new FilelInfo(fileName); 
if (copiedFile.Length == originalFile.Length) 
{ 
Console.WriteLine ($"delete {copiedFile.FullName}"); 
if (I'checkonly) 
{ 
copiedFile.Delete().; 
} 
} 
} 
previousFileName = fileName; 
} 
} 


22.4 ”使 用 流 


现在 ， 处 理 文件 有 更 强大 的 选项 : 流 。 流 的 概念 已 经 存在 很 长 时 间 了 。 流 是 一 个 用 于 传输 数据 的 对 象 ， 数 
据 可 以 同 两 个 方 回 传输 : 

e 如 果 数 据 从 外 部 源 传输 到 程序 中 ， 这 就 是 读 取 流 。 

e 如 果 数 据 从 程序 传输 到 外 部 源 中 ， 这 就 是 写 入 流 。 

外 部 源 常 沼 是 一 个 文件 ， 但 也 不 完全 都 是 文件 。 它 还 可 能 是 : 

e ”使 用 一 些 网 络 协议 读 写 网 络 上 的 数据 ， 其 目的 是 选择 数据 ， 或 从 男 一 个 计算 机 上 发 送 数 据 。 

e 读 写 到 命名 管道 上 。 

e 把 数据 读 写 到 一 个 内 存 区 域 上 。 

一 些 流 只 允许 写 入 ， 一 些 流 只 允许 读 取 ， 一 些 流 允许 随机 存 取 。 随 机 存 取 人 允许 在 流 中 随机 定位 游标 ， 例 如 ， 
从 流 的 开头 开始 读 取 ， 以 后 移动 到 流 的 末尾 ， 再 从 流 的 一 个 中 间 位 置 继续 读 取 。 

在 这 些 示 例 中 ， 微 软 公 司 提供 了 一 个 NET 类 System.IO.MemoryStream 对 象 来 读 写 内 存 ， 而 
System .Net.Sockets.NetworkStream 对 象 处 理 网 络 数据 。Stream 类 对 外 部 数据 源 不 做 任何 假定 ， 外 部 数据 源 可 
以 是 文件 流 、 内 存 流 、 网 络 流 或 任意 数据 源 。 

一 些 流 也 可 以 链接 起 来 。 例 如 ， 可 以 使 用 DeflateStream 压缩 数据 。 这 个 流 可 以 写 入 FileStream、 
MemoryStream 或 NetworkStream。CryptoStream 可 以 加 密 数 据 。 也 可 以 链接 DeflateStream 和 CryptoStream， 
肝 与 入 FileStream 。 


注意 : 
第 24 章 解 释 了 如 何 使 用 CrVptoStream。 


使 用 流 时 ， 外 部 源 甚至 可 以 是 代码 中 的 一 个 变量 。 这 听 起 来 很 荒 廖 ， 但 使 用 流 在 变量 之 间 传 输 数据 的 技术 
是 一 个 非常 有 用 的 技巧 , 可 以 在 数据 类 型 之 间 转 换 数据 。C 语言 使 用 类 似 的 函数 sprintft0 在 整 型 和 字符 串 之 间 转 
换 数 据 类 型 ， 或 者 格式 化 字符 串 。 

使 用 一 个 独立 的 对 象 来 传输 数据 ， 比 使 用 Filemfo 或 DirectoryInfo 类 更 好 ， 因 为 把 传输 数据 的 概念 与 特定 
数据 源 分 离开 来 ， 可 以 更 容易 交换 数据 源 。 流 对 象 本 身 包含 许多 通用 代码 ， 可 以 在 外 部 数据 源 和 代码 中 的 变量 
之 间 移 动 数据 ， 把 这 些 代 码 与 特定 数据 源 的 概念 分 离开 来 ， 就 更 容易 实现 不 同 环境 下 代码 的 重用 。 

虽然 直接 读 写 流 不 是 那么 容易 ， 但 可 以 使 用 阅读 器 和 写 入 器 。 这 是 另 一 个 关注 点 分 离 。 阅 读 器 和 写 入 器 
可 以 读 写 流 。 例如， StringReader 和 StringWriter 类 , 与 本 章 后 面 用 于 读 写 文本 文件 的 两 个 类 StreamReader 和 
StreamWriter 一 样 , 都 是 同一 继承 树 的 一 部 分 , 这 些 类 几乎 一 定 在 后 台 共 享 许多 代码 。 在 System_.IO 名 称 空 间 中 ， 
与 流 相关 的 类 的 层次 结构 如 图 22-2 所 示 。 
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图 22-2 


对 于 文件 的 读 写 ， 最 常用 的 类 如 下 : 

e FileStream( 文 件 流 ) 一 一 这 个 类 主要 用 于 在 二 进 制 文件 中 读 写 二 进 制 数据 。 

e StreamReader( 流 读 取 器 ) 和 StreamWriter( 流 写 入 器 ) 一 一 这 两 个 类 专门 用 于 读 写 文本 格式 的 流产 品 API。 

e BinaryReader 和 BinaryWriter 一 一 这 两 个 类 专门 用 于 读 写 二 进 制 格式 的 流产 品 API。 

使 用 这 些 类 和 直接 使 用 底层 的 流 对 象 之 间 的 区 别 是 ， 基 本 流 是 按照 字 节 来 工作 的 。 例 如 ， 在 保存 某 个 文档 
时 ， 需 要 把 类 型 为 long 的 变量 的 内 容 写 入 一 个 二 进 制 文件 中 ， 每 个 long 型 变量 都 占用 8 个 字 节 ， 如 果 使 用 一 
般 的 二 进 制 流 ， 就 必须 显 式 地 写 入 内 存 的 8 个 字 节 中 。 

在 C# 代 码 中 ， 必 须 执行 一 些 按 位 操作 ， 从 long 值 中 提取 这 8 个 字 节 。 使 用 BinaryWriter 实例 ， 可 以 把 整个 操 
作 封 装 在 BinaryWiiter WiiteO0 方 法 的 一 个 重 载 方法 中 ， 该 方法 的 参数 是 long 型 ， 它 把 8 个 字 节 写 入 流 中 (如 果 流 指 
向 一 个 文件 ， 就 写 入 该 文件 )。 对 应 的 BinaryReader.Read0 方 法 则 从 流 中 提取 8 个 字 节 ， 恢 复 long 的 值 。 
22.4.1 使 用 文件 流 

下 面 对 流 进行 编程 ， 以 读 写 文件 。FileStream 实例 用 于 读 写 文件 中 的 数据 。 要 构造 FileStream 实例 ， 需 要 以 
下 4 条 信息 : 

e 要 访问 的 文件 。 

e 表示 如 何 打 开 文 件 的 模式 一 一 例如 ， 新 建 一 个 文件 或 打开 一 个 现 有 的 文件 。 如 果 打 开 一 个 现 有 的 文件 ， 

写 入 操作 是 覆盖 文件 原来 的 内 容 ， 还 是 追加 到 文件 的 末尾 ? 
e 表示 访问 文件 的 方式 是 只 读 、 只 写 还 是 读 写 ? 
e 共享 访问 表示 是 否 独占 访问 文件 。 如 果 人 允许 其 他 流 同时 访问 文件 ， 则 这 些 流 是 只 读 、 只 写 还 是 读 
写 文 件 ? 

一 条 信息 通常 用 一 个 包含 文件 的 完整 路 径 名 的 字符 串 来 表示 , 本 章 只 考虑 需要 该 字符 串 的 那些 构造 函数 。 
除了 这 些 构造 函数 外 ， 一 些 其 他 的 构造 函数 用 本 地 Windows 句柄 来 处 理 文件 。 其 余 3 条 信息 分 别 由 3 个 NET 
枚 举 FileMode、FileAccess 和 FileShare 来 表示 ， 这 些 枚 举 的 值 很 容易 理解 ， 如 表 22-1 所 示 。 


表 22-1 
枚 举 值 
FileMode Append、Create、CreateNew、Open、OpenOrCreate 或 Truncate 
FileAccess Read、ReadWirite 或 Write 
FileShare Delete、Inheritable、None、Read、ReadWrite 或 Write 


注意 ， 对 于 FileMode， 如 果 要 求 的 模式 与 文件 的 现 有 状态 不 一 致 ， 就 会 抛 出 一 个 异 第 。 如 果 文 件 不 存在 ， 
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Append、Open 和 Tiruncate 就 会 抛 出 一 个 异常 ， 如 果 文 件 存在 ，CreateNew 就 会 抛 出 一 个 异常 。Create 和 
OpenOrCreate 可 以 处 理 这 两 种 情况 ， 但 Create 会 删除 任何 现 有 的 文件 ， 新 建 一 个 空 文件 。 因 为 FileAccess 和 
FileShare 枚 举 是 按 位 标志 ， 所 以 这 些 值 可 以 与 C# 的 按 位 OR 运算 符 “|” 合 并 使 用 。 

1. 创建 FileStream 

StreamSamples 的 示例 代码 使 用 如 下 名 称 空间 : 


System 
System.Collections.Generic 
System.Globalization 
System.IO 

System.Linq 

System. [ext 
System.Threading.Tasks 


FileStream 有 很 多 构造 函数 。 下 面 的 示例 使 用 带 4 个 参数 的 构造 函数 (代码 文件 SteamSamples/Program .cs): 
e@ 文件 名 

e FileMode 枚 举 值 Open， 打 开 一 个 已 存在 的 文件 

se FileAccess 枚 举 值 Read， 读 取 文 件 

e FileShare 枚 举 值 Read， 人 允许 其 他 程序 读 取 文 件 ， 但 同时 不 修改 文件 


Private void ReadFileUsingFileSstream!(string fileName) 
{ 
const int buffersize = 4096- 
using (var stream = new FileStream(fileName, FileMode .Open, 
FileAccess.Read, FileShare.Read)) 
{ 
ShowSstreamInformation'(stream):; 
Encoding encoding = GetEncoding (stream); 


SE 
除了 使 用 FileStream 类 的 构造 函数 来 创建 FileStream 对 象 之 外 , 还 可 以 直接 使 用 File 类 的 OpenRead 方法 创 
建 FileStream。OpenRead 方法 打开 一 个 文件 (类 似 于 FileMode.Open)， 返 回 一 个 可 以 读 取 的 流 (FileAccess.Read)， 
也 允许 其 他 进程 执行 读 取 访问 (FileShare.Read ): 
using (FileStream stream = File.0OpenRead (filename)) 


{ 
Ee 


2. 获取 流 信息 


Stream 类 定义 了 属性 CanRead、CanWrite、CanSeek 和 CanTimeout,， 可 以 读 取 这 些 属性 ， 得 到 可 以 通过 流 
处 理 的 信息 。 为 了 读 写 流 ， 超 时 值 ReadTimeout 和 WriteTimeout 指定 超时 ， 以 毫秒 为 单位 。 设 置 这 些 值 在 网 络 
场景 中 是 很 重要 的 ， 因 为 这 样 可 以 确保 当 读 写 流失 败 时 ， 用 户 不 需要 等 待 太 长 时 间 。Position 属性 返回 光标 在 
流 中 的 当前 位 置 。 每 次 从 流 中 读 取 一 些 数据 ， 位 置 就 移动 到 下 一 个 将 读 取 的 字 节 上 。 示 例 代 码 把 流 的 信息 写 到 
控制 全 上 (代码 文件 StreamSamples/Program.cs): 

private VOId ShowSstreamInformation (Stream stream) 


Console.WriteLine($"stream can read: {stream.CanRead}, "™ + 

$s"can write: {stream.CanWrite}, can seek: lstream.CanSeek}, "+ 

Ss"oan timeout: {stream.CanTimeout}").: 
Console.WriteLine($"length: {stream.Length}, position: {stream.Position}").; 
if (stream.CanTimeout) 
{ 

Console.WriteLinel($"read timeout: {stream.ReadTimeout} ™ + 

SwIrite timeout: {stream.WriteTimecout} 一 ) ; 
} 
} 
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对 已 打开 的 文件 流 运 行 这 个 程序 ， 会 得 到 下 面 的 输出 。 位 置 目前 为 0， 因 为 尚未 开始 读 取 : 


stream can read: True, can write: False, can seek: True, can timeout: False 
length: 1113, position: 0 


3. 分 析 文 本 文件 的 编码 


对 于 文本 文件 ， 下 一 步 是 读 取 流 中 的 第 一 个 字 节 一 一 序言 。 序 言 提供 了 文件 如 何 编 码 的 信息 (使 用 的 文本 格 
式 )。 这 也 称 为 字 节 顺序 标记 (Byte Order Mark，BOM)。 

读 取 一 个 流 时 ,利用 ReadByte 可 以 从 流 中 只 读 取 一 个 字 节 ， 使 用 Read0 方 法 可 以 填充 一 个 字 节 数组 。 使 用 
GetEncoding0 方 法 创建 了 一 个 包含 5 字 节 的 数组 ， 使 用 Read0 方 法 填充 字 节 数组 。 第 二 个 和 第 三 个 参数 指定 字 
节 数 组 中 的 侦 移 量 和 可 用 于 填充 的 字 节 数 。Read0 方 法 返回 读 取 的 字 节 数 ;， 流 可 能 小 于 缓冲 区 。 如 果 没 有 更 多 
的 字符 可 用 于 读 取 ，Read 方法 就 返回 0。 

示例 代码 分 析 流 的 第 一 个 字符 ， 返 回 检测 到 的 编码 ， 并 把 流 定位 在 编码 字符 后 的 位 置 (代码 文件 
StreamSamples/Program.cs); 

private Encoding GetEncodinac(Stream stream) 

if (!stream.CanSeek) throw new ArgumentException ! 
"require a stream that can seek"); 


Encoding encoding = Encoding.ASCII; 
byte[] bom = new byrte[5]: 
int nRead = stream.Read(bom, offset: 0, count: 5).; 
if (bom[0] == Oxff gg& lbom[l1] == Oxfe g& bom[2] — 0 g&& bom[3] == 0) 
{ 
Console.WriteLine ("UTF-—32"™");} 
stream.Seek (4, SeekOrigin.Begin); 
return Encoding .UTF32; 
} 
else if (bom[0] == Oxff g&& bom[1] == Oxfe) 
{ 
Console.WriteLine ("UTF-16, little endian™.); 
stream.Seek (2, SeekOrigin.Begin); 
return Encoding.Unicode; 
} 
else if (bom[0] == Oxfe g& bom[l1] == 0xff) 
{ 
Console.WriteLine ("UTF-16, big enadian") ， 
stream.Seek (2, SeekOrigin.Begin); 
return Encoding.BigEndianUnicode; 
} 
else if (bom[0] == Oxef gg& bom[1] == Oxbb && bom[2] == 0xbf) 
{ 
Console.WriteLine ("UTF-—8"); 
stream.Seek (3, SeekOrigin.Begin); 
return Encoding .UTFS8; 
} 
stream.Seek(0, SeekOrigin.Begin); 


return encoding; 


} 

文件 以 FF 和 FE 字符 开头 。 这 些 字 节 的 顺序 提供 了 如 何 存储 文档 的 信息 。 两 字 节 的 Unicode 可 以 用 小 或 大 
端 字 节 顺序 法 存储 。FF 紧 随 在 FE 之 后 ， 表 示 使 用 小 端 字 节 序 ， 而 FE 后 跟 FF， 就 表示 使 用 大 端 字 节 序 。 这 个 
字 节 顺序 可 以 追溯 到 IBM 的 大 型 机 , 它 使 用 大 端 字 节 序 给 字 节 排序 ，Digital Equipment 中 的 PDP11 系统 使 用 小 
端 字 节 序 。 通 过 网 络 与 采用 不 同 字 节 顺序 的 计算 机 通信 时 ， 要 求 改变 一 端的 字 节 顺序 。 现 在 ， 英 特 尔 CPU 体系 
结构 使 用 小 端 字 节 序 ，ARM 架构 允许 在 小 端 和 大 端 字 节 顺序 之 间 切 换 。 

这 些 编码 的 其 他 区 别 是 什么 ?在 ASCII 中 ， 每 一 个 字符 有 7 位 就 足够 了 。ASCI 最 初 基于 英语 字母 表 ， 提 
供 了 小 写字 母 、 大 写字 母 和 控制 字符 。 

扩展 的 ASCII 利用 8 位 ， 人 允许 切换 到 特定 于 语言 的 字符 。 切 换 并 不 容易 ， 因 为 它 需 要 关注 代码 地 图 ， 也 没 
有 为 一 些 亚洲 语言 提供 足够 的 字符 。UTF-16(Unicode 文本 格式 ) 解 决 了 这 个 问题 ， 它 为 每 一 个 字符 使 用 16 位 。 
因为 对 于 以 前 的 字形 ，UTF-16 还 不 够 ， 所 以 UTF-32 为 每 一 个 字符 使 用 32 位 。 虽 然 Windows NT 3.1 为 默认 文 
本 编码 切换 为 UTF-16 (在 以 前 ASCI 的 微软 扩展 中 )， 现 在 最 常用 的 文本 格式 是 UTIF-8。 在 Web 上 ，UTF-8 是 
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和 目 2007 年 以 来 最 党 用 的 文本 格式 (这 个 取代 了 ASCI， 是 以 前 最 闻 见 的 字符 编码 )。UTF-8 使 用 可 变 长 度 的 字符 
定义 。 一 个 字符 定义 为 使 用 1 到 6 个 字 节 。 这 个 字符 序列 在 文件 的 开头 探测 UTF-8: 0xEF、0xBB、0xBF。 


22.4.2 读 取 流 


打开 文件 并 创建 流 后 ， 使 用 Read0 方 法 读 取 文件 。 重 复 此 过 程 ， 直 到 该 方法 返回 0 为 止 。 使 用 在 前 面 定义 的 
GetEncoding0 方 法 中 创建 的 Encoder, 创建 一 个 字符 串 。 不 要 和 起 记 使 用 Dispose0 方 法 关闭 流 。 如 果 可 能 , 使 用 using 
语句 (如 本 代码 示例 所 示 ) 目 动 销 毁 流 (代码 文件 StreamSamples/Program.cs): 


Public static Vola ReadFileUsingFilestreaml(string fileName) 
{ 
const int BUFFERSIZE = 256; 
USing (Var stream = new FileStreaml(lfileName, FileMode .Open, 
Filenccess.Read, FlileShare.Read)) 
{ 
ShowSstreamInformation (stream).; 
Encoding encoding = GetEncoding (stream); 
byte[] buffer = new bytel[lbufferSsizel]; 
bool completed = falser 


do 
{ 
int nread = stream.Read(buffer, 0, BUFFERSIZE).; 
if (nread == 0) completed = true; 
IE (nread < BUFFERSIZ2E) 
{ 
Arravy.Clear (buffer, nread, BUFFERSIZE 一 nread):; 
} 


string s = encoding.GetSstring (buffer, 0, nread); 
Console .WriteLine($"read {nread} bytes™"™); 
Console .WriteLine (s):; 

while {({!Icompleted); 


Hm 


} 
} 


22.4.3 写 入 流 


把 一 个 简单 的 字符 串 写 入 文本 文件 ， 就 演示 了 如 何 写 入 流 。 为 了 创建 一 个 可 以 写 入 的 流 ， 可 以 使 用 
File.OpenWriite0 方 法 。 这 次 通过 Path.GetTempFileName 创建 一 个 临时 文件 名 。GetTempFileName 定义 的 默认 文 
件 扩展 名 通过 Path.ChangeExtension 改 为 txt( 代 码 文 件 StreamSamples/Prosgram.cs): 


PuUublic static volid WriteTextFlle{() 


{ 
string tempTextFileName = Path.ChangeExtension (Path.GetTempFileName(), 
"txt"); 
usSing (FileStream stream = File.OpenWrite (tempTextFileName)) 
{ 
is 


写 入 UTF-8 文件 时 ， 需 要 把 序言 写 入 文件 。 为 此 ， 可 以 使 用 WriteByte0 方 法 ， 给 流 发 送 3 个 字 节 的 UTF-8 


stream.WriteBvyte (Oxef):; 
stream.WriteByte (0xbb); 
stream.WriteByte (0xbf); 


这 有 一 个 替代 方案 。 不 需要 记 住 指定 编码 的 字 节 。Encoding 类 已 经 有 这 些 信息 了 。GetPreamble( 方 法 返回 
一 个 字 节 数组 ， 其 中 包含 文件 的 序言 。 这 个 字 节 数组 使 用 Stream 类 的 Wirite0 方 法 写 入 : 


byte[] preamble = Encoding .UTFS8.GetPreamble(});} 
stream.Write (preamble, 0, preamble.Length); 


现在 可 以 写 入 文件 的 内 容 。Wirite0 方 法 需要 写 入 字 节 数组 ， 所 以 需要 转换 字符 串 。 将 字符 串 转 换 为 UTF-8 
的 字 节 数组 ， 可 以 使 用 Encoding.UTF8.GetBytes 完成 这 个 工作 ， 之 后 写 入 字 节 数组 : 

string hello = "Hello, World!™; 

byte[] buffer = Encoding .UTFS8 .GetBytes (hello).; 


stream.Write (buffer, 0, buffer.Length).; 
Console .WriteLine (S$"file {stream.Name} written™):; 
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可 以 使 用 编辑 器 (比如 Notepad) 打 开 临 时 文件 ， 它 会 使 用 正确 的 编码 。 


22.4.4 复制 流 


现在 复制 文件 内 容 ， 把 读 写 流 合并 起 来 。 在 下 一 个 代码 片段 中 ， 用 File.OpenRead 打开 可 读 的 流 ， 用 File. 
OpenWrite 打开 可 写 的 流 。 使 用 Stream.Read0 方 法 读 取 缓 冲 区 ， 用 Stream.Wiite(0 方 法 写 入 缓冲 区 (代码 文件 
StreamSamples/Proeram.cs): 


public static void CopyUsingstreams (string inputFile, string outputFile) 
{ 
CoOnst int BUFFERSIZE = 4096; 
using (var inputstream = File.OpenRead (inputrile)) 
using (var outepeutstream = File.O0penWrite (outputFile)) 
{ 
byte[] lbuffer = new byte[BUFFERSIZE]|; 
bool completed = false; 


do 

{ 
int nRead = inputSstream.Read(buffer, 0, BUFFERSIZE). 
1if {(nRead == 0) completed = true; 


outputStream.Write(buffer, 0, nRead); 
} while (I!completed).; 
} 
} 


为 了 复制 流 ， 不 需要 编写 读 写 流 的 代码 。 而 可 以 使 用 Stream 类 的 CopyTo 方法 ， 如 下 所 示 ( 代 码 文件 
StreamSamples/Proeram.cs): 


public static void CopyUsingstreams2 (string inputFile, string outputrFile) 
{ 

using (Var inputstream = File.OpenRead(inputrFrile)) 

usSing (var outputstream = File.OpenWrite (outputrile)) 


inputSstream.CopyTo (outputSstream) ; 
} 
} 


22.4.5 随机 访问 流 


随机 访问 流 (甚至 可 以 访问 大 文件 ) 的 一 个 优势 是 ， 可 以 快速 访问 文件 中 的 特定 位 置 。 

为 了 了 解 随机 存 取 动 作 ， 下 面 的 代码 片段 创建 了 一 个 大 文件 。 这 个 代码 片段 创建 的 文件 sampledata.data 包 
会 了 长 度 相 同 的 记录 , 包括 一 个 数字 、 一 个 文本 和 一 个 随机 的 日 期 。 传递 给 方法 的 记录 数 通 过 Enumerable Range 
方法 创建 。Select 方法 创建 了 一 个 匿名 类 型 ， 其 中 包含 Number、Text 和 Date 属性 。 除 了 这 些 记 录 外 ， 还 创建 
一 个 融 # 前 级 和 后 缀 的 字符 串 ， 每 个 值 的 长 度 都 固定 ， 每 个 值 之 间 用 :作为 分 隔 和 从 。WiriteAsync 方法 将 记录 写 入 
流 (代码 文件 StreamSamples/Program.cs): 


const string SampleFilePath = "./samplefile.data"™; 
Public static async Task CreateSampleFilel(int nRecords) 
{ 
FileSstream stream = File.Create(SampleFilePath).,; 
using (var writer = new StreamWriter'(stream)) 
{ 
Var T 三 new Random(}).: 
Var records = Enumerable.Range (0, nRecords} .Select (KX => new 
{ 
Number = XX, 
Text = $"Sample text {Ir.Next (200)}", 
Date = new DateTime (Math.Abs(({long}) ((r.NextDouble() * 2— 1) * 
DateTime.MaxVvalue. Ticks))) 
}) 5; 


foreach (var rec In records) 
{ 
string date = rec.Date.ToString("d", CultureInfo.InvariantcCculture); 
string s = 
$s"#{rec.Number,8}; {rec.Text,—20}; {date}#{Environment .NewLine}"™; 
await writer .WriteAsync'(s).; 
} 


510 | 第 中 部 分 .NET Core 与 Windows Runtime 


} 
} 


注意 

第 17 章 提 到 , 每 个 实现 IDisposable 的 对 象 都 应 该 销毁 。 在 前 面 的 代码 片段 中 , FileStream 似乎 并 没有 销毁 。 
然而 事实 并 非 如 此 。StreamWriter 销毁 时 ，StreamWriter 会 控制 所 使 用 的 资源 ， 并 销毁 流 。 为 了 使 流 打 开 的 时 间 
比 StreamWriter 更 长 ， 可 以 用 StreamWriter 的 构造 函数 配置 它 。 在 这 种 情况 下 ， 需 要 显 式 地 销 毁 流 。 


现在 把 游标 定位 到 流 中 的 一 个 随机 位 置 ， 读 取 不 同 的 记录 。 用 户 需 要 输入 应 该 访问 的 记录 号 。 流 中 应 该 访 
问 的 字 节 基于 记录 号 和 记录 的 大 小 。 现 在 Stream 类 的 Seek 方法 允许 定位 流 中 的 光标 。 第 二 个 参数 指定 位 置 是 
流 的 开头 、 流 的 末尾 或 是 当前 位 置 (代码 文件 StreamSamples/Program.cs): 


Public static void RandomAccessSample () 
{ 
七 工科 


UslIno (FileStream stream = FiIlLe.OPenReadad(SampLeEiLeEath) ) 
{ 


byte[] buffer = new byte[RECORDSIZE]; 
do 
{ 
try 
{ 
Console.Write("record number (or 'bye' to end}): "™); 
string line = Console.ReadLine (}); 
if (line.ToUpper() .CcompareTo ("BYE") == 0) break; 
if (int.TryParse (line, out int record))} 
{ 
stream. Seek((record - 1) * RECORDSIZE，SeekoOrigin.Beginl) : 
stream.Read (buffer, 0, RECORDSIZE).; 
string S = Encoding .UTF8.GetSstring (buffer).; 
Console .WriteLine ($"record: {5s}"); 


} 


catch (Exception ex) 
{ 
Console.WriteLine (ex.Message).; 
} while (true); 
Console .WriteLine ("finished"™);} 
} 
} 
catch (FileNotFoundException) 
{ 
Console.WriteLine ("Create the sample file using the option -sample first"); 
} 
} 


利用 这 些 代 码 ， 可 以 尝试 创建 一 个 包含 150 万 条 记录 或 更 多 的 文件 。 使 用 记事 本 打开 这 个 大 小 的 文件 会 比 
较 慢 ， 但 是 使 用 随机 存 取 会 非常 快 。 根 据 系 统 、CPU 和 磁盘 类 型 ， 可 以 使 用 更 高 或 更 低 的 值 来 测试 。 


注意 : 

如 果 应 该 访问 的 记录 的 大 小 不 国定 ， 仍 可 以 为 大 文件 使 用 随机 存 取 。 解决 这 一 问题 的 方法 之 一 是 把 写 入 记 
录 的 位 置 放 在 文件 的 开头 。 另 一 个 选择 是 读 取 记录 所 在 的 一 个 更 大 的 块 ， 在 其 中 可 以 找到 记录 标识 符 和 内 存 块 
中 的 记录 限 值 条 件 。 


22.4.6 ”使 用 缓存 的 流 


从 性 能 原因 上 看 ， 在 读 写 文件 时 ， 输 出 结果 会 被 缓存 。 如 果 程 序 要 求 读 取 文 件 流 中 下 面 的 两 个 字 节 ， 该 流 
会 把 请 求 传 递 给 Windows， 则 Windows 不 会 连接 文件 系统 ， 再 定位 文件 ， 并 从 磁盘 中 读 取 文件 ， 仅 读 取 两 个 字 
节 。 而 是 在 一 次 读 取 过 程 中 ， 检 索 文 件 中 的 一 个 大 块 ， 把 该 块 保存 在 一 个 内 存 区 域 ， 即 缓冲 区 上 。 以 后 对 流 
中 数据 的 请 求 就 会 从 该 缓冲 区 中 读 取 ， 直 到 读 取 完 该 缓冲 区 为 止 。 此 时 ，Windows 会 从 文件 中 再 获取 另 一 个 数 
据 块 。 
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写 入 文件 的 方式 与 此 相同 。 对 于 文件 ， 操 作 系 统 会 日 动 完成 读 写 操 作 ， 但 需要 编写 一 个 流 类 ， 从 其 他 没有 
缓存 的 设备 中 读 取 数据 。 如 果 是 这 样 ， 就 应 从 BufferedStream 创建 一 个 类 ， 它 实现 一 个 缓冲 区 ， 并 把 应 缓存 的 
流传 递 给 构造 函数 。 但 注意 ，BufferedStream 并 不 用 于 应 用 程序 频 粽 切换 读数 据 和 写 数据 的 情形 。 


22.5 ”使 用 读 取 器 和 写 入 器 


使 用 FileStream 类 读 写 文本 文件 ， 需 要 使 用 字 节 数组 ， 处 理 前 一 节 描述 的 编码 。 有 更 简单 的 方法 : 使 用 读 
取 器 和 写 入 器 。 可 以 使 用 StreamReader 和 StreamWriter 类 读 写 FileStream， 不 需要 处 理 字 节 数组 和 编码 ， 比 较 
轻松 。 

这 是 因为 这 些 类 工作 的 级 别 比 较 高 ， 特 别 适合 于 读 写 文 本 。 它 们 实现 的 方法 可 以 根据 流 的 内 容 ， 目 动 检测 

出 停止 读 取 文本 较 方 便 的 位 置 。 特 别 是 : 

e 这 些 类 实现 的 方法 (StreamReader.ReadLine 和 StreamWriter .WriteLine) 可 以 一 次 读 写 一 行文 本 。 在 读 取 文 
件 时 ， 流 会 目 动 确定 下 一 个 回 车 符 的 位 置 ， 并 在 该 处 停止 读 取 。 在 写 入 文件 时 ， 流 会 自动 把 回 车 符 和 
换行 符 退 加 到 文本 的 末尾 。 

e 使 用 StreamReader 和 StreamWiriter 类 ， 就 不 需要 担心 文件 中 使 用 的 编码 方式 。 

ReaderWriterSamples 的 示例 代码 使 用 下 面 的 名 称 空间 : 


System 
System.Collections.Generic 
System.Globalization 
System.IO 

System.LIng 

System. Lext 
System.Threadine.Tasks 


22.5.1 StreamReader 类 


先 看 看 SteamReader， 将 前 面 的 示例 转换 为 读 取 文件 以 使 用 StreamReader。 它 现在 看 起 来 容易 得 多 。 
StreamReader 的 构造 函数 接收 FileStream。 使 用 EndOfstream 属性 可 以 检查 文件 的 末尾 ， 使 用 ReadLine 方法 读 
取 文 本 行 (代码 文件 ReaderWiriterSamples/Program.cs): 

Public static Volq ReadFileUsingReader (string fileName) 

{ 

var stream = new FileSstreaml(fileName, FileMode.Open, FlleAccess.Read, 
FileSshare.Read);} 
USing (var reader = new StreamReader (stream)) 


{ 
while (lreader .EndoOfstream) 
{ 


string line = reader .ReadLine (); 
Console .WriteLine (line):; 
} 
} 
} 


不 再 需要 处 理 字 节 数组 和 编码 。 然 而 注意 ，StreamReader 默认 使 用 UT F-8 编码 。 指 定 另 一 个 构造 函数 ， 可 
以 让 StreamReader 使 用 文件 中 序言 定义 的 编码 : 

Var reader = new StreamReader(stream, detectEncodingFromByteOrderMarks: true); 

也 可 以 显 式 地 指定 编码 : 

var reader = new StreamReader (stream, Encoding.Unicode)}),; 

其 他 构造 函数 允许 设置 要 使 用 的 缓冲 区 ; 默认 为 1024 个 字 节 。 此 外 , 还 可 以 指定 关闭 读 取 器 时 不 应 该 关闭 
底层 流 。 默 认 情 况 下 ， 关 闭 读 取 器 时 (使 用 Dispose 方法 )， 会 关闭 底层 流 。 
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不 显 式 实例 化 新 的 StreamReader， 而 可 以 使 用 File 类 的 OpenText 方法 创建 StreamReader: 

Var reader = File.0penText (fileName); 

对 于 读 取 文件 的 代码 片段 , 该 文件 使 用 ReadLine 方 法 逐 行 读 取 。StreamReader 还 允许 在 流 中 使 用 ReadToEnd 
从 光标 的 位 置 读 取 完整 的 文件 : 

string content = reader.ReadToEnd(); 

StreamReader 还 允许 把 内 容 读 入 一 个 字符 数组 。 这 类 似 于 Stream 类 的 Read 方法 ; 它 不 读 入 字 节 数组 ， 而 
是 读 入 char 数组 。 记 住 ，char 类 型 使 用 两 个 字 节 。 这 适合 于 16 位 Unicode， 但 不 适合 于 UTF-8， 其 中 ， 一 个 字 
符 的 长 度 可 以 是 1 至 6 个 字 节 : 

int nchars = 100; 


char[] charaArray = new charlnchars]; 
int nCcharsRead = reader.Read(charArray, 0, nchars); 


225.2 StreamWriter 类 


StreamWriter 的 工作 方式 与 StreamReader 相同 ， 只 是 StreamWriter 仅 用 于 写 入 文件 (或 写 入 男 一 个 流 )。 下 面 
的 代码 片段 传递 FileSstream ， 创 建 了 一 个 SteamWriter。 然 后 把 传 入 的 字符 串 数 组 写 入 流 (代码 文件 
ReaderWriterSamples/Program.cs): 
public static void WriteFileUsingWriter (string fileName, string[] lines) 
{ 
Var outputstream = File.OQpenWrite (fileName).; 
USing (var writer = new StreamWHriter (outputstream)) 
{ 
byte[] preamble = Encoding .UTFS8.GetPreamble (); 
outputstream.Write (preamble, 0, preamble.Length); 
Writer.Write (lines).,; 
} 
} 


记 住 ，StreamWriter 默认 使 用 UTF-8 格式 写 入 文本 内 容 。 通 过 在 构造 函数 中 设置 Encoding 对 象 ， 可 以 定义 
蔡 代 的 内 容 。 另 外 ， 类 似 于 StreamReader 的 构造 函数 ，StreamWoriter 允许 指定 缓冲 区 的 大 小 ， 以 及 关闭 写 入 器 
时 是 否 不 应 该 关闭 底层 流 。 

StreamWriter 的 Write0 方 法 定义 了 17 个 重 载 版 本 ， 人 允许 传递 字符 串 和 一 些 NET 数据 类 型 。 请 记 住 ， 使 用 
传递 NET 数据 类 型 的 方法 ， 这 些 都 会 使 用 指定 的 编码 变 成 字符 串 。 要 以 二 进 制 格式 写 入 数据 类 型 ， 可 以 使 用 下 
面 介 绍 的 BinaryWriter。 


22.5.3 读 写 二 进 制 文件 


读 写 二 进 制 文件 的 一 种 选择 是 直接 使 用 流 类 型 ， 在 这 种 情况 下 ， 最 好 使 用 字 节 数组 执行 读 写 操作 。 男 一 个 
选择 是 使 用 为 这 个 场景 定义 的 读 取 器 和 写 入 器 : BinaryReader 和 BinaryWriter。 使 用 它们 的 方式 类 似 于 使 用 
StreamReader 和 StreamWriter, 但 BinaryReader 和 BinaryWriter 不 使 用 任何 编码 。 文 件 使 用 二 进 制 格式 而 不 是 文 
本 格式 写 入 。 

与 Stream 类 型 不 同 ，BinaryWriter 为 Write0 方 法 定义 了 18 个 重 载 版 本 。 重 载 版 本 接受 不 同 的 类 型 ， 如 下 面 
的 代码 片段 所 示 ， 它 写 入 double、int、long 和 string( 代 码 文 件 ReaderWriterSamples/Proeram.cs): 

oh static void WriteFileUsingBinaryWriter (string binFile) 


Var outputstream = File.Create (binFile); 
USing (var writer = new BinaryWriter (outputstream)) 


| 
double d = 47.47; 
nt 1 = 42- 
Jong 1 = S987654321.; 
string Ss = "sample™; 
WEiter .Write (dd); 
Writer .Write(i}. 
Writer .Write(l}). 
Writer .Write'(s).; 
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} 
} 
为 了 再 次 读 取 文件 ， 可 以 使 用 BinaryReader。 这 个 类 定义 的 方法 会 读 取 所 有 不 同 的 类 型 ， 如 ReadDouble、 
ReadInt32、ReadInt64 和 ReadString， 如 下 所 示 : 
Public static void ReadFileUsingBinaryReader (string binrile) 
{ 
var linputstream = File.Open (binFile, FileMode .Open),; 
using (var reader = new BinaryReader(inputstream)) 
{ 
double d = reader.ReadDouble (}: 
int 1 = reader.ReadInt32(); 
long 1 = reader.ReadInt64(); 
string s = reader.ReadSstring'().; 
Console.WriteLine($"d: {dd}, i: {i}, 1: {1}, s: {ss}"); 
} 
} 
读 取 文件 的 顺序 必须 完全 匹配 写 入 的 顺序 。 创 建 自己 的 二 进 制 格式 时 ， 需 要 知道 存储 的 内 容 和 方式 ， 并 用 
相应 的 方式 读 取 。 旧 的 微软 Word 文档 使 用 二 进 制 文件 格式 ， 而 新 的 docx 文件 扩展 是 ZIP 文件 。 如 何 读 写 压缩 
文件 详 见 下 一 节 。 


22.6 ”压缩 文件 


NET 包 括 使 用 不 同 的 算法 压缩 和 解压 缩 流 的 类 型 .可 以 使 用 DeflateStream 和 GZipStream 压缩 和 解压 缩 流 ; 
ZipArchive 类 可 以 创建 和 读 取 ZIP 文件 。 

DeflateStream 和 GZipStream 使 用 相同 的 压缩 算法 (事实 上 ，GZipStream 在 后 台 使 用 DeflateStream)， 但 
GZipStream 增加 了 循环 元 余 校 验 ， 来 检测 数据 的 损坏 情况 。Brot 是 谷歌 中 比较 新 的 开源 压缩 算法 。Brot 的 速 
度 类 似 于 抑制 算法 ,但 它 提 供 了 更 好 的 压缩 。 与 大 多 数 其 他 压缩 算法 不 同 的 是 ， 它 给 向 用 的 单词 使 用 一 个 字典 ， 
来 进行 更 好 的 压缩 。 目 前 大 多 数 现代 浏览 器 都 支持 这 种 算法 。 

使 用 zip 文件 的 优点 是 可 以 将 文件 压缩 到 存档 (使 用 ZipArchive)， 并 且 可 以 使 用 Windows 资源 管理 器 直接 
打开 该 存档 ; 它 目 从 1998 年 开始 就 安装 到 Windows 系统 中 ,不 能 使 用 Windows 资源 管理 器 打开 gzip 归档 文件 ; 
打开 gzip 需要 第 三 方 工具 。 


注意 : 

DeflateStream 和 GZipStream 使 用 的 算法 是 抑制 算法 。 该 算法 由 RFC 1951 定义 (https:Wtools.ietf org/htmlrfe1951)。 
这 个 算法 被 广泛 认为 不 受 专利 的 限制 ， 因 此 得 到 广泛 使 用 。 

Brotli 可 以 在 GitHub 上 的 https://github.com/google/brotli 获得 ， 它 由 RFC 7932 (https://tools.ietf.org/htmlrfc7932) 
定义 。 


CompressFileSample 的 示例 代码 使 用 了 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.IO.Compresslon.Brotl 
名 称 空间 
System 
System.Collections.Generic 
System.IO 
System.IO.Compression 
System. [ext 
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22.6.1 使 用 压缩 流 


如 前 所 述 ， 流 的 一 个 特性 是 可 以 将 它们 链接 起 来 。 为 了 压缩 流 ， 只 需要 创建 DeflateStream， 并 给 构造 函数 
传递 另 一 个 流 (在 这 个 例子 中 ， 是 写 入 文件 的 outputStream)， 使 用 CompressionMode. Compress 表示 压缩 。 使 用 
Wiite 方法 或 其 他 功能 写 入 这 个 流 ， 如 以 下 代码 片段 所 示 的 CopyTo0 方 法 ， 就 是 文件 压缩 所 需 的 所 有 操作 (代码 
文件 CompressFileSample/Proesram .cs): 


Public static void CompressFile(string fileName, string compressedFileName) 
{ 
usSing (FileStream inputstream = File.OpenRead (fileName)) 
{ 
Filestream outputstream = File.OpenWrite (compressedFileName); 
using (var compressSstream = 
new DeflateStream(outputSstream, CompressionMode .Compress)) 
{ 
inputstream.CopYylIo(compressstream) ; 
} 
} 
} 


为 了 再 次 把 通过 DeflateStream 压缩 的 文件 解压 纵 ， 下 面 的 代码 片段 使 用 FileStream 打开 文件 ， 并 创建 
DeflateStream 对 象 ， 把 CompressionMode.Decompress 传 入 文件 流 ， 表 示 解 压缩 。Stream.CopyTo 方法 把 解压 
缩 的 流 复制 到 MemoryStream 中 。 然 后 ， 这 个 代码 片段 利用 SteamReader 读 取 MemoryStream 中 的 数据 ， 把 输出 
写 到 控制 台 。StreamReader 配置 为 打开 所 分 配 的 MemoryStream (使 用 leaveOpen 参数 )， 所 以 MemoryStream 在 关 
闭 读 取 器 后 也 可 以 使 用 : 


Public static vold DecompressFile (string fileName) 

{ 
FileStream inputSstream = File.OpenRead (fileName).; 
USing (MemoryStream outputstream = new MemorySstream!()) 
using (var compressSstream = new DeflateStream(inputstream, 

CompressionMode .Decompress)) 

{ 

Compressstream.CopylIo (outputSstream) ; 

outputstream.Seek(0, SeekOrigin.Begin); 

USing (Var reader = new StreamReader (outputstream, Encoding .UTFS8, 
detectEncodingFromByteOrderMarks: true, bufferSize: 4096, 
leaveOpen: true)) 

{ 
string result = reader.ReadToEnd (); 

Console .WriteLine (resulty}.: 
} 
// you could use the outputstream after the StreamReader is closed 
} 
} 


22.6.2 ”使 用 Brotli 


使 用 BrotliStream ， 通 过 Broti 进行 压缩 就 像 使 用 deflate 一 样 。 只 需要 添加 NuGet 包 
System.IO.Compression.Broti， 并 实例 化 BrotliStream 类 (代码 文件 CompressFileSample/Program.cs): 


public static void CompressFileWithBrotli (string fileName, 
string compressedFileName) 
{ 
using (FileStream inputstream = File.OpenRead (fileName)})) 
{ 
FileStream outputstream = File.OpenWrite (compressedFileName),; 
Using (var compressstream = 
new Brotlistream(outputstream, CompressionMode .Compress)) 
{ 
inputstream.CopyTo (compressSstream); 
} 
} 
} 


使 用 Brotlistream 进行 相应 的 解压 工作 : 


Public static void DecompressFileWithBrotli (string fileName) 
{ 
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FileStream ImnputStream = File.OpenRead (fileName); 
using (Memory3Stream outputstream = new MemorySstream!()) 
using (var compressSstream = new Brotlistream(inputstream, 
CompressionMode .Decompress)) 
{ 
COMmPressstream.CopyTo (outputSstream); 
outputstream.Seek(0, SeekOrigin.Begin).; 
using (var reader = new StreamReader (outputstream, Encoding .UTFS8, 
detectEncodingFromByteOrderMarks: true, bufferSsize: 4096, 
leaveOpen: true)) 
{ 
string result = reader.ReadToEnd(}); 
Console .WriteLine (result); 
} 
} 
} 


22.6.3 ”压缩 文件 


今天 , ZIP 文件 格式 是 许多 不 同文 件 类 型 的 标准 。 Word 文档 (docx) 以 及 NuGet 包 都 存储 为 ZIP 文件 .在 NET 
中 ， 很 容易 创建 ZIP 归档 文件 。 
要 创建 ZIP 归档 文件 ,可 以 创建 一 个 ZipArchive 对 象 .ZipArchive 包含 多 个 ZipArchiveEntry 对 象 .ZipArchive 
类 不 是 一 个 流 ， 但 是 它 使 用 流 进行 读 写 〈 类 似 于 前 面 讨论 的 读 取 器 和 写 入 器 )。 下 面 的 代码 片段 创建 一 个 
ZipArchive， 将 压缩 内 容 写 和 信用 File.OpenWrite 打开 的 文件 流 中 。 添 加 到 ZIP 归档 文件 中 的 内 容 由 所 传递 的 目录 
定义 。Directory. EnumerateFiles 枚 举 了 目录 中 的 所 有 文件 ， 为 每 个 文件 创建 一 个 ZipArchiveEnty 对 象 。 调 用 
Open 方法 创建 一 个 Stream 对 象 。 使 用 要 读 取 的 Stream 的 CopyTo 方法 ， 压 缩 文件 ， 写 入 ZipArchiveEntry ( 代 
码 文 件 CompressFileSample/Program.cs): 
Public static void Createz%ipFile (string directory, string ZzZipFile) 
{ 
FileStream zipSsStream = File.OpenWrite (zi]pFile); 
USslIno (var archive = new ZipArchive (zipStream, ZipArchiveMode .Create)) 
{ 
IEnumerable<string> files = Directory.EnumerateFiles!l 
directory, "*", SearchOoption.TopDirectoryOnly); 
foreach (var file in files) 
{ 
ZipArchiveEntry entry = archive.CreateEntry (Path.GetFileName (file)).; 
using (FileStream inputstream = File.OpenRead (file)) 
using (Stream outputstream = entry .Open()) 
{ 
inpeutstream.CopyIo(outputstream); 
} 
} 
} 


22.7 ”观察 文件 的 更 改 


使 用 FileSystemWatcher 可 以 监视 文件 的 更 改 。 事 件 在 创建 、 重 命名 、 删 除 和 更 改 文件 时 触发 。 这 可 用 于 如 
下 场景 : 需要 对 文件 的 变更 做 出 反应 ， 例 如 ， 服 务 器 上 传 文件 时 ， 或 文件 缓存 在 内 存 中 ， 而 缓存 需要 在 文件 更 
改 时 失效 。 
因为 FileSystemWatcher 易于 使 用 , 所 以 下 面 直接 开始 一 个 示例 .FileMonitor 的 示例 代码 利用 以 下 名 称 空间 : 
System 
System.IO 
示例 代码 在 WatchFiles0 方 法 中 开始 观察 文件 。 使 用 FileSystemWatcher 的 构造 函数 时 ， 可 以 提供 应 该 观察 
的 目录 。 还 可 以 提供 一 个 过 滤器 ,只 过 滤 出 与 过 滤 表 达 式 匹配 的 特定 文件 。 当 设置 属性 IncludeSubdirectories 时 ， 
可 以 定义 是 否 应 该 只 观察 指定 目录 中 的 文件 ， 或 者 是 否 还 应 该 观察 子 目 录 中 的 文件 。 对 于 Created、Changed、 
Deleted 和 Renamed 事件 , 提供 事件 处 理 程 序 。 所 有 这 些 事件 的 类 型 都 是 FileSystemEventHandler, 只 有 Renamed 
事件 的 类 型 是 RenamedEventHandler。RenamedEventHandler 派生 自 FileSystemEventHandler, 提供 了 事件 的 附加 
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言 息 ( 代 码 3 ileMonitorProsram.cs): 
信息 (代码 文件 FileMonitorProgram 
private static FilesystemWatcher s watcher; 


Public static void WatchFiles (string path, string filter) 
{ 

s watcher = new FileSystemWatcher (path, filter) 

{ 

IncscludeSubdirectories = true 

s watcher.Created += OnFileChanged; 

s watcher.Changed += OnFileChanged; 

s watcher.Deleted += OnFileChanged; 

Ss watcher.Renamed + 一 OnFlilleRenamed; 

s watcher.EnableRaisingEvents = true; 

Console .WriteLine{("watching file changes..."™); 


} 

因 文 件 变 更 而 接收 到 的 信息 是 FileSystemEventArgs 类 型 。 它 包含 了 变更 文件 的 名 字 ， 这 种 变更 是 一 个 
WatcherChangeTypes 类 型 的 枚 举 ; 

private static void OnFrileChanged (object sender, FileSystemEventArgs e) 

{ 


Console.WriteLine($"file {e.Name} {e.ChangeType}™"); 
} 


重 命名 文件 时 ， 通 过 RenamedEventArgs 参数 收 到 其 他 信息 。 这 个 类 型 派生 上 自 FileSsystemEventArgs, 它 定 义 了 
文件 原始 名 称 的 额外 信息 : 

private static void OnFileRenamed (object sender, RenamedEventArgs e) 

{ 


Console.WriteLine($"file {e.0ldName} {ee.ChangeType} to {ee.Name}"); 
} 


指定 要 观察 的 廊 件 夹 和 *.txt 作为 过 滤器 ， 启 动 应 用 程序 ， 创 建文 件 samplel.txt， 添 加 内 容 ， 把 它 重 命名 为 
sample2. txt， 最 后 删除 它 ， 输 出 如 下 。 


watching file changes... 

file New Text Document.txt Created 

file New Text Document.txt Renamed to samplel .txt 
file samplel.txt Changed 

file samplel.txt Changed 

file samplel.txt Renamed to sample2 .txt 

file sample2.txt Deleted 


22.8 ”使 用 内 存 映射 的 文件 


内 存 映 射 文件 允许 访问 文件 ， 或 在 不 同 的 进程 中 共享 内 存 。 这 个 技术 有 几 个 场景 和 特 反 : 
使 用 文件 地 图 ， 人 快速 随机 访问 大 文件 
在 不 同 的 进程 或 任务 之 间 共 享 文件 
在 不 同 的 进程 或 任务 之 间 共 享 内 存 
使 用 访问 器 直接 从 内 存 位 置 进行 读 写 
使 用 流 进行 读 写 
内 存 映 射 文件 API 允许 使 用 物理 文件 或 共享 的 内 存 ， 其 中 把 系统 的 页 面 文件 用 作 后 备 存 储 器 。 共 享 的 内 存 
可 以 大 于 可 用 的 物理 内 存 , 所 以 需要 一 个 后 备 存 储 器 。 可 以 为 特定 的 文件 或 共享 的 内 存 创 建 一 个 内 存 映射 文件 。 
使 用 这 两 个 选项 ， 可 以 给 内 存 映 射 指定 名 称 。 使 用 名 称 ， 允 许 不 同 的 进程 访问 同一 个 共 至 的 内 存 。 
创建 了 内 存 映 射 之 后 ， 束 可 以 创建 一 个 视图 。 视 图 用 于 映射 完整 内 存 映射 文件 的 一 部 分 ， 以 访问 它 ， 进 行 
读 写 。 
MemoryMappedFilesSample 利用 下 面 的 名 称 空 间 : 
System 
System.IO 
System.IO.MemoryMappedFiles 
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System.Ihreadmg 
System.Threading.Tasks 
示例 应 用 程序 演示 了 如 何 通 过 内 存 映射 文件 ， 使 用 这 两 种 视图 访问 器 和 流 完 成 多 个 任务 。 一 个 任务 是 创建 
内 存 映 射 文件 和 写 入 数据 ; 男 一 个 任务 是 读 取 数据 。 


注意 : 
示例 代码 使 用 了 任务 和 事件 。 任 务 和 任务 之 间 的 同步 参见 第 21 章 。 


准备 好 映射 ， 写 入 数据 时 ， 需 要 一 些 基础 设施 来 创建 任务 ， 发 出 信号 。 映 射 的 名 称 和 ManualResetEventSlim 
对 象 定义 为 Program 类 的 一 个 成 员 (代码 文件 MemoryMappedFilesSample/Program.cs)， 


private ManualResetEventSslim mapCreated = 
new ManualResetEventSslim(initialstate: false).: 


private ManualResetEventSlim dataWrittenEvent = 
new ManualResetEventSsliml(linitialstate: false); 


private const string MAPNAME = "SampleMap"; 
在 Main0 方 法 中 使 用 Task.Run0 方 法 开始 执行 任务 : 


Public void Run() 

{ 
Task.Run(() => WriterAsync ()}.; 
Task.Runt(()} => Reader())}).; 
Console.WriteLine ("tasks started"™y.: 
Console.ReadLine (); 


} 


现在 使 用 访问 器 创建 读 取 器 和 写 入 器 。 
22.8.1 使 用 访问 器 创建 内 存 映射 文件 


为 了 创建 一 个 基于 内 存 的 内 存 映射 文件 ， 写 入 器 调用 了 MemoryMappedFile.CreateOrOpen 方法 。 这 个 方法 
打开 第 一 个 参数 指定 名 称 的 对 象 , 如 果 它 不 存在 , 就 创建 一 个 新 对 象 .要 打开 现 有 的 文件 , 可 以 使 用 OpenExisting 
方法 。 为 了 访问 物理 文件 ， 可 以 使 用 CreateFromFile 方法 。 

示例 代码 中 使 用 的 其 他 参数 是 内 存 映 射 文件 的 大 小 和 所 需 的 访问 。 创 建 内 存 映 射 文件 后 ， 给 事件 
_mapCreated 发 出 信号 ， 给 其 他 任务 提供 信息 ， 说 明 已 经 创建 了 内 存 映射 文件 ， 可 以 打开 它 了 。 调 用 方法 
CreateViewAccessor， 返 回 一 个 MemoryMappedViewAccessor， 以 访问 共享 的 内 存 。 使 用 视图 访问 器 ， 可 以 定义 
这 一 任务 使 用 的 偶 移 量 和 大 小 。 当 然 ， 可 以 使 用 的 最 大 大 小 是 内 存 映 射 文件 的 大 小 。 这 个 视图 用 于 写 入 ， 因 此 
文件 访问 设置 为 MemoryMappedFileAccess.WTite。 

接 下 来 ， 使 用 MemoryMappedViewAccessor 的 重 载 Write 方法 ， 可 以 将 原始 数据 类 型 写 入 共享 内 存 。Write 
方法 总 是 需要 位 置信 息 ， 来 指定 数据 应 该 写 入 的 位 置 。 写 入 所 有 的 数据 之 后 ， 给 一 个 事件 发 出 信号 ， 通 知 读 取 
器 ， 现 在 可 以 开始 读 取 了 (代码 文件 MemoryMappedFilesSample/Proeram.cs): 

private async Task WriterAsync () 

| try 

using (MemoryMappedFile mappedFile = MemoryMappedFile .CreateOrOpen ( 
MAPFNAME, 10000, MemoryMappedFileAccess .ReadWrite)) 
ER // signal shared memory segment created 
Console .WriteLine ("shared memory segment created"); 
using (MemorvyMappedViewhccessor accessor = mappedFile.CreateViewhccessorl 
0, 10000, MemoryMappedFileAccess .Write)) 
for (int i = 0, pos = 0; i < 100; i++, pos += 4) 
aCCEeSSoOr .Write (pos, 工 ) ; 
Console .WriteLine(Snwritten {i} at position {pos}"); 


awalt Task.Delay (10); 
} 
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dataWrittenEvent -Set () : /:/ signal all data written 
Console.WriteLine{"data written™).:; 
} 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine ($s$"writer {ex.Message}™),; 
} 
} 


读 取 器 首先 等 待 创建 内 存 映 射 文件 ， 再 使 用 MemoryMappedFile.OpenExisting 打开 它 。 读 取 器 只 需要 映射 
的 读 取 权限 。 之 后 , 与 前 面 的 写 入 器 类 似 , 创建 一 个 视图 访问 器 。 在 读 取 数据 之 前 , 等待 设置 dataWrittenEvent。 
读 取 类 似 于 写 入 ， 因 为 也 要 提供 应 该 访问 数据 的 位 置 ， 但 是 不 同 的 Read 方法 ， 如 ReadInt32， 用 于 读 取 不 同 的 

private void Reader () 

{ 

try 

{ 
Console.WriteLine ("reader"™),; 
mapCreated.Wait (); 
Console.WriteLine ("reader starting™).; 
using (MemoryMappedFile mappedFile = MemoryMappedFile.OpenExisting' 
MAPNAME, MemoryMappedFileRights .Read)) 
{ 
Using (MemorvyMappedViewhccessor accessor = mappedFile.CreateViewhccessorl 
0, 10000, MemoryMappedFileAccess .Read)) 
{ 
dataWrittenEvent .Wait (); 
Console.WriteLine ("reading can start Pow'") : 
for (int i = 0; 1 < 400; 1 += 4) 
{ 
int result = accessor.ReadInt32 (1).; 
Console.WriteLine ($"reading {result} from position {1}"); 
} 
} 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"reader {ex.Message}™"); 
} 
} 


运行 应 用 程序 ， 输 出 如 下 : 
reader 

reader starting 

tasks started 

shared memory Segment created 
written 0 at position 0 
written 1 at position 4 
written 2 at position 8 


written 99 at 396 

data written 

reading can start now 
reading 0 from position 0 
reading 1 from position 4 


22.8.2 ”使 用 流 创 建 内 存 映 射 文件 


除了 用 内 存 映 射 文 件 写 入 原始 数据 类 型 之 外 ， 还 可 以 使 用 流 。 流 允许 使 用 读 取 器 和 写 入 器 ， 如 本 章 前 面 所 
述 。 现 在 创建 一 个 写 入 器 来 使 用 StreamWriter。 MemoryMappedFile 中 的 方法 CreateViewStream0 返回 
MemoryMappedViewStream。 这 个 方法 非常 类 似 于 前 面 使 用 的 CreateViewAccessor0 方 法 ， 也 是 在 映射 内 定义 一 
个 视图 ， 有 了 偏 移 量 和 大 小 ， 可 以 方便 地 使 用 流 的 所 有 特性 。 

然后 使 用 WriteLineAsync0 方 法 把 一 个 字符 串 写 到 流 中 。StreamWriter 缓存 写 入 操作 ， 所 以 流 的 位 置 不 是 在 
每 个 写 入 操作 中 都 更 新 ， 只 在 写 入 器 写 入 块 时 才 更 新 。 为 了 用 每 次 写 入 的 内 容 刷 新 缓存 ， 要 把 StreamWriiter 的 
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AnutoFlush 属性 设置 为 tue( 代 码 文件 MemoryMappedFilesSample/Program.cs): 
private async Task WriterUsingstreams ( ) 
{ 
tryY 
{ 
using (MemoryMappedFile mappedFile = MemoryMappedFile.CreateOropenl( 
MAPNAME, 10000, MemoryMappedFileAccess.ReadWrite)) 
{ 
_ mapCreated.Set(}); // signal shared memory segment created 
Console .WriteLine ("shared memory segment created"™); 
MemoryMappedViewSstream stream = mappedFile.CreateViewStream!l 
0, 10000, MemoryMappedFileAccess .Write). 
using (var Writer = new StreamHriter (stream)) 
{ 
WIlter.AutoFlush = 七 了 TUE 7 
for (nt 1 = 0; 1 < 100; I++)} 
{ 
string Ss = $"some data {1}"; 
Console .WriteLine($"writing {s} at {stream.Position}"); 
await writer .WriteLineAsync(s); 
} 


} 
dataWrittenEvent.Set(); i:/ signal all data written 


Console .WriteLine ("data written™),; 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"writer {ex.Message}™); 
} 
} 
人 | | 各 i PE 有 HF :下 加 | ee 
读 取 器 同样 用 CreateViewStream 创建 了 一 个 映射 视图 流 , 但 这 次 需要 读 取 权限 。 现 在 可 以 使 用 StreamReader0) 
Fw 上 人 二 | x 
方法 从 共享 内 存 中 读 取 内 容 : 
private async Task ReaderUsingstreams () 
{ 
try 
{ 
Console.WriteLine ("reader™); 
mapCreated .Wait (}); 
Console.WriteLine("reader starting™"); 
using (MemoryMappedFile mappedFile = MemoryMappedFile.OpenExistingl 
MAPNAME, MemoryMappedFileRights.Read)) 
{ 
MemorvMappedViewSstream stream = mappedFile.CreateViewSstreaml! 
0, 10000, MemorvyMappedFileAccess .Read); 
USing (Var reader = new StreamReader (stream)) 
{ 
dataWrittenEvent .Wait (}; 
Console.WriteLine ("reading can start now"™); 
for {int i = 0; i < 100; 1i++) 
{ 
long pos = stream.Position; 
string s = await reader.ReadLineAsync().; 
Console .WriteLine ($$"read {s} from {pos}"); 
} 
} 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine($"reader {ex.Message}™); 
} 
} 


运行 应 用 程序 时 ， 可 以 看 到 读 写 的 数据 。 写 入 数据 时 ， 流 中 的 位 置 总 是 更 新 ， 因 为 设置 了 AutoFlush 属性 。 
读 取 数据 时 ， 总 是 读 取 1024 字 节 的 块 。 


tasks started 

reader 

reader starting 

shared memory Segment created 
WIiting some data 0 at 0 
WIliting some data 1 at 13 
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WIiting some data 2 at 26 
WIiting some data 3 at 39 
Writing some data 4 at S52 
data written 

reading can start now 
read some data 0 from 0 
read some data 1 from l1024 


read some data 之 from 1024 
read some data 3 from 1l1024 


通过 内 存 映射 文件 通信 时 ， 必 须 同 步 读 取 器 和 写 入 器 ， 这 样 读 取 器 才 知 道 数据 何 时 可 用 。 下 一 节 讨论 的 管 
起 给 这 样 的 场景 提供 了 其 他 选项 。 


22.9 ”使 用 管道 通信 


为 了 在 线程 和 进程 之 间 通 信 ， 在 不 同 的 系统 之 间 快 速 通信 ， 可 以 使 用 管道 。 在 .NET 中 ,管道 实 现 为 流 ， 因 
此 不 仅 可 以 把 字 节 发 送 到 管道 ， 还 可 以 使 用 流 的 所 有 特性 ， 如 读 取 器 和 写 入 器 。 
管道 实现 为 不 同 的 类 型 : 一 种 是 命名 管道 ， 其 中 的 名 称 可 用 于 连接 到 每 一 端 ， 另 一 种 是 匿名 管 志 。 匿 名 管 
道 不 能 用 于 不 同系 统 之 间 的 通信 ; 只 能 用 于 一 个 父子 进程 之 间 的 通信 或 不 同 任务 之 间 的 通信 。 
所 有 管道 示例 的 代码 都 利用 以 下 名 称 空间 : 
System 
System.IO 
System.IO.Pipes 
System.Threadine 
System.Threadne.Tasks 
下 面 先 使 用 命名 管道 在 不 同 的 进程 之 间 进 行 通信 。 在 第 一 个 示例 应 用 程序 中 , 使 用 了 两 个 控制 台 应 用 程序 。 
一 个 充当 服务 器 ， 从 管道 中 读 取 数 据 ; 另 一 个 把 消息 写 入 管道 。 


22.9.1 创建 命名 管道 服务 器 


通过 创建 NamedPipeServerStream 的 一 个 新 实例 ， 来 创建 服务 器 。NamedPipeServerStream 派生 自 基 类 
PipeStream，PipeStream 派生 目 Stream 基 类 ， 因 此 可 以 使 用 流 的 所 有 功能 ， 例 如 ， 可 以 创建 CryptoStream 或 
GZipSstream， 把 加 密 或 压缩 的 数据 写 入 命名 管道 。 构 造 图 数 需 要 管道 的 名 称 ， 通 过 管道 通信 的 多 个 进程 可 以 使 
用 该 管道 。 

用 于 下 面 代 码 片 段 的 第 二 个 参数 定义 了 管道 的 方 问 。 服 务 器 流 用 于 读 取 ， 因 此 将 方向 设置 为 
PipeDirection.In。 命 名 管道 也 可 以 是 双 同 的 ， 用 于 读 写 ， 此 时 使 用 PipeDirection.InOut。 匿 名 管道 只 能 是 单 问 的 。 
接 下 来 , 调用 WaitForConnection0) 方 法 , 命名 管道 等 待 写 入 方 的 连接 。 然 后 , 在 一 个 循环 中 (直到 收 到 消息 "bye”)， 
管道 服务 器 把 消 晨 读 入 缓冲 区 数组 ， 把 消息 写 到 控制 台 ( 代 码 文 件 PipesReader/Program.cs): 

private static void PipesReader (string pipeName) 


try 
{ 
using (var pipeReader = 
new NamedPipeServerstream(pipeName, PipeDirection.In)) 
{ 
PipeReader .WaitForConnection().; 
Console .WriteLine("reader connected™); 
const jint BUFFERSIZE = 256; 
bool completed = false; 
while (!'completed) 
{ 
bytel[] buffer = new byte [BUFFERSIZE]|:; 
int nRead = pipeReader .Read(buffer, 0, BUFFERSIZE).; 
string line = Encoding.UTF8.Getstring (buffer, 0, nRead); 
Console.WriteLine (line});) 
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if (line == "bye") completed = true; 
} 
} 


Console.WriteLine ("comleted reading™}); 
Console.ReadLine (); 


catch (Exception ex) 
{ 
Console.WriteLine (ex.Message); 
} 
} 


以 下 是 可 以 用 命名 管道 配置 的 其 他 一 些 选 项 : 

se 可 以 把 枚 举 PipeTransmissionMode 设置 为 Byte 或 Message。 设 置 为 Byte， 就 发 送 一 个 连续 的 流 ， 设 置 
为 Message， 就 可 以 检索 每 条 消 居 。 

e 使 用 管道 选项 ， 可 以 指定 WriteThrough 立即 写 入 管道 ， 而 不 缓存 。 

e 可 以 为 输入 和 输出 配置 缓冲 区 大 小 。 

e 配置 管道 安全 性 ， 指 定 谁 允许 读 写 管道 。 安 全 性 参见 第 24 章 。 

se 可 以 配置 管道 句柄 的 可 继承 性 ， 这 对 与 子 进程 进行 通信 是 很 重要 的 。 

因为 NamedPipeServerStream 是 一 个 流 ， 所 以 可 以 使 用 StreamReader， 而 不 是 读 取 字 节 数 组 ， 该 方法 简化 

了 代码 : 


Var pipeReader = new NamedPipeServerSstream(lpipeName, PipeDirection.In); 
using (var reader = new StreamReader (pipeReader)) 
{ 


pipeReader.WaitForCconnection(); 
Console.WriteLine("reader connected™).; 
bool completed = falser 
while {({!completed) 
{ 
string line = reader.ReadLine(); 
Console.WriteLine{(line).: 
if (line == "bye") completed = true; 
} 
} 


22.9.2 ”创建 命名 管道 客户 端 


现在 需要 一 个 客户 端 。 服 务 器 读 取 消 忠 ， 客 户 问 就 写 入 它们 。 

通过 实例 化 一 个 NamedPipeClientStream 对 象 来 创建 客户 痛 。 因 为 命名 管道 可 以 在 网 络 上 通信 ,所 以 需要 服 
务 器 名 称 、 管 道 的 名 称 和 管道 的 方向 。 客 户 端 通过 调用 Connect0 方 法 来 连接 。 连 接 成 功 后 ， 就 在 StreamWiiter 
上 调用 WriteLine， 把 消息 发 送 给 服务 器 。 默 认 情 况 下 ， 消 息 不 立即 发 送 ， 而 是 缓存 起 来 。 调 用 Flush0 方 法 把 消 
息 推 到 服务 器 上 。 也 可 以 立即 传送 所 有 的 消息 ， 而 不 调用 Flush0 方 法 。 为 此 ， 必 须 配 置 选项 ， 在 创建 管道 时 遍 
历 缓存 文件 (代码 文件 PipesWriterProgram.cs): 


Public static vold PipesWriter(string serverName, string pipeName) 
{ 
Var pipeWriter = new NamedPipeClientSstreaml(lserverName, 
PipeName, PipeDirection.Out).; 
Using (var writer = new StreamWriter (pipeWriter)) 
{ 
PipeWriter .Connect().; 
Console .WriteLine ("writer connected"™):; 
bool completed = false; 
while (!'completed) 
{ 
string input = ReadLine (); 
if (input == "bye") completed = true; 
writer.WriteLine (input)}).; 
Writer.Flush'().; 
} 
} 
Console.WriteLine("comleted writing™"),; 


} 


为 了 在 Visual Studio 内 开始 两 个 项 目 ， 可 以 用 Project | Set Startup Projects 配置 多 个 启动 项 目 。 运 行 应 用 程 
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序 ， 一 个 控制 台 的 输入 就 在 男 一 个 控制 台 上 回应 。 
22.9.3 创建 匿名 管道 


下 面 对 匿 名 管道 执行 类 似 的 操作 。 通过 匿名 管道 ,创建 两 个 彼此 通信 的 任务 。 为 了 给 管道 的 创建 发 出 信和 号， 
使 用 ManualResetEventSlim 对 象 ， 与 内 存 映射 文件 一 样 。 在 Program 类 的 Run 方法 中 ， 创 建 两 个 任务 ， 调 用 
Reader 和 Wiriter 方法 (代码 文件 AnonymousPipes/Proeram.cs): 


private string pipeHandle; 
private ManualResetEventSslim pipeHandleset:; 


static woid Maint() 

{ 
Var p = new Program(}); 
p-.Run()}); 
Console.ReadLine (); 


} 


Public void Run() 
{ 
PipeHandlesSet = new ManualResetEventSlim(initialstate: false); 
Task.Run(l() => Reader ());，; 
Task.Run(() => Writer({())}).; 
Console.ReadLine (); 


} 


创建 一 个 AnonymousPipeServerStream， 定 义 PipeDirection.In， 把 服务 器 端 充 当 读 取 器 。 通 信 的 另 一 端 需要 
知道 管道 的 客户 端 句 柄 。 这 个 句柄 在 GetClientHandleAsString 方法 中 转换 为 一 个 字符 串 , 赋予 pipeHandle 变量 。 
这 个 变量 以 后 由 充当 写 入 器 的 客户 端 使 用 。 在 最 初 的 处 理 后 ， 省 道 服务 器 可 以 作为 一 个 流 ， 因 为 它 本 来 就 是 一 
个 流 : 


private void Reader () 
{ 
try 
{ 
Var PipeReader = new AnonymousPipeServerSstream(PipeDirection.In, 
HandleInheritability.None); 
using (var reader = new StreamReader (pipeReader)) 
{ 
_PipeHandle = pipeReader .GetClientHandleAsSstring(); 
Console .WriteLine($"pipe handle: { pipeHandle}™); 
PipeHandleset .Set () ; 加 
bool end = false; 
while (lend) 
{ 
string line = reader.ReadLine (); 
Console.WriteLine (line):; 
if (line == "end") end = true:; 
} 
Console .WriteLine ("finished reading™); 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine (ex.Message).; 
} 
} 


客户 端 代码 等 到 变量 pipeHandleSet 发 出 信号 ， 就 打开 由 _pipeHandle 变量 引用 的 管道 句柄 。 后 来 的 处 理 用 
StreamWriter 继续 ; 


private void Writer() 
{ 
Console.WriteLine ("anonymous pipe writer™); 
PipeHandleSet .Wait (); 
Var pipeWriter = new AnonymousPipeClientSstream! 
PipeDirection.QOut, pipeHandle).; 
USing (Var writer = new StreamWriter (pipeWriter)) 
{ 
WIlter.AutoFlush = true; 
Console.WriteLine ("starting writer™); 
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for (int i = 0; 1 < 5; 1i++) 

{ 
writer.WriteLine ($"Message {1}"); 
Task.Delay (500) .Wait (); 

} 

WIiter.WIriteLine ("end™).: 

} 
} 


运行 应 用 程序 时 ， 两 个 任务 就 相互 通信 ， 在 任务 之 间 发 送 数 据 。 


22.10 ”通过 Windows 运行 库 使 用 文件 和 流 


通过 Windows 运行 库 ， 可 以 使 用 本 地 类 型 实现 流 。 尽 管 它 们 用 本 地 代码 实现 ， 但 看 起 来 类 似 于 .NET 类 型 。 
然而 ， 它 们 是 有 区 别 的 ， 对 于 流 ，Windows 运行 库 在 名 称 空间 Windows.Storage.Streams 中 实现 目 己 的 类 型 。 其 
中 包含 FileImputStream 、FileOutputStream 和 RandomAccessStreams 等 类 。 所 有 这 些 类 都 基于 接口 ， 例 如 
ImputStream、IOutputStream 和 IRandomAccessStream。 还 有 读 取 器 和 写 入 器 的 概念 。Windows 运行 库 的 读 取 器 
和 写 入 器 类 型 是 DataReader 和 DataWriter。 

下 面 看 看 它 与 前 面 的 .NET 流 有 什么 不 同 ，.NET 流 和 类 型 如 何 映射 到 这 些 本 地 类 型 上 。 


22.10.1 Windows App 编辑 器 


下 面 使 用 Blank App (Universal Windows) Visual Studio 模板 创建 一 个 编辑 器 。 
为 了 添加 打开 和 保存 文件 的 命令 ， 在 主页 上 添加 一 个 带 AppBarButton 元 素 的 CommandBar (代码 文件 
WindowsAppEditor/MainPage. xam!l): 


<Page.BottomAppBar> 
<CommandBar Isopen="TIUe"> 
<AppBarButton Icon="OpenFile™" Label="Open™" Click="{x:Bind Onopen}™ /> 
<AppBarButton Icon="Save" Label="Save™" Click="{xX:Bind Onsave}™ /> 
</CommandBar> 
</Page .BottomAppBar> 


添加 到 Grid 中 的 TextBox 接收 文件 的 内 容 : 
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
<TextBox x:Name="textl" HorizontalTextAlignment="Left" 


AcceptsReturn="True" /> 
</Grid> 


OnOpen 句柄 首先 月 动 对 话 框 ， 用 户 可 以 在 其 中 选择 文件 。 记 住 ， 前 面 使 用 了 OpenFileDialog。 在 Windows 
应 用 程序 中 ， 可 以 使 用 选择 器 。 要 打开 文件 ，FileOpenPicker 是 首选 的 类 型 。 可 以 配置 此 选择 器 ， 为 用 户 定义 
建议 的 开始 位 置 . 将 SuggestedStartLocation 设置 为 PickerLocationId. DocumentsLibrary, 打开 用 户 的 文档 文件 夹 。 
PickerLocationId 是 定义 各 种 特殊 文件 夹 的 枚 举 。 

接 下 来 ，FileTypeFilter 集合 指定 应 该 为 用 户 列 出 的 文件 类 型 。 最 后 ， 方 法 PickSingleFileAsync 返回 用 户 选 
择 的 文件 。 为 了 让 用 户 选择 多 个 文件 ， 可 以 使 用 方法 PickMultipleFilesAsync。 这 个 方法 返回 一 个 StorageFile。 
StorageFile 是 在 Windows.Storage 名 称 空间 中 定义 的 。 这 个 类 相当 于 FileInfo 类 ， 用 于 打开 、 创 建 、 复 制 、 移 动 
和 删除 文件 (代码 文件 WindowsAppEditor/MainPage.xaml.cs): 


Public async void Onopen() 
{ 
try 
{ 
Var Picker = new FileOpenPicker() 
{ 
ViewMode = PickerViewMode .Thumbnail, 
SuggestedSstartLocation = PickerLocationld.DocumentsLibrary 
}; 
Picker .FileTypeFilter.Addl(™" .txt"),; 
Picker.FileTypeFilter.Add(" .md").; 


StorageFile file = await picker.PickSingleFileAsync(); 
EE 
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现在 ， 使 用 方法 OpenReadAsync0 打 开 文 件 。 这 个 方法 返回 一 个 实现 了 接口 IRandomAccessStream- 
WithContentType 的 流 , IRandomAccessStreamWithContentType 派生 于 接口 RandomAccessStream、 IInputStream、 
IOuputStream、IContentProvider 和 IDisposable。IRandomAccessStream 人 允许 使 用 Seek 方法 随机 访问 流 ， 提 供 了 
流 大 小 的 信息 。IInputStream 定义 了 读 取 流 的 方法 ReadAsync。IOutputStream 正好 相反 ， 它 定义 了 WriteAsync 
和 FlushAsync 方法 。IContentTypeProvider 定义 了 属性 ContentType， 提 供 文件 内 容 的 信息 。 还 记得 文本 文件 的 
编码 吗 ? 现在 可 以 调用 ReadAsync0 方 法 ， 读 取 流 的 内 容 。 然 而 ，Windows 运行 库 也 知道 前 面 讨论 的 读 取 器 和 
写 入 器 概念 .DataReader 通过 构造 函数 接受 IInputStream。DataReader 类 型 定义 的 方法 可 以 读 取 原始 数据 类 型 ， 
如 ReadInt16、ReadInt32 和 ReadDateTime。 使 用 ReadBytes 可 以 读 取 字 节 数组 ， 使 用 ReadString 可 以 读 取 字符 
嘻 。ReadString(0 方 法 需要 要 读 取 的 字符 数 。 字 符 串 赋 给 TextBox 控件 的 Text 属性 ， 来 显示 内 容 : 


i... 
if (file != null) 
{ 
IRandomhccessSstreamWithContentIiype stream = await file.OpenReadhsynce().:; 
using (var reader = new DataReader (stream)) 
{ 
await reader.LoadAsync( (uint) stream.Size). 
textl.Text = reader.ReadString( (uint) stream. Size).; 
} 
} 
} 
catch (Exception ex) 
{ 
Var dlg = new MessageDialog (ex.Message, "Error™); 
await dlg.ShowAsync(); 
} 


注意 : 

与 NET Framework 的 读 取 器 和 写 入 器 类 似 ，DataReader 和 DataWriter 管理 通过 构造 函数 传递 的 流 。 在 销毁 
读 取 器 和 写 入 器 时 ， 流 也 会 销 席 。 在 NET 类 中 ， 为 了 底层 流 打 开 更 长 时 间 ， 可 以 在 构造 函数 中 设置 leaveOpen 
参数 。 对 于 Windows 运行 库 类 型 ， 可 以 调用 方法 DetachStream， 把 读 取 器 和 写 入 器 与 流 分 离开 。 


保存 文档 时 ， 调 用 OnSave0) 方 法 。 首 先 ，FileSavePicker 用 于 允许 用 户 选 择 文档 ， 与 FileOpenPicker 类 似 。 
接 下 来 , 使 用 OpenTransactedWriteAsync 打开 文件 。NTFS 文件 系统 支持 事务 ; 这 些 都 不 包含 在 .NET Framework 
中 ， 但 可 用 于 Windows 运行 库 。OpenTransactedWriteAsync 返回 一 个 实现 了 接口 IStorageStreamTransaction 的 
StorageStreamTransaction 对 象 。 这 个 对 象 本 身 并 不 是 流 ， 但 是 它 包 含 了 一 个 可 以 用 Stream 属性 引用 的 流 。 这 个 
属性 返回 一 个 信 andomAccessStream 流 。 与 创建 DataReader 类 似 ， 可 以 创建 一 个 DataWriter， 写 入 原始 数据 类 
型 ， 包 括 字 符 串 ， 如 这 个 例子 所 示 。StoreAsynec 方法 最 后 把 缓冲 区 的 内 容 写 到 流 中 。 销 毁 写 入 器 之 前 ， 需 要 调 


本 入 3 目 
用 CommitAsync 方法 来 提交 事务 : 
PuUublic async void Onsave() 
{ 
七 工交 
{ 
var picker = new FileSavePlcker () 
{ 
SuggestedSstartLocation = PickerLocationId.DocumentsLibrary, 
SuggestedFileName = "New Document™" 
上 


picker.FileTypeChoices.Add ("Plain Text", new List<string>() { ".txt"™ }); 
StorageFile file = await picker.PickSaveFileAsync(); 
if (file ‘= null) 
{ 
Using (StorageSstreamIransaction tx = 
await file.OpenTransactedWHriteAsvync()) 


IRandomiccessSstream stream = tx.Stream; 
stream.Seek (0).; 
USInd (Var writer = new DataWriter (stream)) 
{ 
writer.WriteSstring (textl] .Text); 
tx.Stream.Size = awalt writer.SsStoreAsync (); 
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awalt tx.CommitAsync (); 
} 
} 
} 
} 
catch (Exception ex) 
{ 
Var dlg = new MessageDialog (ex.Message, "Error™); 
await dlg.sShowhsync(}); 
} 
} 


DataWriter 不 把 定义 Unicode 文件 种 类 的 序言 添加 到 流 中 。 需 要 明确 这 么 做 ， 如 本 章 前 面 所 述 。DataWiTriter 
只 通过 设置 UnicodeEncoding 和 ByteOrder 属性 来 处 理 文 件 的 编码 。 默 认 设置 是 UnicodeEncoding.Utf8 和 
ByteOrder BigEndian。 除 了 使 用 DataWriter 之 外 ， 还 可 以 利用 StreamReader 和 StreamWriter 以 及 .NET Stream 
类 的 功能 ， 见 下 一 节 。 


22.10.2 把 Windows Runtime 类 型 映射 为 .NET 类 型 


下 面 开 始 读 取 文 件 。 为 了 把 Windows Runtime 流转 换 为 .NET 流 用 于 读 取 ， 可 以 使 用 扩展 方法 
AsStreamForRead。 这 个 方法 是 在 程序 集 System.Runtime.WindowsRuntime 的 System.IO 名 称 空 间 中 定义 (必须 打 
开 )。 这 个 方法 创建 了 一 个 新 的 Stream 对 象 ， 来 管理 InputStream。 现 在 ， 可 以 使 用 它 作为 正常 的 NET 流 ， 如 
前 所 述 ， 例 如 ， 给 它 传递 一 个 StreamReader， 使 用 这 个 读 取 器 访问 文件 : 


Public async void OnopenDotnet () 
{ 
try 
{ 
Var picker = new FileQpenPickerl() 
{ 
ViewMode = PickerViewMode.Thumbnail, 
SuggestedstartLocation = PickerLocationId.DocumentsLibrary 
上 
picker.FileTypeFilter.Add(".txt").; 
picker.FileTypeFilter.Add{(".md™"); 


storageFile file = awalt picker.PickSingleFileAsync();} 
if (file != null) 
{ 
IRandomAccessStreamWithContentType wrtSstream = 
await file.OopenReadAsync (); 
Stream stream = WrtSstream.AsSstreamForReadl().; 
using (var reader = new StreamReader (stream)) 
{ 
textl .Text = await reader .ReadToEndAsvync(); 
} 
} 
} 
catch (Exception ex) 
{ 
Var dlg = new MessageDialog (ex.Message, "Error™),; 
await dlg.showhsync () ; 
} 
} 


所 有 的 Windows Runtime 流 类 型 都 很 容易 转换 为 .NET 流 ， 反 之 亦 然 。 表 22-2 列 出 了 所 需 的 方法 : 


表 22-2 


从 方 法 
RAR Rss 
ImputsStream AsStreamForRead 
i AsStreamFor writ 


Stream AsInputstream 
Stream IOQutputstream AsOQutputSstream 
Stream IRandomAccessStream AsRandomAccessStream 
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现在 将 更 改 保存 到 文件 中 。 用 于 写 入 的 流通 过 扩展 方法 AsStreamForWiite 转换 。 现 在 ， 这 个 流 可 以 使 用 
StreamWiriter 类 写 入 。 代 码 片段 也 把 UFT- 8 编码 的 序言 写 入 文件 : 
public async void onsaveDotnet () 
try 
var picker = new FileSavepicker () 


{ 


SuggestedstartLocation = PickerLocationId.DocumentsLibrary, 
SuggestedFileName = "New Document™" 


于 
picker.FileTypeChoices.Add ("Plain Text", new 工 LSt<SLITIDO>() { ".txt™ }); 


StorageFile file = awalt plcker.PickSaveFileAsync(); 
IE (file != null) 
{ 


StorageSstreamTransaction tx = await file.0OpenTransactedWriteAsync (); 
using (var writer = new StreamWriter (tx .Stream.AsStreamForWrite())})) 
{ 

byte[] preamble = Encoding .UTFS8.GetPreamblel().; 

await stream.WriteAsync (preamble, 0, preamble.Length).; 

await writer.WriteAsync (textl .Text); 

await writer.FlushAsync().:; 

tx .Stream.Size = (ulong) stream.Length.; 

await tx.CommitAsynct().; 
} 

} 
} 
catch (Exception ex) 


{ 


Var dlg = new MessageDialog (ex.Message, "Error"™); 
awalt dlg.ShowAsync(); 
} 
} 


22.11 ”小结 


本 章 介 绍 了 如 何在 C# 代 码 中 使 用 NET 基 类 来 访问 文件 系统 。 在 这 两 种 情况 下 ， 基 类 提供 的 对 象 模型 比较 
简单 ， 但 功能 强大 ， 从 而 很 容易 执行 这 些 领 域 中 几乎 所 有 的 操作 。 对 于 文件 系统 ， 可 以 复制 文件 ; 移动、 创建 、 
删除 文件 和 文件 夹 ， 读 写 二 进 制 文件 和 文本 文件 。 

本 章 学 习 了 如 何 使 用 压缩 算法 和 ZIP 文件 来 压缩 文件 。 在 更 改 文件 时 ，FileSystemWatcher 用 于 获取 信息 。 
还 解释 了 如 何 通过 共享 内 存 、 命 名 管道 和 匿名 管道 进行 通信 。 最 后 ， 讨 论 了 如 何 把 NET 流 映射 到 Windows 
Runtime 流 ， 在 Windows 应 用 程序 中 利用 NET 特性 。 

本 书 的 其 他 章节 会 介绍 流 的 操作 。 第 23 章 在 网 络 上 使 用 流 发 送 数 据 。 读 写 XML 文件 和 发 送 大 型 XML 文 
件 的 内 容 参 见 网 上 附加 第 2 章 。 

第 23 草 将 介绍 联网 和 在 网 络 上 发 送 流 的 内 容 。 


网 络 


本 章 要 点 

e 操作 地址 ， 执 行 DNS 查询 

e 用 WebListener 创建 服务 器 

e 用 TCP、UDP 和 套 接 字 类 进行 套 接 字 编程 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代 码 。 源 代码 也 可 以 在 Networking 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 
HttpClientSample 
WinAppHttpClient 
HttpServer 
Utlities 
DnsLookup 
HttpClientUsingTcp 
TcpServer 
WmAppTcpClient 
UdpRecelver 
UdpSender 
SocketServer 
SocketClient 


23.1 概述 


本 章 将 采取 非常 实用 的 网 络 方法 ， 结 合 示例 讨论 相关 理论 和 相应 的 网 络 概念 。 本 章 并 不 是 计算 机 网 络 的 指 
南 ， 但 会 介绍 如 何 使 用 NET Framework 进行 网 络 通信 。 
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本 章 介绍 了 如 何 使 用 网 络 协议 创建 客户 端 和 服务 器 。 从 最 简单 的 示例 开始 ， 立 明 如 何 给 服务 器 发 送 请 求 和 
在 啊 应 中 存储 返回 的 信息 。 

然后 讨论 如 何 创建 HITP 服务 器 ， 使 用 实用 工具 类 分 拆 和 创建 URI， 把 主机 名 解析 为 PP 地 址 。 还 介绍 了 通 
过 TCP 和 UDP 收发 数据 ， 以 及 如 何 利用 Socket 类 。 

在 网 络 环境 下 ， 我 们 最 感 兴趣 的 两 个 名 称 空间 是 System.Net 和 System.Net.Sockets。System.Net 名 称 空 间 通 
帝 与 较 高 层 的 操作 有 关 ， 例 如 下 载 和 上 传 文件 ,使 用 HITP 和 其 他 协议 进行 Web 请 求 等 ; 而 System Net Sockets 
名 称 空间 包含 的 类 通常 与 较 低 层 的 操作 有 关 。 如 果 要 直接 使 用 套 接 字 或 TCP/IP 之 类 的 协议 , 这 个 名 称 空间 中 的 
类 就 非常 有 用 ， 这 些 类 中 的 方法 与 Windows 套 接 字 (Winsock)API 函数 (派生 自 Berkeley 套 接 字 接口 非常 类 似 。 
本 章 介绍 的 一 些 对 象 位 于 System.IO 名 称 空间 中 。 


23.2 ”HttpClient 类 


HttpClient 类 用 于 发 送 HTTP 请 求 ， 接 收 请 求 的 响应 。 它 在 System NetHttp 名 称 空间 中 。System Net.Http 
名 称 空间 中 的 类 有 助 于 简化 在 客户 问 和 服务 器 上 使 用 Web 服务 。 

HttpClient 类 派生 于 HttpMessageInvoker 类 , 这 个 基 类 负责 执行 SendAsync 方 法 .SendAsynec 方法 是 HttpClient 
类 的 主干 。 如 本 节 后 面 所 述 ， 这 个 方法 有 几 个 派生 物 。 顾 名 思 义 ，SendAsync 方法 调用 是 异步 的 ， 这 样 就 可 以 
编写 一 个 完全 异步 的 系统 来 调用 Web 服务 。 


警告 : 

HttpClient 类 实现 了 IDisposable 接口 。 一 般 来 说 ， 实 现 IDisposable 的 对 象 应 该 在 使 用 后 销毁 。HttpClient 
类 也 是 如 此 。 但 是 ，HttpClient 的 Dispose 方法 不 会 立即 释放 相关 的 套 接 字 ， 而 是 在 超时 后 释放 。 这 个 超时 可 能 
需要 20 秒 .有 了 这 个 超时 ,使 用 许多 HttpClient 对 象 实例 可 能 导致 程序 耗 尽 套 接 字 。 解 决 方案 是 : 构建 HttpClient 
类 ， 以 进行 重用 。 可 以 对 许多 请 求 使 用 这 个 类 ， 而 不 是 每 次 都 创建 一 个 新 实例 。 


23.2.1 发 出 异步 的 Get 请 求 


本 章 的 下 载 代码 示例 是 HttpClientSample。 它 以 不 同 的 方式 异步 调用 Web 服务 。 为 了 演示 本 例 使 用 的 不 同 
方法 ， 使 用 了 命令 行 参 数 。 
示例 代码 使 用 了 以 下 名 称 空间 : 
System 
System_.LIng 
System.Net 
System.Net.Http 
System.Net.Http.Headers 
System.Threadne 
System.Threadine.Tasks 
第 一 段 代码 实例 化 一 个 HttpClient 对 象 ， 把 它 赋 予 私有 字段 httpClient， 以 进行 重用 。 这 个 HttpClient 对 象 
是 线程 安全 的 ， 所 以 一 个 HttpClient 对 象 就 可 以 用 于 处 理 多 个 请 求 。HttpClient 的 每 个 实例 都 维护 它 目 己 的 线程 
池 ， 所 以 HttpClient 实例 之 间 的 请 求 会 被 隔离 。 
接着 调用 GetAsync， 给 它 传 递 要 调用 的 方法 的 地 址 ， 把 一 个 HTTP GET 请 求 发 送 给 服务 器 。GetAsync 调 
用 被 重 载 为 带 一 个 字符 串 或 URI 对象。 在 本 例 中 调用 Microsoft 的 OData 示例 站 点 http://services.odata.org， 但 
可 以 修改 这 个 地 址 ， 以 调用 任意 多 个 REST Web 服务 。 
对 GetAsync 的 调用 返回 一 个 HttpResponseMessage 对 象 。HttpResponseMessage 类 表示 包含 标题 、 状 态 和 内 
容 的 啊 应 。 检 查 啊 应 的 ISuccessfulstatusCode 属性 ， 可 以 确定 请 求 是 否 成 功 。 如 果 调 用 成 功 ， 就 使 用 
ReadAsStringAsync 方法 把 返回 的 内 容 检索 为 一 个 字符 串 ( 代 码 文 件 HttpClientSample/HttpClientSamples.cs): 
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private const string NorthwindUrl = 
"http://services.data.org/Northwind/Northwind.svec/Regions™; 

private const string INCorrectUrl = 
"http://services.data.org/Northwindl/Northwind.svcec/Regions"™; 


private HttpClient httpClient; 
public HttpClient HttpClient => 
httpClient 232? ( httpClient = new HttpClient ()); 


private async Task GetDataSsimpleAsyncl() 


{ 
HttpResponseMessage response = await HttpClient.GetAsync (NorthwindUrl).; 


if(response.TIsSuccessSstatusCode) 
{ 


Console .WriteLine ($"Response Status Code: {(int)response.StatusCode} " 十 
$s"{response.ReasonPhrase}"); 
string responseBodyAsText = await response.Content.ReadAsstringAsync(); 
Console .WriteLine ($"Recelived payload of {responseBodyAsText.Length} characters"™);} 
Console .WriteLine (); 
Console .WriteLine (responseBodyAsText).; 
} 
} 
} 


用 命令 行 参数 -s 执行 这 段 代码 ， 产 生 以 下 输出 : 


Response Status Code: 200 OF 

Received payload of 3379 characters 
<2XMm] version="1.0" encoding="utf-8"?> 
Tl = 


注意 : 
因为 HttpClient 类 使 用 GetAsync 方法 调用 ， 且 使 用 了 await 关键 字 ， 所 以 返回 调用 线程 ， 并 可 以 执行 其 他 


工作 。GetAsync 方法 的 结果 可 用 时 ， 就 用 该 方法 继续 线程 ， 响 应 写 入 response 变量 。await 关键 字 参 见 第 15 章 ， 
任务 的 创建 和 使 用 参见 第 21 章 . 


23.2.2 ” 抛 出 异常 

如 果 调 用 HttpClient 类 的 GetAsync 方法 失败 ， 默 认 情况 下 不 产生 异常 。 调 用 EnsureSuccessStatusCode 方法 和 
HttpResponseMessage， 很 容易 改变 这 一 点 。 该 方法 检查 IsSuccessStatusCode 是 否 是 包 lse， 否 则 就 抛 出 一 个 异 各 
(代码 文件 HttpClientSample/HttpClientSamples.cs): 

private async Task GetDataWithExceptionsAsyncl() 

{ 


tryY 


{ 
HttpResponseMessage response = await HttpClient.GetAsync (IncorrectUrl); 


response.EnsureSuccessstatusCode ().; 
ConsoleWriteLine ($"Response Status Code: {(int)response.StatusCode} ™ + 
s"{response.ReasonPhrase}™"); 

string responseBodyAsText = await response.Content.ReadAsStringAsync(); 
Console.WriteLine($"Recelved payload of {responseBodyAsText.Length} characters"™); 
Console .WriteLine{(); 
Console.WriteLine (responseBodyAsText),; 

} 

catch (Exception ex) 

{ 
Console .WriteLine ($"{ex.Message}").; 

} 

} 


23.2.3 ”传递 标题 

发 出 请 求 时 没有 设置 或 改变 任何 标题 ， 但 HttpClient 的 DefaultRequestHeaders 属性 允许 设置 或 改变 标题 。 
使 用 Add 方法 可 以 给 集合 添加 标题 。 设 置 标题 值 后 ， 标 题 和 标题 值 会 与 这 个 HttpClient 实例 发 送 的 每 个 请 求 一 
起 发 送 。 
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响应 内 容 默 认为 XML 格式 。 要 改变 它 , 可 以 在 请 求 中 添加 一 个 Accept 标题 , 以 使 用 JSON。 在 调用 GetAsync 
之 前 添加 如 下 人 代码， 内容 就 会 以 JSON 格式 返回 : 

client.DefaultRequestHeaders.Add ("Accept", "application/json;odata=verbose"™); 

添加 和 删除 标题 ， 运 行 示例 ， 会 以 XML 和 JSON 格式 显示 内 容 。 

从 DefaultHeaders 属性 返回 的 HttpRequestHeaders 对 象 有 许多 辅助 属性 ， 可 用 于 许多 标准 标题 。 可 以 从 这 
些 属性 中 读 取 标题 的 值 , 但 它们 是 只 读 的 。 要 设置 其 值 , 需要 使 用 Add 方法 ,在 代码 片段 中 , 添加 了 HTTP Accept 
标题 。 根 据 服务 器 接收 到 的 Accept 标题 ， 服 务 器 可 以 基于 客户 的 需求 返回 不 同 的 数据 格式 。 发 送 Accept 标题 
application/json 时 ， 客 户 就 通知 服务 器 ， 它 接受 JSON 格式 的 数据 。 标 题 信息 用 ShowHeaders 方法 显示 ， 从 服 
务 器 接收 啊 应 时 ， 也 调用 该 方法 (代码 文件 HttpClientSample/HttpClientSamples.cs): 


Public Task GetDataWithHeadersAsync() 


{ 
try 
{ 
HttpClient.DefaultRequestHeaders.Add ("Accept"., 
"application/json;odata=verbose"); 
showHeaders("Request Headers:", HttpClient.DefaultRequestHeaders).; 
HttpResponseMessage response = await client.GetAsync (NorthwindUrl); 
HttpClient.EnsureSuccessstatusCode (); 
ShowHeaders("Response Headers:", response.Headers); 
En 
} 
} 


与 上 一 个 示例 不 同 ， 添 加 了 ShowHeaders 方法 ， 它 把 一 个 HttpHeaders 对 象 作为 参数 。HttpHeaders 是 
HttpRequestHeaders 和 HttpResponseHeaders 的 基 类 。 这 两 个 特殊 化 的 类 都 添加 了 辅助 属性 ， 以 直接 访问 标题 。 
HttpHeader 对 象 定义 为 keyValuePair<string, IEnumerable<strine>>。 这 表示 每 个 标题 在 集合 中 都 可 以 有 多 个 值 。 
因此 ， 如 果 和 希望 改变 标题 中 的 值 ， 就 需要 删除 原 值 ， 添 加 新 值 。 

ShowHeaders 函数 很 简单 ， 它 人 迄 代 HttpHeaders 中 的 所 有 标题 。 枚 举 返 回 KeyValuePair<string, 
IEnumerable<strimng>> 元 素 ， 为 每 个 键 显 示 值 的 字符 串 版 本 : 


Public void ShowHeaders (string title, HttpHeaders headers) 
{ 

Console .WriteLine (title); 

foreach (var header in headers) 


{ 
string Value = string-.Join{(™" ", header.Value}); 
Console.WriteLine($"Header: {header.Key} Value: {value}"); 
} 
Console .WriteLine'().; 


} 
运行 这 段 代码 ， 就 显示 请 求 的 任何 标题 。 


Request Headers: 

Header: Accept Value: application/json; odata=verbose 

Response Headers: 

Header: Cache-Control Value: private 

Header: Date Value: Thu, 31 Aug 2017 09:58:09 GMT 

Header: Server Value: Microsoft-IIS/8.0 

Header: Set-Cookie Value: 
ARRAffinity=aSee71l7bl498daedb0l64e6el1l9089a5a78c47693a6 
D0e57422887d7e01lfble5e;Path=/; Domain=services.odata.org 

Header: Vary Value: 去 

Header: X-Content-Type-Options Value: nosniff 

Header: DataServiceVersion Value: 2-0; 

Header: X-AspNet-Version Value: 4.0.30319 

Header: X-Powered-ByY Value: ASP .NET 

Header: Access-Control-Allow-Origin Value: * 

Header: Access-Control-Allow—-Methods Value: GET 

Header: Access-Control-Allow—Headers Value: Accept, Origin, Content—Type, 
MaxDataServiceVersion 

Header: Access-Control-Expose-Headers Value: DataServiceVersion 


因为 现在 客户 端 请 求 JSON 数据 ， 服 务 器 返回 JSON， 也 可 以 看 到 这 些 信息 : 


Response Status Code: 200 oFK 
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Received payload of 1551 characters 
{"d":{"results":[{" metadata™:{"id":"http://services.odata.org/Northwind/ 


Northwind.sve/Regions (1) ™, "uri™: 


23.2.4 访问 内 容 


先前 的 代码 片段 展示 了 如 何 访问 Content 属性 , 获取 一 个 字符 串 。 啊 应 中 的 Content 属性 返回 一 个 HttpContent 
对 象 。 为 了 获得 HttpContent 对 象 中 的 数据 ， 需 要 使 用 所 提供 的 一 个 方法 。 在 例子 中 , 使 用 了 ReadAsStringAsync 
方法 。. 它 返回 内 容 的 字符 串 表 示 。 顾名思义 , 这 是 一 个 异步 调用 。 除了 使 用 async 关键 字 之 外 , 也 可 以 使 用 Result 
属性 。 调 用 Result 属性 会 阻塞 该 调用 ， 直 到 ReadAsStringAsynec 方法 执行 完毕 ， 然 后 继续 执行 下 面 的 代码 。 

其 他 从 HttpContent 对 象 中 获得 数据 的 方法 有 ReadAsByteArrayAsync( 返 回 数据 的 字 节 数组 ) 和 
ReadAsStreamAsync( 返 回 一 个 流 )。 也 可 以 使 用 LoadIntoBufferAsync 把 内 容 加 载 到 内 存 缓存 中 。 

Headers 属性 返回 HttpContentHeaders 对 象 。 它 的 工作 方式 与 前 面 例子 中 的 请 求 和 啊 应 标题 相同 。 


注意 : 

除了 使 用 HttpClient 和 HttpContent 类 的 GetAsync 和 ReadAsStringAsync 方法 之 外 ，HttpClient 类 还 提供 了 
方法 GetStringAsync， 来 返回 一 个 字符 串 ， 而 不 需要 调用 两 个 方法 。 然 而 使 用 这 个 方法 时 ， 对 错误 状态 和 其 他 
言 息 没 有 那么 多 的 控制 。 


注意 : 
流 参 见 第 22 章 。 


23.2.5 用 HttpMessageHandler 自 定义 请 求 


HttpClient 类 可 以 把 HttpMessageHandler 作为 其 构造 阔 数 的 参数 ， 这 样 就 可 以 定制 请 求 。 可 以 传递 
HttpClientHandler 的 实例 。 它 有 许多 属性 可 以 设置 ， 例 如 ClientCertificates 、 Pipelining 、 CachePolity 、 
ImpersonationLevel 等 。 

下 一 个 代码 片段 实例 化 SampleMessageHandler， 并 传递 给 HttpClient 构造 函数 (代码 文件 HttpClientSample/ 
HttpClientSamples.cs): 


private HttpClient httpcCclientWithMessageHandler; 
Public HttpClient HttpClientWithMessageHandler =»> 
httpclientWithMessageHandler ?2 ( httpClientWithMessageHandler = 
new HttpClient (new SampbleMessageHandler ("error™))); 


这 个 处 理 程序 类 型 SampleMessageHandler 的 作用 是 把 一 个 字符 串 作 为 参数 ， 在 控制 台 上 显示 它 ， 如 果 消 妃 
“error”， 就 把 啊 应 的 状态 人 码 设置 为 Bad Request。 如 果 创 建 一 个 派生 于 HttpClientHandler 的 类 ， 就 可 以 重 写 

一 些 属性 和 方法 SendAsync。SendAsync 通常 会 重 写 , 因为 发 送 到 服务 器 的 请 求 会 受 影响 。 如 果 displayMessage 
设置 为 “error”， 就 返回 一 个 HttpResponseMessage 和 错误 请 求 。 该 方法 需要 返回 一 个 Task。 对 于 错误 的 情况 ， 
不 需要 调用 异步 方法 ; 这 就 是 为 什么 只 是 用 TaskFromResult 返回 错误 (代码 文件 
HttpClientSample/SampleMessageHandler.cs): 

public class SampleMessageHandler : HttpclientHandler 

private string message; 


Public SampleMessageHandler (string message) 三 > 
message = message; 


protected override Task<HttpResponseMessage> SendasyYync 
HttpRequestMessage request, CancellationToken cancellationToken) 


Console.WriteLine(s"In SampleMessageHandler { message}"); 

if( message == "error"™") 

{ 
Var Iesponse = new HttpResponseMessage (HttpstatuscCode.BadReaquest); 
return Task.FromResult<HttpResponseMessage> (response);} 
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} 
return base.SendAsync (request, cancellationToken); 
} 
} 


添加 定制 处 理 程序 有 许多 理由 。 设 置 处 理 程序 管道 ， 是 为 了 添加 多 个 处 理 程 
序 。 除 了 默认 的 处 理 程序 之 外 ， 还 有 DelegatingHandler， 它 执行 一 些 代 码 ， 再 把 
调用 委托 给 内 部 的 处 理 程序 或 下 一 个 处 理 程序 。HttpClientHandler 是 最 后 一 个 处 : 
理 程序 , 它 把 请 求 发 送 到 地 址 。 图 23-1 显示 了 管道 .每 个 添加 的 DelegatingHandler 
都 调用 下 一 个 或 内 部 的 处 理 程序 , 最 后 一 个 是 基于 HttpClientHandler 的 处 理 程序 。 


SendAsync 


SendAsync 


23.2.6 ”使 用 SendAsync 创建 HttpRequestMessage 


在 后 台 ，HttpClient 类 的 GetAsync 方法 调用 SendAsync 方法 。 除 了 使 用 
GetAsync 方法 之 外 ， 还 可 以 使 用 SendAsync 方法 发 送 一 个 HTTP 请 求 。 使 用 


SendAsync， 可 以 对 定义 请 求 有 更 多 的 控制 。 重 载 HttpRequestMessage 类 的 构造 
函数 ,传递 HttpMethod 的 一 个 值 .GetAsync 方法 用 HttpMethod.Get 创建 一 个 HITP 
请 求 。 使 用 HttpMethod， 不 仅 可 以 发 送 GET、POST、PUT 和 DELETE 请 求 ， 也 


可 以 发 送 HEAD、OPTIONS 和 TRACE。 有 了 HttpRequestMessage 对 象 ， 可 以 用 
HttpClient 调用 SendAsync 方法 (代码 文件 HttpClientSample/HttpClientSamples.cs): 


private async Task GetDataAdvancedAsync() 

{ 
Var request = new HttpRequestMessage (HtteMethod.Get, NorthwindUrl).; - 
HttpResponseMessage response = await client.SendAsync (request).; 
a 图 23-1 


SendAsync 


} 


注意 : 

本 章 只 使 用 HttpClient 类 发 出 HITP GET 请 求 .HttpClient 类 还 允许 使 用 PostAsync、PutAsync 和 DeleteAsync 
方法 ， 发 送 HTTP POST、PUT 和 DELETE 请 求 。 这 些 方法 在 第 32 章 使 用 ， 发 出 这 些 请 求 ， 在 Web 服务 中 调 
用 相应 的 动作 方法 。 


创建 HttpRequestMessage 对 象 后 ， 可 以 使 用 Headers 和 Content 属性 提供 标题 和 内 容 。 使 用 Version 属性 ， 
可 以 指定 HTTP 版 本 。 


注意 : 

HTTP/1.0 在 1996 年 发 布 ， 几 年 后 发 布 了 1.1 版 本 。 在 1.0 版 本 中 ， 服 务 器 返回 数据 后 ， 连 接 总 是 关闭 ; 在 
1.1 版 本 中 , 增加 了 keep-alive 标题 ,允许 客户 端 根据 需要 保持 连接 打开 ， 因 为 客户 端 可 能 希望 发 出 更 多 的 请 求 ， 
不 仅 接 收 HTML 代码 ， 还 接收 CSS、JavaScript 文件 和 图 片 。1999 年 定义 了 HTTP/1.1 后 ， 过 了 16 年 ，HTTP/2 
才 在 2015 年 完成 。 版 本 2 有 什么 优点 ?HTTP/2 允许 在 相同 的 连接 上 发 出 多 个 并 发 请 求 ， 压 缩 标题 信息 ， 客 户 
机 可 以 定义 哪个 资源 更 重要 ， 服 务 器 可 以 通过 服务 器 推 操作 把 资源 发 送 到 客户 端 。HTTP/2 支持 服务 器 推送 ， 
意味 着 一 旦 HTTP/2 支持 无 处 不 在 ，WebSockets 就 会 过 时 。 所 有 浏览 器 的 新 版 本 ， 以 及 运行 在 Windows 10 和 
Windows Server 2016 上 的 JIS， 都 支持 HITP/2。 对 于 NET Core，( 在 撰写 本 文 时 )HTTP/2 计划 成 为 未 来 的 里 程 
碑 ; 参见 https://github.com/dotnet/corefx/issues/23134. 


23.2.7 使 用 HttpClient 和 Windows Runtime 


在 撰写 本 书 时 ， 用 于 控制 台 应 用 程序 和 WPF 的 HttpClient 类 不 支持 HITP/2。 然 而 ， 用 于 通用 Windows 平 
台 的 HttpClient 类 有 不 同 的 实现 ， 它 基于 Windows 10 API 的 功能 。 因 此 ，HttpClient 支持 HITP/2， 甚 至 在 默认 
情况 下 使 用 这 个 版 本 。 

下 一 个 代码 示例 显示 了 一 个 通用 Windows 应 用 程序 ， 它 辐 进 入 一 个 文本 框 的 链接 发 出 一 个 HTTP 请 求 , 并 
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显示 结果 ， 给 出 HTTP 版 本 信息 。 以 下 代码 片段 显示 了 XAML 代码 ， 图 23-2 显示 了 应 用 程序 的 用 户 界面 (代码 
文件 WinAppHttpClienUMainPage.xaml): 


<StackPanel Orientation="Horizontal™"> 
<TextBox Header="Url1l" Text="{XxX:Bind Url, Mode=TwoWay}™ MinWidth="200" 
Margin="5" /> 
<Button Content="Send™" Click="{X:Bind OnSsSendRequest}" Margin="10,5,5,5" 
VerticalAliqgnment="Bottom™ /> 
</SstackPanel> 
<TextBox Header="Version™. Text="{XxX:Bind Version, Mode=OneWay}™ Grid.Row="1" 
Margin="5" IsReadonly="True" /> 
<TextBox AcceptsReturn="True" IsReadoOnly="True™ 
Text="{X:Bind Result, Mode=OneWay}™ Grid.Row="2" 
SCIrollViewer.HorizontalSsScrollBarVisibility="Auto"™ 
ScrollViewer.VerticalSscrollBarvisibility="Auto"™" /> 


HTTP Chent 


Ln 


Version 


| 


23- 2 


注意 : 
XAML 代码 和 依赖 属性 参见 第 33 章 ， 编 译 后 的 绑 定 参见 第 34 章 。 


属性 Url、Version 和 Result 实现 为 依赖 属性 ， 以 目 动 更 新 UI。 下 面 的 代码 片段 显示 了 Url 属性 (代码 文件 
WinAppHttpClient/MainPage.xaml.cs): 


Public string Url 
{ 
Get => (string)GetValue (UrlProperty); 
Set => SetValue (UrlProperty, value); 
} 


Public static readonly DependencyProperty UrlProperty = 
DependencyProperty.Register ("Url", typeof (string), typeof (MainPage)., 
new PropertyMetadata (strlIng-Empty) ) ; 


HttpClient 类 用 于 OnSendRequest 方法 。 单 击 UI 中 的 Send 按钮 ,就 调用 该 方法 。 在 前 面 的 示例 中 ,SendAsync 
方法 用 于 发 出 HITP 请 求 。 为 了 看 到 请 求 确实 是 使 用 HTTP/2 版 本 发 出 的 ， 可 以 在 调试 器 中 检查 request.Version 
属性 。 服 务 器 给 出 的 版 本 是 来 自 response. Version， 并 写 入 在 UI 中 绑 定 的 Version 属性 。 如 今 ， 大 多 数 服 务 器 都 
只 支持 HTTP 1.1 版 本 。 如 前 所 述 ，Windows Server 2016 文 持 HTTP/2: 


private async void DnSenadReduest {() 
{ 
try 
{ 
using (war client = new HttpClient(})) 
{ 
Var regquest = new HttpRequestMessage (HttepMethod.Get, Url).; 
HttpResponseMessage response = AWwait client.SendAsync(lrequest).; 
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Version = response.Version.ToString().; 
response.EnsureSuccessstatusCode ().; 
Result = await response.Content.ReadhsSstringhsync(}); 
} 
} 


catch (Exception ex) 
awalIt new MessageDialog (ex.Message) .ShowAsync ();} 
} 
运行 该 应 用 程序 ， 向 https://http2.akamai.conydemo 发 出 请 求 ， 就 返回 HTTP/2。 


23.3 ”使 用 WebListener 类 


使 用 IIS(Internet Information Service， 互 联网 信息 服务 ) 作 为 HTTP 服务 器 通常 是 一 个 好 方法 , 因为 可 以 访问 
很 多 功能 ， 如 可 伸缩 性 、 健 康 监测 、 用 于 管理 的 图 形 用 户 界 面 等 。 然 而 ， 也 可 以 轻松 创建 目 己 的 简单 HITP 服 
务 器 。 自 .NET Framework 2.0 以 来 ， 就 可 以 使 用 HttpListener， 但 是 现在 自从 .NET Core 1.0 以 来 ， 有 一 个 新 的 
WebListener 类 。 

HttpServer 的 示例 代码 使 用 了 以 下 依赖 项 和 名 称 空间 : 

依赖 项 

Microsott. Net.Http.Server 
名 称 空间 

Microsott. Net.Http.Server 
System 
System.Collections.Generic 
System.Ling 

System.Net 
System.Retlection 
System. Text 
System.Threading.Tasks 

HTTP 服务 器 的 示例 代码 是 一 个 控制 台 应 用 程序 ( 包 )， 人 允许 传递 一 个 URL 前 组 的 列表 ， 来 定义 服务 器 侦 听 
的 地 点 。 这 类 前 缀 的 一 个 例子 是 http://localhost:8082/samples， 其 中 如 果 路 径 以 samples 开头 ， 服 务 器 就 只 侦 听 
本 地 主机 上 的 端口 8082。 不 管 其 后 的 路 径 是 什么 ， 服 务 器 都 处 理 请 求 。 不 仅 支 持 来 目 本 地 主机 的 请 求 ， 还 可 以 
使 用 + 字符 ， 比 如 http:/ 汪 :8082/samples。 这 样 ， 服 务 器 也 可 以 从 所 有 的 主机 名 中 访问 。 如 果 不 以 提升 模式 局 动 
Visual Studio， 运 行 侦 听 器 的 用 户 就 需要 许可 。 为 此 ， 可 以 以 提升 模式 运行 一 个 命令 提示 符 ， 使 用 如 下 netsh 命 
令 来 添加 URL: 

>netsh http add Urlacl url=http://+:8082/samples user=Everyone 

示例 代码 检查 参数 是 否 传 递 了 至 少 一 个 前 弘 ， 之 后 调用 StartServer 方法 (代码 文件 HttpServer/Program.cs): 

static async Task Main(string[] args) 

| if (args.Length < 1) 


ShowUsage (}; 

return; 
} 
awalit StartServerAsync (args); 
Console.ReadLine(}); 


} 


private static void ShowUsage () 
{ 
Console .WriteLine ("Usage: HttpServer Prefix [Prefix2] [Prefix3] [Prefijx4] "); 


} 
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该 程序 的 核心 是 StartServer 方法 。 这 里 实例 化 WebListener 类 ， 添 加 在 命令 参数 列表 中 定义 的 前 组 。 调 用 
WebListener 类 的 Start 方法 ， 注 册 系 统 上 的 痛 口 。 接 下 来 ， 调 用 GetContextAsync 方法 后 ， 侦 听 器 等 待 客户 咒 连 
接 和 发 送 数据 。 一 旦 客户 端 及 送 HTTP 请求， 请 求 就 可 以 读 取 GetContextAsync 返回 的 HttpContext 对 象 。 
对 于 来 自 客户 端的 请 求 和 发 回 的 回应 ， 都 使 用 HttpContext 对 象 。Request 属性 返回 一 个 Request 对 象 。Request 
对 象 包含 HTTP 标题 信息 。 在 HTTP POST 请 求 中 ，Request 还 包含 请 求 体 。Response 属性 返回 Response 对 象 ， 
它 允 许 返 回 标题 信息 (使 用 Headers 属性 )、 状 态 码 (StatusCode 属性 ) 和 啊 应 体 (Body 属性 ): 


Public static async Task StartServerAsync (params string[] prefixes) 
{ 
try 
{ 
Console.WriteLine($"server starting at™); 
var listener = new WebListener().; 
foreach (var prefix in prefixes) 
{ 
listener.UrlPrefixes.Add (prefix).; 
Console .WriteLine ($"™\t{prefix}").; 
} 
listener.Start().: 
do 
{ 
using (RequestContext context = await listener.GetContextAsync()) 
{ 
conterxt .Response.Headers.hdd{(t"content—type”™, 
new string[] { "text/html™ }); 
context.Response.StatusCode = (int}HttpStatusCode .OK; 
byte[] buffer = GetHtmlContent (context.Request); 
await context.Response.Body .Writeasvne (buffer, 0, buffer.Length).; 


} while (七 YUE) ; 
} 
catch (Exception ex) 
{ 
Console.WriteLine (ex.Message); 
} 
} 


示例 代码 返回 一 个 HIML 文件 ， 使 用 GetHtmlContent 方法 检索 它 。 这 个 方法 利用 htmlFormat 格式 字符 串 ， 
该 字符 串 在 标题 和 正文 中 有 两 个 占 位 符 。GetHtmlContent 方法 使 用 string.Format 方法 填充 占 位 符 。 为 了 填充 
HTML 体 ， 使 用 两 个 辅助 方法 GetHeaderInfo 和 GetRequesthfo， 检 索 请 求 的 标题 信息 和 Request 对 象 的 所 有 属 
性 值 : 


private static string htmlFormat = 
"IDOCTYPE html><html><head><title>{0}</title></head>"™ + 
"<body>{1}</body></html>"; 


private static byte[] GetHtmlContent (Request request) 

{ 
string title = "Sample WebListener™,; 
Var sb = new StringBuilder ("<hl>Hello from the server</hl>"); 
sb.Append ("<h2>Header Info</h2>"); 
sb.Append(string.Join(™" ", GetHeaderIinfo (request.Headers}))})); 
sb.Append ("<h2>Request Object Information</h2>"); 
sb.Append (string.Join{(™." ", GetRequestInfo(request)))}).; 
string html = string.Format (htmlFormat, title, sb.ToString(})); 
return Encoding .UTF8.GetBytes (html) ，; 

} 


GetHeaderInfo 方法 从 HeaderCollection 中 检索 键 和 值 ， 返 回 一 个 div 元 素 ， 其 中 包含 了 每 个 键 


private static IEnumerable<string> GetHeaderIinfo (HeaderCcollection headers) 三 > 
headers.Keys.Select (key 三 > 
s"<div>{key}: {string.Join(",", headers.GetVvalues (key)) }</div>"),， 


GetRequestInfo 方法 利用 反射 获得 Request 类 型 的 所 有 属性 ， 返 回 属性 名 称 及 其 值 : 


private static IEnumerable<string> GetRequestInfo (Request request) 三 > 
request.GetType () .GetProperties() -Select 
p => $"<div>{p.Name}: {p.GetValue (request}) }</div>"); 
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注意 : 
GetHeaderInfo 和 GetRequestInfo 方法 利用 表达 式 体 的 成 员 函 数 、LINQ 和 反射 。 表 达 式 体 的 成 员 函 数 参 见 
第 3 章 。 第 12 章 讨 论 了 LINQ。 第 16 章 把 反射 作为 一 个 重要 的 话题 。 


运行 服务 器 , 使 用 Google Chrome 等 浏览 器 ,通过 URL 访问 服务 器 , 如 http://[hostname]:8082/samples/Hello?sample=text, 
结果 输出 如 图 23-3 所 示 。 


注意 : 

要 从 Edge 浏览 器 访问 localhost, 需要 启用 localhost 回溯 , 这 可 以 通过 aboutflags 实现 。 在 某 些 Windows 10 
构建 版 本 中 ， 如 果 启 用 了 localhost 回 滴 ， 就 会 出 现 从 Edge 浏览 器 事件 中 访问 localhost 的 问题 。 在 这 种 情况 下 ， 
应 使 用 其 他 浏览 器 ， 如 Internet Explorer。 


[| Sample WebListener A 


| 二 GG | ©@ localhost:8082/samples/Hello?rsample=text 罕 | : 


Hello from the server 


Header Info 


| Bccept: text/html.application'xhtml+xml application'xml:g=0.9.1magewebp.image /apng.*/™*:0=0.9 
Accept-Encoding: gzip,deflate,br 
Accept-Language: en-US,engq=0.8 
| Connection: keep-alive 
Host: localhost:&082 
User-Agent: Mozillas 0 (Windows NT 10.0: Win6d: x64) AppleWebRit 37.36 (EHTINML like Gecko) Chrome 0.0.3112.113 Safarys37.36 
Upsrade-Insecure-Requests: ] 


| Request Object Information 


Connectionld: -144113182170275838 
| QueryString: ?sample=text 
ContentLength: 
| Headers: Microsoft. Net Http. Server. HeaderCollection 
| Method: GET 
| Body: System.IQ. Stream- NullStream 
| PathBase: ,samples 
Path: 'Hello 
IsHttps: False 
Rawtlrl: /samples Hello sample=text 
ProtocolVersion: 1.1 
HasEntitvBody: False 
| RemotelpAddress: ::1 
| LocallpAddress: ::1 
| RemotePort: 2812 
| LecalPort: S082 
Scheme: htip 
Content lype: 


23-3 


23.4 ”使 用 实用 工具 类 


在 使 用 抽象 HTTP 协议 的 类 ， 如 HttpClient 和 WebListener， 处 理 HTTP 请 求 和 响应 后 ， 下 面 看 看 一 些 实用 
工具 类 ， 它 们 在 处 理 URI 和 J 了 IP 地址 时 ， 更 容易 进行 Web 编程 。 

在 Internet 上 ， 服务 器 和 客户 端 都 由 人 P 地 址 或 主机 名 (也 称 作 DNS 和 名称) 标识。 通常， 主机 名 是 在 Web 浏 览 器 的 
窗口 中 输入 的 友好 名 称 ， 如 www.wrox.com 或 www.cninnovation.com 等 。 男 一 方面 ，IP 地 址 是 计算 机 用 于 互相 识 
别 的 标识 从 ， 它 实际 上 是 用 于 确保 Web 请 求 和 啊 应 到 达 相 应 计算 机 的 地 址 。 一 台 计 算 机 甚至 可 以 有 多 个 他 地 址 。 

目前 , IP 地址 一 般 是 一 个 32 位 或 128 位 的 值 ， 这 取决 于 使 用 的 是 IPv4 还 是 IPv6。 例如 192.168.1.100 就 是 
一 个 32 位 的 下 地 址 ,目前 有 许多 计算 机 和 其 他 设备 在 苋 争 Internet 上 的 一 个 地 点 ， 所 以 人 们 开发 了 IPv6。IPv6 
至 多 可 以 提供 3X10”3 个 不 同 的 地 址 。.NET 允许 应 用 程序 同时 使 用 IPv4 和 IPv6。 

为 了 使 这 些 主 机 名 发 挥 作用 ， 首 先 必须 发 送 一 个 网 络 请 求 ， 把 主机 名 翻译 成 IP 地 址 ， 翻 译 工作 由 一 个 或 几 
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个 DNS 服务 器 完成 。DNS 服务 器 中 保存 的 一 个 表 把 主机 名 映射 为 它 知 道 的 所 有 计算 机 的 他 地 址 以 及 其 他 DNS 
服务 器 的 卫 地 址 ， 这 些 DNS 服务 器 用 于 在 该 表 中 查找 它 不 知道 的 主机 名 。 本 地 计算 机 至 少 要 知道 一 个 DNS 
服务 器 。 网 络 管理 员 在 设置 计算 机 时 配置 该 信息 。 
在 发 送 请 求 之 前 ,计算 机 首先 应 要 求 DNS 服务 器 指出 与 输入 的 主机 名 相对 应 的 全 地址 。 找到 正确 的 下 地 
址 后 ， 计 算 机 就 可 以 定位 请 求 ， 并 通过 网 络 发 送 它 。 所 有 这 些 工 作 一 般 都 在 用 户 浏 览 Web 时 在 后 台 进 行 。 
.NET Framewolk 提供 了 许多 能 够 帮助 寻找 PP 地 址 和 主机 信息 的 类 。 
示例 代码 使 用 了 以 下 名 称 空间 : 
System 
System.Net 


23.4.1 URI 


Uri 和 UriBuilder 是 System 名 称 空间 中 的 两 个 类 , 它们 都 用 于 表示 URI。Uri 类 允许 分 析 、 组 合 和 比较 URI。 
而 UriBuilder 类 允许 把 给 定 的 字符 串 当 作 URI 的 组 成 部 分 ， 从 而 构建 一 个 URI。 

下 面 的 代码 片段 演示 了 Uri 类 的 特性 。 构 造 函 数 可 以 传递 相对 和 绝对 URL。 这 个 类 定义 了 几 个 只 读 属性 ， 
来 访问 URL 的 各 个 部 分 ， 例 如 模式 、 主 机 名 、 端 口号 、 查 询 字 符 串 和 “URL 的 各 个 部 分 (代码 文件 
Utilities/Proeram.cs): 


public static void UriSsSample (string url) 
{ 
Var Page = new Uri (url).; 
Console.WriteLine($"scheme: {page.Scheme}").; 
Console.WriteLine ($"host: {page.Host}, type: {page.HostNameType}, ™ 十 
s"idn host: {page.IdnHost}").; 
Console.WriteLine ($"port: {page.Port}").; 
Console.WriteLine($"path: {page.AbsolutePath}").; 
Console.WriteLine ($"query: {page.Query}"); 


foreach (var segment in page.Segments) 
{ 
Console.WriteLine($"segment: {segment}"); 
} 
天 
} 


运行 应 用 程序 ， 传 递 下 面 的 URL 和 包含 一 个 路 径 和 查询 字符 串 的 字符 串 : http://wwwamazon.com/ 
Professional-C-6-0-Christian-Nagel/dp/111909660X/ref=sr 1 4?1e=UTF8&q1id=1438459506&sI=8-4&keywords= 
protessionaltc%23+6。 

将 得 到 下 面 的 输出 : 


scheme: http 

host: www.amazon.com, type: Dns, idn host: www.amazon.com 

port: 80 

path: /Professional-c-6-0-Christian-—Nagel/dp/111909660X/ref=sr 1 4 
Query: ?lie=UTF8&9q1id=1438459506&sr=8-4gkeywords=professlionalt+c%®23+6 
segment: / 

segment: Professional-C-6-0-Cchristian-Nagel/ 

segment: dp/ 

segment: 111909660X/ 

segment: ref=sr 1 4 


与 Uri 类 不 同 ，UriBuilder 定义 了 读 - 写 属性 ， 如 下 面 的 代码 片段 所 示 。 可 以 创建 一 个 UriBuilder 实例 ， 指 
定 这 些 属性 ， 并 得 到 一 个 从 Uri 属性 返回 的 URL: 


Public static void UriSample (string url) 
{ 
ff -。。 
var builder = new UriBuilder().; 
builder.Host = "WWWw .cninnovation.com"; 
builder.Port = 80.; 
builder.Path = "training/MVC".; 
Uri uri = builder .Uri.; 
Console .WriteLine (uri).; 
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除了 使 用 UriBuilder 的 属性 之 外 ， 这 个 类 还 提供 了 构造 函数 的 几 个 重 载 版 本 ,其 中 也 可 以 传递 URL 的 各 个 
部 分 。 


234.2 |PAddress 


IPAddress 类 代表 瑟 地 址 。 使 用 GetAddressBytes 属性 可 以 把 地 址 本 身 作 为 字 节 数组 ， 并 使 用 ToString0 方 法 转换 
为 用 小 数 点 隔 开 的 十 进 制 格式 。 此 外 ，IPAddress 类 也 实现 静态 的 Parse0 和 TryParse 方法 ， 这 两 个 方法 的 作用 与 
ToStming0 方 法 正好 相反 ， 把 小 数 点 隔 开 的 十 进 制 字符 串 转换 为 PAddress。 代 码 示例 也 访问 AddressFamily 属性 ， 并 
将 一 个 IPv4 地 址 转换 成 Pv6， 反 之 亦 然 (代码 文件 Utilities/Program.cs): 


Public static void IPAddressSample (string ipAddressSstring) 
{ 
IFAddress address; 
if (IIPAddress.TryParse (liphAddressString, out address)) 
{ 
Console.WriteLine($"cannot parse {ipAddressstring}"); 
returns 
} 
byte[] bytes = address .GetAddressBytes(}).; 
for (nt i = 0; i < bytes.Length; i++) 
{ 
Console.WriteLine($"byte {1}: {bytes[i] :XxX}"); 
} 
Console.WriteLine($"family: {address.AddressFamily}, ™ + 
$s"map to ipveé: {address.MapToIPv6()}, map to ipvi: {address .MapToIPvA()}"); 
I 


给 方法 传递 地 址 65.52.128.33， 输 出 结果 如 下 : 

byte V0: 41 

byte 1: 34 

byte 2: 80 

byte 3: 21 

family: InterNetwork, map to ipveé: ::ffff:65.52.128.33, map to ipv4: 65.52.128.3 


3 


IPAddress 类 也 定义 了 议 态 属性 ， 来 创建 特殊 的 地 址 ， 如 loopback、broadcast 和 anycast: 


public static void IPAddressSample (string ipAddressSstring) 
{ 


Console .WriteLine($"IPvy4 loopback address: {IPAddress.Loopback}"); 
Console .WriteLine($"IPv6 loopback address: {IPAddress.IPv6éLoopback}"); 
Console .WriteLine ($"IPvi4 broadcast address: {IPAddress.Broadcast}"); 
Console.WriteLine($"IPv4 any address: {IPAddress.Bny}"); 
Console.WriteLine($"IPv6é any address: {IPFAddress.IPvéAny}"); 

} 


通过 loopback 地 址 ， 可 以 绕 过 网 络 硬 件 。 这 个 人 P 地 址 代表 主机 名 localhost。 

每 个 broadcast 地 址 都 在 本 地 网 络 中 寻 址 每 个 节点 。 这 类 地 址 不 能 用 于 IPv6, 因为 这 个 概念 不 用 于 互联 网 协 
议 的 更 新 版 本 。 最 初 定 义 PPv4 后 ， 给 IPv6 添加 了 多 播 。 通 过 多 播 ， 寻 址 一 组 节点 ， 而 不 是 所 有 节点 。 在 IPV6 
中 ， 多 播 完全 取代 广播 。 本 章 后 面 使 用 UDP 时 ， 会 在 代码 示例 中 演示 广播 和 多 播 。 

通过 anycast,， 也 使 用 一 对 多 路 由 , 但 数据 流 只 传送 到 网 络 上 最 近 的 节点 。 这 对 负载 平衡 很 用。 对 于 IPv4， 
Border Gateway Protocol (BGP) 路 由 协议 用 来 上 友 现 网 络 中 的 最 短路 径 ; 对 于 了 Pv6， 这 个 功能 是 内 置 的 。 

运行 应 用 程序 时 ， 可 以 看 到 下 面 的 了 Pv4 和 IPv6 地 址 : 

IPv4 loopback address: 127.0.0.1 

IPv6 loopback address: ::1 

IPv4 broadcast address: 255.255.255.255 


IEV4d any address: 0.0.0.0 
IPve any address: :: 


23.4.3 1IPHostEntry 


IPHostEntry 类 封装 与 某 台 特定 的 主机 相关 的 信息 。 通 过 这 个 类 的 HostName 属性 (这 个 属性 返回 一 个 字符 
串 )， 可 以 使 用 主机 名 ; 通过 AddressList 属性 返回 一 个 IPAddress 对 象 数 组 。 下 一 个 示例 使 用 IPHostEntry 类 。 


23.4.4 
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Dns 


Dns 类 能 够 与 默认 的 DNS 服务 器 进行 通信 ， 以 检索 卫 地 址 。 
DnsLookup 示例 代码 使 用 了 以 下 名 称 空间 : 


System 
System.Net 
System.Threadine.Tasks 
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样 例 应 用 程序 实现 为 一 个 控制 台 应 用 程序 ( 包 )， 要 求 用 户 输入 主机 名 (也 可 以 添加 一 个 卫 地 址 )， 通 过 
Dns.GetHostEntryAsync 得 到 一 个 IPHostEntry。 在 IPHostEntry 中 ， 使 用 AddressList 属性 访问 地 址 列表 。 主 机 的 
所 有 地 址 以 及 AddressFamily 都 写 入 控制 台 ( 代 码 文件 DnsLookup/Program.cs): 


static void Maint{) 


t 


do 


{ 


} 
} 


Console.Write ("Hostname: \t"); 
string hostname = ReadLine (); 


if (hostname.CompareTo("exit") == 0) 
{ 

Console .WriteLine ("bye!™),; 

returns 
} 


OnLookupAsync (hostname) .Wait ()，} 
Console.WriteLine(); 
while (true); 


public static async Task OnLookupAsync (string hostname) 


| 


try 


{ 


} 


IPHostEntry ipHost = await Dns.GetHostEntryAsync (hostname); 
Console.WriteLine($"Hostname: {ipHost.HostName}"); 
foreach (IPAadadress address in ipHost.AddressList) 
{ 
Console .WriteLine ($"Address Family: {address.AMddressFamily}"); 
Console .WriteLine (S$"Address: {address}"); 


} 


catch (Exception ex) 


{ 


} 
} 


Console.WriteLine (ex.Message),; 


运行 应 用 程序 ， 并 输入 几 个 主机 名 ， 得 到 如 下 输出 。 对 于 主机 名 www.orf.at， 可 以 看 到 这 个 主机 名 定义 了 
多 个 下 地址 。 


Hostname: WWW . cninnovation .com 
Hostname: www.cninnovation .com 
Address Family: InterNetwork 
Address: 65.52.128.33 
Hostname: Www.orf.at 

Hostname: Www.orf.at 


Lddress 


Lddress: 


Address 


Lddress: 


Lddress 


Lddress: 


Lddress 


Address: 


Lddress 


Lddress: 


Lddress 


Address: 


Family: InterNetwork 
194.232.104.150 
Famlly: InterNetwork 
194.232.104.139 
Family: InterNetwork 
194.232.104.140 
Famlly: InterNetwork 
194.232.104.142 
Family: InterNetwork 
194.232.104.141 
Famlly: InterNetwork 
194.232.104.149 


Hostname: exlit 


bye! 
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注意 : 

Dns 类 是 比较 有 限 的 ， 例 如 不 能 指定 使 用 非 默认 的 DNS 服务 器 。 此 外 ，IPHostEntry 的 Aliases 属性 不 在 
GetHostEntryAsync 方法 中 填充 。 它 只 在 Dns 类 的 过 时 方法 中 填充 ,而且 这 些 方法 也 不 完全 地 填充 这 个 属性 。 要 
充分 利用 DNS 查找 功能 ， 最 好 使 用 第 三 方 库 。 


下 面 介 绍 一 些 低 级 协议 ， 如 TCP 和 UDP 等 。 


23.5 ”使 用 TCP 


HTTP 协议 基于 传输 控制 协议 (Transmission Control Protocol，TCP)。 要 使 用 TCP， 客 户 端 首先 需要 打开 一 
个 到 服务 器 的 连接 ， 才 能 发 送 命令 。 而 使 用 HITP， 发 送 文本 命令 。HttpClient 和 WebListener 类 隐藏 了 HTTP 
协议 的 细节 。 使 用 TCP 类 发 送 HTTP 请 求 时 ， 需 要 更 多 地 了 解 HITP 协议 。TCP 类 没有 提供 用 于 HTTP 协议 的 
功能 ， 必 须 上 自己 提供 。 另 一 方面 ，TCP 类 提供 了 更 多 的 灵活 性 ， 因 为 可 以 使 用 这 些 类 与 基于 TCP 的 其 他 协议 。 

传输 控制 协议 (TCP) 类 为 连接 和 发 送 两 个 端点 之 间 的 数据 提供 了 简单 的 方法 。 问 点 是 卫 地 址 和 端口 号 的 组 
合 。 已 有 的 协议 很 好 地 定义 了 端口 号 ， 例 如 ，HTTP 使 用 端口 80， 而 SMTP 使 用 端口 23。Intermet 地 址 编码 分 
配 机 构 (Internet Assigned Numbers Authority，ILANA，http://www.iana.org/) 把 端口 号 赋予 这 些 已 知 的 服务 。 除 非 实 
现 茶 个 已 知 的 服务 ， 否 则 应 选择 大 于 1024 的 问 口 号 。 

TCP 流量 构成 了 目前 Intemet 上 的 主要 流量 。TCP 通常 是 首选 的 协议 ， 因 为 它 提 供 了 有 保证 的 传输 、 错 误 
校正 和 缓冲 。TcpClient 类 封装 了 TCP 连接 ， 提 供 了 许多 属性 来 控制 连接 ， 包 括 缓冲 、 缓 冲 区 的 大 小 和 超时 。 
通过 GetStream0 方 法 请 求 NetworkStream 对 象 可 以 实现 读 写 功能 。 

TcpListener 类 用 Start0 方 法 侦 听 引入 的 TCP 连接 。 当 连接 请 求 到 达 时 ， 可 以 使 用 AcceptSocket0 方 法 返回 
一 个 套 接 字 ， 与 远程 计算 机 通信 ， 或 使 用 AcceptTcpClient0 方 法 通过 高 层 的 TcpClient 对 象 进行 通信 。 曾 明 
TcpListener 类 和 TcpClient 类 如 何 协同 工作 的 最 简单 方式 是 给 出 一 个 示例 。 


23.5.1 使 用 TCP 创建 HTTP 客户 程序 


首先 ， 创 建 一 个 控制 台 应 用 程序 ( 包 )， 同 Web 服务 器 发 送 一 个 HTTP 请 求 。 以 前 用 HttpClient 类 实现 了 这 
个 功能 ， 但 使 用 TepClient 类 需要 深入 HITP 协议 。 
HttpClientUsingTcp 示例 代码 使 用 了 以 下 名 称 空间 : 
System 
System.IO 
System.Net.Sockets 
System. [ext 
System.Threading.Tasks 
应 用 程序 接受 一 个 命令 行 参数 ， 传 递 服务 器 的 名 称 。 这 样 ， 就 调用 RequestHtmlAsync 方法 ， 同 服务 器 发 出 
HTTP 请 求 。 它 用 Task 的 Result 属性 返回 一 个 字符 串 (代码 文件 HttpClientUsingTcp/Program.cs): 
static void Main(string[] args) 
if (args-Length != 1) 
ShowUsage () ; 
Task<string> tl = RequestHtmlAsync (args[0]1); 
Console .WriteLine (tl1.Result); 


Console.ReadLine (); 


} 
private static void ShowUsage () 


Console.WriteLine ("Usage: HttpClientUsingTcp hostname™); 
} 
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现在 看 看 RequestHtmlAsync 方法 的 最 重要 部 分 。 首 先 , 实例 化 一 个 TcpClient 对 象 .其 次 ,使 用 ConnectAsync 
方法 ， 在 HITP 默认 端口 80 上 建立 到 主机 的 TCP 连接 。 再 次 ， 通 过 GetStream 方法 检索 一 个 流 ， 使 用 这 个 连 
接 进 行 读 写 : 
private const int ReadBufferSize = 1024; 
Public static async Task<string> RequestHtmlAsync (string hostname) 
{ 
try 
{ 


Using (var client = new TocpClient(})) 


await client.ConnectAsync (hostname, 80); 
NetworkStream stream = client.GetSstreaml(); 
fp 


} 
} 
} 


流 现在 可 以 用 来 把 请 求 写 到 服务 器 ， 读 取 响 应 。HTTP 是 一 种 基于 文本 的 协议 ， 所 以 很 容易 在 字符 串 中 定 
义 请 求 。 为 了 同 服 务 器 发 出 一 个 简单 的 请 求 ， 标 题 定义 了 HTTP 方法 GET， 其 后 是 URL/ 的 路 笃 和 HTTP 版 本 
HTTP/1.1。 第 二 行 定 义 了 Host 标题 、 主 机 名 和 疹 口 号 ， 第 三 行 定 义 了 Connection 标题 。 通 浓 ， 通 过 Connection 
标题 ， 客 户 端 请 求 keep-alive， 要 求 服 务 器 保持 连接 打开 ， 因 为 客户 端 希 望 太 出 更 多 的 请 求 。 这 里 只 问 服 务 器 上 
出 一 个 请 求 ， 所 以 服务 器 应 该 关闭 连接 ， 从 而 close 设置 为 Connection 标题 。 为 了 绪 束 标题 信息 ， 需 要 使 用 rm 
给 请 求 添加 一 个 空 行 。 标 题 信 息 调 用 NetworkStream 的 方法 WriteAsync， 用 UTF-8 编码 发 送 。\rn 为 了 立即 加 
服务 器 发 送 缓存 ， 请 调用 FlushAsynec 方法 。 否 则 数据 就 可 能 保存 在 本 地 缓存 : 

ee header = "GET/HTTP/1.1\r\n™ + 

$s$"Host: {hostname} :80\r\n"™ + 

"Connection: close\r\n” + 

"ATAn" 7 

byte[] buffer = Encoding-UTEF8.GetBYtLes (header); 

await stream.WriteAsync (buffer, 0, buffer.Length); 

await stream.FlushAsvync(); 

现在 可 以 继续 这 个 过 程 ， 从 服务 器 中 读 取 回应 。 不 知道 回应 有 多 大 ， 所 以 创建 一 个 动态 生长 的 MemoryStream。 
使 用 ReadAsync 方法 把 服务 器 的 回应 暂时 写 入 一 个 字 节 数组 ， 这 个 字 节 数组 的 内 容 添加 到 MemoryStream 中 。 
从 服务 器 中 读 取 所 有 数据 后 ，StreamReader 接管 控制 ， 把 数据 从 流 读 入 一 个 字符 串 ， 并 返回 给 调用 者 : 


Var ms = new MemorySstream(); 


buffer = new byte[ReadBufferSizel]; 
int read = 0-; 

do 

{ 


read = await stream.Readhsync (buffer, 0, ReadBufferSsize).; 
ms .Write (buffer, 0, read); 
Array.Clear (buffer, 0, buffer.Length); 

} while (read > D) ; 

ms .Seek (0, SeekOrigin.Begin); 

Var Ieader = new StreamReader (ms)s; 

return reader.ReadToEnd().; 


} 
Fo 

把 一 个 网 站 传递 给 程序 ， 会 看 到 一 个 成 功 的 请 求 ， 其 HIML 内 容 显示 在 控制 台 上 。 
现在 该 创建 一 个 TCP 侦 听 器 和 目 定义 协议 了 。 


23.5.2 创建 TCP 侦 听 器 


创建 基于 TCP 的 目 定 义 协 议 需要 对 架构 进行 一 些 思考 。 可 以 定义 目 己 的 二 进 制 协议 , 每 个 位 都 保存 在 数据 
传输 中 ， 但 读 取 比 较 复 杂 ， 或 者 可 以 使 用 基于 文本 的 格式 ， 例 如 HTTP 或 FTP。 对 于 每 个 请 求 ， 会 话 应 保持 开 
放 还 是 关闭 ? 服务 器 需要 保持 客 己 端的 状态 ， 还 是 保存 随 每 个 请 求 一 起 发 送 的 所 有 数据 ? 

目 定 义 服 务 器 支持 一 些 简 单 的 功能 ， 如 回应 和 反 回 发 送 消 息 。 目 定义 服务 器 的 另 一 个 特点 是 ， 客 户 端 可 以 
发 送 状 态 信息 ， 使 用 另 一 个 调用 再 次 检索 它 。 状 态 会 临时 存储 在 会 话 状 态 中 。 尽 管 这 是 一 个 简单 的 场景 ， 但 我 
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们 知道 需要 设置 它 。 

TcpServer 示例 代码 实现 为 一 个 控制 台 应 用 程序 (NET Core)， 利 用 以 下 名 称 空间 : 
System 
System.Collections 
System.Collections.Concurrent 
System.Linq 
System.Net.Sockets 
System. lext 
System.Threading 
System.Threading.Tasks 
static TcpServer.CustomProtocol 

自 定义 TCP 侦 听 器 支持 几 个 请 求 ， 如 表 23-1 所 示 。 


表 23-1 


请 求 说 明 
启动 连接 后 ， 这 个 命令 需要 发 送 。 其 他 命令 将 不 被 接受 
ECHO 命令 向 调用 者 返回 消息 


REV 命令 保留 消息 并 返回 给 调用 者 


HEFLO::v1.0 
ECHO::message 


REV::message 


BYE BYE 命令 关闭 连接 
SET::key=value SET 命令 设置 服务 器 端 状 态 ， 可 以 用 GET 命令 检索 
GET::key 


请 求 的 第 一 行 是 一 个 会 话 标 识 符 ， 并 带 有 前 缀 用。 它 需 要 与 每 个 请 求 
作为 状态 标识 符 使 用 。 
协议 的 所 有 常量 都 在 静态 类 CustomProtocol 中 定义 (代码 文件 TcpServer /CustomProtocol.cs): 


public static class CustomProtocol 
{ 


起 发 送 ， 除了 HELO 请 求 之 外 。 它 


} 


public 
public 
public 
public 
public 
public 
Public 
public 
public 
public 
public 
public 
public 
public 
public 


CONSt 
Const 
CONnst 
CONnst 
CONnSst 
CONSt 
CONnst 
CONnst 
CONnst 
CONSt 
CoOnNnst 
CONnst 
COoOnNnst 
CONnst 


string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 


SESSIONID = “ID™; 


COMMAMDHELO 
COMMANDECHO 
COMMANDREYV 
COMMANDBYE 
COMMANDSET 
COMMANDGET 
STATUSOR = 
STATUSCLOSED 
STATUSINVALID 
STATUSUNENOWN 


STATUSTIMEOUT 


SEPARATOR = ™:: 
static readonly TimeSspan SessionTimeout 


"HELO"; 


"CLOSED™; 


= "INV"; 
= "UNK"; 
STATUSNOTFOUND = "NOTFOUND"; 


= "TIMOUT™; 


Wh = 
F 


TimeSpan.FromMinutes (21) ， 


Run0) 方 法 (从 Main0 方 法 中 调用 ) 启 动 一 个 计时 器 ,每 分 钟 清理 一 次 所 有 的 会 话 状态 。Run0 方 法 的 主要 功能 
是 通过 调用 RunServerAsync0 方 法 来 启动 服务 器 (代码 文件 TcpServer/Program.cs): 


static volid Mainl) 


{ 
Var pp = new Program():; 
p-Run(); 
} 
Public void Run() 
{ 
USing (var timer = new Timer (TimerSessionCleanup, null, 


TimeSpan.FromMinutes (1)}, TimeSpan.FromMinutes (1))) 


{ 
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RunSserverAsync() -Walt() ; 
} 
} 


对 于 TcpListener 类 ， 服 务 器 最 重要 的 部 分 在 RunServerAsync 方法 中 。TcpListener 使 用 人 P 地 址 和 端口 号 的 
构造 函数 实例 化 ,在 下 地 址 和 端口 号 上 可 以 访问 侦 听 器 。 调 用 Start 方法 ， 侦 听 器 开始 侦 听 客户 端 连接 。 
AcceptTcpClientAsynec 等 待 客户 闯 连 接 。 一 旦 客户 关连 接 ， 就 返回 TcpClient 实例 ， 允 许 与 客户 沟通 。 这 个 实例 
传递 给 RunClientRequest 方法 ， 以 处 理 请 求 。 


private async Task RunsServerhsyncl) 
{ 
try 
{ 
Var listener = new TcepListener (IPAddress.Any, PortNumber).; 
Console.WriteLine($"listener started at port {portNumber}").; 
listener.Sstart({}); 
while (true) 
{ 
Console .WriteLine ("waiting for client..."™); 
TocpClient client = await listener.AcceptIicpClientAsvynct(); 
Task 二 = RunClientRequest (client); 
} 
} 
catch (Exception ex) 
{ 
Console.WriteLine ($"Exception of type {ex.GetType() .Name}, Message: {ex.Message}"™); 
} 
} 


为 了 在 客户 问 上 读 写 ，TcpClient 的 GetStream 方法 返回 NetworkStream。 首 先 需 要 读 取 来 目 客 户 机 的 请 求 。 
为 此 ， 可 以 使 用 ReadAsync 方法 。ReadAsynec 方法 填充 一 个 字 节 数组 。 这 个 字 节 数组 使 用 Encoding 类 转换 为 字 
付 串 。 收 到 的 信息 写 入 控制 台 ， 传 递 到 ParseRequest 辅助 方法 。 根 据 ParseRequest 方法 的 结果 ， 创 建 客户 新 的 
回应 ， 使 用 WriteAsync 方法 返回 给 客户 端 。 


private Task RunClientRequestAsync (TcpClient client) 
{ 
return Task.Run (lasync (} =»> 
{ 
try 
{ 
using (client) 
{ 
Console.WriteLine ("client connected"™). 
using (MNetworkSstream stream = client.GetSstream()) 
{ 
bool completed = false; 
do 
{ 
byte[] readBuffer = new byte[ll024]; 
int read = await stream.ReadAsync (readBuffer, 0, readBuffer.Length).; 
string request = Encoding.ASCII.Getstring (readBuffer, 0, read):; 
Console.WriteLine ($"received {request}"); 


byte[] writeBuffer = null; 
string response = string.Empty; 
ParseResponse resp = ParseRequest (request, out string sessionId, 
out string result); 
switch (resp) 
{ 
CAaASE PAISeEReSPONSe .OF: 
string content = $"{STATUSORK}:: {SESSIONID}:: {sessionId}"™"; 
if (lstring.IsNulloOrEmpty (result)) 
{ 
content += $"{SEPARATOR} {result}"; 
} 
response = $"{STATUSOK} {SEPARATOR} {SESSIONID} {SEPARATOR}"™ + 
ss"{sessionId} {SEPARATOR} {content}"; 
break; 
CASE PAaArseResponse .CLOSE: 
response = $"{STATUSCLOSED}"™"; 
completed = truer; 
breaks 
CASE PATSEReESPONSEe. TIMEOQUT: 
response = $"{STATUSTIMEOUT}"; 
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break; 
Case ParseResponse .ERROR: 
response = $"{STATUSINVALID}"; 
break; 
default: 
break; 
} 
writeBuffer = Encoding.ASCIIT.GetBytes (response); 
await stream.WriteAsvync (writeBuffer, 0, writeBuffer .Length).; 
awalt stream.FlushAsync (); 
Console .WriteLine($"returned {Encoding.ASCIIT.GetSstringl 
writeBuffer, 0, writeBuffer.Length}) }"); 
} While (!completed).; 
} 
} 
} 
catch (Exception ex) 
{ 
Console .WriteLine ($"Exception in client regquest handling "+ 
"of type {lex.GetType(} .Name}, Message: {ex.Messagel}™); 
} 
Console.WriteLine ("client disconnected"™); 
}); 
} 


ParseRequest 方法 解析 请 求 ， 并 过 滤 掉 会 话 标识 符 。server (HELO ) 的 第 一 个 调用 是 不 从 客户 端 传递 会 话 标 
识 符 的 唯一 调用 ， 它 是 使 用 SessionManasger 创建 的 。 在 第 二 个 和 后 来 的 请 求 中 ，requestColl[0] 必 须 包 售 ID， 
requestColl[1] 必 须 包 含 会 话 标识 符 。 使 用 这 个 标识 符 ， 如 果 会 话 仍然 是 有 效 的 ，TouchSession 方法 就 更 新 会 话 
标识 符 的 当前 时 间 。 如 果 无 效 ， 就 返回 超时 。 对 于 服务 的 功能 ， 调 用 ProcessRequest 方法 : 


private ParseResponse ParseRequest (string request, cout string sessionId, 
out string response) 
{ 
sessionId = string.Empty; 
response = string.Empty; 
string[] requestColl = request.split!( 
new string[] { SEPARATOR }, StringsSplitOptions.RemoveEmptyEntries).; 
if (requestcoll[0] == COMMANDHELO) // first request 
{ 
sessionId = sessionManager.CreateSession(); 
} 
else if (requestcoll[0] == SESSIONID) // any other valid request 
{ 
SessionId = requestColl[l1]; 
if (! sessionManager.TouchSession (sessionId)) 


{ 
return ParseResponse.TIMEOUT:; 
} 
if (requestcColl[2] == COMMANDBYE) 
{ 
return ParseResponse .CLOSE; 
} 
if (requestColl.Length >= 4) 
{ 
response = ProcessRequest (requestcoll).; 
} 
} 
全 ] Se 


| 

return ParseResponse .ERROR; 
} 
return ParseResponse .OK; 


} 
ProcessRequest 方法 包含 一 个 switch 语句 , 来 处 理 不 同 的 请 求 。 这 个 方法 使 用 CommandActions 类 来 回应 或 
反 回 传递 收 到 的 消息 。 为 了 存储 和 检索 会 话 状态 ， 使 用 SessionManager: 


private string ProcessRequest (string[] requestColl) 
{ 
if (requestColl.Length < 4) 
throw new ArgumentException("invalid length regquestCcColl"™); 


string sessionId = requestColl[l1l]; 
string response = string.Empty; 
string requestCommand = requestColl[2]; 
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string requestAction = requestColl[3]; 
switch (requestCcCommand) 


{ 
aSe COMMANDECHO: 
response = CommandActions.Echo (requestAction); 
break; 
Case COMMANDREY : 
response = comandActions.Reverse (requestAction); 
break; 
Case COMMANDSET: 
response = sesslilonManager.ParseSesslionData (sessionId, requestAction}); 
break; 
忆 SeE COMMANDGET: 
response = $"{ sessionManager.GetSessionData{(sessionId, requestAction) }"; 
break; 
default: 
response = STATUSUNENOWN: 
break:; 
} 


return responser 


} 


CommandActions 类 定义 了 简单 的 方法 Echo 和 Reverse， 返 回 操作 字符 串 ， 或 返回 反问 发 送 的 字符 串 ( 代 
码 文 件 TcpServer/CommandActions.cs): 


Public class CommandActions 

{ 
public string Reverse(string action) => string.Join("", action.Reverse(})}); 
Public string Echo(string action) => action; 


} 
用 Echo 和 Reverse 方法 检查 服务 器 的 主要 功能 后 ， 就 要 进行 会 话 管理 了 。 服 务 器 上 需要 一 个 标识 符 和 上 
次 访问 会 话 的 时 间 ， 以 删除 最 古老 的 会 话 (代码 文件 TcpServer/SessionManager.cs): 


public struct Session 
{ 
PUublic string SesslonIQ { get; set; } 
public DateTime LastAccessTime 1{ get; set; } 


} 

SessionManager 包含 线程 安全 的 字典 ， 其 中 存储 了 所 有 的 会 话 和 会 话 数 据 。 使 用 多 个 客户 端 时 ， 字 典 可 以 
在 多 个 线程 中 同时 访问 。 所 以 使 用 名 称 空 间 System.Collections.Concurrent 中 线程 安全 的 字典 。CreateSession 方 
法 创建 一 个 新 的 会 话 ， 并 将 其 添加 到 _sessions 字典 中 : 


Public class SessionManager 
{ 
private readonly ConcurrentDictionary<string, Session> sessions = 
new ConcurrentDictionary<string, Session> (),，; 
private readonly ConcurrentDictionary<string, Dictionary<string, string>> 
sessionData = 
new ConcurrentDictionary<string, Dictionary<string, string>> (); 


Public string CreateSession'() 
{ 
string sessionId = Guid.NewGuid() .ToString(); 
if ( sessions.TryAdd (sessionId, 
new Sesslion 


{ 
SessionId = sessionId, 
LastAccessTime = DateTime .UtcNow 
})) 
{ 
return SeSSLDnIO; 
} 
忆 ] Se 
{ 
return string.Empty; 
} 
} 
tf: 


} 
从 计时 器 线程 中 ，CleanupAllSessions 方法 每 分 钟 调用 一 次 ， 删 除 最 近 没 有 使 用 的 所 有 会 话 。 该 方法 又 调用 
CleanupSession， 删 除 单个 会 话 。 客 户 端 发 送 BYE 信息 时 也 调用 CleanupSession: 
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Public void CleanupAllSsSessions  () 
{ 
foreach (Var session in sesslions) 
{ 
1f session.Value.LastAccessTime + SessionTimeout >= DateTime .UtcNow) 
{ 
CleanupSession (session.FKey); 
} 
} 
} 


Public void CleanupSession'(string sessionId) 
{ 
if ( sessionData.TryRemove (sessionId, out Dictionary<string, string> removed)) 
{ 
Console.WriteLine(s$"removed {sessionId} from session data™):; 
} 
if ( sessions.TryRemove (sessionId, out Session header)) 
{ 
Console.WriteLine($"removed {sessionId} from sessions™).; 
} 
} 


TouchSession 方法 更 新 会 话 的 LastAccessTime， 如 果 会 话 不 再 有 效 ， 就 返回 false: 


Public bool TouchSession(string sessionId) 
{ 
if (! sessions.TryGetValue (sessionId, out Session oldHeader)) 
{ 
return false; 
} 
Session updatedHeader = oldHeader; 
updatedHeader.LastAccessTime = DateTime .UtcNow; 
_ sesslons.TryUpdate (sessionId, updatedHeader, oldHeader); 
ITEturn 七 TU ; 


} 
为 了 设置 会 话 数据 ， 需 要 解析 请 求 。 会 话 数 据 接 收 的 动作 包含 由 等 号 分 隔 的 键 和 值 ， 如 x=42。 
ParseSessionData 方法 解析 它 ， 进 而 调用 SetSessionData 方法 : 


Public string ParseSessionDatal(string sessionId, string requestAction) 


{ 
string[] sessionData = requestAction.SsSplit("'="); 
if (sessionData.Length != 2) return STATUSUNKNOWMN ; 
string key = sessionDatal[ld0]; 
string Value = sessionDatal[lll]; 


SetSessionData (sessionlId, key, value).,;} 
return S$"{key}={value}™; 


} 
SetSessionData 添加 或 更 新 字典 中 的 会 话 状 态 。GetSessionData 检索 值 ， 或 返回 NOTFOUND: 


Public string GetSessionDatal(string sessionId, string KeY) 
{ 
if (! sessionData.TryGetValue (sessionId, out Dictionary<string, string> data)) 
{ 
data = new Dictionary<string, string> (}; 
data.Add (key, value); 
sessionData.TryAdd (sessionId, data); 
} 
全 号 己 
{ 
if (data.TrycGetValue (key, out string val)) 
{ 
data.Remove (key})s 
} 
data.Add (key, value); 
} 
} 


public string GetSessionDatal(string sessionId, string key) 
{ 
if ( sessionData.TryGetVvalue (sessionId, out Dictionary<string, string> data)) 
{ 
if (data.TryGetValue (key, out string value)) 
{ 
return values 


} 
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} 
return STATUSNOTFOUND; 
} 


编译 侦 听 器 后 ， 可 以 启动 程序 。 现 在 ， 需 要 一 个 客户 端 ， 以 连接 到 服务 器 。 
23.5.3 创建 TCP 客户 端 

客户 端 示 例 是 一 个 UWP 应 用 程序 WinAppTCPClient。 这 个 应 用 程序 允许 连接 到 TCP 服务 器 ， 发 送 自 定义 
协议 支持 的 所 有 不 同 命令 。 


注意 : 
为 了 使 用 UWP 和 TcpClient 类 , 需要 一 个 支持 .NET 标准 2.0 的 版 本 , Fall Creators Update of Windows 10 开 
始 支 持 它 。 可 下 载 的 代码 还 包括 一 个 WPF 示例 项 目 。 


应 用 程序 的 用 户 界 面 如 图 23-4 所 示 。 左 上 部 分 允许 连接 到 服务 器 。 右 上 部 分 的 组 合 框 列 出 了 所 有 命令 , Send 
按钮 癌 服 务 器 皮 送 命令 。 在 中 间 部 分 ， 显 示 会 话 标识 竺 和 所 发送 请 求 的 状态 。 下 部 的 控件 显示 服务 器 接收 到 的 
信息 ， 人 允许 清理 这 些 信 息 。 


| -| 


SESSIGNn | 本 


Status 


Clear Log 


类 CustomProtocolCommand 和 CustomProtocolCommand: z 数据 缚 
Name 属性 显示 命令 的 名 称 ，Action 属性 是 用 户 输入 的 、 与 命令 二 起 发 送 的 数据 。 类 CustomProtocolCommands 包 
含 一 个 绑 定 到 组 合 框 的 命令 列表 (代码 文件 WPFAppTcpClient/CustomProtocolCommands.cs): 


Public class CustomProtocolCommand 
{ 
Public CustomProtocolCommand (string name) 
: this{(name, null) { } 


Public CustomProtocolCommand (string name, string action) 
Name = name;y 


Action = action; 


} 
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public string Name { get; } 


public string Action { get; set; } 


public override string ToString() => Name; 


Public class CustomProtocolCommands : IEnumerable<CustomProtocolCommand> 


{ 


} 


private readonly List<CustomProtocolCommand> commands = 
new List<CustomProtocolCommand> () ; 


public CustomProtocolCommands () 

| string[] comands = { "HELO™"™, "BYE™, “SET"™, "GET", "ECO™, "REV™ }; 
foreach (var command in commands) 
0 CustomProtocolCommand (command} }; 
0 => C-Name == "HELO") .Action = v1.0"™ 


} 


public IEnumerator<CustomProtocolComand> GetEnumerator() => 
Commands .GetEnumerator () 7 


IEnumerator IEnumerable.GetEnumerator() =» _ Commands .GetEnumerator () 7 


MainPage 类 包含 绑 定 到 XAML 代码 的 属性 和 基于 用 户 交 互 调用 的 方法 。 这 个 类 创建 TcpClient 类 的 一 个 实 
例 和 一 些 绑 定 到 用 尸 界面 的 属性 (代码 文件 WinAppTcpClient/MainPage.xaml.cs)。 


Public partial class MainPage : Page, INotifyPropertyChanged, IDisposable 


{ 


private TcpClient client = new TcpClient () : 
private readonly CustomProtocolCommands commands = 
new CustomProtocolCommands (); 


public MainWindow() => InitializeComponent (}); 


private string remoteHost = "localhost"; 
public string RemoteHost 


get => remoteHost; 
Set => SetPropertylref remoteHost, value); 


private int serverPort = 8800; 
Public int ServerPort 


get = ServerPort. 


set => SetProperty(ref serverPort, value); 


private string sessionId; 
public string SessionId 


get => return sessionId; 
set => SetProperty (ref sessionId, value); 


private CustomProtocolCommand activeCommand; 
Public CustomProtocolCommand ActiveCommand 


get => activeCommand; 
set => SetProperty(ref activeCommand, value); 


private string log; 
Public string Log 


get => log; 
set => SetProperty(lref log, value); 


private string status; 
public string Status 
{ 
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get = 三 > return statuss 
Set => SetPropertylref status, value). 


当 用 户 单 击 Connect 按钮 时 ， 调 用 方法 OnConnect。 建 立 到 TCP 服务 器 的 连接 ， 调 用 TcpClient 类 的 
ConnectAsync 方法 。 如 果 连 接 处 于 失效 模式 ， 且 再 次 调用 OnConnect 方法 ， 就 抛 出 一 个 SocketException 
异常 ， 其 中 ErrorCode 设置 为 0x2748。 这 里 使 用 C# 异 和 常 过 滤器 来 处 理 SocketException， 创 建 一 个 新 的 
TcpClient， 因 此 再 次 调用 OnConnect 可 能 会 成 功 (代码 文件 WinAppTcpClient/MainPage.xaml.cs): 


private async void OnConnect (object sender, RoutedEventArgs e) 
{ 
try 
{ 
await client.ConnectAsync (RemoteHost, ServerPort).; 
} 
catch (SocketException ex) when (ex.ErrorCode == 0x2748) 
{ 
client.Dispose(); 
Client = new TcpClient (); 
awalit new MessageDialog ("please retry connect") .ShowAsync (); 
} 
catch (Exception ex) 
{ 
awalt new MessageDialog (ex.Message) .Showasymnc () ; 
} 
} 


请 求 发 送 到 TCP 服务 器 是 由 OnSendCommand 方法 处 理 的 。 这 里 的 代码 非常 类 似 于 服务 器 上 的 收发 代码 。 
GetStream 方法 返回 一 个 NetworkStream， 这 用 于 把 (WriteAsync) 数 据 写 入 服务 器 ， 从 服务 器 中 读 取 (ReadAsync) 
数据 (代码 文件 WinAppTcpClient/MainPage.xaml.cs): 


private async vold OnSendCommand (object sender, RoutedEventArgs e) 
{ 
tryY 
{ 
IE (iVerifyIsConnected()})} return; 
NetworkSstream stream = client.Getstream(); 
byte[] writeBuffer = Encoding.ASCIIT.GetBytes (GetCommand () ) ; 
awalit stream.WriteAsync (writeBuffer, 0, writeBuffer.Length); 
awalit stream.FlushAsync(); 
byte[] readBuffer = new byte[l024]; 
int read = await stream.ReadAsvync (readBuffer, 0, readBuffer .Length).:; 
string messageRead = Encoding.ASCII.GetSstring (readBuffer, 0, read); 
Log += messageRead + Environment.NewLine; 
ParseMessage (messageRead)}).; 
} 
catch (Exception ex) 
{ 
awalt new MessageDialog (ex.Message) .Showhsync (); 
} 
} 


为 了 建立 可 以 发 送 到 服务 器 的 数据 ， 从 OnSendCommand 内 部 调用 GetCommand 方法 。GetCommand 又 调 
用 方法 GetSessionHeader 来 建立 会 话 标 识 从 ， 然 后 提取 ActiveCommand 属性 (其 类 型 是 
CustomProtocolCommand)， 其 中 包含 选中 的 命令 名 称 和 输入 的 数据 : 


private string GetCommanaQ() 三 > 
Ss"IGetSessionHeader(}) } {ActiveCommand? .Name}:: 1ActiveCommand? .BAction}™; 


private string GetSessionHeader () 

{ 
if (string.IsNullorEmpty (SessionId})) return string.Empty; 
return S$"ID:: {SessionId}::"™; 


} 
从 服务 器 接收 数据 后 使 用 ParseMessage 方法 。 这 个 方法 拆 分 消息 以 设置 Status 和 SessionId 属性 : 


private void ParseMessage (string message) 

{ 
if (string.IsNullorEmpty (message)) return; 
string[] messageColl = message.3plit! 
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new string[] { "::"™ }, StringsplitOptions.RemoveEmptyEntries); 
3tatus = messageColl[0].; 
SessionId = GetSessionlId (messageCol]l).; 
} 
运行 应 用 程序 时 ， 可 以 连接 到 服务 器 ， 选 择 命 令 ， 设 置 回 应 和 反 回 发 送 的 值 ， 碍 看 来 自 服务 器 的 所 有 消息 ， 
如 图 23-5 所 示 。 


TCP Client 一 DO x 
Connect 
Session gd 


36b35d9f-areB-Accd-89f3-dac866d24br3 


status 


OK 


DOKID:B6b35dMf-a7ed-A4ccd-89f3-dac866d24bf3:OkR::ID::86b35d9-a7eB-4ccd-89f3-dac866d24bf3 

OK:ID:B bd9f-ared-4ccd-89f3-dach66d24bf3:OKR::ID::B6bA5d9f-ared-4ccd-89f3-dacd66d24bf3secret=42 

OK:IDBobadd-ared-dccd-89f3-dacdbbd24bf3:OR::IC:B0b35d9-a7 eB-=dccd-8973-dac866d24bf3=d2 

DK:IDBo bdd-ared-4ccd-89f3-dacd6bd24bf3:OK::ID::B0b35d9-a7ed-4ccd-89f3-dacd66d24bf3:secret 
Clear Log OK:ID:B6b33d9f-areB-4ccd-89f3-dacBbbd24bf3::OK::IC:B6b3d9-areg-A4ccd-8913-dacB6bd2Abf3:terces 


图 23-5 


23.5.4 TCP 和 UDP 


本 节 要 介绍 的 另 一 个 协议 是 UDP( 用 户 数据 报 协议 )。UDP 是 一 个 几乎 没有 开销 的 简单 协议 。 在 使 用 TCP 
发 送 和 接收 数据 之 前 ， 需 要 建 并 连接 。 而 这 对 于 UDP 是 没有 必要 的 。 使 用 UDP 只 需要 开始 发 送 或 接收 。 当 然 ， 
这 意味 着 UDP 开销 低 于 TCP, 但 也 更 不 可 靠 。 当 使 用 UDP 发 送 数据 时 , 接收 这 些 数 据 时 就 没有 得 到 信息 。UDP 
经 常用 于 速度 和 性 能 需求 大 于 可 靠 性 要 求 的 情形 , 例如 视频 流 。 UDP 还 可 以 把 消息 三 播 到 一 组 节点。 相反 , TCP 
提供 了 许多 功能 来 确保 数据 的 传输 , 它 还 提供 了 错误 校正 以 及 当 数 据 丢失 或 数据 包 损坏 时 重新 传输 它们 的 功能 。 
最 后 ，TCP 可 缓冲 传 入 和 传 出 的 数据 ， 还 保证 在 传输 过 程 中 ， 在 把 数据 包 传 送 给 应 用 程序 之 前 重组 杂乱 的 一 系 
列 数据 包 。 即 使 有 一 些 额 外 的 开销 ，TCP 仍 是 在 Internet 上 使 用 最 广泛 的 协议 ， 因 为 它 有 非常 高 的 可 靠 性 。 


23.6 使 用 UDP 


为 了 演示 UDP， 创建 两 个 控制 台 应 用 程序 ( 包 ) 项 目 ， 显 示 UDP 的 各 种 特性 : 直接 将 数据 发 送 到 主机 ， 在 本 
地 网 络 上 把 数据 广播 到 所 有 主机 上 ， 把 数据 多 播 到 属于 同一 个 组 的 一 组 节点 上 。 
UdpSender 和 UdpReceiver 项 目 使 用 以 下 名 称 空间 : 
System 


System.Linqg 
System.Net 
System.Net.Sockets 
System. [ext 
System.Threading.Tasks 


23.6.1 建立 UDP 接收 器 


从 接收 应 用 程序 开始 。 该 应 用 程序 使 用 命令 行 参数 来 控制 应 用 程序 的 不 同 功能 。 所 需 的 命令 行 参数 是 
-Pp， 它 指定 接收 器 可 以 接收 数据 的 端口 号 。 可 选 参 数 -g 与 一 个 组 地 址 用 于 多 播 。ParseCommandLine 方 
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法 解析 命令 行 参 数 ， 并 将 结果 放 入 变量 port 和 groupAddress 中 (代码 文件 UdpReceiver/Program.cs): 


static async Task Main(string[] args) 
{ 
if (!ParseCommandLine (args, out int port, out string groupAddress)) 
{ 
ShowUsage ti 
return; 
} 
await ReaderAsync (port, groupAddress); 
Console.ReadLine():; 


} 
private static void ShowUsage() 
{ 
Console.WriteLine ("Usage: UdpReceiver -D port [-g groupaddress]"); 
} 


Reader 方法 使 用 在 程序 参数 中 传 入 的 端口 号 创建 一 个 UdpClient 对 象 。ReceiveAsync 方法 等 到 一 些 数据 的 
到 来 。 这 些 数据 可 以 使 用 UdpReceiveResult 和 Buffer 属性 找到 。 数 据 编码 为 字符 串 后 ， 写 入 控制 台 ， 继 续 循环 ， 
等 待 下 一 个 要 接收 的 数据 ; 


private static asvync Task ReaderAsyncl(int port, string groupAddress) 
{ 
usSing (Var client = new UdpClient (port)) 
{ 
if (groupadadress != null) 
{ 
cllient.JoinMulticastGroup (IPAddress.Parse (groupAddress)); 
Console .WriteLine( 
$5" oining the multicast group {IPAddress.Parse (groupAddress}) }"); 
} 


bool completed = false; 

do 

{ 
Console .WriteLine ("starting the recelver".); 
UdpReceiveResult result = await client.ReceiveAsync(); 
byte[] datagram = result.Buffer; 
string received = Encoding .UTF8.GetString (datagram); 
Console .WriteLine ($"received {receljved} "™); 
if {recelved == "bye"™) 
{ 

completed = true; 

} 

} while (Icompleted); 

Console.WriteLine ("receiver closing"™); 

IE (groupAddress != null) 

{ 
client.DropMulticastGroup (IPAddress.Parse (groupAddress)); 

} 

} 
} 


局 动 应 用 程序 时 ， 它 等 竺 发送 方 发 送 数 据 。 目 前 ， 忽 略 多 氮 
送 器 后 讨论 。 


组 ， 只 使 用 参数 和 端口 号 ， 因 为 多 播 在 创建 发 


23.6.2 创建 UDP 发 送 器 


UDP 发 送 器 应 用 程序 还 允许 通过 命令 行 选项 进行 配置 。 它 比 接收 应 用 程序 有 更 多 的 选项 。 除 了 命令 行 参数 
-P 指定 器 口 号 之 外 ， 发 送 方 还 允许 使 用 -b 在 本 地 网 络 中 广播 到 所 有 节点 ， 使 用 -bh 识别 特定 的 主机 ， 使 用 -g 指 
定 一 个 组 ， 使 用 -ipv6 表明 应 该 使 用 IPv6 取代 IPv4 (代码 文件 UdpSender/Program.cs): 


static async Task Main(string[] args) 
{ 
if (!'ParseCommandLine (args, out int port, out string hostname, out pool broadcast, 
out string groupAddress, out bool jpv6)) 
{ 
ShowUsage () 7 
Console.ReadLine (); 
IeEturns 


} 
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IPENndpoint endpoint = await GetIPEndPointAsync (port, hostname, broadcast, 
groupAddress, jpv6).; 
await SenderAsync (endpoint, broadcast, groupAddress); 


Console .WriteLine ("Press return to exit..."™); 
Console.ReadLine (); 
} 
private static void ShowUsage () 
{ 
Console .WriteLine ("Usage: UdpSender -p port [-g groupaddress | -b | -h hostname] ™ + 


"[-IPV6]") 7 
CoDnSO1E .WriteLine(™\t-p port number\tEnter a port number for the sender™);} 
Console.WriteLine("™\t-g group address\tGroup address in the range 224.0.0.0 ™ + 
"to 239.255.255.255"); 
Console .WriteLine{(™\t-b\tFor a broadcast"™).; 
Console.WriteLine(™\t-h hostname\tUse the hostname option if the message should ™ 十 
"be sent to a single hos 七 ") ; 


} 

发 送 数 据 时 ， 需 要 一 个 IPEndPoint。 根 据 程 序 参 数 ， 以 不 同 的 方式 创建 它 。 对 于 广播 ，IPv4 定义 了 从 
IPAddress.Broadcast 返回 的 地 址 255.255.255.255。 没 有 用 于 广播 的 IPv6 地 址 ， 因 为 IPv6 不 支持 广播 。IPv6 用 多 
播 蔡 代 广 播 。 多 播 也 添加 到 IPv4 中 。 

传递 主机 名 时 , 主机 名 使 用 DNS 查找 功能 和 Dns 类 来 解析 。GetHostEntryAsync 方法 返回 一 个 IPHostEntry， 
其 中 IPAddress 可 以 从 AddressList 属性 中 检索 。 根据 使 用 IPv4 还 是 IPv6， 从 这 个 列表 中 提取 不 同 的 IPAddress。 
根据 网 络 环境 ， 只 有 一 个 地 址 类 型 是 有 效 的 。 如 果 把 一 个 组 地 址 传递 给 方法 ， 就 使 用 IPAddress.Parse 解析 地 址 : 


Public static async Task<IPENndPoint> GetIPEndPoint (int port, string hostName ， 
bool broadcast, string groupAddress, bool ipv6) 
{ 

IPENdPoint endpoint = null; 

七 TY 


1if (broadcast) 


{ 
endpoint = new IPEndPoint (IPAddress .Broadcast, port); 
} 
else if (hostName != null) 
{ 


IPHostEntry hostEntry = await Dns.GetHostEntryAsync (hostName) ; 
IFAddress address = null; 


if (ipv6é) 
{ 
address = hostEntry.AddressList.Wherel 
a => a.AddressFamily == AddressFamily.InterNetworkv6) 
.FirstoOrDefault(); 
} 
lSe 
{ 
address = hostEmntIY-addressL1Lst -Where 
a => a.AddressFamily == AddressFamlly.InterNetwork) 
.FirstoOrDpefault():; 
} 
if (address == null) 
{ 
FUuNc<string> ipversion = () => ipv6 ? "IPV6" : "IPV4"; 


Console.WriteLine($"no {ijpversion(}} address for {hostName}").; 
return null:; 


= new IPEnNndPoint (address, port); 
ee if (groupAddress != null) 
! endpoint = new IPEndPoint (IPFAddress.Parse (grouphddress), port). 
ee 
{ 


throw new InvalidOperationException($"{nameof (hostName) } ， 
+ "{nameof (broadcast) }, or {lnameof (groupAddress}} mst be set™). 
} 
} 
catch (SocketException ex) 
{ 


Console.WriteLine (ex.Message),; 
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} 
return endpoint; 


I 

现在 ， 关 于 UDP 协议 ， 讨 论 发 送 器 最 重要 的 部 分 。 在 创建 一 个 UdpClient 实例 ， 并 将 字符 串 转 换 为 字 节 数 
组 后 ， 就 使 用 SendAsync 方法 发 送 数 据 。 请 注意 接收 器 不 需要 侦 听 ， 发 送 方 也 不 需要 连接 。UDP 是 很 简单 的 。 
然而 ， 如 果 发 送 方 把 数据 发 送 到 未 知 的 地 方 一 一 无 人 接收 数据 ， 也 不 会 得 到 任何 错误 消息 : 


private async Task Sender (IPEndpoint endpoint, bool broadcast, 
string groupAddress) 


try 


string localhost = Dns.GetHostName (); 
using (var client = new UdpClient'(})) 
{ 
client.EnableBroadcast = broadcast.; 
if (groupAddress != null) 
{ 
cllient.JoinMulticastGroup (IPAddress.Parse (groupAddress) ); 
} 
bool completed = false; 
do 
{ 
Console.WriteLine ("Enter a message or bye to exit"™"),; 
string input = Console.ReadLine(); 
Console.WriteLine IT) 
completed = input 一 "bye"™ 
byte[] datagram = EncoOding.UTFS8.GetBytes ($"{input} from {localhost}").; 
int sent = await client.SendAsync (datagram, datagram.Length, endpoint); 
} While (!completed)}); 


if (groupAddress != null) 
{ 


client.DropMulticastGroup (IPAddress.Parse (groupAddress) ); 
} 
} 
} 
catch (SocketException ex) 
{ 
Console.WriteLine (ex.Message); 
} 
} 


现在 可 以 用 如 下 选项 局 动 接收 器 : 

-pp 9400 

用 如 下 选项 局 动 发 送 器 : 

-pp 9400 -h localhost 

可 以 在 发 送 器 中 输入 数据 ， 发 送 到 接收 器 。 如 果 停 止 接收 器 ， 就 可 以 继续 发 送 ， 而 不 会 检测 到 任何 错误 。 
也 可 以 尝试 使 用 主机 名 而 不 是 localhost， 并 在 另 一 个 系统 上 运行 接收 器 。 

在 发 送 器 中 ， 可 以 添加 -b 选项 ， 删 除 主机 名 ， 给 在 同一 个 网 络 上 侦 听 端口 9400 的 所 有 节点 发 送 广 播 : 

-PP 9400 —b 


请 注意 广播 不 跨越 大 多 数 路 由 器 ， 当 然 不 能 在 互联 网 上 使 用 广播 。 这 种 情况 和 多 播 不 同 , 参见 下 面 的 讨论 。 


23.6.3 ”使 用 多 播 


广播 不 跨越 路 由 器 ， 但 多 播 可 以 跨越 。 多 播 用 于 将 消息 发 送 到 一 组 系统 上 一 一 所 有 节点 都 属于 同一 个 组 。 
在 IPv4 中 ， 为 使 用 多 播 保 留 了 特定 的 卫 地 址 。 地 址 是 从 224.0.0.0 到 239.255.255.253。 这 些 地 址 中 的 许多 都 保 
留 给 具体 的 协议 ， 例 如 用 于 路 由 器 ， 但 239.0.0.0/8 可 以 私下 在 组 织 中 使 用 。 这 非常 类 似 于 IPV6， 它 为 不 同 的 路 
由 协议 保留 了 著名 的 IPV6 多 播 地 址 。 地 址 于:/16 是 组 织 中 的 本 地 地 址 ， 地 址 fxe::/16 有 全 局 作用 域 ， 可 以 在 公 
共 互 联网 上 路 由 。 

对 于 使 用 多 播 的 发 送 器 或 接收 器 ， 必 须 通过 调用 UdpClient 的 JoinMulticastGroup 方法 来 加 入 一 个 多 播 组 : 


client.JoinMulticastGroup (IPAddress.Parse (groupAddress)); 
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为 了 再 次 退出 该 组 ， 可 以 调用 方法 DropMulticastGroup: 

client.DropMulticastGroup (IPAddress.Parse (groupAddress)); 

用 如 下 选项 启动 接收 器 和 发 送 器 : 

-p 9400 -dg 230.0.0.1 

它们 都 属于 同一 个 组 ， 多 播 在 进行 。 和 广播 一 样 ， 可 以 月 动 多 个 接收 器 和 多 个 发 送 器 。 接 收 器 将 接收 来 目 
每 个 接收 器 的 几乎 所 有 消息 。 


23.7 ”使 用 套 接 字 


HTTP 协议 基于 TCP, 因此 HttpXX 类 在 TcpXX 类 上 提供 了 一 个 抽象 层 . 然 而 TepXX 类 提供 了 更 多 的 控制 。 
使 用 套 接 字 ， 甚 至 可 以 获得 比 TcpXX 或 UdpXX 类 更 多 的 控制 。 通 过 套 接 字 ， 可 以 使 用 不 同 的 协议 ， 不仅 是 基 
于 TCP 或 UDP 的 协议 ， 还 可 以 创建 目 己 的 协议 。 更 重要 的 是 ， 可 以 更 多 地 控制 基于 TCP 或 UDP 的 协议 。 

SocketServerSender 和 SocketClient 项 目 实现 为 控制 台 应 用 程序 ( 包 )， 使 用 如 下 名 称 空间 : 

System 

System.LInq 

ystem.TO 

System.Net 
System.Net.Sockets 
System. [ext 
System.Threadine 
System.Threadine.Tasks 


23.7.1 使 用 套 接 字 创建 侦 听 器 


首先 用 一 个 服务 器 侦 听 传 入 的 请 求 。 服 务 器 需要 一 个 用 程序 参数 传 入 的 器 口号。 之后， 就 调用 Listener 方 
法 (代码 文件 SocketServer/Program.cs): 

static void Main(string[] args) 

(args.Length != 1) 


ShowUsage (}); 
returns; 


} 

if (lint.TryParse (args[0], out int port)) 
ShowUsage ()，} 
return; 

} 

Listener (port).; 

Console.ReadLine (}); 

} 


private void ShowUsage() 


Console .WriteLine ("SocketServer port").; 


对 套 接 字 最 重要 的 代码 在 下 面 的 代码 片段 中 。 侦 听 器 创建 一 个 新 的 Socket 对 象 。 给 构造 函数 提供 
AddressFamily、SocketType 和 ProtocolType。AddressFamily 是 一 个 大 型 枚 举 ， 提 供 了 许多 不 同 的 网 络 。 例 如 
DECnet(Digital Equipment 在 1975 年 发 布 它 ， 主 要 用 作 PDP-11 系统 之 间 的 网 络 通信 ); Banyan VINES( 用 于 连接 
客户 机 ); 当然 还 有 用 于 卫 v4 的 IntemetWork 和 用 于 IPV6 的 IntermnetWorkV6。 如 前 所 述 ， 可 以 为 大 量 网 络 协议 
使 用 套 接 字 。 第 二 个 参数 SocketType 指定 套 接 字 的 类 型 。 例 如 用 于 TCP 的 Stream、 用 于 UDP 的 Dgram 或 用 于 
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原始 套 接 字 的 Raw。 第 三 个 参数 是 用 于 ProtocolType 的 枚 举 。 例 如 一 、Ucmp、Udp、IPv6 和 Raw。 所 选 的 设 
置 需要 匹配 。 例 如 ， 使 用 TCP 与 Pv4， 地 址 系列 就 必须 是 InterNetwork、 套 接 字 类 型 Steam、 协 议 类 型 Tcp。 
要 使 用 IPv4 创建 一 个 UDP 通信 ， 地 址 系列 就 需要 设置 为 IhterNetwork、 套 接 字 类 型 Dgram 和 协议 类 型 Udp。 


Public static void Listener (int port) 

{ 
var listener = new Socket (AddressFamily.InterNetwork, SocketType.Stream, 
ProtocolType.Tcp}; 
listener.ReceiveTimeout = S5000; // receive timout 5 seconds 
listener.SendTimeout = S5000; // send 七 Imeout 5 seconds 


ans 

从 构造 函数 返回 的 侦 听 器 套 接 字 绑 定 到 IP 地 址 和 端口 号 上 。 在 示例 代码 中 ， 侦 听 器 绑 定 到 所 有 本 地 IPv4 

地 址 上 ， 问 口号 用 参数 指定 。 调 用 Listen 方法 ， 局 动 套 接 字 的 侦 听 模式 。 套 接 字 现在 可 以 接受 传 入 的 连接 请 求 。 
用 Listen 方法 指定 参数 ， 定 义 了 服务 器 的 缓 促 区 队列 的 大 小 一 一 在 处 理 连接 之 前 ， 可 以 同时 连接 多 少 客户 站 : 


Public static void Listener (int port) 
{ 
Ap 
listener.Bindlnew IPEndPoint(IPAddress.Any, Port)).; 
listener.Listen(backlog: 15); 
Console.WriteLine ($"listener started on port {port}"); 


Pg 
等 待 客户 端 连接 在 Socket 类 的 方法 Accept 中 进行 。 这 个 方法 阻塞 线程 ， 直 到 客户 机 连接 为 止 。 客 户 
端 连接 后 ， 需 要 再 次 调用 这 个 方法 ， 来 满足 其 他 客户 端的 请 求 ， 所 以 在 while 循环 中 调用 此 方法 。 为 了 进行 
侦 听 ， 启 动 一 个 单独 的 任务 ， 该 任务 可 以 在 调用 线程 中 取消 。 在 方法 CommunicateWithClientUsingSocketAsync 
中 执行 使 用 套 接 字 读 写 的 任务 。 这 个 方法 接收 绑 定 到 客户 端的 Socket 实例 ， 进 行 读 写 ; 


Publijic static void LISteneI (Int port) 
{ 
FS 
Var cts = new CancellationTokenSource ().; 
var tf = new TaskFactory (TaskCreationoptions.LongRunning, 
TaskContinuationOptions.None).; 
tf.startNew({(}) => // listener task 
{ 
Console.WriteLine("listener task started"™}): 
while (true) 
{ 
1if (cts.Token.IsCancellationRequested) 
{ 
cts.Token.ThrowIfCcancellationRequested(); 
break; 
} 


Console .WriteLine ("waiting for accept"); 


Socket client = listener .Lccept().; 

if (‘Iiclient.Connected) 

{ 

Console .WriteLine{("not connected™).: 
continue; 

} 

Console .WriteLine (S$"client connected local address ™ 十 
s"{((IPENdPoOint) client.LocalEndPoint) .Address} and port ™ 十 
s"{((IPENdPOINt) client.LocalEndPoint)}) .Port}, remote address ™ 十 
ss"{((IPENdPoOiNnt})client.RemoteEndPoint) .Address} and port ™ 十 
ST{({IFEENdPoOint}client.RemoteEndPoint) .Port}"y.: 

Task 二 = CommunicateWithClientUsingSocketAsvync (client); 

} 

listener.Dispose(); 

Console.WriteLine ("Listener task closing"}); 
}, cts.Token}):; 
Console .WriteLine ("Press return to exit™).:; 
Console.ReadLine (); 
Cts.Cancel (); 


} 

为 了 与 客户 端 沟 通 ， 创 建 一 个 新 任务 。 这 会 释放 侦 听 器 任务 ， 立 即 进行 下 一 次 迭代 ， 等 待 下 一 个 客户 端 连 
接 。Socket 类 的 Receive 方法 接受 一 个 缓冲 ， 其 中 的 数据 和 标志 可 以 读 取 ， 用 于 套 接 字 。 这 个 字 节 数组 转换 为 
字符 串 ， 使 用 Send 方法 ， 连 同一 个 小 变化 一 起 发 送 回 客户 机 : 
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private static Task CommunicateWithClientUsingSocketAsync (Socket socket) 
{ 
return Task.Runt((} 三 > 
{ 
try 
{ 
using (socket) 
{ 
bool completed = falser; 
do 
{ 
byte[] readBuffer = new byte[l024]; 
int read = socket.Receive (readBuffer, 0, 1024, SocketFlags .None); 
string fromClient = Encoding .UTFS8.GetSsString (readBuffer, 0, read); 
Console .WriteLine($"read {read} bytes: {fromClient}"™"),; 


if (string.Compare (fromClient, "shutdown", ignoreCase: true) == 0) 
{ 

completed = truer; 
} 


byte[] writeBuffer = Encoding.UTF8.GetBytes($"echo {fromCclient}").; 
int send = socket .Send (writeBuffer).; 
Console.WriteLine($"sent {send} bytes"™); 
} while (!'completed); 
} 
Console .WriteLine ("closed stream and client socket™).; 
} 
catch (Exception ex) 
{ 
Console .WriteLine (ex.Message); 
} 
}) 7 
} 


服务 器 已 经 准备 好 了 。 然 而 ,下面 看 看 通过 扩展 抽象 级 别 读 写 通信 信息 的 不 同方 式 。 
23.7.2 使 用 NetworkStream 和 套 接 字 


前 面 使 用 了 NetworkStream 类 、TcpClient 和 TcpListener 类 。NetworkStream 构造 函数 允许 传递 Socket， 所 
以 可 以 使 用 流 方法 Read 和 Write 蔡 代 套 接 字 的 Send 和 Receive 方法 。 在 NetworkStream 的 构造 函数 中 ， 可 以 定 
义 流 是 否 应 该 拥有 套 接 字 。 如 这 段 代 码 所 示 ， 如 果 流 拥有 套 接 字 ， 就 在 关闭 流 时 关闭 套 接 字 ( 代 码 文件 
SocketServer/Program.cs): 


private static async Task CommunicateWithClientUsingNetworkStreamAsync( 
Socket socket) 
{ 
try 
{ 
using (var stream = new NetworkStream(socket, ownsSocket: true)) 
{ 
bool completed = false; 
do 
{ 
byte[] readBuffer = new DYte [10z4] :; 
int read = await stream.ReadAsync (readBuffer, 0, 1024); 
string fromClient = Encoding.UTF8.GetString (readBuffer, 0, read); 
Console.WriteLine($"read {read} bytes: {fromCclient}"),; 


1if (string.Compare (fromclient, "shutdown", ignoreCase: true) == 0) 
{ 

completed = true; 
} 


byte[] writeBuffer = Encoding.UTF8.GetBytes (S$"echo {fromClient}"); 
awalt stream.WriteAsync (writeBuffer, 0, writeBuffer.Length); 
} while (!completed).; 
} 
Console.WriteLine("closed stream and client socket"™y.: 
} 
catch (Exception ex) 
{ 
Console.WriteLine (ex.Message).; 
} 
} 


要 在 代码 示例 中 使 用 这 个 方法 ， 需 要 更 改 Listener 方法 ， 调 用 CommunicateWithClientUsineNetworkStreamAsync 
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而 不 是 CommunicateWithClientUsingSocketAsynec 方法 。 


23.7.3 ”通过 套 接 字 使 用 读 取 器 和 写 入 器 


下 面 再 添加 一 个 抽象 层 。 因 为 NetworkStream 派生 于 Stream 类 ， 还 可 以 使 用 读 取 器 和 写 入 器 访问 套 接 字 。 
只 需要 注意 读 取 器 和 写 入 器 的 生存 期 。 调 用 读 取 器 和 写 入 器 的 Dispose 方法 ， 还 会 销毁 底层 的 流 。 所 以 要 选择 
StreamReader 和 StreamWriter 的 构造 函数 ， 其 中 leaveOption 参数 可 以 设置 为 hue。 之 后 ， 在 销毁 读 取 器 和 写 入 
器 时 ， 就 不 会 销毁 底层 的 流 了 。NetworkStream 在 外 层 using 语句 的 最 后 销毁 ， 这 又 会 关闭 套 接 字 ， 因 为 它 拥有 
套 接 字 。 还 有 男 一 个 方面 需要 注意 : 通过 套 接 字 使 用 写 入 器 时 ， 黑 认 情 况 下 ， 写 入 器 不 刷新 数据 ， 所 以 它们 保 
存在 缓存 中 ， 直 到 缓存 已 满 。 使 用 网 络 流 ， 可 能 需要 更 快 的 回应 。 这 里 可 以 把 AutoFlush 属性 设置 为 tue( 也 可 
以 调用 FlushAsync 方法 ): 


Public static async Task CommunicateWithClientUsingReadersAndWritersAsync!l 
Socket socket) 
{ 
try 
{ 
Using (var stream = new NetworkStream(socket, ownsSsSocket: true)) 
using (var reader = new StreamReader (stream, Encoding.UTF8, false, 
8192, leaveOpen: true)) 
using (var writer = new StreamWriter (stream, Encoding .UTFS, 
8192, leaveOpen: true)) 
{ 
Writer.AutoFlush = 七 EU 
bool completed = falsers 
do 
{ 
string fromClient = awalt reader.ReadLineAsync (); 
Console.WriteLine ($$"read {fromClient}"™). 
if (string.Compare (fromClient, "shutdown", jgnoreCase: true) == 0) 
{ 
completed = true; 
} 
awalt writer.WriteLineAsync($"echo {fromClient}"); 
} while (!completed}); 
} 


Console.WriteLine{"closed stream and client socket™).; 
catch (Exception ex) 


{ 


Console.WriteLine (ex.Message}); 
} 
} 


要 在 代码 示例 中 使 用 这 个 方法 ， 需 要 更 改 Listener 方法 来 调用 方法 CommunicateWithClientUsing- 
ReadersAndWritersAsync， 而 不 是 方法 CommmunicateWithClientUsingSocketAsync。 


注意 : 
流 、 读 取 器 和 写 入 器 参见 第 22 章 。 
23.7.4 使 用 套 接 字 实 现 接收 器 


接收 方 应 用 程序 SocketClient 也 实现 为 一 个 控制 台 应 用 程序 ( 包 )。 通 过 命令 行 参数 ， 需 要 传递 服务 器 的 主机 
名 和 端口 号 。 成 功 解析 命令 行 后 ， 调 用 方法 SendAndReceive 与 服务 器 通信 (代码 文件 SocketClient/Program.cs): 


static async Task Main(string[] args) 


{ 
if (args.Length != 2) 
{ 
ShowUsage () 7 
return; 
} 
string hostName = args[0]; 


if (!int.TryParse(args[l1], out int port)) 
{ 
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} 


ShowUsage LT 
return; 


Console .WriteLine ("press return When the server 15 started™); 
Console.ReadLine (}); 

awalit SendAndRecelveAsync (hostName, port).; 
Console.ReadLine{(); 


} 


private static void ShowUsage () 


{ 


Console .WriteLine ("Usage: SocketClient server port"™); 


} 


SendAndReceive 方法 使 用 DNS 名 称 解 析 ， 从 主机 名 中 获得 IPHostEntry。 这 个 PHostEntry 用 来 得 到 主机 的 
IPv4 地 址 。 创 建 Socket 实例 后 (其 方式 与 为 服务 器 创建 代码 相同 )， Connect 方法 使 用 该 地 址 连接 到 服务 器 。 连 
接 完 成 后 ， 调 用 Sender 和 Receiver 方法 ， 创 建 不 同 的 任务 ， 这 人 允许 同时 运行 这 些 方法 。 接 收 方 客户 端 可 以 同时 
读 写 服务 器 ， 


Public static async Task SendanadRecelIVeasYnc (string hostName, int port) 


{ 


try 


{ 


} 


IPHOstEntry ipHost = await Dns.GetHostEntryAsync (hostName}); 
IFAddress ipAddress = ipHost.AddressList.Where!l 


address => address.AddressFamily == AddressFamily.InterNetwork) .First(); 
if (ipAddress == null) 
{ 

Console .WriteLine{"no IPvA4 address"™); 

return; 
} 


using (var client = new Socket (AddressFamily.TInterNetwork, 
SocketTvype.Stream, ProtocolType.Top)) 

{ 
client.Connect(ipAddress, port).; 
Console .WriteLine("client successfully connected™); 
Var stream = new NetworkSstream(client).:; 
var cts = new CancellationTokensource (}); 
Task tSender = SenderaAsync (stream, cts); 
Task tReceiver = RecelverAsync(stream, cts.Token).; 
await Task.WhenAll (tsender, tReceiver); 

} 


catch (SocketException ex) 


{ 


} 
} 


Console.WriteLine (ex.Message),; 


注意 ， 
如 果 改 变 地 址 列表 的 过 滤 方 式 , 得 到 一 个 IPv6 地 址 , 而 不 是 IPv4 地 址 , 则 还 需要 改变 Socket 调用 , 为 IPv6 
地 址 系列 创建 一 个 套 接 字 。 


Sender 方法 要 求 用 户 输入 数据 ， 并 使 用 WriteAsync 方法 将 这 些 数据 发 送 到 网 络 流 。Receiver 方法 用 


ReadAsync 方法 接收 流 中 的 数据 。 当 用 户 进 入 终止 字符 串 时 ， 通 过 CancellationToken 从 Sender 任务 中 发 送 取 


a 
信 息 3 


Public static async Task SenderAsync (NetwoITKStITeam stream, 
CancellationTokenSource cts) 


{ 


Console .WriteLine ("Sender task"™).; 
while (true)} 


{ 


Console.WriteLine ("enter a string to send, shutdown to exit"™); 
string line = Console.ReadLine (}); 

byte[] buffer = Encoding.UTF8.GetBytes ($"{line}\rm\n".); 

awalt stream.WriteAsvync (buffer, 0, buffer.Length).; 

await stream.FlushAsync ();} 

if (string.Compare (line, "shutdown", ignoreCase: true) == 0) 


{ 
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cts.Cancel (); 
Console .WriteLine("sender task closes"™).; 
break; 
有 
} 
} 


private const jint ReadBufferSsSize = 1024; 


public static async Task RecelverAsync (NetworkSstream stream, 
CancellationToken token) 
{ 
try 
{ 
stream.ReadTimeout = S5000; 
Console.WriteLine{({"Receiver task™):; 
byte[] readBuffer = new byte[ReadBuffersizel]; 
while (true) 
{ 
Array.Clear (readBuffer, 0, ReadBufferSize); 
int read = await stream.ReadhAsvync (readBuffer, 0, ReadBufferSize, token).; 
string receivedLine = Encoding.UTFS8.GetString (readBuffer, 0, read); 
Console .WriteLine (S$"recelved {recelvedLine}™); 
} 
} 


catch (OperationCanceledException ex) 


Console.WriteLine (ex.Message}); 
】 
} 


运行 客户 端 和 服务 器 ， 可 以 看 到 通过 TCP 的 通信 。 


注意 : 

示例 代码 实现 了 一 个 TCP 客户 机 和 服务 器 . TCP 需要 一 个 连接 , 才能 发 送 和 接收 数据 ; 为 此 要 调用 Connect 
方法 。 对 于 UDP， 也 可 以 调用 Connect 连接 方法 ， 但 它 不 建立 连接 。 使 用 UDP 时 ， 不 是 调用 Connect 方法 ， 而 
可 以 使 用 SendTo 和 ReceiveFrom 方法 代替 。 这 些 方法 需要 一 个 EndPoint 参数 ， 在 发 送 和 接收 时 定义 端点 。 


注意 : 
取消 标记 参见 第 21 章 。 


23.8 小结 


本 章 回顾 了 System.Net 名 称 空间 中 用 于 网 络 通信 的 .NET Framework 类 。 从 中 可 了 解 到 ， 某 些 .NET 基 类 
可 处 理 在 网 络 和 Internet 上 打开 的 客户 端 连 接 ， 如 何 给 服务 器 发 送 请 求 和 从 服务 器 接收 啊 应 

作为 经 验 规 则 ， 在 使 用 System.Net 名 称 空间 中 的 类 编程 时 ， 应 尽 可 能 一 直 使 用 最 通用 的 类 。 例 如 ， 使 用 
TCPClient 类 代 蔡 Socket 类 , 可 以 把 代码 与 许多 低级 套 接 字 细 节 分 离开 来 。 更 进一步 , HttpClient 类 是 利用 HTTP 
协议 的 一 种 简单 方式 。 

本 书 更 多 地 讨论 网 络 ， 而 不 是 本 章 提 到 的 核心 网 络 功能 。 第 32 章 将 介绍 ASPNET Web API， 它 使 用 HITP 
协议 提供 服务 。 网 上 附加 第 3 章 探 讨 WebHooks 和 SienalR， 这 两 个 技术 提供 了 事件 驱动 的 通信 。 

下 一 章 讨论 安全 性 ， 说 明 CryptoStream 如 何 用 于 加 密 流 ， 无 论 流 是 用 于 文件 还 是 联网 。 


安 全 性 


本 草 要 扣 
身份 验证 和 授权 
创建 和 验证 签名 
保护 数据 交换 
签名 和 散 列 
数据 保护 
资源 的 访问 控制 
Web 安全 性 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Security 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® WindowsPrincipal 
SienineDemo 
Securelranster 
RSASample 
DataProtection 
UserSecretsSample 
FileAccessControl 
WebApplicationSecurity 


24.1 概述 


为 了 确保 应 用 程序 的 安全 ， 安 全 性 有 几 个 重要 方面 需要 考虑 。 一 是 应 用 程序 的 用 户 ， 访 问 应 用 程序 的 是 一 
个 真正 的 用 户 ， 还 是 伪装 成 用 户 的 茶 个 人 ? 如 何 确定 这 个 用 户 是 可 以 信任 的 ? 如 本 章 所 述 ， 确 保 应 用 程序 安全 
的 用 户 方 面 是 一 个 两 阶段 过 程 ， 用 户 盲 先 需要 进行 身份 验证 ， 再 进行 授权 ， 以 验证 该 用 户 是 否 可 以 使 用 需要 的 
资源 。 
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对 于 在 网 络 上 存储 或 发 送 的 数据 呢 ? 例如 ， 有 人 可 以 通过 网 络 嗅 探 器 访问 这 些 数据 吗 ? 这里， 数据 的 加 密 
很 重要 。 一 些 技术 ， 如 Windows Communication Foundation(WCF)， 通 过 简单 的 配置 提供 了 加 密 功能 ， 所 以 可 以 
看 到 后 台 执行 了 什么 操作 。 

另 一 方面 是 应 用 程序 本 身 。 如 果 应 用 程序 驻 留 在 Web 提供 程序 上 ， 如何 禁止 应 用 程序 执行 对 服务 器 有 害 的 
操作 ? 

本 章 将 讨论 NET 中 有 助 于 管理 安全 性 的 一 些 特性 ， 其 中 包括 NET 如 何 避 开 恶意 代码 、 如 何 管理 安全 性 策 
略 ， 以 及 如 何 通过 编程 访问 安全 子 系统 等 。 

本 章 还 会 讨论 保护 Web 应 用 程序 时 需要 注意 的 问题 。 


24.2 ”验证 用 户 信 息 


安全 性 的 两 个 基本 文 柱 是 身份 验证 和 授权 。 喘 份 验证 是 标识 用 户 的 过 程 ， 授 权 在 验证 了 所 标识 用 户 是 否 可 
以 访问 特定 资源 之 后 进行 。 本 节 介 绍 如 何 使 用 标识 符 和 principals 获得 用 户 的 信息 。 


24.2.1 使 用 Windows 标识 


使 用 标识 可 以 验证 运行 应 用 程序 的 用 户 .WindowsImdentity 类 表示 一 个 Windows 用 户 。 如 果 没 有 用 Windows 
账户 标识 用 户 ， 也 可 以 使 用 实现 了 Identity 接口 的 其 他 类 。 通 过 这 个 接口 可 以 访问 用 户 名 、 访 用户 是 否 通过 刁 
份 验证 ， 以 及 验证 类 型 等 信息 。 

principal 是 一 个 包含 用 户 的 标识 和 用 户 的 所 属 角 色 的 对 象 。IPrincipal 接口 定义 了 Identity 属性 和 IsInRole() 
方法 ，Identity 属性 返回 Identity 对 象 ; 在 IImnRole0 方 法 中 ， 可 以 验证 用 户 是 否 是 指定 角色 的 一 个 成 员 。 角 
色 是 有 相同 安全 权限 的 用 户 集合 ， 同 时 它 是 用 户 的 管理 单元 。 角 色 可 以 是 Windows 组 或 自己 定义 的 一 个 字符 
串 集合 。 

.NET 中 的 Principal 类 有 WindowsPrincipal、GenericPrincipal 和 RolePrincipal。 从 NET 4.5 开始 ， 这 些 Principal 
类 型 派生 于 基 类 ClaimsPrincipal。 还 可 以 创建 实现 了 IPrincipal 接口 或 派生 于 ClaimsPrincipal 的 自 定 义 Principal 类 。 

示例 代码 仅 运行 在 Windows 上 ， 使 用 如 下 依赖 项 和 名 称 空间 : 


依赖 项 

System.Security.Principal. Windows 
名 称 空间 

System 


System.Collections.Generic 
System.Security.Clalms 
System.Security.Principal 
下 面 创建 一 个 控制 台 应 用 程序 LNET Core)， 它 可 以 访问 菜 个 应 用 程序 中 的 主体 ， 以 便 允 许 用 尸 访 问 底层 的 
Windows 账户 。 这 里 需要 导入 System.Security.Principal 和 System.Security Claims 名 称 空 间 。Main0 方 法 调用 方 
法 ShowIdentityImmformation0 把 WindowsIdentity 的 信息 写 到 控制 台 ， 调 用 ShowPrincipal 写 入 可 用 于 principals 的 
额外 信息 ， 调 用 ShowClaims 写 入 声称 信息 (代码 文件 WindowsPrincipal/Program.cs): 
static void Main{) 
WindowsIdentity identity = ShowIdentityInformation (); 
WindowsPrincipal principal = ShowPrincipal (identity); 


ShowClaims (principal.cCclaims).; 


} 
ShowIdentityImformation0 方 法 通过 调用 WindowsIdentity 的 静态 方法 GetCurrent， 创 建 一 个 WindowsIdentity 
对 象 , 并 访问 其 属性 , 来 显示 号 份 类 型 、 名称、 号 份 验证 类 型 和 其 他 值 (代码 文件 WindowsPrincipal/Program.cs): 


Public static WindowsIdentity ShowIdentityInformation'() 
{ 
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WindowsIdentity identity = WindowsIdentity.GetCurrent () ; 
if (identity == null) 
{ 
Console.WriteLine("not a Windows Identity"); 
return PmU 1]; 
} 
Console .WriteLine($"IdentityTYype: {identity}"); 
Console .WriteLine ($s"Name: {identity.Name}"™); 
Console .WriteLine($"Authenticated: {identity.IsAuthenticated}").; 
Console .WriteLine($"Authentication Type: {identity.AuthenticationType}"}); 
Console .WriteLine($"Anonymous? {identity.IsAnonymous}"); 
Console .WriteLine($"Access Token: ™ + 
$s"{identity.AccessToken.DangerousGetHandle () }").;，; 
Console .WriteLine():; 
return identity; 


} 

所 有 的 标识 类 ， 例 如 WindowsIdentity， 都 实现 了 IIdentity 接口 ， 该 接口 包含 3 个 属性 (AuthenticationType、 
IsAuthenticated 和 Name)， 便 于 所 有 的 派生 标识 类 实现 它们 。WindowsIdentity 的 其 他 属性 都 专用 于 这 种 标识 。 

运行 应 用 程序 , 信息 如 以 下 代码 片段 所 示 。 身 份 验证 类 型 显示 CloudAP， 因 为 使 用 Microsoft Live 账户 登录 
到 系统 。 如 果 使 用 Active Directory，Active Directory 就 显示 在 验证 类 型 中 : 

IdentityType: SySstem.Security.Principal .WindowsIdentity 

Name: THEROCES‘\Christian 

Authenticated: True 

Authentication Type: CLoudaP 


Anonymous? False 
Bccess Token: S64 


24.2.2 Windows Principal 


principal 包含 一 个 标识 ， 提 供 额 外 的 信息 ， 比 如 用 户 所 属 的 角色 。principal 实现 了 IPrincipal 接口 ， 提 供 了 
方法 IsInRole 和 Identity 属性 。 在 Windows 中 ， 用 户 所 属 的 所 有 Windows 组 映射 到 角色 。 重 载 IsInRole 方法 ， 
以 接受 安全 标识 从、 角色 字符 串 或 WindowsBuiltInRole 榴 举 的 值 。 示 例 代 码 验 证 用 户 是 否 属于 内 置 的 角色 User 
和 Administrator (代码 文件 WindowsPrincipal/Prosgram.cs): 


public static WindowsPrincipal ShowPrincipal (WindowsIdentity identity) 


{ 
Console .WriteLine ("Show principal information™); 
WindowsPrincipal principal = new WindowsPrincipal (identity),; 
if {principal == null) 
{ 


Console.WriteLine ("not a Windows Principal™); 

return null; 
} 
Console .WriteLine($"Users? {principal.IsInRole (WindowsBuiltInRole.User) }"); 
Console .WriteLine'( 

$s"Administrators? {principal.IsInRole (WindowsBuiltIinRole.Administrator}) }"); 
Console .WriteLine(); 
return principal; 


} 
运行 应 用 程序 ， 我 的 账户 属于 Users 角色 ， 而 不 是 Administrator 角色 ， 得 到 以 下 结果 : 
Show principal information 


USers? TIue 
Administrators? False 


很 明显 ， 如 果 能 很 容易 地 访问 当前 用 户 及 其 角色 的 详细 信息 ， 然 后 使 用 那些 信息 决定 允许 或 拒绝 用 户 执 行 
某 些 动 作 ， 这 就 非常 有 好 处 。 利 用 角色 和 Windows 用 户 组 ， 管 理 员 可 以 完成 使 用 标准 用 户 管理 工具 所 能 完成 的 
工作 ， 这 样 ， 在 用 户 的 角色 改变 时 ， 通 常 可 以 避免 更 改 代码 。 

所 有 principal 类 都 派生 自 基 类 ClaimsPrincipal。 这 样 ， 可 以 使 用 principal 对 象 的 Claims 属性 来 访问 用 户 的 
声称 。 下 一 节 讨 论 声称 。 


24.2.3 ”使 用 声称 
声称 (claim) 提 供 了 比 角色 更 大 的 灵活 性 。 声 称 是 一 个 关于 标识 (来 自 权威 机 构 ) 的 语句 。 权 威 机 构 如 Active 
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Directory 或 Microsoft Live 账户 身份 验证 服务 ， 建 立 关 于 用 户 的 声称 ， 例 如 ， 用 户 名 的 声称 、 用 户 所 属 的 组 的 
声称 或 关于 年 龄 的 声称 。 用 户 已 经 21 岁 了 ， 有 资格 访问 特定 的 资源 吗 ? 

方法 ShowClaims 访问 一 组 声称 ， 把 主题 、 发 行人 、 声 称 类 型 和 更 多 选项 写 到 控制 台 ( 代 码 文 件 
WindowsPrincipal/Proeram.cs): 


Public static volid ShowCclaims (IEnumerable<Claim> claims) 
{ 
Console .WriteLine ("Claims"™}).; 
foreach (war claim in claims) 
{ 
Console.WriteLine($"Subject: {claim.subject}");} 
Console.WriteLine{($"Issuer: {claim.Issuer}"™).; 
Console.WriteLine($"Type: {claim.Type}"); 
Console.WriteLine($s"Value type: {claim.VvalueType}"); 
Console.WriteLine ($s"Value: {claim.Value}™}); 
foreach (var prop in claim.Properties) 
{ 
Console .WriteLine ($"\tProperty: {prop.Key} {prop.Value}"™); 
} 
Console.WriteLine{(); 
} 
} 


下 面 是 从 Microsoft Live 账户 中 提取 的 一 个 声称 ， 它 提供 了 名 称 、 主 ID 和 组 标识 符 等 信息 。 


Clalims 

subject: System.SsSecurity.Principal .WindowsIdentity 

ISSUEer: BD AUTHORITY 

Type: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name 
Value type: http://www.w3.0rg/2001/xMLSchema#string 

Value: THEROCES\Christian 


Subject: System.Security.Principal .WindowsIdentity 
工 SSUEI: BD AUTHORITY 
Type: http://schemas .microsoft.com/ws/2008/06/identity/claims/primarysid 
Value type: http://www.w3.0rg/2001/xMLSchema#string 
Value: 3S-1-5-21-1413171511-313453878-1364686672-1001 
Property: http://schemas.microsoft.com/ws/2008/06/identity/claims/ 
windowssubauthority NTAuthority 


Subject: System.Security.Principal .WindowsIdentity 
ISSUuer: BD AUTHORITY 
Type: http://schemas .microsoft.com/ws/2008/06/identity/claims/groupsid 
Value type: http://www.w3.0rg/2001/xMLSchema#string 
Value: SS-1—1-—0 
Property: http://schemas.microsoft.com/ws/2008/06/identity/claims/ 
windowssubauthority WorldAuthority 


Subject: System.Security.Principal .WindowsIdentity 
Issuer: BD AUTHORITY 
Type: http://schemas .microsoft.com/ws/2005/05/identity/claims/denyonlysid 
Value type: http://www.w3.0rg/2001/xMLSchema#string 
Value: SS-1—S—114 
Property: http://schemas.microsoft.com/ws/2008/06/identity/claims/ 
windowssubauthority NTAuthority 


可 以 从 声称 的 提供 程序 中 把 声称 添加 到 Windows 标识 。 还 可 以 从 简单 的 客户 端 程序 中 添加 声称 ， 如 年 龄 
声称 : 

identity.Addclaim(new Claim("Age™, "25")); 

使 用 程序 中 的 声称 ， 相 信 这 个 声称 。 这 个 声称 是 真 的 一 一 是 25 岁 吗 ?声称 也 可 以 是 谎言。 从 客户 机 应 用 程 
序 中 添加 这 个 声称 ， 可 以 看 到 ， 声 称 的 发 行人 是 LOCAL AUTHORITY。AD AUTHORITY (the Active Directory) 
的 信息 更 值得 信赖 ， 但 这 里 需要 信任 Active Directory 系统 管理 员 。 

WindowsIdentity 派生 自 基 类 ClaimsIdentity， 提供 了 几 个 方法 来 检查 声称 ,或 检索 特定 的 声称 。 为 了 测试 声 
称 是 否 可 用 ， 可 以 使 用 HasClaim 方法 : 


bool hasName = laentlItYy-HasClalm(c => c.Type == ClaimTypes.Name); 


564 | 第 中 部 分 .NET Core 与 Windows Runtime 


要 检索 特定 的 声称 ，FindAll 方法 需要 一 个 谓词 来 定义 匹配 : 


Var groupClaims = identity.FindAll l(c => c.Type == ClaimTypes.Groupsid); 


注意 : 
声称 类 型 可 以 是 一 个 简单 的 字符 串 ， 例 如 前 面 使 用 的 "Age" 类 型 。ClaimType 定义 了 一 组 已 知 的 类 型 ， 例 如 
Country、Email、Name、MobilePhone、UserData、Sumame、PostalCode 等 。 


24.3 ”加 密 数 据 


机 密 数 据 应 得 到 保护 ， 从 而 使 未 授权 的 用 户 不 能 读 取 它们 。 这 对 于 在 网 络 中 发 送 的 数据 或 存储 的 数据 都 有 
效 。 可 以 用 对 称 或 不 对 称 密 钥 来 加 密 这 些 数 据 。 

通过 对 称 密 钥 ,可 以 使 用 同一 个 密 钥 进行 加 密 和 人 解密。 与 不 对 称 的 加 密 相 比 ， 加 密 和 解密 使 用 不 同 的 密 钥 : 
公 钥 / 私 钥 。 如 果 使 用 一 个 公 钥 进行 加 密 ， 就 应 使 用 对 应 的 私 钥 进 行 解密 ， 而 不 是 使 用 公 钥 解密 。 同 样 ， 如 果 使 
用 一 个 私 钥 加 密 ， 就 应 使 用 对 应 的 公 钥 解密 ， 而 不 是 使 用 私 钥 解 密 。 不 可 能 从 私 钥 中 计算 出 公 钥 ， 也 不 可 能 
公 钥 中 计算 出 私 钥 。 

公 和 钥 / 私 钥 总 是 成 对 创建 。 公 和 钥 可 以 由 任何 人 使 用 ， 它 甚至 可 以 放 在 Web 站 点 上 ， 但 私 钥 必须 安全 地 加 锁 。 
为 了 说 明 加 密 过 程 ， 下 面 看 看 使 用 公 钥 和 私 钥 的 例子 。 

如 果 Alice 给 Bob 发 了 一 封 电子 邮件 ， 如 图 24-1 所 示 ， 并 且 Alice 希望 能 保证 除了 Bob 外 ， 其 他 人 都 不 能 
阅读 该 邮件 ， 那 么 她 就 使 用 Bob 的 公 钥 。 邮 件 是 使 用 Bob 的 公 钥 加 密 的 。Bob 打开 该 邮件 ， 并 使 用 他 秘密 存 
储 的 私 钥 解密 。 这 种 方式 可 以 保证 除了 Bob 外 ， 其 他 人 都 不 能 阅读 Alice 的 邮件 。 


Alice 


A 
~ 


人 人 


Eve 


24-1 


但 这 还 有 一 个 问题 : Bob 不 能 确保 邮件 是 Alice 发 送 来 的 。Eve 可 以 使 用 Bob 的 公 钥 加 蜜 发送 给 Bob 的 
邮件 并 假装 是 Alice。 我 们 使 用 公 钥 / 私 钥 把 这 条 规则 扩展 一 下 。 下 面 再 次 从 Alice 给 Bob 发 送 电子 邮件 开始 。 
在 Alice 使 用 Bob 的 公 和 钥 加 密 邮 件 之 前 ， 她 添加 了 目 己 的 签名 ， 再 使 用 目 己 的 私 钥 加 密 该 签名 。 然 后 使 用 Bob 
的 公 和 钥 加 密 邮 件 。 这 样 就 保证 除 Bob 外 ， 其 他 人 都 不 能 阅读 该 邮件 。 在 Bob 解密 邮件 时 ， 他 检测 到 一 个 加 密 
的 签名 。 这 个 签名 可 以 使 用 Alice 的 公 钥 来 解密 。 而 Bob 可 以 访问 Alice 的 公 和 钥 ， 因 为 这 个 密 钥 是 公 钥 。 在 解 
密 了 签名 后 ，Bob 就 可 以 确定 是 Alice 发 送 了 电子 邮件 。 

使 用 对 称 密 钥 的 加 密 和 人 解密 算法 比 使 用 非 对 称 密 钥 的 算法 快 得 多 。 对 称 密 钥 的 问题 是 帘 钥 必须 以 安全 的 方 
式 互 换 。 在 网 络 通 信 中 ， 一 种 方式 是 先 使 用 非 对 称 的 密 钥 进行 密 钥 互 换 ， 再 使 用 对 称 密 钥 加 密 通 过 网 络 发 送 的 
数据 。 

.NET 在 System.Security.Cryptography 名 称 空 间 中 包含 用 于 加 密 的 类 。 它 实现 了 几 个 对 称 算法 和 非 对 称 算法 。 
有 几 个 不 同 的 算法 类 用 于 不 同 的 目的 。 一些 类 以 Cng 作 为 前 缀 或 后 级 。CNG 是 Cryptography Next Generation 的 简 
称 ， 是 本 机 Windows Crypto API 的 更 新 版 本 ， 这 个 API 可 以 使 用 基于 提供 程序 的 模型 ， 编 写 独立 于 算法 的 程序 。 
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表 24-1 列 出 了 System.Security.Cryptography 名 称 空间 中 的 加 密 类 及 其 功能 。 没 有 Cng、Managed 或 
CryptoServiceProvider 后 级 的 类 是 抽象 基 类 ， 如 MD5。Managed 后 缀 表示 这 个 算法 用 托管 代码 实现 ， 其 他 类 可 


能 封装 了 本 地 Windows API 调用 。CryptoServiceProvider 后 缀 用 于 实现 了 抽象 基 类 的 类 ，Cng 后 组 用 于 利用 新 


CIyptography CNG API 的 类 。 


关 别 | 类 


表 24-1 


散 列 MD5 散 列 算法 的 目标 是 从 任意 长 度 的 二 进 制 字 符 串 中 创建 一 个 长 
SHA1 度 固定 的 散 列 值 。 这 些 算法 和 数字 签名 一 起 用 于 保证 数据 的 完 
SHA1Managed 整 性 。 如 果 再 次 散 列 相同 的 二 进 制 字符 串 ， 会 返回 相同 的 散 列 
SHA256 结果 。MDS(Message Digest Algorithm 5， 消 息 摘要 算法 5) 由 
SHA256Managed RSA 实验 室 开 发 ， 比 SHA1 快 。SHA1 在 抵御 暴力 攻击 方面 
SHA256Cng 比较 强大 。SHA 算法 由 美国 国家 安全 局 (NSA) 设 计 。MDS5 使 
SHA384 用 128 位 的 散 列 长 度 ，SHA1 使 用 160 位 。 其 他 SHA 算法 在 其 
SHA384Managed 名 称 中 包含 了 散 列 长 度 。SHAS12 是 这 些 算法 中 最 强大 的 ， 其 散 
SHAS12 列 长 度 为 512 位 ， 它 也 是 最 慢 的 
SHAS12Managed 

对 称 DES DESCryptoServiceProvider 对 称 密 钥 算法 使 用 相同 的 密 钥 进行 数据 的 加 密 和 人 解密。 现在 认 
TripleDESTripleDESCryptoServiceProvider | 为 DES(Data Encryption Standard， 数 据 加 密 标准 ) 是 不 安全 的 ， 
AesAesCryptoServiceProvider 因为 它 只 使 用 56 位 的 密 钥 长 度 ， 可 以 在 不 超过 24 小 时 的 时 间 
AesManaged RC2 内 破解 。Triple-DES 是 DES 的 继承 者 ， 其 密 钥 长 度 是 168 位 ， 
RC2CryptoServiceProvider 但 它 提供 的 有 效 安 全 性 只 有 112 位 。AES(Advanced Encryption 
RijandelRijandelManaged standard， 高 级 加 密 标 准 ) 的 密 钥 长 度 是 128、192 或 256 位 。 

Rijandel 非常 类 似 于 AES,， 它 只 是 在 密 钥 长 度 方面 的 选项 较 多 。 
AES 是 美国 政府 采用 的 加 密 标 准 
非 对 称 DSA 非 对 称 算法 使 用 不 同 的 密 钥 进行 加 密 和 解密 。RSA(Rivest， 


DSACryptoServiceProvider 
ECDsa 

ECDsaCnge 
ECDitfieHellman 


ECDiffieHellmanCne 


RSA 
RSACryptoServiceProvider 
RSACng 


Shamir，Adleman) 是 第 一 个 用 于 签名 和 加 密 的 算法 。 这 个 算法 
广泛 用 于 电子 商务 协议 。RSACng 是 NET 4.6 和 NET Core 的 
一 个 新 类 ， 基 于 Cryptography Next Generation (CNG) 实 现 方 式 。 
DSA(Digital Signature Algorithm， 数 字 等 名 算法 ) 是 用 于 数字 签 
名 的 一 个 美国 联邦 政府 标准 。ECDSA(Elliptic Curve DSA, 椭圆 
曲线 数字 签名 算法 ) 和 EC Diffie-Hellman 使 用 基于 椭圆 曲线 组 
的 算法 。 这 些 算 法 比较 安全 ， 且 使 用 较 短 的 密 钥 长 度 。 例 如 ， 
DSA 的 密 钥 长 度 为 1024 位 ， 其 安全 性 类 似 于 ECDSA 的 160 
位 。 因 此 ，ECDSA 比较 快 。EC Diffe-Hellman 算法 用 于 以 安全 
的 方式 在 公共 信道 中 交换 私 钥 


下 面 用 例子 说 明 如 何 通 过 编程 使 用 这 些 算法 。 


注意 : 

带 有 Cng 前 组 或 后 级 ( 属于 Windows Cryptography Next Generation CNG ) 的 所 有 类 仅 在 Windows 上 得 到 
支持 ， 不 能 在 Linux 或 Mac 上 运行 。 这 些 API 在 Linux 上 会 抛 出 PlatformNotSupportedException 异常 。 
24.3.1 创建 和 验证 签名 


第 一 个 例子 说 明了 如 何 使 用 ECDSA 算法 进行 签名 。Alice 创建 了 一 个 签名 ， 它 用 Alice 的 私 钥 加 密 ， 可 以 
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使 用 Alice 的 会 钥 访问 。 因 此 保证 该 签名 来 和 目 Alice。 
SigningDemo 示例 代码 使 用 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.Security.Cryptoeraphy.Cnge 
名 称 空间 
System 
System.Security.Cryptoeraphy 
System. [ext 
首先 ， 看 看 Main0 方 法 中 的 主要 步骤 ， 创 建 Alice 的 密 钥 ， 给 字符 串 “Alice” 签 名 ， 最 后 使 用 公 钥 验证 该 
签名 是 否 来 自 Alice。 要 签名 的 消息 使 用 Encoding 类 转换 为 一 个 字 节 数组 。 要 把 加 密 的 签名 写 入 控制 台 ， 包 含 
该 签名 的 字 节 数组 应 使 用 Convert.ToBase64Strine0 方 法 转换 为 一 个 字符 串 (代码 文件 SigningDemo/Program.cs)。 


private CngKey aliceKeySignature; 
private byte[l] alicePubKeyBlob; 


static void Main{() 

{ 
Var pp = new Program(}); 
PpP-.Run(); 

} 


Public void Run{() 
{ 
InNnitAliceRKeys(); 
byte[] aliceData = Encoding.UTFS3.GetBytes ("Alice™); 
byte[] aliceSignature = CreateSignature (aliceData, aliceKRKeySignature),; 
Console.WriteLine($"Alice created signature: ™ + 
ss"{Convert.ToBase64Sstring (aliceSignature) }"); 
if (VerifySignature(aliceData, aliceSignature, alicePubKeyBlob)) 
| 
Console.WriteLine("Alice signature verified successfully"); 
} 
} 


注意 : 
千 万 不 要 使 用 Encoding 类 把 加 密 的 数据 转换 为 字符 串 。Encoding 类 验证 和 转换 Unicode 不 允许 使 用 的 无 效 
值 ， 因 此 把 字符 串 转换 回 字 节 数组 会 得 到 另 一 个 结果 。 


InitAliceKeys0 方 法 为 Alice 创建 新 的 密 钥 对 。 因 为 这 个 密 钥 对 存储 在 一 个 静态 字段 中 ， 所 以 可 以 从 其 他 方 
法 中 访问 它 。CngKey 类 的 Create0 方 法 把 该 算法 作为 一 个 参数 ， 为 算法 定义 密 钥 对 。 通 过 Export0 方 法 ， 导 出 
密 钥 对 中 的 公 钥 。 这 个 公 钥 可 以 提供 给 Bob， 来 验证 签名 。Alice 保留 其 私 钥 。 除 了 使 用 CngKey 类 创建 密 钥 对 
之 外 ， 还 可 以 打开 存储 在 密 钥 存储 器 中 的 已 有 密 钥 。 通 党 Alice 在 其 私有 存储 器 中 有 一 个 证 书 ， 其 中 包含 了 一 
个 密 钥 对 ， 该 存储 器 可 以 用 CngKey.Open0 方 法 访问 。 


private Vol InitAliceRKeys () 


{ 


aliceKeySignature = CngKey.Create (CngAlgorithm.ECDsaPS21); 
alicePubKeyBlob = 
aliceKeySignature.Export (CngKeyBlobFormat .GenericPublicBlob).; 
} 


有 了 密 钥 对 ，Alice 就 可 以 使 用 ECDsaCng 类 创建 签名 了 。 这 个 类 的 构造 函数 从 Alice 那里 接收 包含 公 钥 和 
私 钥 的 CngKey 类 。 再 使 用 私 钥 ， 通 过 SignData0 方 法 给 数据 签名 : 
Public byte[] CreateSignature (byte[] data, CngKey KeY) 


byte[] signature; 
USing {var signingAlg = new ECDsaCng (key)) 
{ 


signature = signingAlg.SsignDatat(data, HashAlgorithmName.SsHAS12);} 
signingAlg.cClear ()，; 


return signature; 


} 
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要 验证 签名 是 否 来 目 于 Alice，Bob 使 用 Alice 的 公 钥 检查 签名 。 包含 公 钥 blob 的 字 节 数组 可 以 用 静态 方法 
Import0 导 入 CngKey 对 象 。 然 后 使 用 ECDsaCng 类 ， 调 用 VerifyData0 方 法 来 验证 签名 。 
public bool VerifySignature (byte[] data, bytel[] signature, byte[] PubpEKeY) 
{ 
bool TetValue = false; 
uUSing (CngKey key = CngKey.Import (pubRey, CngKeyBlobFormat .GenericPublicBlob)) 
usSing (var SigningAlg = new ECDsaCng (key)) 


retValue = signingAlg.VverifyData (data, signature, HashAlgorithmName .SHA512) ; 
signingAlg.cClear (}); 


return retVvalue; 


24.3.2 ”实现 安全 的 数据 交换 


下 一 个 例子 帮助 解释 公 和 钥 / 私 钥 的 原则 ， 在 两 个 团体 之 间 交 换 机 密 数 据 ， 用 对 称 密 钥 通信 。 它 使 用 EC 
Diffie-Hellman 算法 在 两 个 团体 之 间 交 换 机 密 数 据 。 这 个 算法 允许 仅 使 用 公 钥 和 私 钥 来 交换 机 密 数 据 , 在 两 个 团 
体 之 间 交 换 公 和 钥 。 编写 本 书 时 , 这 个 算法 的 实现 代码 还 不 能 用 于 .NET Core, 只 能 用 于 运行 在 Windows 上 的 NET 
Framework。 在 应 用 程序 中 ， 一 般 不 需要 实现 这 个 功能 ， 因 为 基础 架构 服务 已 经 提供 了 它 。 


注意 : 
编写 本 书 时 ，NET Core 仅 包含 ECDiffieHellman 抽象 基 类 ， 实 现代 码 可 以 使 用 它 创建 具体 的 类 。 目 前 还 没 
有 具体 的 类 ， 所 以 这 个 示例 仅 使 用 NET 4.7.1. 


SecureTransfer 示例 应 用 程序 的 目标 框架 设置 为 net471， 使 用 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.Security.Cryptoeraphy.Algorithms 
System.Securty.Cryptoeraphy.Cneg 
System.Securlity.Cryptoeraphy.Csp 
System.Security.Cryptoeraphy.Prinmitives 
名 称 空间 
System 
System.IO 
System.Security.Cryptoeraphy 
System. Text 
System.Threadine.Tasks 
Main0 方 法 包含 了 其 主要 功能 。Alice 创建 了 一 条 加 密 的 消 轧 ， 并 把 它 发 送 给 Bob。 在 此 之 前 ， 要 先 为 Alice 
和 了 Bob 创建 密 铀 对 .Bob 只 能 访问 Alice 的 公 钥 ,Alice 也 只 能 访问 Bob 的 公 钥 (代码 文件 SecureTransfer/Program.cs)。 


private CngKey aliceFKey; 
private CngFKey bobFRKey; 

private byte[] alicePubKeyBlob; 
private byte[] bobPubKeyBlob; 


static async Task Main{) 
{ 
var p = new Programl(); 
await p.RunAsync '(); 
Console.ReadLine (); 


} 


public async Task RunAsync() 
{ 
try 
{ 
CreateRKeys (); 
byte[] encrytpedData = 
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await AliceSendsDataAsync("This is a Secret message for Bob").; 
awalt BobRecelilvesDatanAsync (encrytpedData),; 
} 
catch (Exception ex) 
{ 
Console.WriteLine (ex.Message),; 
} 
} 


在 CreateKeys0 方 法 的 实现 代码 中 ， 使 用 EC Diffie-Hellman 512 算法 创建 密 钥 。 


Public void CreateKeys() 

{ 
aliceKey = CngKey.Create (CngAlgorithm.ECDiffieHellmanP521).; 
bobFey = CngKey.Create (CngAlgorithm.ECDiffieHellmanP521); 
alicePubKeyBlob = aliceKey .Export (CngKeyBlobFormat .EccPublicBl1ob); 
bobPubKeyBlob = bobKey .Export (CngKeyBlobFormat .EccPublicBlob); 

} 


在 AliceSendsDataAsync(0 方 法 中 ， 包 含 文本 字符 的 字符 串 使 用 Encoding 类 转换 为 一 个 字 节 数组 。 创建 一 个 
ECDiffieHellmanCng 对 象 ， 用 Alice 的 密 钥 对 初始 化 它 。Alice 调用 DeriveKeyMaterial0 方 法 ， 从 而 使 用 其 密 铂 
对 和 Bob 的 公 钥 创建 一 个 对 称 密 钥 。 返 回 的 对 称 密 钥 使 用 对 称 算法 AES 加 密 数 据 。AesCryptoServiceProvider 
需要 密 钥 和 一 个 初始 化 矢量 IV)。IV 从 GenerateIV0 方 法 中 动态 生成 ， 对 称 密 钥 用 EC Diffie-Hellman 算法 交换 ， 
但 还 必须 交换 IV。 从 安全 性 角度 来 看 , 在 网 络 上 传输 未 加 密 的 IV 是 可 行 的 一 一 只 是 密 钥 交换 必须 是 安全 的 。 IV 
存储 为 内 存 流 中 的 第 一 项 内 容 ， 其 后 是 加 密 的 数据 ， 其 中 ，CryptoStream 类 使 用 AesCryptoServiceProvider 类 创 
建 的 encryptor。 在 访问 内 存 流 中 的 加 密 数 据 之 前 ， 必 须 关 闭 加 密 流 。 否 则 ， 加 密 数 据 就 会 丢失 最 后 的 位 。 


Public async Task<byte[]> AliceSendsDataAsync (string message) 
{ 
Console .WriteLine($"Alice sends message: {messagel}™"™); 
byte[] rawData = Encoding.UTF38.GetBytes (message); 
byte[] encryptedData = null; 
USing (Var aliceAlgorithm = new ECDiffieHellmanCng (aliceKey)) 
USing (CnoKeYy bobPubRey = CngKey.Import (bobPubKeyBlob., 
CngKeyBlobFormat .EccPublicBlob)) 
| 
byte[] symmRey = aliceAlgorithm.DeriveKeyMaterial (bobPubRey); 
Console.WriteLine ("Alice creates this symmetric key with ™+ 
5"Bobs public key information: {Convert.ToBase64Sstring (symmRey) }"); 
US1InNng (Var aes = new MesCryptoServiceProvider()) 
{ 
aes.Key = SYMTMReY: 
已 人 号 .GenerateIV(); 


using (ICryptoTransform encryptor = aes.CreateEncryptor()})) 
usSing (Var ms = new MemorySsStream!()) 
{ 
// create Cryptostream and encrypt data to send 
using (Var cs = new Cryptostream(ms, encryptor, 
CryptostreamMode .Write})) 
{ 


// write initialization Vector not encrypted 
awalit ms.WriteAsyncl(laes.IV, 0, aes.IV.Length); 
Cs.Write (rawData, 0, rawData.Length); 
} 
encrypbtedData = ms.ToArray (}); 
} 
aes.Clear(); 
} 
} 
Console.WriteLine ("Alice: message is encrypted: "十 
ss"{Convert.ToBase64string (encryptedData) }");} 
Console .WriteLine (); 
return encryptedData; 


} 

Bob 从 BobReceivesDataAsync0 方 法 的 参数 中 接收 加 蜜 数据 。 首 先 ， 必 须 读 取 未 加 密 的 初始 化 天 量 。 
AesCryptoServiceProvider 类 的 BlockSize 属性 返回 块 的 位 数 。 位 数 除 以 8， 就 可 以 计算 出 字 节 数 。 最 快 的 方式 是 
把 数据 右 移 3 位 。 右 移 1 位 就 是 除 以 2， 碳 移 2 位 就 是 除 以 4， 右 移 3 位 就 是 除 以 8。 在 for 循环 中 ， 包 售 未 加 
密 IV 的 原 字 节 的 前 几 个 字 节 写 入 数组 iv 中 。 接 着 用 Bob 的 密 钥 对 实例 化 一 个 ECDiffieHellmanCng 对 象 。 使 用 
Alice 的 公 和 钥 ， 从 DeriveKeyMaterial0 方 法 返回 对 称 密 钥 。 
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比较 Alice 和 Bob 创建 的 对 称 密 钥 ， 可 以 看 出 所 创建 的 密 钥 值 相同 。 使 用 这 个 对 称 密 钥 和 初始 化 天 量 ， 来 


自 Alice 的 消息 就 可 以 用 AesCryptoServiceProvider 类 解密 。 


public async Task BobRecelVesDataasvync (byte[] emncIYptedData) 
{ 
Console.WriteLine ("Bob receives encrypted data™); 
byte[] rawData = null; 
Var aes = Nnew AesCryptoServiceProvider (); 
int nBytes = aes.BlockSize 3; 
byte[] iv = new bytel[lnBytes]; 
for {int i = 0; i < iv.Length; I++) 
{ 
iv[il] = encryptedDatal[il]; 
} 
uSing (Var bobAlgorithm = new ECDiffijeHellmanCng (bobKey)) 
uSing (CngKey alicePubRKey = CngKey. Import (alicePubReyBlob, 
CngKeyBlobFormat .EccPubl1icB1ob)) 
{ 
byte[] symmRey = bobAlgorithm.DeriveKeyMaterial (alicePubKey); 
Console.WriteLine("Bob creates this symmetric key With ™ + 
Ss"Alices public key information: {Convert.ToBase64string (symmRey) }"); 
aes.Key = symmRey; 
aES.IV = iv; 
using (ICryptoTransform decryptor = aes.CreateDecryptor(})) 
usSing (MemorYyStream ms = new MemoryStIream() ) 
{ 
using (var cs = new Cryptostream(ms, decryptor, CryptostreamMode .Write)) 
{ 
await cs.WriteAsync (encryptedData, nBytes, 
encryptedData.Length 一 nBytes); 
} 
rawData = ms.ToArray(}); 
Console .WriteLine ("Bob decrypts message to: ™+ 
ss"{Encoding.UTFS8.GetString (rawData) }"); 


aes.Cleart(); 


} 
} 


运行 应 用 程序 ， 会 在 控制 台 上 看 到 如 下 输出 。 来 自 Alice 的 消息 被 加 密 ，Bob 用 安全 交换 的 对 称 密 钥 解密 。 


Alice sends message: this is a secret message for Bob 

Alice creates this symmetric key with Bobs public key information: 
q4D182m7lyev9Nlp6éfOav2Jvc0+LmHFSZEJjXW1Ol1I3Y= 

Alice: message 1i5s encrypted: WbpOxvUoOWHSXY31lwC8aXcDWeDUWabzaSObfGcQCpPK1ixzl1TJ9exb 
tkFSHPp2WPSZWL9IV9N1 3toBgThg]j PbrVzN2A== 

Bob receives encrypted data 

Bob creates this symmetric key with Alices public key information: 
dq4D182m7lyev9Nlp6fOav2Jvc0+LmHFSZEjJXW1Ol1I3Y= 

Bob decrypts message to: this is a secret message for Bob 


24.3.3 使 用 RSA 签名 和 散 列 


一 个 新 的 加 密 算 法 类 是 RSACng。RSA( 这 个 名 字 来 目 于 算法 设计 者 Ron Rivest、Adi Shamir 和 Leonard 
Adlermam) 是 一 个 广泛 使 用 的 非 对 称 算法 。RSA 算法 已 经 可 用 于 NET、RSA 和 RSACryptoServiceProvider 类 ， 


RSACng 类 基于 CNG API， 其 用 法 类 似 于 先前 使 用 的 ECDSACng 类 。 


对 于 本 节 所 示 的 示例 应 用 程序 ，Alice 创建 一 个 文档 ， 散 列 它 ， 以 确保 它 不 会 改变 ,给 它 加 上 签名 ,保证 是 


Alice 生成 了 文档 。Bob 接收 文件 ， 并 检查 Alice 的 担保 ， 以 确保 文件 没有 被 算 改 。 
RSA 示例 代码 使 用 了 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.Security.Cryptoeraphy.Cne 
名 称 空间 
System 
System.TO 
System.LInq 
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构造 应 用 程序 的 Main0 方 法 ,开始 Alice 的 任务 ,调用 方法 AliceTasks0， 来 创建 一 个 文档 、 散 列 码 和 签名 。 
然后 把 这 些 信息 传递 给 Bob 的 任务 ， 调 用 方法 BobTasks0( 代 码 文件 RSASample/Program.cs): 


class Program 

{ 
private CngFey aliceKey; 
private byte[] alicePubFKeyBlob; 


static woid Main{() 

{ 
Var p = new Program(); 
DpD.Run(); 

} 


Public void Run() 
{ 
AliceTasks(out byte[] document, out byte[] hash, out byte[] signature); 
BobTasks (document, hash, signature); 
} 
a 
} 


方法 AliceTasks0O 首 先 创建 Alice 所 需 的 密 钥 ， 将 消息 转换 为 一 个 字 节 数组 ， 散 列 字 节 数组 ， 并 添加 一 个 
签名 : 
Public void AliceTasks (out byte[] data, out byte[] hash, out byte[] signature) 
{ 
InNnitAliceKeys(); 
data = Encoding .UTFS8.GetBytes ("Best greetings from Alice"™).; 
hash = HashDocument (data); 


signature = AddSsignatureToHash (hash, aliceFey); 
} 


与 之 前 一 样 ，Alice 所 需 的 密 钥 是 使 用 CngKey 类 创建 的 。 现 在 正在 使 用 RSA 算法 ， 把 CngAlgorithm.Rsa 
枚 举 值 传递 到 Create 方法 ， 来 创建 公 钥 和 私 钥 。 公 和 钥 只 提供 给 Bob， 所 以 公 钥 用 Export 方法 提取 : 

private void InitAliceReys () 

| aliceKey = CngKey.Create (CngAlgorithm.Rsa); 


alicePubKeyBlob = aliceRKey .Export (CngKeyBlobFormat .GenericPublicBlob); 
} 


从 Alice 的 任务 中 调用 HashDocument 方法 ， 为 文档 创建 一 个 散 列 码 。 散 列 码 使 用 一 个 散 列 算法 SHA384 
类 创建 。 不 管 文 档 有 多 长 ， 散 列 码 的 长 度 总 是 相同 。 再 次 为 相同 的 文档 创建 散 列 码 ， 会 得 到 相同 的 散 列 码 。Bob 
需要 在 文档 上 使 用 相同 的 算法 。 如 果 返 回 相 同 的 散 列 码 ， 就 说 明文 档 没 有 改变 。 


private byte[] HashDocument (byte[] data) 


{ 
USing (Var hashalg = SHA384.Create ()) 
{ 
return hashAlg.computeHash (data); 
} 
} 


添加 签名 ， 可 以 保证 文档 来 自 Alice。 在 这 里 ， 使 用 RSACng 类 给 散 列 签名 。Alice 的 CngKey( 包 括 公 钥 和 
私 钥 ) 传 递 给 RSACng 类 的 构造 函数 ， 签 名 通过 调用 SignHash 方法 创建 。 给 散 列 签名 时 ，SignHash 方法 需要 了 
解散 列 算法 ;HashAlgorithmName.SHA384 是 创建 散 列 所 使 用 的 算法 .此 外 , 需要 RSA 填充 .RSASignaturePadding 
枚 举 的 可 能 选项 是 Pss 和 Pkcsl: 

private byte[] addsigqnatureToHash (byte[] hash, CngKey key) 

using (var signingAlg = new RSACng (key)) 
byte[] signed = signingAlg.signHash(hash, 
HashAlgorithmName .SHA384, RSASiqgnaturePadding .Pss); 
return signed; 


} 
} 


Alice 散 列 并 签名 后 ，Bob 的 任务 可 以 在 BobTasks 方法 中 开始 。Bob 接收 文档 数据 、 散 列 码 和 签名 ， 他 使 
用 Alice 的 公 钥 。 首 先 ，Alice 的 会 钥 使 用 CngKey. Import 导入 ， 分 配给 aliceKey 变量 。 接 下 来 ，Bob 使 用 辅助 
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方法 IsSienatureValid 和 IDocumentUnchanged， 来 验证 签名 是 否 有 效 ， 文 档 是 否 不 变 。 只 有 在 两 个 条 件 是 true 
时 ， 文 档 才 写 入 控制 台 : 


public void BobTasks (byte[] data, byte[] hash, byte[] signature) 
{ 
CngKey alliceFKey = CngFEey.Import!( alicePubKeyBlob, 
CnogReyBlobFormat.GenericPublicBlob),;} 
1if (!IsSignatureValid(hash, signature, aliceKey)) 
{ 
Console.WriteLine("signature not valid™); 
return; 
} 
1IE (!IsDocumentUnchanged (hash, data)) 
{ 
Console.WriteLine ("document was changed™).; 
return; 
} 
Console.WriteLine ("signature valid, document unchanged"™); 
Console.WriteLine ($"document from Alice: {Encoding.UTF8.GetSsString (data) }"); 
} 


为 了 验证 签名 是 否 有 效 ， 使 用 Alice 的 公 钥 创建 RSACng 类 的 一 个 实例 。 通 过 这 个 类 ， 使 用 VerifyHash 方 
法 传递 散 列 、 签 名 、 早 些 时 候 使 用 的 算法 信息 。 现 在 Bob 知道 ， 信 息 来 自 Alice: 
private bool IssignatureValid (byte[] hash, byte[] signature, CngKey key) 
using (var signingAlg = new RSACng (key)) 
z return signingalg.VerifyHash (hash, signature, HashAlgorithmName .SHA384, 
RSASignaturePadding .Pss); 


} 
} 
为 了 验证 文档 数据 没有 改变 ，Bob 再 次 散 列 文件 ， 并 使 用 LINQ 扩展 方法 SequenceEqual， 验 证 散 列 码 是 否 
与 旱 些 时 候 发 送 的 相同 。 如 果 散 列 值 是 相同 的 ， 就 可 以 假定 文档 没有 改变 : 
private bool IsDocumentUnchanged (byte[] hash, byte[] data) 
| byte[] newHash = HashDocument (data}),; 


return newHash.SequenceEqual (hash):; 


} 
运行 应 用 程序 ， 输 出 如 下 。 调 试 应 用 程序 时 ， 可 以 在 Alice 散 列 后 修改 文档 数据 ，Bob 不 会 接受 更 改 的 文 
档 。 为 了 改变 文档 数据 ， 很 容易 在 调试 器 的 Watch 窗口 中 改变 值 。 


signature valid, document unchanged 
document from Alice: Best greetings from Alice 


24.4 ”保护 数据 


在 加 蜜 、 签 名 和 散 列 数据 之 后 ， 下 面 将 抽象 层 移动 到 更 高 的 位 置 。 本 节 将 讨论 数据 的 保护 一 一人 存储 对 安全 
性 敏感 的 数据 。 当 数据 与 Web 应 用 程序 一 起 使 用 时 ， 所 使 用 的 客户 问 是 不 可 信任 的 。 这 就 需要 使 用 数据 保护 
API 了 。 

男 一 种 需要 保护 的 数据 是 配置 数据 ,配置 数据 一 一 比如 SQL 连接 字符 串 (包括 用 户 名 和 密码 ) 或 AWS 或 微软 
Azure 的 访问 令 脾 一 一 不 应 该 放 在 公共 源 代 码 存 储 库 中 。 这 些 信息 很 容易 被 误 用 ,实际 上 ,机 器 人 被 用 来 在 GitHub 
的 会 共存 储 库 中 疏 行 ， 寻 找 密 钥 并 使 用 它们 ， 例 如 ， 运 转 虚 拟 机 来 存放 比特 币 。App Secrets 提供 了 一 种 方法 ， 
可 以 将 机 蜜 数据 存储 在 用 户 的 配置 文件 中 。 

这 些 技术 、 数 据 保 护 和 用 户 机 蜜 都 在 本 节 中 讨论 。 


24.4.1 实现 数据 保护 


在 NET Framework 中 ,名 称 空间 System.Security. DataProtection 包含 DpApiDataProtector 类 ， 而 这 个 类 包装 
了 本 机 Windows Data Protection API (DPAPT)。 这 些 类 基于 Windows， 并 不 提供 .NET Core 需要 的 灵活 性 和 功能 ， 
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所 以 ASPNET 团队 创建 了 Microsoft.AspNetCore.DataProtection 名 称 空间 中 的 类 。 
使 用 这 个 库 的 原因 是 为 日 后 的 检索 存储 可 信 的 信息 , 但 存储 媒体 (如 使 用 第 三 方 的 托管 环境 ) 不 能 信任 上 自己 ， 
所 以 信息 需要 加 密 存储 在 主机 上 。 
示例 应 用 程序 是 一 个 简单 的 控制 台 应 用 程序 (NET Core), 允许 使 用 数据 保护 功能 读 写 信息 。 在 这 个 示例 中 ， 
可 以 看 到 ASPNET 数据 保护 的 灵活 性 和 功能 。 
数据 保护 的 示例 代码 使 用 了 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Microsott.AspNetCore.DataProtection 
Microsott.Extensions.DependencyInjection 
名 称 空间 
Microsott.AspNetCore.DataProtection 
Microsott.Extensions.DependencyInjection 
System 
System.IO 
System.Ling 
使 用 -r 和 -w 命令 行 参数 ， 可 以 局 动 控制 台 应 用 程序 ， 读 写 存 储 占 。 此 外 ， 需 要 使 用 命令 行 ， 设 置 一 个 文件 
名 来 读 写 。 检 查 命令 行 参数 后 ， 通 过 调用 SetupDataProtection 辅助 方法 来 初始 化 数据 保护 。 这 个 方法 返回 一 个 
MySafe 类 型 的 对 象 ， 髓 入 IDataProtector。 之 后 ， 根 据 命令 行 参数 ， 调 用 Write 或 Read 方法 (代码 文件 
DataProtectionSample/Proeram.cs): 


Class Program 


{ 
private const String readOption = "一 工 " 7 
private const string WIILeOpt1Ion = "一 如 "7 
private readonly string[] options = { readoption, writeOption }; 
static void Main(string[] args) 
{ 
if (args.Length != 2 || args.Intersect (options) .Count () != 1) 
{ 
ShowUsage (}; 
IeEturnr 
} 


string fileName = args[1]; 
MySafe safe = SetupDataPprotection (}); 
switch (args[0]) 
{ 
Case writeoOption: 
Write(safe, fileName);} 
break:; 
Case readoOption: 
Read (safe, fileName); 


breaks; 
default: 
ShowUsage ty) 
break; 
} 
} 
mn 


} 

类 MySafe 有 一 个 IDataProtector 成 员 。 这 个 接口 定义 了 成 员 Protect 和 Unprotect， 来 加 密 和 解密 数据 。 这 
个 接口 定义 了 Protect 和 Unprotect 方法 , 这 些 方法 带 有 字 节 数组 参数 , 返回 字 节 数组 ,不 过 , 示例 代码 使 用 NuGet 
包 Microsoft.AspNetCore.DataProtection.Abstractions 中 定义 的 扩展 方法 ， 直 接 发 送 、 返 回来 自 Encrypt 和 Decrypt 
方法 的 字符 串 。MySafe 类 通过 依赖 注入 接收 IDataProtectionProvider 接口 。 有 了 这 个 接口 ， 传 递 目的 字符 串 ， 
返回 IDataProtector。 读 写 这 个 安全 时 ， 需 要 使 用 相同 的 字符 串 (代码 文件 DataProtectionSample/MySafe.cs): 

人 class MYSafe 


private IDataProtector protector; 
public MySafe (IDataProtectionProvider provider) => 
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_Protector = provider.CcreateProtector ("MySafe .MyProtection.v2"); 


Public string Encrypt (string input)} => protector.Protect (input); 
Public string Decrypt (string encrypted) => protector.Unprotect (encrypted); 
} 


在 SetupDataProtection 方法 中 ， 调 用 AddDataProtection 扩展 方法 ， 通 过 依赖 注入 添加 数据 保护 ， 并 配置 它 。 
AddDataProtection 方法 注册 默认 服务 ， 返 回 一 个 AddDataProtection， 它 可 进一步 使 用 流利 的 API， 配 置 数据 保护 。 
示例 代码 把 DirectoryInfo 实例 传递 给 PersistKeysToFileSystem 方法 ， 把 密 钥 保存 在 实际 的 目录 中 。 另 一 个 选择 是 
把 密 钥 保存 到 注册 表 (PersistKeysToRegistry) 中 ， 可 以 创建 目 己 的 方法 ， 把 密 钥 保存 在 定制 的 存储 中 。 所 创建 密 
钥 的 生命 周期 由 SetDefaultKeyLifetime 方法 定义 。 接 下 来 ， 密 钥 通 过 调用 ProtectKeysWithDpapi 来 保护 。 这 个 
方法 使 用 DPAPI 保护 密 钥 ， 加 密 与 当前 用 户 一 起 存储 的 密 钥 。ProtectKeysWithCertificate 允许 使 用 证 书 保护 密 
钥 。API 还 定义 了 UseEphemeralDataProtectionProvider 方法 ， 把 密 钥 存储 在 内 存 中 。 再 次 月 动 应 用 程序 时 ， 需 
要 生成 新 密 钥 。 这 个 功能 非常 适合 于 单元 测试 (代码 文件 DataProtectionSample/Program.cs): 


Public static MySafe SetupDataProtectlion() 
{ 
Var ServiceCollection = new ServiceCollection().; 
SeErviceCcollection.AddDataProtection()} 
.PersistKeysToFileSystem(new DirectoryInfo(™"..")) 
.SetDefaultKeyLifetime (TimeSpan.FromDays (20)) 
.ProtectKeysWithDpapl (}); 


ISeErviceProvider services = serviceCollection.BuildServiceProviderl):; 


return ActivatorUtilities.CreateInstance<MySafe> (services); 


} 


注意 : 
依赖 注入 参见 第 20 章 。 


现在 ， 实 现 了 数据 保护 应 用 程序 的 核心 ，Wirite 和 Read 方法 可 以 利用 MySafe， 加 密 和 解密 用 户 的 内 容 : 


Public static void Write{(MySafe safe, string fileName) 
{ 
Console.WriteLine ("enter content to write:™); 
string content = Console .ReadLine() ，; 
string encrypted = safe.Encrypt (content); 
File.WriteAllText (fileName, encrypted),; 
Console.WriteLine ($"content written to {fileName}"); 
} 
Public static void Read (MySafe safe, string fileName) 
{ 
string encrypted = File.ReadAllText (fileName).; 
string decrypted = safe.Decrypt (encrypted); 
Console.WriteLine (decrypted); 


} 
24.4.2 用户 机 密 


只 要 使 用 Windows 身份 验证 ,连接 字符 串 放 在 配置 文件 中 就 不 是 大 问题 。 使 用 连接 字符 串 存 储 用 户 名 和 密 
码 时 ， 将 连接 字符 串 添 加 到 配置 文件 ， 并 将 配置 文件 与 源 代码 存储 库 一 起 存储 可 能 是 一 个 大 问题 。 拥 有 一 个 公 
共存 储 库 ， 并 使 用 配置 存储 Amazon 或 Azure 密 钥 ， 可 能 会 很 快 导 致 损失 数 干 美元 。 黑 客 的 后 台 工 作 在 公开 的 
GitHub 库 中 搜索 ， 寻 找 Amazon 密 钥 来 劫持 账户 ， 并 创建 制造 比特 币 的 虚拟 机 。 访 问 https:/www.humankode. 
com/security/how-a-bug-in-visual-studio-2015-exposed-my-source-code-on-github-and-cost-me-6500-in-a-few-hours 来 了 
解 更 多 情况 。 

.NET Core 在 这 一 把 上 有 一 些 缓和 : 用 户 机 密 。 有 了 用 户 机 密 ， 配 置 就 不 会 存储 在 项 目的 配置 文件 中 ， 它 
存储 在 与 账户 相关 联 的 配置 文件 中 。 

用 尸 机 密 示例 代码 使 用 了 以 下 依赖 项 和 名 称 空间 : 

依赖 项 


Microsotft.Extensions.Confieuration 


574 | 第 中 部 分 .NET Core 与 Windows Runtime 


Microsott.Extensions.Confieuration.CommandLine 

Microsott.Extensions.Confieuration.EnvironmentVariables 

Microsott.Extensions.Confieuration.Json 

Microsott.Extensions.Confieuration.UserSecrets 

名 称 空间 

Microsott.Extensions.Confieuration 

System 

System.IO 

要 获得 domet CLI 工具 的 用 户 机 密 命 令 行 扩 展 ， 需 要 给 csproj 文件 添加 对 Microsoft.Extensions. 

SecretManager.Tools 的 引用 (项 目 文 件 UserSecretsSample/UserSecretsSample.csproj): 


<ItemGroup> 
<DotNetCliToolReference Include="Microsoft.Extensions.SecretManager.Tools" 
Version="2.0.0" /> 
</ItemGroup> 


此 外 ， 需 要 在 项 目 文件 中 向 UserSecretsId 元 素 添加 一 个 值 ， 来 定义 初始 ID( 项 目 文 件 
UserSecretsSample/UserSecretsSample.cspro]): 


<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp?2.0</TargetFramework> 
<UserSecretsId>UserSecretsSample-Id</UserSecretsId> 
</PropertyGroup> 


这 个 机 密 ID 只 需要 在 本 地 系统 上 是 唯一 的 ， 以 避免 混 消 来 自 不 同 项 目的 配置 值 。 因 此 ， 最 好 将 项 目 名 称 
包 舍 在 标识 符 中 。 

示例 应 用 程序 使 用 JSON 文件 中 的 配置 、 环 境 变 量 、 命 令 行 和 用 户 机 密 进 行 定 义 。 用 户 机 密 配 置 为 使 用 
ConfigurationBuilder 调用 扩展 方法 AddUserSecrets。 只 有 在 启用 了 调试 模式 的 情况 下 构建 应 用 程序 , 才 添 加 此 提供 
程序 。 请 记 住 ， 只 有 使 用 具有 用 户 机 密 的 用 户 配置 文件 运行 应 用 程序 ， 该 提供 程序 才 可 用 。AddUserSecrets 的 
重 载 方法 需要 把 用 户 机 密 ID 作为 参数 一 一 与 配置 使 用 的 标识 符 相 同 (代码 文件 UserSecretsSample/Program.cs): 


static void Main(string[] args) 
{ 
Var ConfigBuilder = new ConfigurationBuilder(}); 
configBuilder.SetBasePath (Directory.GetcCurrentDirectory () ) 
-AddJsonFile ("appsettings.json") 
.AddEnvironmentVariables () 
-AddCommandLine (args)}); 


#if DEBUG 
ConfigBuilder .AddUserSecrets("UserSecretsSample-Id"). 
#endif 
IConfigurationRoot configuration = configBuilder.Build(); 
Ee 
} 


注意 : 
第 30 章 介 绍 了 使 用 Microsoft Extensions.Configuration 进行 应 用 程序 配置 的 更 多 内 容 。 


使 用 JSON 配置 文件 appsettings.json， 写 入 键 NotASecret 的 值 。 当 项 目 添加 到 公共 源 代 码 存储 库 中 时 ， 该 
配置 文件 不 应 该 包含 敏感 的 配置 信息 (配置 文件 UserSecretsSample/appsettings.json): 
{ 


"NotASecret™: "this 1s not a secret™ 


} 
因为 SecretManager 工具 已 经 配置 了 项 目 文件 ， 所 以 可 以 使 用 dotnet 命令 行 工 具 来 设置 、 列 出 、 删 除 和 清 
除 机 密 。 下 面 的 命令 使 用 密 钥 Secretl 设置 机 密 : 


> dotnet user-secrets set Secretl "this 1s5 a Secret™ 
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使 用 dotnet user-secrets list 显示 所 有 用 户 的 机 密 ， 使 用 dotnet user-secrets clear 可 以 清除 所 有 用 户 的 机 蜜 。 

在 Windows 系统 上 , 用 户 机 密 存 储 在 文件 夹 %APPDATA%\microsoft\UserSecrets\ <userSecretsId>\secrets.json 
中 。 在 Linux 系统 上 ， 用 户 机 密 存 储 在 ~/.microsoft/~/usersecrets/<userSecretsId>/secrets.json 中 。 

要 读 取 配置 值 ， 无 论 配置 存储 在 何 处 ， 都 可 以 使 用 IConfigurationRoot 类 型 的 变量 。 使 用 索引 器 ， 可 以 读 取 
使 用 相应 键 存 储 的 值 ， 无 论 配 置 是 存储 在 JSON 文件 中 还 是 带 有 用 户 机 密 ( 代 码 文 件 UserSecretsSample/ 
Program.cs): 


string motaSecTretl = Conftligurat1on ["NMotaASecCTet" ] ; 
Console .WriteLine(s"not a secret: {notASecret1l1}").; 


string secretVvaluel = configuration["Secretl1"]; 
Console .WriteLine ($"secret: {secretValuel}"™); 


在 生产 系统 上 ， 存 储 用 户 机 密 的 私有 配置 文件 不 可 用 。 根 据 所 使 用 的 技术 ， 可 以 使 用 不 同 的 提供 程序 。 例 
如 , 通过 Azure App Services， 可 以 使 用 Azure 门户 指定 配置 ,并 使 用 环境 变量 检索 配置 。 还 可 以 使 用 Azure Key 
Vault 配置 提供 程序 从 Azure Key Vault 机 密 中 读 取 配置 。 


24.5 ”资源 的 访问 控制 


在 操作 系统 中 ， 资 源 ( 如 文件 和 注册 表 键 ， 以 及 命名 管道 的 句柄 ) 都 使 用 访问 控制 列表 (ACL) 来 保护 。 图 24-2 
显示 了 这 个 映射 的 结构 。 资 源 有 一 个 关联 的 安全 摘 述 符 。 安 全 描述 符 包 含 了 资源 拥有 者 的 信息 ， 并 引用 了 两 个 
访问 控制 列表 : 目 由 访问 控制 列表 (Discretionary Access Control List，DACL) 和 系统 访问 控制 列表 (System Access 
Control List，SACL)。DACL 用 来 确定 谁 有 访问 权 ; SACL 用 来 确定 安全 事件 日 志 的 审核 规则 。ACL 包含 一 个 
访问 控制 项 (Access Control Entries，ACE) 列 表 。ACE 包含 类 型 、 安 全 标识 符 和 权限 。 在 DACL 中 ，ACE 的 类 
型 可 以 是 允许 访问 或 拒绝 访问 。 可 以 用 文件 设置 和 获得 的 权限 是 创建 、 读 取 、 写 入 、 删 除 、 修 改 、 改 变 许可 和 
获得 拥有 权 。 

读 取 和 修改 访问 控制 的 类 在 System.Security AccessControl 名 称 空间 中 。 下 面 的 程序 说 明了 如 何 从 文件 中 读 
取 访 问 控 制 列 表 。 


图 24-2 


FileAccessControl 示例 应 用 程序 使 用 了 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
System.IO.FlleSystem 
System.IO.FileSystem.AccessControl 
名 称 空间 
System 
System.IO 
System.Security. AccessControl 
System.Security.Principal 
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警告 : 
访问 控制 API 只 能 用 于 Windows， 不 能 用 于 Linux 或 Mac。System.IO.FileSystem.AccessControl 4PT 是 
Windows 上 资源 管理 的 一 部 分 。 


FileStream 类 定义 了 GetAccessControl0 方 法 ， 该 方法 返回 一 个 FileSecurity 对 象 。FileSecurity 是 一 个 NET 关 ， 
它 表 示 文 件 的 安全 摘 述 符 。FileSecurity 类 派生 目 基 类 ObjectSecurity、CommonObjectSecurity、 NativeObjectSecurity 
和 FileSystemSecurity。 其 他 表示 安全 描述 符 的 类 有 CryptoKeySecurity、EventWaitHandleSecurity、MutexSecurity、 
RegistrySecurity、SemaphoreSecurity、PipeSecurity 和 ActiveDirectorySecurity。 上 所 有 这 些 对 象 都 可 以 使 用 访问 控 
制 列表 来 保护 。 一 般 情况 下 ， 对 应 的 .NET 类 定义 了 GetAccessControl0 方 法 ， 返 回 相 应 的 安全 类 ; 例如 ， 
Mutex.GetAccessControl0 方法 返回 一 个 MutexSecurity 类 ， PipeStream.GetAccessControl0 方法 返回 一 个 
PipeSecurity 类 。 

FileSecurity 类 定义 了 读 取 、 修 改 DACL 和 SACL 的 方法 。GetAccessRules0 方 法 以 Authorization- 
RuleCollection 类 的 形式 返回 DACL。 要 访问 SACL， 可 以 使 用 GetAuditRules 方法 。 

在 GetAccessRules0 方 法 中 ， 可 以 确定 是 否 应 使 用 继承 的 访问 规则 (不 仅仅 是 用 对 象 直接 定义 的 访问 规则 )。 
最 后 一 个 参数 定义 了 应 返回 的 安全 标识 符 的 类 型 。 这 个 类 型 必须 派生 目 基 类 IdentityReference。 可 能 的 类 型 有 
NTAccount 和 SecurityIdentifier。 这 两 个 类 都 表示 用 户 或 组 。 NITAccount 类 按 名 称 查 找 安全 对 象 ，SecurityIdentifier 
类 按 唯一 的 安全 标识 符 查 找 安全 对 象 。 

返回 的 AuthorizationRuleCollection 包含 AuthorizationRule 对 象 。AuthorizationRule 对 象 是 ACE 的 .NET 表 
示 。 在 这 里 的 例子 中 ， 因 为 访问 一 个 文件 ， 所 以 AuthorizationRule 对 象 可 以 强制 转换 为 FileSystemAccessRule 
类 型 。 在 其 他 资源 的 ACE 中 ， 人 存在 不 同 的 NET 表示 ， 例 如 MutexAccessRule 和 PipeAccessRule 。 在 
FileSystemAccessRule 类 中 ，AccessControlTVype、FileSystemRights 和 IdentityReference 属性 返回 ACE 的 相关 信 
恩 ( 代 码 文 件 FileAccessControl/Program.cs)。 


Class Program 
{ 
static void Malnl(striIngd[] args) 
| 
string filename = null; 
if (args.Length == 0) return; 
filename = args[0]; 
using (FileStream stream = File.0pen(lfilename, FileMode.Open)) 
{ 
FileSecurity securityDescriptor = stream.GetAccessControl (); 
AuthorizationRuleCollection rules = 
securityDescriptor.GetAccessRules (true, true, 
typeof (NTAccount)}) ); 
foreach (AuthorizationRule rule in rules) 
{ 
var fileRule = rule as FileSystemAccessRule; 
Console.WriteLine ($"Access type: {fileRule.AccessControlType}").; 
Console.WriteLine ($"Rights: {fileRule.FileSystemRights}").; 
Console.WriteLine($"Identity: {fileRule.IdentityReference.Value}"™); 
Console.WriteLine().; 
} 
} 
} 
} 


运行 应 用 程序 ， 并 传递 一 个 文件 名 ， 就 可 以 看 到 文件 的 访问 控制 列表 。 这 里 的 输出 列 出 了 管理 员 和 系统 的 
全 部 控制 权限 、 通 过 身份 验证 的 用 户 的 修改 权限 ， 以 及 属于 Users 组 的 所 有 用 户 的 读 取 和 执行 权限 。 


Bccess type: Allow 

Rights: FullControl 

Identity: BUILTIN\Administrators 
Access type: Allow 

Rights: FullControl 

Identity: NT AUTHORITY\SYSTEM 
Access tvype: Allow 

Rights: FUullControl 

Identity: BUILTIN\Administrators 
Access type: Allow 


第 24 章 安 全 性 | 577 


Rights: FullControl 
Identity: Theotherside\Christian 


设置 访问 权限 非常 类 似 于 读 取 访问 权限 。 要 设置 访问 权限 ， 几 个 可 以 得 到 保护 的 资源 类 提供 了 
SetAccessControl0 和 ModifyAccessControl0 方 法 。 这 里 的 示例 代码 调用 File 类 的 SetAccessControl0 方 法 ， 以 修 
改 文件 的 访问 控制 列表 。 给 这 个 方法 传递 一 个 FileSecurity 对 象 。FileSecurity 对 象 用 FileSystemAccessRule 对 象 
填充 。 这 里 列 出 的 访问 规则 拒绝 Sales 组 的 写 入 访问 权限 , 给 Everyone 组 提供 了 读 取 访问 权限 , 并 给 Developers 
组 提供 了 全 部 控制 权限 。 


注意 : 
只 有 定义 了 Windows 组 Sales 和 Developers， 这 个 程序 才能 在 系统 上 运行 。 可 以 修改 程序 ， 使 用 自己 环境 
下 的 可 用 组 。 


private void WIFILIteacl (string filename) 
var SalesIdentity = new NTAccount ("Sales"™); 
var developersIdentity = new NTACccount ("Developers"™),; 
var everyOoneIdentity = new NTACccount ("Everyone™); 
var SaleshAce = new FileSystemMAccessRule (salesIdentity, 
FileSystemRights.Write, AccessControlType.Deny).; 
Var everyonehAce = new FlleSystemAccessRule (everyOneIdentity, 
FileSystemRights.Read, AccessControlType.Allow); 
var developersAce = new FileSystemAccessRule (developersIdentity, 
FileSystemRights.FullControl, AccessControlType.Allow); 
Var SecurityDescriptor = new FileSecurity(); 
securityDescriptor.SetAccessRule (everyonence); 
SecurityDescriptor.SetAccessRule (developershce).,} 
SecurityDescriptor.SetAccessRule (salesAce),; 
File.SetAccessControl (filename, securityDescriptor),; 


} 


注意 : 
打开 Properties 窗口 ， 在 Windows 资源 管理 器 中 选择 一 个 文件 ， 选 择 Security 选项 卡 ， 列 出 访问 控制 列表 ， 
就 可 以 验证 访问 规则 。 


24.6 ”Web 安全 性 


对 于 允许 用 户 输入 的 应 用 程序 ，Web 应 用 程序 有 一 些 需 要 注意 的 特定 安全 问题 。 用 户 输 入 是 不 能 信任 的 。 
使 用 JavaScript 或 内 置 HIMLS 特性 在 客户 端 验证 输入 数据 只 是 为 了 方便 用 户 。 可 以 显示 错误 ， 而 不 同 服务 器 发 
出 额外 的 网 络 请 求 。 但 是 ， 客 户 端 是 不 能 信任 的 。 因 为 用 户 ( 黑 客 ) 可 以 拦截 HTTP 请 求 ， 发 出 不 同 的 请 求 ， 统 
过 HTML5 和 JavaScript 验证 。 

本 节 讨 论 Web 应 用 程序 的 常见 问题 ， 以 及 需要 注意 的 避免 这 些 问题 的 内 容 。 


注意 : 
本 节 使 用 的 是 ASPNET Core 和 ASP.NET MVC。 更 多 关于 这 些 技 术 的 信息 ， 请 阅读 第 30 章 。 


24.6.1 编码 


千 万 不 要 相信 用 户 输入 。 将 用 户 信息 写 入 数据 库 ， 并 将 这 些 信息 显示 在 网 站 上 ， 是 黑客 攻击 的 典型 原因 。 
例如 ， 社 区 网 站 在 主页 上 显示 了 最 近 的 5 个 新 用 户 。 其 中 一 个 新 用 户 设法 同 用 户 名 添加 了 一 个 脚本 ， 该 脚本 重 
定 问 到 一 个 恶意 网 站 上 。 因 为 用 户 信 息 显 示 给 每 个 访问 该 站 点 的 用 户 ， 所 以 每 个 用 尸 都 被 重 定 问 。 

下 一 个 例子 说 明了 模拟 和 避免 这 种 行为 是 多 么 容易 。 在 下 面 的 代码 片段 中 ，/echo URL 映射 到 一 个 应 答 ， 
该 应 答 返 回 用 户 输入 ， 并 分 配给 x 参数， 然后 使 用 context,Response.WiiteAsync 发 送 啊 应 (代码 文件 
ASPNETCoreMVCSecurity/Startup.cs): 


app.Map("/echo", appl => 
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{ 
appl .Run (asvync context => 
{ 
string data = context.Request.Query["x"]; 
await context.Response.WriteAsync (data).; 
}); 
})5; 


现在 传递 请 求 : 

http://localhost:24897/echo?x=I'"'m a nice user 

字符 串 Tm a nice user 返回 到 浏览 器 。 这 并 不 是 那么 糟糕 ,但 是 用 户 的 运行 结果 可 能 不 一 样 。 例 如 ， 用 户 可 
以 输入 如 下 HTML 代码 : 

http://localhost:24897/echo?x=<hl>Is this wanted?</hl1> 

结果 显示 ， 输 入 字符 串 用 HTML HI1 标记 格式 化 。 用 户 可 以 通过 输入 JavaScript 代码 做 更 多 的 坏事 : 

localhost:24897/echo?x=<script>alert ("this is pbad");</script> 

在 大 多 数 浏览 器 中 ， 会 出 现 一 个 弹出 窗口 ， 用 户 在 其 中 输入 文本 。 如 果 用 Google Chrome 来 尝试 ， 可 以 用 
一 个 单独 的 指 施 来 避免 这 个 问题 。 该 浏览 器 显示 了 一 个 错误 页 面 This page isnt working， 和 附加 信息 
ERR BLOCKED BY XSS AUDITOR。 

如 果 试 图 检查 带 有 输入 的 <Script > 元 素 ， 而 在 这 种 情况 下 没有 返回 值 来 避免 这 个 问题 ， 就 可 能 会 失败 。 除 
了 使 用 <Script > 元 素 之 外 ， 也 可 以 给 尖 括 号 使 用 Unicode 数字 来 得 到 相同 的 结果 。 下 面 对 用 户 输入 进行 编码 ， 
使 其 不 被 浏览 器 解释 。 

可 以 从 名 称 空 间 System.Text.Encodings.Web 使 用 HIMLEncoder 类 来 编码 用 户 输 入 : 

app.Map ("/echoenc", appl => 

appl.Run (async context => 

string data = context.Request.Query["x"]; 
await context.Response.WriteAsync (HtmlEncoder .Default.Encode (data) ) ; 

Re | 

使 用 HtmlEncoder 类 时 ， 用 户 可 以 通过 <hl> 元 系 输 入 http://localhost:24897/echoenc?x<h1l>this gets 
converted</hl>。 因 此 ， 在 浏览 器 中 显示 <h1>this gets converted</ hl>。< 字 符 编 码 为 &lt:， 因 此 显示 为 文本 。 完 
整 的 编码 字符 串 为 : 

&lt;hlggt;this gets convertedglt; /hilgegt; 


类 似 地 ， 脚 本 元 素 会 被 转换 ， 不 会 以 脚本 的 形式 在 浏览 器 中 运行 。 


注意 : 

可 以 使 用 HtmlEncoder 类 来 允许 检查 特定 的 输入 一 一 例如 ， 可 能 允许 用 户 添加 <b> 元 素 。 可 以 使 用 
HtmlEncoder.Create 方法 通过 已 接受 的 输入 创建 编码 器 。 现 在 的 首选 方法 是 允许 用 户 使 用 Markdown 并 将 
Markdown 转换 为 HTML， 进行 一 些 格式 化 。 关 于 Markdown 的 博客 文章 可 以 在 https://csharp.christiannagel.comy/ 
2016/07/03/markdown/ 上 阅读 。 


到 目前 为 止 ， 示 例 代码 已 经 使 用 了 ASPNET Core 功能 。 直 接 从 ASPNET Core MVC 控制 器 或 视图 内 部 返 
回 一 个 字符 串 时 ， 编 码 是 默认 进行 的 。 需 要 进行 额外 的 投资 ， 以 避免 对 这 里 的 结果 进行 编码 。 

通过 ASPNET Core 控制 器 只 返回 一 个 字符 串 ， 会 得 到 一 个 编码 的 字符 串 ( 代 码 文件 
ASPNETCoreMVCSecurity/Controllers/HomeController.cs): 


Public string Echol(string x) 一 > xXx; 
要 发 送 未 编码 的 字符 串 ， 可 以 使 用 Controller 基 类 的 Content 方法 ， 并 指定 内 容 返 回 为 text/html: 
public IActionResult EchoUnencoded (string X) => Content (x, "text/html"); 


下 面 在 视图 中 进一步 使 用 Razor 代码 。 这 里 ，EchoWithView 方法 使 用 ViewBag.SampleData 把 用 户 的 输入 
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数据 传递 给 视图 (代码 文件 ASPNETCoreMVCSecurity/Controllers/HomeControll.cs): 


Public IActionResult EchoWithVview (string XxX) 


| 


} 


ViewBag.SampleData = XxX; 
return VIEWT) ; 


在 视图 中 ， 编 码 是 默认 进行 的 。 使 用 Razor 表达 式 @data 传递 输入 数据 。data 是 一 个 本 地 变量 ， 其 中 ， 指 
定 了 传递 的 ViewBag 人 信息。 为 了 不 使 用 编码 ， 使 用 Html 辅助 类 的 Raw 方法 (代码 文件 
ASPNETCoreMVCSecturnity/Views/Home/EchoWithView.cshtm]): 


昌 1{ 
string data = ViewBag.SampleData; 
} 
<dliv> 
this is encoded 
</div> 
<div>l@data</div> 
<br /> 
<dliv> 
This 1s not encoded 
</div> 
<dliv> 
@Html .Raw (Rdata) 
</div> 
注意 : 
当 显 式 向 客户 端 发 送 未 编码 数据 时 ， 需 要 确保 输入 是 可 信 的 一 一 例如 ，HTML 从 Markdown 转换 而 来 ， 而 
不 是 直接 返回 用 户 输入 。 
注意 : 


在 使 用 URL 字符 串 的 用 户 输入 时 ， 可 以 使 用 UrlEncoder 类 ， 这 类 似 于 使 用 用 户 输入 作为 HTML 内 容 时 使 
用 HtmlEncoder 类 的 方式 。 


24.6.2 SQL 注入 
Web 应 用 程序 的 另 一 个 常见 问题 是 SQL 注入 。 与 HTML 编码 一 样 ,使 用 内 置 的 功能 很 容易 避免 这 个 问题 。 
下 面 的 代码 片段 创建 了 一 个 SQL 字符 串 , 该 字符 串 直接 在 SqlSample 控制 器 方法 中 分 配 输入 参数 。 有 了 它 ， 
用 户 就 可 以 输入 :SELECT * FROM Table Users， 所 有 这 些 信息 都 显示 给 用 户 ;: 


Public IActionResult SqlSample (string id) 


| 


string connectionstring = GetConnectionstring ().; 
Var SqlConnection = new SqlConnection (connectionstring).; 


SqlCommand command = sgqlConnection.CreateCommand(}); 
// don't do this - string concatenation for SQL commands! 
command.cCcommandText = "SELECT * FROM Customers WHERE City = ”十 id; 


sdqlCconnection.open(});} 
using (SdqlDataReader reader = 
command.ExecuteReader (System.Data.CommandBehavior.CcloseConnection)) 
{ 
Var sb = new StringBuilder(); 
while lreader.Read()) 
{ 
for (int 1 = 0; 1 < reader.FieldCount; 1++) 
{ 
sb.Append (reader[1i]); 
} 
sb.AppendLine (}); 
} 
ViewBag.Data = sb.ToString(}); 
} 


return View{()}; 1} 


干 万 不 要 对 SQL 语句 使 用 字符 串 连接 。 相 反 ， 使 用 参数 或 隐 式 地 使 用 Entity Framework Core 参数 可 以 轻松 
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地 避免 这 个 问题 。 


注意 ;: 
使 用 SQL 命令 参见 第 25 章 。Entity Framework Core 参见 第 26 章 。 


24.6.3” 跨 站 点 请 求 伪造 


跨 站 点 请 求 伪 造 (Cross-Site Request Forgery，CSRE) 是 一 种 攻击 ， 恶 意 网 站 试图 在 用 户 不 知情 的 情况 下 重播 
用 户 并 输入 数据 。 

在 下 一 个 示例 中 ， 用 户 在 表格 中 输入 图 书信 息 。Book 是 一 个 包含 Tite 和 Publisher 属性 的 简单 模型 类 。 在 
HomeController 中 ，EditBook 方法 返回 一 个 视图 (代码 文件 ASPNETCoreMVCSecurity/Controllers/HomeController.cs): 

Public IActionResult EditBook() => View(); 

视图 定义 了 简单 的 输入 数据 ， 用户 可 以 在 其 中 输入 Title 和 Publisher 信息 ， 并 通过 HTTP POST 请 求 将 这 些 
信息 传递 给 服务 器 (代码 文件 ASPNETCoreMVCSecurity/Views/EditBook.cshtm]): 


[El 
ViewDatal["™Title"] = "EditBook™; 


} 
<h?2>Edit Book</h2> 


<form asp-controller="Home" asp-action="EditBook™" method="post"> 
<label for="title">Title:</label> 
<input type="text" id="title™" name 一 "七 七 em /> 
<br /> 
<label for="publisher">Publisher:</label> 
<input type="text"™" id="publisher™" name="publisher™ /> 
<DI /> 
<input type="submit™ value="Submit"™" /> 
</form> 


使 用 HTTP POST 请 求 ， 将 调用 下 面 的 EditBook 方法 ， 来 显示 带 有 输入 用 户 数 据 的 视图 (代码 文件 
ASPNETCoreMVCSecurity/Controllers/HomeController.cs): 


[HttpPost] 
Public IActionResult EditBook (Book book) => View("EditBookResult", book}); 


打开 URL http://localhost:24897/Home/EditBook， 运 行 应 用 程序 时 ， 可 以 输入 图 书信 息 ， 单 击 submit 按钮 ， 
从 控制 器 中 接收 信息 ， 图 书信 息 显示 在 视图 结果 中 。 
与 此 同时 ， 恶 意 网 站 只 需要 使 用 相同 的 链接 ， 以 自己 的 形式 发 布 数据 。 检 查 以 下 代码 片段 ， 其 中 的 表单 元 
素 引 用 了 与 以 前 相同 的 URL。 此 表单 托管 于 另 一 个 网 站 http//localhost:9817/dothis.html。 这 只 是 一 个 不 同 的 端口 ， 
但 也 可 以 是 不 同 的 域名 。 用 户 不 需要 在 表单 中 输入 任何 内 容 (输入 元 素 是 隐藏 的 ， 因 此 不 会 显示 给 用 户 )。 用 户 
只 需要 单 击 submit 按钮 ， 不 需要 知道 幕后 发 生 了 什么 不 同 的 事情 (代码 文件 HackingSite/wwwroot/dothis.htm)l): 
<h1>ClicKk this for a win!</hi> 
< 上 一 form has a redirect to the website being hacked 一 一 > 
<form action="http://localhost:24897/Home/EditBook™" method="post"> 
<input type="hidden™ value="bad book title"™" name="title™ /> 
<input type="hidden™" value="bad publisher™" name="publisher™ /> 


<input type="submit™ value="Click Now!™" /> 
</ form> 


单 击 这 个 链接 时 ， 恶 意 数据 会 以 用 户 的 名 义 传送 到 网 站 。 如 果 用 户 通 过 Book 网 站 进行 了 身份 验证 ， 并 且 
没有 注销 ， 数 据 就 以 用 户 的 名 义 提 交 ， 并 且 很 可 能 在 不 同 的 交付 地 址 下 了 一 些 订单 。 

为 了 避免 这 种 行为 ，ASPNET Core 提供 了 反 伪 造 令 牌 。 这 样 的 令 牌 需要 从 用 户 应 该 使 用 的 表单 中 创建 ， 以 
输入 有 效 数据 ， 并 在 接收 数据 时 进行 验证 。 

编辑 图 书 表单 现在 通过 HIML 辅助 方法 AntiForgeryToken 改 为 包含 该 令 牌 (代码 文件 
ASPNETCoreMVCSecurity/Views/EditBook.cshtml): 


<form asp-controller="Home" asp-action="EditBook™" method="post"> 
但 再 七 ml .AntiForgeryTIoken() 
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<label for="title">Title:</label> 
<input type="text" id="title"™" name="title™ /> 
<br /> 
<label for="publisher">Publisher:</label> 
<input type="text" id="publisher”" name="publisher™" /> 
<br /> 
<input type="submit" value="Submit™ /> 
</form> 


运行 应 用 程序 时 ， 可 以 看 到 一 个 隐藏 表单 字段 ， 其 中 包含 上 自动 生成 的 令 脾 。 当 检索 数据 时 ， 使 用 
ValidateAntiForgeryToken 属性 对 标记 进行 验证 (代码 文件 ASPNETCoreMVCSecurity/Controllers/HomeController.cs): 

[HttpPost] 

[ValidateAntiForgeryToken] 

Public IActionResult EditBook (Book book) => View ("EditBookResult™", book); 


现在 运行 恶意 网 站 时 ， 将 返回 啊 应 ， 而 不 接受 无 效 数据 。 


24.7 “小结 


本 章 讨论 了 与 ,NET 应 用 程序 相关 的 几 个 安全 性 方面 。 用 户 用 标识 和 主体 表示 ， 这 些 类 实现 了 IIdentity 和 
IPrincipal 接口 。 还 介绍 了 如 何 访问 标识 中 的 声称 。 

本 章 介 绍 了 加 密 方 法 , 说 明了 数据 的 签名 和 加 密 ， 以 安全 的 方式 交换 密 钥 。.NET 提供 了 对 称 加 密 算法 和 非 
对 称 加 密 算 法 ， 以 及 散 列 和 签名 。 

使 用 访问 控制 列表 还 可 以 读 取 和 修改 对 操作 系统 资源 (如 文件 ) 的 访问 权限 。ACL 的 编程 方式 与 安全 管道 、 
注册 表 键 、Active Directory 项 以 及 许多 其 他 操作 系统 资源 的 编程 方式 相同 。 

在 许多 情况 下 ， 可 以 在 较 高 的 抽象 级 别 上 处 理 安全 性 。 例 如 ， 使 用 HTTPS 访问 Web 服务 器 ， 在 后 台 交 换 
加 密 密 钥 。File 类 提供 了 Encrypt 方法 (使 用 NTFS 文件 系统 )， 轻 松 地 加 密 文 件 。 知 道 这 个 功能 如 何 发 挥 作用 也 
很 重要 。 

对 于 Web 应 用 程序 , 讨论 了 因为 信任 用 户 输入 而 导致 各 种 攻击 所 带 来 的 常见 问题 , 包括 跨 站 点 的 请 求 伪 造 ， 
也 探讨 了 如 何 使 用 编码 来 避免 各 种 问题 ， 如 何 使 用 反 伪 造 请 求 令 牌 来 避免 XSRF。 

接 下 来 的 两 章 使 用 数据 库 中 的 数据 ， 从 ADO.NET 开始 讨论 。 


ADO.NET 和 事务 


执行 命令 
ADONET 对 象 模型 
用 ADONET 完成 事务 
用 System.Transactions 管理 事务 
本 章 源 代码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 ADONET 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 ; 
® ConnectionSamples 


CommandSamples 


AsyncSamples 
TransactionSamples 


SystemlransactionSamples 


25.1 ADO.NET 概述 


本 章 讨论 如 何 使 用 ADO.NET 访问 C# 程 序 中 的 关系 数据 库 ， 例 如 SQL Server， 主 要 介绍 如 何 连接 数据 库 ， 
以 及 断 开 与 数据 库 的 连接 .如 何 使 用 查询 , 如 何 添加 和 更 新 记录 。 学 习 各 种 命令 对 象 选 项 , 了解 如 何 为 SQL Server 
提供 程序 类 提供 的 每 个 选项 使 用 命令 ; 如 何 通 过 命令 对 象 调 用 存储 过 程 ， 以 及 如 何 使 用 事务 。 

ADO.NET 之 前 使 用 OLEDB 和 ODBC 附带 了 不 同 的 数据 库 提 供 程序 ， 一 个 提供 程序 用 于 SQL Server; 男 
一 个 提供 程序 用 于 Oracle。OLEDB 技术 不 再 获得 支持 ， 所 以 这 个 提供 程序 不 应 该 用 于 新 的 应 用 程序 。 对 于 访 
问 Oracle 数据 库 , 微软 的 提供 程序 也 不 再 使 用 , 因为 来 自 Oracle(http://www.oracle.com/technetwork/topics/dotnet/) 
的 提供 程序 能 更 好 地 满足 需求 。 对 其 他 数据 源 (也 用 于 Oracle)， 有 许多 可 用 的 第 三 方 提供 程序 。 使 用 ODBC 提 
供 程 序 之 前 ， 应 该 给 所 访问 的 数据 源 使 用 专用 的 提供 程序 。 本 章 中 的 代码 示例 基于 SQL Server， 但 也 可 以 把 它 
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改 为 使 用 不 同 的 连接 和 命令 对 象 ， 如 访问 Oracle 数据 库 时 ， 使 用 OracleConnection 和 OracleCommand， 而 不 是 
使 用 SqlConnection 和 SqlCommand。 


注意 : 

本 章 不 介绍 把 表 放 在 内 存 中 的 DataSet， 尽 管 NET Core 2.0 支持 它们 。DataSet 允许 从 数据 库 中 检索 记录 ， 
并 把 内 容 存 储 在 内 存 的 数据 表 关 系 中 。 DataSet 在 .NET 的 早期 版 本 中 用 得 很 多 。 现 在 可 以 使 用 Entity Framework 
Core (EF Core ) ， 参 见 第 26 章 。 这 个 新 技术 允许 使 用 对 象 关 系 ， 而 不 是 使 用 基于 表 的 关系 。 


25.1.1 示例 数据 库 


本 章 的 示例 使 用 Books 数据 库 。 这 个 数据 库 的 备份 文件 位 于 CreateDatabase 目录 下 的 源 代 码 中 。 使 用 
该 备份 文件 ， 可 以 通过 SQL Server Management Studio 恢复 数据 库 备 份 ， 如 图 25-1 所 示 。 另 外 ， 也 可 以 使 
用 SQL 脚本 CreateBooks.sql 创建 数据 库 。 如 果 系 统 上 没有 SQL Server Management Studio， 则 可 以 从 
https://docs.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms 上 下 载 一 个 免费 的 版 本 。 


并 p Restore Database = Books 
盘 Etallog backup of the source database wi be taken. Vew this setting on tha Optiona page. 
IT Seript ™ | 0 Help 


So0urce 

OO) Database: 

图 Device: [Cprocsharpsources\adonet ‘ProfessionalC Sharp 7ADONET"Create Database\Books| 

Database: Books wa 

Destination 

Datsbase: es 

Restore to: The last backup taken [Tuesday. Oetober 3, 2017 9.5852 PM) ine... 
Restors plan 

Backup sets to retore- 


Componaent Type Sarver Database Position 
Full CHARIGTSALOCALDB 共 330192FB Books 2 


属 Mocaldbjimssqllocaldb 
[CHARIOTS\chis] 


Verty Backup Media 


Cancel Help 


图 25-1 
本 章 使 用 的 SQL Server 是 SQL Server LocalDb。 这 个 数据 库 服务 器 安装 为 Visual Studio 的 一 部 分 。 也 可 以 
使 用 任何 其 他 SQL Server 版 本 ， 只 需要 改变 相应 的 连接 字符 串 。 
25.1.2 NuGet 包 和 名 称 空间 


ADO.NET 示例 的 示例 代码 利用 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Microsott.Extenslons.Confpuration 
Microsott.Extenslons.Confieuration.Json 
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System.Data.SqlClient 

名 称 空 间 
Microsott.Extensions.Confieuration 
System 

System.Collections 

System.Data 

System.Data.SqlClient 

System.TO 

System.Threading.Tasks 


25.2 使 用 数据 库 连 接 


为 了 访问 数据 库 ， 需 要 提供 某 种 连接 参数 ， 如 运行 数据 库 的 计算 机 和 登录 证 书 。 使 用 SqlConnection 类 连接 
SQL SerVer。 

下 面 的 代码 段 说 明了 如 何 创建 、 打开 和 关闭 Books 数据 库 的 连接 (代码 文件 ConnectionSamples/Program.cs)。 
Public static vold OpenCconnect1Ion () 
{ 

string connectionstring = ff"server=(localdb) \MSSOQLLOCalDB;"™ + 

"integrated security=S3S3PI;database=Books"; 

Var Connection = new SqlConnection (connectionstring); 

connection.Open(}; 

// Do something useful 


Console .WriteLine ("Connection opened"™).; 
connection.Cclose(}:; 


注意 : 
SqlConnection 类 实现 了 IDisposable 接口 ， 其 中 包含 Dispose 方法 和 Close 方法 。 这 两 个 方法 的 功能 相同 ， 
都 是 释放 和 连接。 这 样 ， 就 可 以 使 用 using 语句 来 关闭 连接 。 


在 该 示例 的 连接 字符 串 中 ， 使 用 的 参数 如 下 所 示 。 连 接 字符 串 中 的 参数 用 分 号 分 隔 开 。 

e server(localdb) MSSQLLocalDB 一 一 表示 要 连接 到 的 数据 库 服务 器 。 SQL Server 允许 在 同一 台 计 算 机 上 
运行 多 个 不 同 的 数据 库 服务 器 实例 , 这 里 连接 到 localdb 服务 器 和 安装 SQL Server 时 创建 的 SQL Server 
实例 MSSQLLocalDB。 如 果 使 用 的 是 本 地 安装 的 SQL Server， 就 把 这 一 部 分 改 为 server=(local)。 如 果 
不 使 用 关键 字 server， 还 可 以 使 用 Data Source 。 要 连接 到 SQL Azure， 可 以 设置 Data 
Source=servername.database.windows.net。 

e database=Books 一 一 这 摘 述 了 要 连接 到 的 数据 库 实 例 。 每 个 SQL Server 进程 都 可 以 提供 几 个 数据 库 实例 。 
如 果 不 使 用 关键 字 database， 可 以 使 用 Initial Catalog。 

e inteerated security=SSPI 一 一 这 个 参数 使 用 Windows Authentication 连接 到 数据 库 ， 如 果 使 用 SQL Azure， 
就 需要 设置 User Id 和 Password 或 者 使 用 Azure Active Directory。 


注意 : 

在 http://www.connectionstrings.com 上 可 以 找到 许多 不 同 数据 库 的 连接 字符 串 信息 .。 

这 个 ConnectionSamples 示例 使 用 定义 好 的 连接 字符 串 打 开 数 据 库 连 接 ， 再 关闭 该 连接 。 一 旦 打开 连接 后 ， 
就 可 以 对 数据 源 执行 命令 ， 完 成 后 ， 就 可 以 关闭 连接 。 
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25.2.1 管理 连接 字符 串 


不 在 C# 代 码 中 硬 编码 连接 字符 串 , 而 是 最 好 从 配置 文件 中 读 取 它 。 在 .NET Core 中 , 配置 文件 可 以 是 JSON 
或 XML 格式 ， 或 从 环境 变量 中 读 取 。 在 下 面 的 示例 中 ， 连 接 字 符 串 从 一 个 JSON 配置 文件 中 读 取 (代码 文件 
ConnectionSamples/config.jSoDy): 
"Data™: { 
"DefaultcCconnection™: I 
"Connectionstring™: 
"Server=({localdb) \\MSSOLLoOCalDB; Database=Books; 
Trusted Connection=True;™" 
} 


} 
} 


使 用 NuGet 包 Microsoft.Extensions.Confieuration 定义 的 Configuration API 可 以 读 取 JSON 文件 。 为 了 使 用 
JSON 配置 文件 ， 还 要 添加 NuGet 包 Microsoft.Extensions.Configuration.Json。 为 了 读 取 配置 文件 ， 创 建 
ConfigurationBuilder。AddJsonFile 扩展 方法 添加 JSON 文件 config.Json， 从 这 个 文件 中 读 取 配置 信息 一 一 假定 
它 与 程序 在 相同 的 路 径 中 。 要 配置 另 一 条 路 径 ， 可 以 调用 SetBasePath 方法 。 调 用 ConfigurationBuilder 的 Build 
方法 ， 从 所 有 添加 的 配置 文件 中 构建 配置 ， 返 回 一 个 实现 了 IConfiguration 接口 的 对 象 。 这 样 ， 就 可 以 检索 配置 
值 ， 如 Data:DefaultConnection:ConnectionString 的 配置 值 (代码 文件 ConnectionSamples/Program_cs): 


public static void ConnectionUsingConfig'() 
{ 
var configurationBuilder = new ConfigurationBuilder() 
.SetBasePath (Directory.GetCurrentDirectory()) 
.AddJsonFile ("config.Json™); 
IConfiguration config = confijgurationBuilder.Build():; 
string connectionstring = config["Data:DefaultConnection:Connectionstring"]; 
Console.WriteLine (connectionSstring}),; 


} 
25.2.2 连接 池 


几 年 前 实现 两 层 应 用 程序 时 ， 是 在 应 用 程序 启动 时 打开 连接 ， 只 有 在 关闭 应 用 程序 时 才 关 闭 连接 。 现 在 就 
不 用 这 人 么 做 。 使 用 这 个 程序 架构 的 原因 是 ， 需 要 一 定 的 时 间 来 打开 连接 。 现 在 ， 关 闭 连接 不 会 关闭 与 服务 器 的 
连接 。 相 反 ， 连 接 会 添加 到 连接 池 中 。 再 次 打开 连接 时 ， 它 可 以 从 池 中 提取 ， 因 此 打开 连接 会 非常 快速 ， 只 有 
第 一 次 打开 连接 需要 一 定 的 时 间 。 

连接 池 可 以 用 几 个 选项 在 连接 字符 串 中 配置 。 选 项 Pooling 设置 为 false， 会 禁用 连接 池 ; 它 默 认为 后 用 ， 
Pooling = tue。Min Pool Size 和 Max Pool Size 允许 配置 池 中 的 连接 数 。 默 认 情 况 下 ，Min Pool Size 的 值 为 0， 
Max Pool Size 的 值 为 100。Connection Lifetime 定义 了 连接 在 释放 前 在 池 中 保持 不 活跃 状态 的 时 间 。 


25.2.3 ”连接 信息 


在 创建 连接 之 后 ， 可 以 注册 事件 处 理 程序 ， 来 获得 一 些 连 接 信息 。SqlConnection 类 定义 了 InfoMessage 和 
StateChange 事件 。 每 次 从 SQL Server 返回 一 个 信息 或 警告 消息 时 ， 就 触发 InfoMessage 事件 。 连 接 的 状态 变化 
时 ， 就 触发 StateChange 事件 ， 例 如 打开 或 关闭 连接 (代码 文件 ConnectionSamples/Program.cs): 


Public static void Connect1IonInftormat1Ion () 
{ 


uUSing (var connection = new SgqlConnection (GetConnectionstring(}))) 


connection.InfoMessage += (sender, 8) 三 > 
{ 
Console .WriteLine ($"warning or info {e.Message}™); 


上 


connection.StateChange += (sender, e) => 
{ 


ComSoO1e .WriteLine (SCUTTET state: {e.currentstate}, before: ™ + 
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s"{e.originalstate}™}); 


上 

try 

{ 
connection.SsStatisticsEnabled = true; 
connection.FireInfoMessageEventOnUserErrors = true; 


connection.oOpen(); 


Console .WriteLine ("connection opened™); 
//... Read some records 

} 

catch (Exception ex) 

{ 
Console .WriteLine (ex.Message); 

} 

} 
} 


运行 应 用 程序 时 ， 会 触发 StateChange 事件 ， 看 到 Open 和 Closed 状态 : 


current state: Open, before: Closed 
connection opened 

-- -Dutput reading records 

current state: Closed, before: OQpen 


如 果 出 现 了 异常 ， 默 认 不 触发 InfoMessage 事件 。 设 置 FireInfoMessageEventOnUserErrors 属性 ， 可 以 改变 
这 个 行为 。 这 样 在 出 错时 ， 例 如 使 用 了 Titl 而 不 是 Tite， 就 可 以 从 应 用 程序 中 看 到 这 个 信息 : 


CUIrTent state: Gpen, before: Closed 
connection opened 

warning or info: Invalid column name "Tit]l". 
---_ Output reading records 

CUIrrent state: Closed, before: Open 


SqlConnection 类 还 提供 了 统计 信息 。 只 需要 设置 StatisticsEnabled 属性 ， 就 可 以 在 RetrieveStatistics 方法 中 
检索 统计 信息 。 这 个 方法 通过 实现 了 IDictionary 接口 的 对 象 返 回 统 计 信 息 : 


IDictionary statistics = connection.Retrievestatistics (); 
ShowSstatistics (statistics); 
connection.ResetSstatistics (); 


ShowStatistics 方法 迭代 接收 了 IDictionary 接口 的 所 有 键 ， 并 显示 所 有 值 : 


private static void ShowSstatistics (IDictionary statistics) 
| Console .WriteLine ("Statistics"™y).: 
foreach (var key in statistics.Reys) 
| Console.WriteLine($"{key}, value: {statistics[key] }"); 
EN 


} 
从 Books 表 中 检索 所 有 记录 ， 就 会 显示 连接 中 的 这 些 统计 信息 : 


BuffersReceived, value: 1 
BuffersSsent, value: 1 
BytesRecelved, value: 142 
BytesSsent, walue: l124 
CursoroOpens, value: 0 
Iducount, value: 0 
IduRows, Value: 0 
PreparedExecs, value: 0 
Prepares, Value: 0 
SelectCount, value: 0 
SelectRows, value: 0 
ServerRoundtrips, value: 1 
SumResultsets, value: 0 
Transactions, value: 0 
UnpreparedExecs, Value: 1 
ConnectionTime, value: 140 
ExecutionTime, Vvalue: 456 
NetworkServerTime, value: 8 
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25.3 命令 


25.2 节 “ 使 用 数据 库 连 接 ” 简 要 介绍 了 针对 数据 库 执行 的 命令 。 简 言 之 ， 命 令 就 是 一 个 要 在 数据 库 上 执行 
的 包含 SQL 语句 的 文本 字符 串 。 命 令 也 可 以 是 一 个 存储 过 程 ， 如 本 节 后 面 所 述 。 

把 SQL 子 句 作为 一 个 参数 传递 给 Command 类 的 构造 函数 ， 就 可 以 构造 一 条 命令 ， 如 下 例 所 示 ( 代 码 文 件 
CommandSamples/Proeram.cs ): 

public static void CreateCommand () 

using (var connection = new SqlConnection(GetConnectionString() ) ) 

string sql = "SELECT [Title], [Publisher], [ReleaseDate] "+ 
"FROM [Procsharp]. [Books]"; 


Var Command = new SgqlComand (sgl, connection); 
connection.Open(); 


a 
} 
} 
通过 调用 SqlConnection 的 CreateCommand 方法 ， 把 SQL 语句 赋予 CommandText 属性 ， 也 可 以 创建 命令 : 
Sgqlcommand command = connection.CreateCommangd (); 
command .CommandText = sql; 


命令 通常 需要 参数 。 例 如 ， 下 面 的 SQL 语句 需要 一 个 Title 参数 。 不 要 试图 使 用 字符 串 连 接 来 建立 参数 。 
相反 ， 总 是 应 使 用 ADO.NET 的 参数 特性 : 

string sgql = "SELECT [Title], [Publisher], [ReleaseDate] " + 

"FROM [ProCcSsharp]. [Books] WHERE lower{([Title]) LIKE RTitle™; 

Var Command = new SgqlCommand(sql, connection);} 

将 参数 添加 到 SqlCommand 对 象 中 时 ， 有 一 个 简单 的 方式 可 以 使 用 Parameters 属性 返回 
SqlParameterCollection 和 AddWithValue 方法 : 


command.Parameters.AddWithVvalue ("Title™", "Professional C#%"); 


有 一 个 更 有 效 的 方式 ， 但 需要 更 多 的 编程 工作 : 通过 传递 名 称 和 SQL 数据 类 型 ， 使 用 Add 方法 的 重 载 


command.Parameters.Add ("TitleSstart", SgqlDbType.NVarChar, 50); 
command.Parameters["Title"] .Value = "Professional C#%"; 


也 可 以 创建 一 个 SqlParameter 对 象 ， 并 添加 到 SqlParameterCollection 中 。 


注意 : 
不 要 试图 给 SQL 参数 使 用 字符 串 连 接 。 它 经 常 被 用 于 SQL 注入 攻击 。 使 用 SqlParameter 对 象 会 抑制 这 种 
攻击 。 


定义 好 命令 后 ， 就 需要 执行 它 。 执 行 语句 有 许多 方式 ， 这 取决 于 要 从 命令 中 返回 什么 数据 。SqlCommand 
类 提供 了 下 述 可 执行 的 命令 : 

s ExecuteNonQuery0 一 一 执行 命令 ， 但 不 返回 任何 结果 。 

@ ExecuteReader0 一 一 执行 命令 ， 返 回 一 个 类 型 化 的 IDataReader。 

se ExecuteScalar( 一 一 执行 命令 ， 返 回 结果 集中 第 一 行 第 一 列 的 值 。 


25.3.1 ExecuteNonQuery() 方 法 


这 个 方法 一 般 用 于 UPDATE、INSERT 或 DELETE 语句 ， 其 中 唯一 的 返回 值 是 受 影响 的 记录 个 数 。 但 如 
果 调 用 带 输 出 参数 的 存储 过 程 ， 该 方法 就 有 返回 值 。 示例 代码 在 ProCSharp.Books 表 中 创建 了 一 个 新 的 记录 。 
25-2 显示 Visual Studio 2017 中 这 个 表 的 设计 视图 。 

这 个 表 把 Id 作为 主键 ，Id 是 一 个 标识 列 ， 因 此 创建 记录 时 不 需要 提供 它 。Title 和 Isbn 列 都 不 允许 空 值 ( 见 
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图 25-2), 但 其 他 列 允 许 。 在 示例 代码 中 ， 所 有 列 都 填充 了 值 。ExecuteNonQuery 方法 定义 了 SQL INSERT 语句 ， 
添加 了 参数 值 ， 并 调用 SqlCommand 类 的 ExecuteNonQuery 方法 (代码 文件 CommandSamples/Program.cs): 


| ADONetsamples = 品 其 
Procsharp.Books [Design]” 1 
合 Update soript File Procsharp.Books.sgl" = 
Name Data Type Allow Nulls Default a Mays |i) 
| it [| Unnameds (Primary Key, Clustered: Id) 
Titile nvarchar(so) LL ec Constrmints (0 
Publisher nvarchar(So) ea i | 
-一 I Books lsbn (Unigue: lsbrn) 
lsbn nvarchar(20) | | Foreign Keys (0 
ReleaseDate date i Triggers (0) 
BDesign tH ST.soL 加 日 图 
L ECREATE TABLE [Procsharp].[Books] | 中 
2 [Id | INT IDENTITY (1, 1) NOT NULL, P= 
} [Titlel] NVARCHAR (58) NOT NULL, 
4 [Publisher | NVARCHAR (50) NULL, | 
5| [Isbn] NVARCHAR (28) NOT N 
6 [ReleaseDate | DATE NULL ， 
7 PRIMARY KEY CLUSTERED ([Id] ASC) 
60 | ); 
9 G0 
ID ECREATE UNIQUE INDEX [IX Books Isbn] ON [Procsharp].[Books] ([1Isbn], 
100 4 | 避 Bk 
-Connection Ready TeecaldbANMSsSOLLOcalDB CHARIOT™ehns | Books 
25-2 
Public static void ExecuteNonQuery 
{ 
try 
{ 
UslIng (var connection = new SgqlConnection (GetConnectionstring()}))) 
{ 
string sgl = "INSERT INTO [PrOCSharp] . [Books] " + 
"([Title], [Fublisher], [Isbn], [ReleaseDate]) ™ + 
"VALUES (@Title, @Publisher, &Isbn, frReleaseDate) "™"; 
Var command = new SqlCommand (sgl, connection); 
command.Parameters.AddWithVvalue ("Title™, 
"Professional C# 7 and .NET Core 2.0"); 
command.Parameters.AddWithValue ("Publisher", "Wrox Press"™); 
command.Parameters.AddWithVvalue ("Isbn™., "978-1119449270"); 
command.Parameters.AddWithVvalue ("ReleaseDate", new DateTime (2018, 4, 2)); 
connection.Open (});} 
int records = command.ExecuteNonQuery(); 
Console .WriteLine ($"{records} record(s)} inserted™).; 
} 
} 
catch (SqlException ex) 
{ 
Console.WriteLine (ex.Message); 
} 
} 


ExecuteNonQuery0 方 法 返回 命令 所 影响 的 行 数 , 它 是 一 个 整数 。 第 一 次 


em ss 


运 休 这 


个 方法 时 , 插入 了 一 个 记录 。 


第 二 次 运行 相同 的 方法 时 ,会 得 到 一 个 异 闸 ， 因 为 唯一 索引 有 冲突 。Isbn 定义 了 唯一 的 索引 ， 只 允许 使 用 一 次 。 


第 二 次 运行 该 方法 时 ， 需 要 先 删除 前 面 创建 的 记录 。 


25.3.2 ”ExecuteScalar() 方 法 


在 许多 情况 下 ， 需 要 从 SQL 语句 返回 一 个 结果 ， 如 给 定 表 中 的 记录 个 数 ， 或 者 服务 器 上 的 当前 日 期 /时 间 。 


ExecuteScalar0 方 法 就 可 以 用 于 这 些 场合 : 


Public static void ExecuteScalar{() 
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using (var connection = new SqlConnection{(GetConnectionstring())) 

{ 
string sql = "SELECT COUNT(*} FROM [ProCSsharp]. [Books]"; 
SgqlCcommand command = connection.CreateCommand(); 
Command.cCcommandText = sql; 
connection.Open(); 
object count = command.ExecuteSscalar (}); 
Console.WriteLine(S$"counted {count} book records"™):; 

} 

} 


该 方法 返回 一 个 对 象 ， 根 据 需 要 ， 可 以 把 该 对 象 强制 转换 为 合适 的 类 型 。 如 果 所 调用 的 SQL 只 返回 一 列 ， 
则 最 好 使 用 ExecuteScalar0 方 法 来 检索 这 一 列 。 这 也 适合 于 只 返回 一 个 值 的 存储 过 程 。 


25.3.3 ExecuteReader() 方 法 


ExecuteReader( 方 法 执行 命令 ， 并 返回 一 个 DataReader 对 象 ， 返 回 的 对 象 可 以 用 于 遍历 返回 的 记录 。 
ExecuteReader 示例 使 用 一 个 SQL 查询 ， 它 在 ExecuteReader 方法 中 通过 本 地 函数 GetBookQuery 定义 (代码 文件 
CommandSamples/Proeram.cs): 

Public static voild ExecuteReader (string titleParameter) 

{ 

string GetBookQuery() => 
"SELECT [Id], [Title], [Publisher], [ReleaseDate] "+ 
"FROM [PIroCsharp]. [Books] WHERE lower([Title]) LIKE @Title ™ 十 
"ORDER BY [ReleaseDate] DESC™"; 


PP 
} 


注意 : 

本 地 函数 详 见 第 13 章 。 

当 调 用 SqlCommand 对 象 的 ExecuteReader 方法 时 ， 返 回 SqlDataReader。 注 意 ，SqlDataReader 使 用 后 需要 
销毁 。 还 要 注意 ， 这 次 SqlConnection 对 象 没有 在 方法 的 最 后 明确 地 销毁 。 给 ExecuteReader 方法 传递 参数 
CommandBehavior.CloseConnection， 会 在 关闭 读 取 器 时 ， 目 动 关闭 连接 。 如 果 没 有 提供 这 个 设置 ， 就 仍然 需要 

从 数据 读 取 器 中 读 取 记录 时 ，Read 方法 在 while 循环 中 调用 。Read 方法 的 第 一 个 调用 将 光标 移动 到 返回 的 
第 一 条 记录 上 。 再 次 调用 Read 时 , 光标 定位 到 下 一 个 记录 (只 要 还 有 记录 )。 如果 下 一 步 位 置 上 没有 记录 了 , Read 
方法 就 返回 false。 访 问 列 的 值 时 ， 调 用 不 同 的 GetXXX 方法 ， 如 GetInt32、GetString 和 GetDateTime。 这 些 方 
法 是 强 类 型 化 的 ， 因 为 它们 返回 所 需 的 特定 类 型 ， 如 int、string 和 DateTime。 传 递 给 这 些 方法 的 索引 对 应 于 用 
SQL SELECT 语句 检索 的 列 , 因此 即使 数据 库 结构 有 变化 ,该 索引 也 保持 不 变 。 在 强 类 型 化 的 GetXXX 方法 中 ， 
需要 注意 从 数据 库 返 回 的 null 值 ， 此 时 ，GetXXX 方法 会 抛 出 一 个 异常 。 对 于 检索 的 数据 ， 只 有 ReleaseDate 
可 以 为 空 ,在 这 种 情况 下 为 了 避免 异常 , 使 用 C# 条 件 语句 ?: 和 SqlDataReader.IsDbNull 方法 , 检查 值 是 否 是 null。 
如 果 是 ， 就 把 null 分 配给 可 空 的 DateTime。 只 有 值 不 是 null， 才 使 用 GetDateTime 方法 访问 DateTime (代码 文 
件 CommandSamples/Prosgram.cs): 

Public static voilid ExecuteReader (string title) 


{ 
FF 


Var Connection = new SqlConnection (GetConnectionstring{()); 


Var Command = new SqlCommand (GetBookQuery(})}, connection}); 
var parameter = new SqlParameter ("Title", SgqlDbType.NVarchar, 50) 
{ 


Value = $"{title}s”" 
}s 


F 
command.Parameters.Add (parameter}); 


connection.Open(); 
using (SqlDataReader reader = 

command. ExecuteReader (CommandBehavior.CloseConnection})) 
{ 
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While (FEeader .Read()) 
{ 
int id = reader.GetInt32(0).; 
string bookTitle = reader.GetSstring (1).; 
string publisher = reader.GetSstring (2); 
DateTime? releaseDate = 
reader.IsDbBbNul1l1(3) 2? (DateTime?3}null : reader.GetDateTime (3):; 
DateTime from = reader.GetDateTime (4); 
Console .WriteLine($"{id,5}. {bookTitle,—A40} {publisher,——15} ™ + 
ss"{releaseDate:d}"™); 


} 
} 
} 
运行 应 用 程序 ， 把 标题 Professional C# 传 递 给 ExecuteReader 方法 ， 输 出 如 下 : 
1015. Professional C# 7 and -NET Core 2.0 Wrox Press 4/2/2018 
1. Professional C# 6 and .NET Core 1.0 Wrox Press 4/11/2016 
2. Professional C# 5.0 and .NET 4.5.1 Wrox Press 2/9/2014 
11. Professional C# 2012 and .NET 4.5 WIocCX Press 10/18/2012 
9. Professional C# 4 and .NET 4 Wrox Press 3/8/2010 
3838. Professional C# 2008 Wrox Press 5/24/2008 
13. Professional C# 2005 with .NET 3.0 Wrox Press 6/12/2007 
12. Professional C# 2005 WIocCX Press 11/7/2005 
6. Professional C# 3rd Edition WIoX Press 6/2/2004 
10. Professional C# 2nd Edition Wrox Press 3/28/2002 
010. PFrofessional C# Web Services Wrox Press 12/1/2001 
1012. Professional C# (Beta 2 Edition) Wrox Press 6/172001 


对 于 SqlDataReader， 不 是 使 用 类 型 化 的 GetXXX 方法 ， 而 可 以 使 用 无 类 型 的 索引 器 返回 一 个 对 象 。 为 此 ， 
需要 转换 为 相应 的 类 型 : 

int id = (int)reader[0]; 

string bookTitle = (string) reader[l1]; 


string publisher = (string) reader [2]; 
DateTime? releaseDate = (DateTime?) reader[3]; 


SqlDataReader 的 索引 器 还 允许 使 用 string 而 不 是 int 传递 列 名 。 在 这 些 不 同 的 选项 中 ， 这 是 最 慢 的 方法 ， 
但 它 可 以 满足 需求 。 与 发 出 服务 调用 所 需 的 时 间 相 比 ， 访 问 索 引 器 所 需 的 额外 时 间 可 以 忽略 不 计 : 


int id = (int)reader["Id"]:; 

string bookTitle = {string) reader["Title"™"]; 

string publisher = (string) reader["Publisher™]; 

DateTime? releaseDate = (DateTime?) reader["ReleaseDate™]:; 


25.3.4 调用 存储 过 程 


用 命令 对 象 调 用 存储 过 程 ， 就 是 定义 存储 过 程 的 名 称 ， 给 过 程 的 每 个 参数 添加 参数 定义 ， 人 然后 用 上 一 节 中 
给 出 的 其 中 一 种 方法 执行 命令 。 
下 面 的 示例 调用 存储 过 程 GetBooksByPublisher, 得 到 一 家 出 版 社 的 所 有 图 书 , 这 个 存储 过 程 接 收 一 个 参数 ， 
使 用 递归 查询 返回 所 请 求 的 所 有 图 书 的 记录 : 
CREATE PROCEDURE [ProCSharp]. [GetBooksByPublisher] 
Qpublisher nvarchar (50) 


SELECT [Id], [Title], [Publisher], [ReleaseDate] FROM [ProCsharp] . [Books] 
WHERE [Publisher] = (lpublisher ORDER BY [ReleaseDate] 


为 了 调用 存储 过 程 ，SqlCommand 对 象 的 CommandText 设置 为 存储 过 程 的 名 称 ，CommandType 设置 为 
CommandType.StoredProcedure。 除 此 之 外 ， 该 命令 的 调用 类 似 于 以 前 的 方式 。 参 数 使 用 SqlCommand 对 象 的 
CreateParameter 方法 创建 ,也 可 以 使 用 其 他 方法 创建 之 前 使 用 的 参数 ,对 于 参数 ,填充 SqlDbType、ParameterName 
和 Value 属性 。 因 为 存储 过 程 返 回 记 录 ， 所 以 它 通 过 调用 方法 ExecuteReader 来 调用 (代码 文件 
CommandSamples/Proeram.cs): 


private static void StoredProcedure (string publisher) 
{ 
USing {var connection = new SqlConnection (GetConnectionstring'())) 
{ 
SqlCcommand command = connection.CreateCommand().; 
Command.CommandText "[ProCcSsharpl]. [GetBooksByPublisher]"; 
Command .CommandType CommandIype .StoredProcedure,; 
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SqlParameter pl = comand.CreateParameter (1) ， 
pl.SqlDbType = SdqlDbType.NvarChar; 
pl.ParameterName = "@Publisher™s 


pl.Value = publisher; 
command.Parameters.Add (pl}; 
connection.Open(); 
using (SgqlDataReader reader = command.ExecuteReader ()) 
{ 
Wwhile (reader.Read()) 
{ 
int recursionLevel = (int}reader["Id"™"]:; 
string title = {string) reader["Title™]; 
string pub = (string) reader["Publisher"]; 
DateTime releaseDate = (DateTime) reader["ReleaseDate"™]; 
Console.WriteLine ($"{title} -— {pub}; {releaseDate:d}"; 
} 
} 
} 
} 


运行 应 用 程序 ， 传 递 出 版 社 Wrox Press， 得 到 如 下 所 示 的 结果 : 


Professional C# (Beta 2 EQitiony 一 Wrox Press; 6/1/2001 
Beginning C# — Wrox Press; 9/15/2001 

Professional C# Web Services 一 Wrox Press; 12/1/2001 
Professional C# 2nd Edition —-— Wrox Press; 3/28/2002 
Beginning Visual C# 一 Wrox Press; 8/20/2002 

Professional .NET Network Programming 一 Wrox Press; 10/1/2002 
ASP to ASP.NET Migration Handbook - Wrox Press; 2/1/2003 
Professional C# 3rd Edition — Wrox Press; 6/2/2004 
Professional C# 2005 — Wrox Press; 11/7/2005 

Beginning Visual C# 2005 一 Wrox Press; 11/7/2005 
Professional C# 2005 with .NET 3.0 一 Wrox Press; 6/12/2007 
Beginning Visual C# 2008 一 Wrox Press; 5/5/2008 

Professional C# 2008 —-— Wrox Press; 5/24/2008 

Professional C# 4 and .NET 4 — Wrox Press; 3/8/2010 
Beginning Visual C# 2010 — Wrox Press; 4/5/2010 

Real World .NET, C#, and Silverlight — Wrox Press; 11/22/2011 
Professional C# 2012 and .NET 4.5 — Wrox Press; 10/18/2012 
Beginning Visual C# 2012 Programming — Wrox Press; 12/4/2012 
Professional C# 5.0 and .NET 4.5.1 — Wrox Press; 2/9/2014 
Professional C# 6 and .NET Core 1.0 - Wrox Press; 4/11/2016 
Professional C# 了 and .NET Core 2.0 — Wrox Press; 4/2/2018 


根据 存储 过 程 返回 的 内 容 ， 需 要 用 ExecuteReader、ExecuteScalar 或 ExecuteNonQuery 调用 存储 过 程 。 
对 于 包含 Output 参数 的 存储 过 程 ， 需 要 指定 SqlParameter 的 Direction 属性 。 默 认 情 况 下 ，Direction 是 
ParametelDIrectlon. Input: 


Var poOut = new SgqlParameter(); 
pOut .Direction = ParameterDirection.OQutput; 


25.4 ”异步 数据 访问 


访问 数据 库 可 能 要 花 一 些 时 间 。 这 里 不 应 该 阻塞 用 户 界 面 。ADOJNET 类 通过 异步 方法 和 同步 方法 提供 了 
基于 任务 的 异步 编程 。 下 面 的 代码 片段 类 似 于 上 一 个 使 用 SqlDataReader 的 代码 ， 但 它 使 用 了 异步 的 方法 调 
用 。 连 接 用 SqlConnection. OpenAsync 打开 ， 读 取 器 从 SqlCommand.ExecuteReaderAsynec 方法 中 返回 ， 记 录 使 
用 SqlDataReader.ReadAsync 检索 。 在 所 有 这 些 方 法 中 ， 调 用 线程 没有 阻塞 ， 但 是 可 以 在 得 到 结果 前 ， 执 行 其 他 
操作 (代码 文件 AsyncSamples/Program.cs): 


Public static async Task Main({) 
{ 
await ReadAsync ("Wrox Press"™),;} 


} 


Public static async Task ReadAsync (Int productId) 
{ 


Var connection = new SqlConnection (GetCconnectionstring'()):; 


string sql = "SELECT [Title], [Publisher], [ReleaseDate] ™ 十 
"FROM [ProCcSharp]. [Books] WHERE lower([Title]) ™ + 
"LIKE QTitle ORDER BY [ReleaseDatel] ™; 
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Var Command = new SqlCommanad (sgql, connection); 

Var titleParameter = new SqlParameter ("Title", SglDbType.NVarChar, 50);) 
titleParameter.Value = title; 

command.Parameters.Add (titleParameter); 


awalt connection.OpenAsync (); 


using (SqlDataReader reader = 
await command.ExecuteReaderAsync (CommandBehavior.CloseConnection)) 
{ 
while (await reader.ReadAsync()) 
{ 
int id = reader.GetInt32(0).; 
string bookTitle = reader.Getstring (1).; 
string publisher = reader[2] .ToString(); 
DateTime? releaseDate = 
reader.IsDBNUu11(3) 2 (DateTime?3}null : reader.GetDateTime (3}).; 
Console .WriteLine($"{id,5}. {bookTitle,—A40} {publisher,—15} "+ 
s"{releaseDate:d}"). 
} 
} 
} 


注意 : 
异步 Main0 方 法 至 少 需要 C# 7.1。 


使 用 异步 方法 调用 ,不 仅 有 利于 Windows 应 用 程序 , 也 有 利于 在 服务 器 端 同时 进行 多 个 调用 .ADO.NETAPI 
的 异步 方法 有 重 载 版 本 来 支持 CancellationToken， 使 长 时 间 运 行 的 方法 早 些 停止 。 


注意 : 
异步 方法 调用 和 CancellationToken 详 见 第 15 章 。 


25.5 事务 


默认 情况 下 ， 一 个 命令 运行 在 一 个 事务 中 。 如 果 需 要 执行 多 个 命令 ， 所 有 这 些 命 令 都 执行 完毕 ， 或 都 没有 
执行 ， 就 可 以 显 式 地 启动 和 提交 事务 。 

事务 的 特征 可 以 用 术语 ACID 来 定义 ，ACID 是 Atomicity、Consistency、Isolation 和 Durability 的 首 字母 缩写 。 

e Atomicity( 原 子 性 ) 一 一 表示 一 个 工作 单元 。 在 事务 中 ， 要 么 整个 工作 单元 都 成 功 完 成 ， 要 么 都 不 完成 。 

e Consistency( 一 致 性 ) 一 一 事务 开始 前 的 状态 和 事务 完成 后 的 状态 必须 有 效 。 在 执行 事务 的 过 程 中 ， 状 态 
可 以 有 临时 值 。 

e Isolation( 隔 离 性 ) 一 一 表示 并 发 进行 的 事务 独立 于 状态 , 而 状态 在 事务 处 理 过 程 中 可 能 发 生变 化 。 在 事务 
未 完成 时 ， 事 务 A 看 不 到 事务 B 中 的 临时 状态 。 

e Durability( 持 久 性 ) 一 一 在 事务 完成 后 ， 它 必须 以 可 持久 的 方式 存储 起 来 。 如 果 关 闭 电 源 或 服务 器 朋 尝 ， 
该 状态 在 重新 局 动 时 必须 恢复 。 


注意 : 

事务 和 有 效 状态 很 容易 用 婚礼 来 解释 。 新婚 夫妇 站 在 事务 协调 员 面前 ， 事 务 协调 员 询问 一 位 新 人 : “你 愿 
意 与 你 身边 的 男人 结婚 吗 ? ”如 果 第 一 位 新 人 同意 ， 就 询问 第 二 位 新 人 : “你 愿意 与 这 个 女人 结婚 吗 ? ”如 果 
第 二 位 新 人 反对 ， 第 一 位 新 人 就 接收 到 回 滚 消息 。 这 个 事务 的 有 效 状态 是 ， 要 么 两 个 人 都 结婚 ， 要 么 两 个 人 都 
不 结婚 。 如 果 两 个 人 都 同意 结婚 ， 事 务 就 会 提交 ， 这 两 个 人 就 都 处 于 已 结婚 的 状态 。 如 果 其 中 一 个 人 反对 ， 事 
务 就 会 终止 ， 两 个 人 都 处 于 未 结婚 的 状态 。 无 效 的 状态 是 : 一 个 人 已 结婚 ， 而 另 一 个 没有 结婚 。 事 务 确保 结果 
永远 不 处 于 无 效 状态 。 


在 ADONET 中 ， 通 过 调用 SqlConnection 的 BegnTransaction 方法 就 可 以 开始 事务 。 事 务 总 是 与 一 个 连接 
关联 起 来 ， 不 能 在 多 个 连接 上 创建 事务 。BeginTransaction 方法 返回 一 个 SqlTransaction，SqlTransaction 需要 使 
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用 运行 在 相同 事务 下 的 命令 (代码 文件 TransactionSamples/Program.cs): 
public static void TransactlIonSample() 
| using (Var connection = new SqlConnection (GetConnectionstring()}) 
awalt connection.OpenAsvync (); 
ne tx = connection.BeginTlransaction()}):; 


} 
} 


注意 : 

为 什么 OpenAsync 和 BeginTransaction 方法 在 try 块 之 外 定义 ”这些 调用 也 可 能 失败 ,例如 ,如 果 OpenAsync 
方法 失败 ， 则 在 本 地 catch 块 中 不 会 捕获 异常 ， 而 是 在 TransactionSample 方法 的 外 部 搜索 匹配 的 catch。 这 是 单 
独处 理 这 些 异 常 的 好 方法 。tx 变量 需要 在 try 块 之 外 声明 ， 否 则 不 可 能 在 catch 中 使 用 它 。 


代码 示例 在 ProCSharp.Books 表 中 创建 一 个 记录 。 使 用 SQL 子 句 INSERT INTO 添加 记录 。Books 表 定 
义 了 一 个 目 动 递增 的 标识 符 , 它 使 用 返回 创建 的 标识 符 的 第 二 条 SQL 语句 SELECT SCOPE _IDENTITY0O 
返回 。 在 实例 化 SqlCommand 对 象 后 , 通过 设置 Connection 属性 来 分 配 连接 , 设置 Transaction 属性 来 指定 事务 。 
在 ADO.NET 事务 中 ， 不 能 把 事务 分 配给 使 用 不 同 连接 的 命令 。 不 过 ， 可 以 用 相同 的 连接 创建 与 事务 不 相关 的 
命令 : 


public static void TransactionSsSample () 


{ 
tf-.-. 
try 
{ 
string sql = "INSERT INTO [ProCSharp] . [Books] ™ 十 
"([Title], [Fublisher], [Isbn], [ReleaseDate])}"™" + 
"VALUES (&@Title, lipPublisher, Isbn, liReleaseDate); ™ 十 
TSELECT SCOPE IDENTITY () “7 
Var Command = new SqlCommand 
{ 
CommandText = sgl, 
Connection = connection, 
Transaction = tx 
} 
Fas 
} 


在 定义 参数 并 填充 值 后 ， 通 过 调用 方法 ExecuteScalarAsync 来 执行 命令 。 这 次 ，ExecuteScalarAsync 方法 和 
INSERT INTO 子 句 一 起 使 用 , 因为 完整 的 SQL 语句 通过 返回 一 个 结果 来 结束 : 从 SELECT SCOPE _IDENTITY0O 
返回 创建 的 标识 符 。 如 果 在 WriteLine 方法 后 设置 一 个 断 点 ， 检 查 数据 库 中 的 结果 ， 在 数据 库 中 就 不 会 看 到 新 
记录 ， 虽 然 已 经 返回 了 创建 的 标识 符 。 原 因 是 事务 还 没有 提交 : 


Public static void Transactionsample() 


{ 
FF 。 
Var pl = new SqlParameter ("Title™", SqlDbType.NVarChar, 50); 
Var p2 = new SdqlParameter ("Publisher", SqlDbType.NVarCchar, 50); 
Var p3 = new SdqlParameter("Isbn", SqlDbType.NVarchar, 20).; 
Var p4 = new SdgqlParameter ("ReleaseDate", SglDbType.Date)}); 


command.Parameters.AddRange (new SgqlParameter[] { Bl, p2, Pp3, p44 1}); 


command.Parameters["Title"] .Value = "Professional C# 8 and -NET Core 3.0"; 
command.Parameters["Publisher™"] .Valuyue = "WIrox Press™:; 
command.Parameters["Isbhn™" | .Value = "42-08154711™; 
command.PFarameters["ReleaseDate"] .Value = new DateTime (2020, 9, 2); 


object id = await command.ExecuteScalarAsync(); 
Console .WriteLine ($s$"record added with id: {iqd}"™); 


fh as 
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现在 可 以 在 同一 事务 中 创建 男 一 个 记录 。 在 示例 代码 中 ， 使 用 同样 的 命令 ， 连 接 和 事务 仍然 相关 ， 只 是 在 
再 次 调用 ExecuteScalarAsync 前 改变 了 值 。 也 可 以 创建 一 个 新 的 SqlCommand 对 象 ， 访 问 同一 个 数据 库 中 的 另 
一 个 表 。 调 用 SqlTransaction 对 象 的 Commit 方法 ， 提 交 事 务 。 之 后 ， 就 可 以 在 数据 库 中 看 到 新 记录 : 


Public static void TransactionSample () 

{ 
i... 
command.Parameters["Title"] .Value = "Professional C# 9 and NET Core 4.0": 
command.Parameters["Publisher"] .Value = "Wrox Press"™; 
command.Parameters["Isbn" |] .Value = "42-08154711™; 
command.Parameters["ReleaseDate"] .Value = new DateTime (2022, 11, 2); 


id = await command.ExecuteScalarAsync (); 
Console.WriteLine($"record added with 1id: {id}"™); 
tx.Commit()-; 

} 

catch (Exception ex) 

{ 
Console.WriteLine($"error {ex.Message}, rolling back"™"); 
tx.Rollback(}):; 


} 
} 


检查 了 两 个 记录 的 Isbn 号 吗 ? 它们 是 相同 的 。 由 于 在 Isbn 号 上 使 用 唯一 索引 指定 了 数据 库 表 ,因此 写 入 第 
二 个 记录 会 失败 ， 抛 出 类 型 SqlException 的 异常 ， 异 党 信息 是 Cannot insert duplicate key row in object 
ProCSharm .Books' with unique index 'TX Books Isbn'. The duplicate key value is (42-81$4711)， 因 此 ，Rollback 方法 
会 撤销 同一 事务 中 的 所 有 SQL 命令 。 状 态 重 置 为 事务 月 动 之 前 的 状态 。 这 样 ， 第 一 个 记录 也 不 会 写 信 数据库 。 

如 果 在 调试 模式 下 运行 程序 ， 断 点 激活 的 时 间 太 长 ， 事 务 就 会 中 断 ， 因 为 事务 超时 了 。 事 务 处 于 活跃 状态 
时 ， 并 不 意味 着 有 用 户 输入 。 为 用 尸 输入 增加 事务 的 超时 时 间 也 不 是 很 有 用 ， 因 为 事务 处 于 活跃 状态 会 导致 
在 数据 库 中 有 一 个 锁定 。 根 据 读 写 的 记录 ， 可 能 出 现行 锁 、 页 锁 或 表 锁 。 为 创建 事务 设置 隔离 级 别 ， 可 以 影 啊 
锁定 ， 因 此 影 啊 数 据 库 的 性 能 。 然 而 ， 这 也 影响 事务 的 ACID 属性 ， 例 如 ， 并 不 是 所 有 数据 都 是 隔离 的 。 

应 用 于 事务 的 默认 隔离 级 别 是 ReadCommitted。 表 25-1 显示 了 可 以 设置 的 不 同 选项 。 

表 25-1 
隔离 级 别 说 明 

ReadUncommitted 使 用 ReadUncommitted， 事 务 不 会 相互 隔离 。 使 用 这 个 级 别 ， 不 等 待 其 他 事务 释放 锁定 的 记录 。 这 样 ， 就 可 
以 从 其 他 事务 中 读 取 未 提交 的 数据 -  - 脏 读 。 这 个 级 别 通常 仅 用 于 读 取 不 管 是 否 读 取 临 时 修改 都 无 关 紧 要 的 
记录 ， 如 报表 

ReadCommitted ReadCommitted 等 待 其 他 事务 释放 对 记录 的 写 入 锁定 。 这样， 就 不 会 出 现 脏 读 操作 。 这 个 级 别 为 读 取 当前 的 
记录 设置 读 取 锁 定 ， 为 要 写 入 的 记录 设置 写 入 锁定 ， 直 到 事务 完成 为 止 。 对 于 要 读 取 的 一 系列 记录 ， 在 移 
动 到 下 一 个 记录 上 时 ， 前 一 个 记录 都 是 未 锁定 的 ， 所 以 可 能 出 现 不 可 重复 的 读 操 作 


RepeatableRead RepeatableRead 为 读 取 的 记录 设置 锁定 ， 直 到 事务 完成 为 止 。 这 样 ， 就 避免 了 不 可 重复 读 的 问题 。 但 约 读 仍 
可 能 发 生 

Serializable Serializable 设置 范围 锁定 。 在 运行 事务 时 ， 不 可 能 添加 与 所 读 取 的 数据 位 于 同一 个 范围 的 新 记录 

Snapshot snapshot 用 于 对 实际 的 数据 建立 快照 。 在 复制 修改 的 记录 时 ， 这 个 级 别 会 减少 锁定 。 这 样 ， 其 他 事务 仍 可 
以 读 取 旧 数据 ， 而 不 需要 等 待 解锁 

Unspecified Unspecified 表示 ， 提 供 程序 使 用 另 一 个 隔离 级 别 值 ， 该 值 不 同 于 IsolationLevel 枚 举 定义 的 值 

Chaos Chaos 类 似 于 ReadUncommitted， 但 除了 执行 ReadUncommitted 值 的 操作 之 外 ， 它 不 能 锁定 更 新 的 记录 


表 25-2 总 结 了 设置 最 利用 的 事务 隔离 级 别 可 能 导致 的 问题 。 
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隔离 级 别 
ReadUncommitted 
ReadCommitted 
RepeatableRead 
Serializable 


25.6 事务 和 System.Transaction 


处 理事 务 的 男 一 种 方法 是 使 用 System.Transactions。 这 些 类 上 自从 .NET Framework 2.0 开始 就 可 以 使 用 , 但 是 
在 .NET Core 1.1 中 还 不 可 用 .在 .NET Core 2.1 中 , 这 些 类 型 又 回来 了 ,可 以 从 ADO.NET( 从 System.Data.SqlClient 
的 4.5 版 本 开始 ) 和 Entity Framework Core 2.1 中 使 用 。 

System.Transactions 名 称 空间 为 事务 定义 了 几 个 类 。 可 能 最 重要 的 类 是 Transaction。 它 可 以 用 于 直接 访问 环 
境 事务 ， 提 供 关 于 事务 的 信息 ， 以 及 在 发 生 故 障 时 局 动 回 深 。 表 25-3 摘 述 了 Transaction 类 的 成 员 ; 


表 25-3 
Transaction 类 的 成 员 说 明 

Current Current 是 一 个 静态 属性 。 如 果 存在 环境 事务 ， 则 Transaction.Current 返回 该 事务 。 本 章 后 面 将 讨论 
环境 事务 

IsolationLevel IsolationLevel 属性 返回 一 个 IsolationLevel 类 型 的 对 象 。IsolationLevel 是 一 个 枚 举 ， 它 定义 了 其 他 
事务 对 某 事务 的 临时 结果 的 访问 权限 。 隔 离 级 别 的 信息 可 参阅 使 用 本 章 的 25.5 节 

TransactionInformation TransactionInformation 属性 返回 TransactionInformation 对 象 ， 它 提供 关于 事务 当前 状态 、 创 建 事务 
的 时 间 和 事务 标识 符 的 信息 

Rollback 使 用 Rollback 方法 ， 可 以 中 止 事 务 ， 并 撤销 事务 的 所 有 部 分 ， 将 所 有 结果 设置 为 事务 之 前 的 状态 

DependentClone 使 用 DependentClone 方法 ， 可 以 创建 一 个 依赖 当前 事务 的 事务 

TransactionCompleted TransactionCompleted 是 在 事务 完成 时 触发 的 事件 一 一 要 么 成 功 ， 要 么 失败 。 使 用 
TransactionCompletedEventHandler 类 型 的 事件 处 理 程 序 对 象 ， 可 以 访问 Transaction 对 象 并 读 取 其 


示例 应 用 程序 (.NET Core Console App) 显 示 , System.Transactions 系统 的 特性 使 用 了 以 下 依赖 项 和 名 称 空间 : 

依赖 项 

Microsott.Extensions.Confieuration 

Nicrosott.Extensions.Confieuration.Json 

System.Data.SqlClient 

名 称 空间 

Microsoft.Extensions.Confieuration 

System 

System.Data.SqlClient 

System.IO 

System.Ling 

System.Threading.Tasks 

System.Iransactions 

代码 示例 定义 了 一 个 Utilities 类 ， 其 中 的 一 些 辅助 方法 在 不 同 示 例 中 使 用 。( 代 码 文 件 
SystemIransactionSamples/Utlities.cs): 
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PUublic class Utilities 


{ 


public static bool AbortTx() 


{ 


Console.WriteLine ("Abort the transaction (y/n) 2?").; 
return Console.ReadLine{() .ToLower(}) .Equals("y"); 


} 


public static void DisplayTransactionInformation(string title., 
TransactionIinformation info) 


{ 


if (info == null) throw new ArgumentNullException (nameof (jnfo)})); 


Console.WriteLine (title}).; 

Console.WriteLine ($s$"Creation time: {info.creationTime:T}"). 
Console.WriteLine(s$"status: {info.status}"):; 
Console.WriteLine($"Local Id: {info.LocallIdentifier}"); 
Console.WriteLine ($s$"Distributed Id: {info.DistributedIdentifier}"™"); 
Console.WriteLine(); 


注意 : 


示例 代码 询问 用 户 是 否 应 该 终止 事务 。 这 适用 于 演示 ， 但 是 在 实际 应 用 程序 的 事务 中 不 应 该 有 用 户 交 互 。 
当 事 务 处 于 活动 状态 时 ， 锁 定 记 录 。 我 们 不 希望 妨碍 其 他 用 户 工作 ， 原 因 是 一 个 用 户 因为 这 些 锁 打 开 了 锁 。 
还 需要 注意 事务 超时 。 如 果 用 户 输入 占用 的 时 间 超 过 事务 超时 时 间 ， 事 务 将 被 中 止 。 


这 个 示例 使 用 与 前 面 示 例 相 同 的 数据 库 ， 但 是 有 一 个 重要 的 更 改 。 这 次 Book 类 型 定义 为 从 Books 表 中 了 映 
射 信息 (代码 文件 SystemTransactionSamples/Book.cs); 


Public class Book 


{ 


Public int IQ { get; set; } 

public string Title { get; set; } 

public string Publisher { get; set; } 
public string Isbn { get; set; } 

Public DateTime? ReleaseDate { get; Set } 


} 


BookData 类 将 Book 类 型 映射 到 数据 库 ， 并 实现 了 AddBookAsync 方法 ， 以 向 Books 表 添加 新 记录 。 该 实 
现 与 以 前 在 调用 ExecuteNonQuery 方法 插入 新 记录 时 看 到 的 实现 类 似 ， 但 有 一 个 重要 的 区 别 。 这 次 
System.Transactions.Transaction 使 用 SqlConnection 方法 EnlistTransaction 征 募 。 这样 ，SqlConnection 将 参与 该 事 
务 的 结果 (代码 文件 SystemTransactionSamples/BookData.cs): 


Public class BookData 


{ 
Public async Task AddBookAsync (Book book, Transaction tx) 
{ 
uslIng (SgqlCconnection connection = new SgqlConnection (GetConnectionstring'())) 
string sgl = "INSERT INTO [ProcSharp] . [Books] ([Title], [Fublisher], ™ 十 


"[Isbn]j, [ReleaseDate]} ™ + 
"VALUES (QTitle, QPublisher, @Isbn, QReleaseDate) "™; 


awalt connection.OpenAsync (); 
if (tx != null) 
{ 

connection.EnlistTransaction (txy}.; 
} 
Var Command = connection.CreateCommand '(); 
command .CommandText = sql; 
command.Parameters.AddWithValue ("Title™", book.Title); 
command.Parameters.AddWithVvalue ("Publisher", book.Publisher); 
command.Parameters.AddWithVvalue ("Isbn™", book.Isbn); 
command.Parameters.AddWithValue ("ReleaseDate™", book.ReleaseDate); 


awalt command.ExecuteNonQueryAsync (); 
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25.6.1 可 提交 的 事务 


Transaction 类 不 能 以 编程 方式 提交 ; 它 没有 提交 事务 的 方法 。 基 类 Transaction 只 支持 中 止 事务 。 唯 一 支持 
提交 事务 的 类 是 类 CommittableTransaction。 

在 CommittableTransactionAsync 方法 中 ,首先 创建 一 个 类 型 为 CommittableTransaction 的 事务 ， 并 回 控 制 台 
显示 信息 。 然 后 创建 一 个 Book 对 象 ， 该 对 象 在 AddBookAsync 方法 中 写 入 数据 库 。 如 果 在 事务 外 部 验证 数据 
库 中 的 记录 ， 则 在 事务 完成 之 前 无 法 看 到 添加 的 图 书 。 如 果 事 务 失败 ， 就 会 出 现 回 滚 ， 并 且 不 会 将 图 书写 到 数 
据 库 中 。 

在 调用 AddBookAsync 方法 之 后 ， 调 用 AbortTx 方法 来 询问 用 户 是 否 应 该 中 止 事 务 。 如 果 用 户 中 止 ， 则 抛 
出 ApplicationException 类 型 的 异 滔 ， 在 catch 块 中 ， 通 过 调用 Transaction 类 的 Rollback 方法 执行 回 深 。 记 录 不 
会 写 入 数据 库 。 如 果 用 户 没 有 中 止 ，Commit 方法 将 提交 事务 ， 并 提交 事务 的 最 终 状 态 ( 代 码 文 件 
SystemIransactionSamples/Proeram.cs): 


static async Task CommittableTransactlionAsync() 

{ 
Var tx = new CommittableTransaction().; 
DisplayTransactionIinformation ("TX created™", tx.TransactionIinformation); 


try 
{ 
var b = new Book 
{ 
Title = "A Dog in The House™, 
Publisher = "Pet Show" ， 
Isbn = RandomIsbn(}), 
ReleaseDate = new DateTime (2018, 11, 24) 
}s 
var data = new BookData(}); 
await data.AddBookAsync (b, tx); 


if (AbortTx{}) 
{ 
throw new ApplicationException ("transaction abort by the user™),; 
} 
tx.Commit(); 
} 
catch (Exception ex) 
{ 
Console.WriteLine (ex.Message); 
Console.WriteLine(); 
tx.Rollback(}); 
} 


DisplayTransactionIinformation ("TX completed", tx.TransactionInformation); 


} 
如 下 面 的 应 用 程序 输出 所 示 ， 事 务 是 活动 的 ， 并 且 具 有 一 个 本 地 标识 符 。 此 外 ， 用 户 选择 中 止 事务 。 事 务 
完成 后 ， 可 以 看 到 中 止 状态 : 


TX created 

Creation time: 7:29:36 PM 

Status: Active 

Local Id: c090c903-3f74-44b2-92a7-7607e33b787c:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Abort the transaction (y/n}? 


¥ 
transaction abort by the user 


TE completed 

Creation time: 7:29:36 PM 

Status: Aborted 

Local Id: cO90c903-3f74-44b2-92aiT-71607e33b787c:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


接 下 来 是 应 用 程序 的 第 二 个 输出 ， 用 户 不 会 中 止 事务 。 事 务 的 状态 是 Committed， 数 据 写 入 数据 库 : 


TX created 
Creation time: 7:30:59 PM 
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Status: Active 
Local Id: etét0feb33-e3b2-4ede-992d-f93296a363ad:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Abort the transaction (YAn) 3? 

n 

TX completed 

creation time: 7:30:59 PM 

status: Committed 

Local Id: ebt0feb383-e3b2—-4ede—992d-f93296a363a4:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


25.6.2 ”依赖 事务 


对 于 依赖 事务 ， 可 以 在 多 个 任务 或 线程 之 间 影 啊 一 个 事务 。 依 赖 事 务 依赖 于 另 一 个 事务 ， 并 影响 事务 的 
结果 。 

示例 方法 DependentTransactions 首先 使 用 CommittableTransaction 创建 根 事 务 。 此 事务 对 象 使 用 方法 
DependentClone 创建 一 个 依赖 事务 。 该 DependentTransaction 在 本 地 函数 UsineDependentTransactionAsync 中 传 
递 给 一 个 单独 的 任务 。 依 赖 事务 可 以 标记 为 已 完成 ， 就 像 调用 Complete 方法 一 样 。 

DependentClone 方法 需要 DependentCloneOption 类 型 的 参数 ， 该 参数 是 一 个 枚 举 ， 其 值 为 
BlockCompleteUntilComplete 和 RollbackIfNotComplete。 如 果 根 事务 在 依赖 事务 之 前 完成 ， 则 此 选项 非常 重要 。 
将 该 选项 设置 为 RollbackIfNotComplete， 如 果 依 赖 事 务 没有 在 根 事务 的 Commit 方法 之 前 调用 Complete 方法 ， 
则 事务 将 中 止 。 将 该 选项 设置 为 BlockCommitUntilComplete， 方 法 Commit 就 会 等 待 (阻塞 )， 直 到 所 有 依赖 事务 
都 定义 了 结果 为 止 。 

接 下 来 ， 如 果 用 户 不 中 止 事 务 ， 则 调用 CommittableTransaction 类 的 Commit 方法 (代码 文件 
SystemTIransactions/Program.cs): 


static void DependentTransactions () 
{ 
asvync Task UsingDependentTransactionAsync (DependentTransaction dtx) 
{ 
dtx.TransactionCompleted += (sender, ee) => 
DisplayTransactionIinformation("Depdendent TX completed", 
.Transaction.TransactionInformation}).; 


DisplayTransactionInformation("Dependent Tx", dtx.TransactionInformation); 
awalt Task.Delay (2000); 


dtx.Complete(); 
DisplayTransactionInformation{("Dependent Tx send complete™, 
dtx.TransactionIinformation); 


} 


Var tx = new CommittableTransactiont():; 
DisplayTransactionInformation ("Root Tx created"™, 
tx.TransactionIinformationy.: 


try 
{ 
DependentTransaction depTx = tx.DependentClonel 
DependentcCloneOption.BlockCommitUntilComplete); 
Task tl1 = Task.RuNn(() => UsingDependentTransactionAsync (depTx) ) ， 


if (BAbortTx()) 
throw new ApplicationException("transaction abort by the user™),;} 
0 
(Exception ex) 
Console.WriteLine (ex.Message).; 
tx.Rollback(); 
} 


DisplayTransactionIinformation ("TX completed", tx.TransactionIinformation}); 
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应 用 程序 的 以 下 输出 显示 了 根 事务 及 其 标识 符 。 因 为 选项 DependentCloneOption.BlockCommitUntilComplete， 
根 事务 在 Commit 方法 中 等 待 ， 直 到 定义 了 依赖 事务 的 结果 为 止 。 一 旦 依赖 事务 完成 ， 就 提交 事务 : 


Root TX created 

Creation time: 7:50:32 PM 

Status: Active 

Local Id: 87268b8c-076d-4823-af58-944b86lbd4fe:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


abort the transaction (y/n)? 

Dependent TX 

Creation time: 7:50:32 PM 

Status: Active 

Local Id: 81268b8c-076d-4823-afos8-944b86l1lbd4fe:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Dependent Tx send complete 

Creation time: 7:50:32 PM 

Status: Active 

Local Id: 8i1268b8c-016d-4823-af58-944b861bd4fe:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


n 
Depdendent TX completed 

Creation time: 7:50:32 PM 

status: Committed 

Local Id: 87268b8c-076d-4823-af58-944b86lbd4fe:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


TE completed 

Creation time: 7:50:32 PM 

status: Committed 

Local Id: 87268b8c-076d-4823-af58-944b86lbd4fe:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


25.6.3 ”环境 事务 


System.Transactions 名 称 空 间 中 类 的 最 大 优势 是 环境 事务 特性 。 对 于 环境 事务 , 不 需要 手动 获取 与 事务 的 连 
接 ; 这 是 由 文 持 环境 事务 的 资源 目 动 完成 的 。 

环境 事务 与 当前 线程 关联 。 可 以 使 用 静态 属性 Transaction.Current 获取 并 设置 环境 事务 。 支 持 环境 事务 的 
API 检查 此 属性 ， 以 获得 环境 事务 ， 并 与 事务 合并 。ADO.NET 连接 文 持 环境 事务 。 

可 以 创建 一 个 CommittableTransaction 对 象 并 将 其 分 配给 Transaction.Curent 属性 ， 来 初始 化 环境 事务 。 男 
一 种 方法 (通常 是 首选 方法 ) 是 使 用 TransactionScope 类 。TransactionScope 的 构造 国 数 会 创建 一 个 环境 事务 。 


注意 : 
如 果 ADO.NET 连接 不 应 该 与 环境 事务 合并 ， 则 可 以 用 连接 字符 囊 设置 值 Enlist= false。 


为 了 使 用 TransactionScope， 创 建 了 男 一 个 AddBook 方法 ， 它 只 加 Books 表 添 加 一 条 记录 ， 而 不 显 式 地 回 
事务 注册 (代码 文件 SystemTransactionSamples/BookData.cs): 


PUublic void AddBook (Book book) 
{ 
using (SqlConnection connection = new SqlConnection (GetConnectionstring())) 
{ 
string sql = "INSERT INTO [ProCSharp] . [Books] {[Title], [Publisher], ™ + 
"[Isbn]j, [ReleaseDate]} ™ + 
"VALUES (QTitle, flPublisher, fiIisbn, ffReleaseDate) "; 


connection.Open(); 


Var command = connection.CreateCommand{():; 
command.CommandText = sqgql; 
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command.Parameters.AddWithvalue ("Title", book.Title).; 
command.Parameters.AddWithVvalue ("Publisher™", book.Publisher); 
command.Parameters.AddWithvalue ("Isbn™", book.Isbhn); 
command.Parameters.AddWithvVvalue ("ReleaseDate™", book.ReleaseDate); 


command.ExecuteNonQuery (); 
} 
} 


TransactionScope 的 重要 方法 是 Complete 和 Dispose。Complete 方法 为 作用 域 设 置 成 功 位 ， 如 果 作 用 域 是 根 
作用 域 ， 那 么 Dispose 方法 将 结束 作用 域 ， 并 提交 或 回 滚 事务 。 

因为 TransactionScope 类 实现 了 IDisposable 接口 ， 所 以 可 以 使 用 using 语句 定义 作用 域 。 默 认 构 造 函 数 创 
建 一 个 新 事务 。 下 面 的 代码 片段 在 创建 TransactionScope 实例 之 后 ， 立 即将 调用 DisplayTransactionInformation 
的 lambda 表达 式 分 配给 TransactionCompleted 事件 ， 以 便 在 事务 完成 时 获取 信息 。 在 此 事件 触发 之 前 ， 在 创建 
事务 之 后 ， 访 问 Transaction.Current 属性 ， 以 在 控制 台 上 显示 事务 的 当前 状态 。 然 后 ,创建 一 个 新 的 Book 对 象 ， 
并 调用 先前 创建 的 AddBook 方法 。 如 果 用 户 没 有 中 止 事 务 ， 则 调用 TransactionScope 的 Complete 方法 。 

using 块 的 末尾 调用 TransactionScope 的 Dispose 方法 。 如 果 调 用 了 Complete 方法 ， 并 且 参 与 事务 的 所 有 其 
他 方 (例如 ，SQL 连接 ) 都 设置 了 成 功 位 ， 则 提交 事务 。 如 果 任 何 一 方 未 成 功 处 理 包含 TransactionScope 的 事务 ， 
也 未 调用 Complete， 则 中 止 事务 (代码 文件 SystemTransactionSamples/Program.cs): 


static woid AmbientTransactionst{) 
{ 
USing (Var scope = new Transaction3Scope (1) ) 
Transaction.Current.TransactionCompleted += (Senaer， 已 ) 三 > 
DisplayTransactionIinformation ("TX completed™, 
ee.Transaction.TransactionInformation):; 


DisplayTransactionIinformation ("Ambient TX created™, 
Transaction.Current.TransactionIinformation}.: 


var b = new Book 
{ 

Title = "Cats In The House"™, 

Publisher = "Pet Show", 

Isbn = RandomIsbnt{), 

ReleaseDate = new DateTime (2019, 11, 24) 
}; 
vAar data = new BookDatal(); 
data.AddBook (DY ; 


if (!AbortTx()) 
{ 
SCOPe .complete (}s 
} 
el1se 
{ 
Console .WriteLine ("transaction abort by the user™); 


} 


} // scope.Dispose(}); 
} 


运行 应 用 程序 时 ， 可 以 在 创建 TransactionSope 类 的 实例 之 后 看 到 一 个 活动 的 环境 事务 。 应 用 程序 的 最 后 一 
个 输出 是 TransactionComplete 事件 处 理 程序 的 输出 ， 以 显示 已 完成 的 事务 状态 : 


Ambient TX created 

creation time: 7:53:10 AM 

status: Active 

Local Id: Oe28b708-9dd7-4b17-bf41-c09f963928cf:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Abort the transaction (y/n}? 

n 

TX completed 

creation time: 7:53:10 AM 

status: Committed 

Local Id: 0e28b70838-9dd7-4bl17-bf41-c09f963928cf:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 
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25.6.4 ” 藤 套 作用 域 和 环境 事务 


对 于 TransactionScope 类 ， 还 可 以 嵌 套 作用 域 。 散 套 的 作用 域 可 以 直接 位 于 外 部 作用 域内 ， 也 可 以 位 于 在 
作用 域 中 调用 的 方法 内 。 靶 套 的 作用 域 可 以 使 用 与 外 部 作用 域 相同 的 事务 ， 抑 制 事务 ， 或 者 创建 独立 于 外 部 作 
用 域 的 新 事务 。 对 该 作用 域 的 需求 由 TransactionScopeOption 枚 举 定 义 ， 该 枚 举 传递 给 TransactionScope 类 的 构 
造 函 数 。 

表 25-4 搞 述 了 TransactionScope 枚 举 可 用 的 值 和 相应 功能 。 


表 25-4 
TransactionScope 成 员 说 明 
Required Required 指定 ， 作 用 域 需 要 一 个 事务 。 如果 外 部 作用 域 已 经 包含 一 个 环境 事务 ， 内 部 作用 域 就 使 用 


现 有 事务 。 如 果 环 境 事务 不 存在 ， 则 创建 一 个 新 的 事务 。 如 果 两 个 作用 域 共享 相同 的 事务 ,那么 每 
个 作用 域 都 会 影响 事务 的 结果 。 只 有 当 所 有 作用 域 设 置 成 功 位 时 ， 事 务 才 能 提交 。 只 要 有 一 个 作用 
域 在 根 作用 域 被 释放 之 前 没有 调用 Complete 方法 ， 事 务 就 中 止 


RequiresNew RequiresNew 总 是 创建 一 个 新 的 事务 。 如 果 外 部 作用 域 已 经 定义 了 事务 ， 那 么 来 自 内 部 作用 域 的 事 
务 是 完全 独立 的 。 两 个 事务 都 可 以 单独 提交 或 中 止 
Suppress 使 用 Suppress， 无 论 外 部 作用 域 是 否 包 含 事 务 ， 作 用 域 都 不 包含 环境 事务 


下 一 个 示例 定义 了 两 个 作用 域 。 使 用 选项 TransactionScopeOption.RequiresNew， 内 部 作用 域 配置 为 需要 一 
个 新 事务 (代码 文件 SystemTransactionSamples/Program.cs): 


static void NestedSscopes () 
{ 
uSing (var scope = new Transact1lIonScope (1) ) 
{ 
Transaction.Current.TransactionCompleted += (SenadeT， 已 ) 一 > 
DisplayTransactionInformation ("TX completed"™, 
.Transaction.TransactionInformation). 


DisplayTransactionIinformation("Ambient TX created"™, 
Transaction.Current.TransactionInformationy).; 


var 上 = new Book 
{ 

Title = "Dogs in The House™, 

Publisher = "Pet Show", 

Isbn = RandomIsbnt()., 

ReleaseDate = new DateTime (2020, 11, 24) 
}i 
var data = new BookData (}; 
data.AddBook (b}; 


USing (var scope2 = new 
TransactionScope (TransactionScopeOption.RequiresNew)) 
{ 
Transaction.Current.TransactionCompleted += (sender, 已) 三 > 
DisplayTransactioniIinformation ("Inner TX completed™, 
e.Transaction.TransactionIinformation).; 


DisplayTransactionIinformation({("“"Inner TX scope", 
Transaction.Current.TransactionIinformationy}):; 


var bl = new Book 
{ 
Title = "Dogs and Cats in The House"™, 
Publisher = "Pet Show", 
Isbn = RandomIsbn{(), 
ReleaseDate = new DateTime (2021, 11, 24) 


var datal = new BookData(); 
datal .AddBook (bl)}).:; 


scopez2.Complete(}); 
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] 


SCoPe .complete (); 


} 
在 运行 应 用 程序 时 ， 可 以 看 到 外 部 作用 域 和 内 部 作用 域 的 不 同事 务 标识 待 ， 其 中 内 部 作用 域 在 GUID 上 附 
加 :2， 外 部 作用 域 在 GUID 上 附加 :1。 这 些 事务 彼此 独立 : 


Ambient TX created 

creation time: 8:20:09 AM 

status: Actlive 

Local Id: d4e3al80-49d6-4cl6-b4c9-89a9céd4ace9:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Inner T&R& scope 

Creation time: 8:20:11 AM 

status: Actlive 

Local Id: die3al80-49d6-4cl1l6-bi4c9-89a9céd4aced:2 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Inner TX completed 

Creation time: 8:20:11 AM 

status: Committed 

Local Id: d4e3al80-49d6-4cl1l6-b4c9-89a9c6d4ace9d:2 
Distributed Id: 00000000-0000-0000-0000-000000000000 


TX completed 

creation time: 8:20:09 AM 

status: Committed 

Local Id: die3al80-49d6-4c1l16-b4c9-B89adc6d4ace9:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


如 果 将 内 部 作用 域 的 创建 更 改 为 使 用 TransactionScopeOption.Required， 就 可 以 看 到 同样 的 事务 用 于 外 部 和 
内 部 作用 域 : 


Ambient TX created 

Creation time: 8:23:52 AM 

status: Active 

Local Id: 95181f71-0268-40f0-8f12-471la01a83638:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


Inner TR SCOPe 

Creation time: 8:23:52 AM 

status: Actlive 

Local Id: 95181f71-0268-40f0-8f12-47la0la83638:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 
TX completed 

Creation time: 8:23:52 AM 

status: Committed 

Local Id: 95181f71-0268-40f0-38f12-471la0l1la83638:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 
Inner TK completed 

Creation time: 8:23:52 AM 

status: Committed 

Local Id: 95181f71-0263—-A40f0-8fli2-47la0la83638:1 
Distributed Id: 00000000-0000-0000-0000-000000000000 


25.7 小结 


本 章 介 绍 了 ADO.NET 的 核心 基础 。 首 先 介 绍 的 SqlConnection 对 象 打开 一 个 到 SQL Server 的 连接 。 讨 论 
了 如 何 从 配置 文件 中 检索 连接 字符 串 。 

接着 闻 述 了 如 何 正 确 地 进行 连接 ， 这 样 稀缺 的 资源 就 可 以 尽 可 能 早 地 关闭 。 所 有 连接 类 都 实现 IDisposable 
接口 ， 在 对 象 放 在 using 子 句 中 时 调用 该 接口 。 如 果 本 章 只 有 一 件 值 得 注意 的 事 ， 那 就 是 尽早 关闭 数据 库 连 接 
的 重要 性 。 

对 于 命令 ,传递 参数 ， 就 得 到 一 个 返回 值 ， 使 用 SqlDataReader 检索 记录 。 还 论述 了 如 何 使 用 SqlCommand 
对 象 调用 存储 过 程 。 
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类 似 于 框架 的 其 他 部 分 ， 处 理 可 能 要 花 一 些 时间 ，ADO.NET 实现 了 基于 任务 的 异步 模式 。 还 看 到 了 如 何 
通过 ADO.NET 创建 和 使 用 事务 。 

对 于 System.Transactions， 人 和 介绍 了 处 理事 务 的 另 一 种 方法 
事务 时 ，SQL 连接 会 自动 将 其 列 到 事务 中 。 

第 26 章 讨论 ADO.NET Entity Framework Core， 它 提供 了 关系 数据 库 和 对 象 层次 结构 之 间 的 映射 ， 从 而 提 
供 了 抽象 的 数据 访问 。 访 问 关 系数 据 库 时 ， 在 后 台 使 用 ADO.NET 类 。 


可 以 独立 于 SQL 连接 的 事务 ， 而 在 使 用 环境 
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本 草 要 氮 


Entity Framework Core 简介 

使 用 依赖 项 注入 和 Entity Framework 
约定 、 注 释 和 流利 API 

使 用 查询 、 已 编译 的 得 询 和 全 局 得 询 过 滤器 
通过 约定 、 注 释 和 流利 API 定义 关系 

在 每 个 层次 结构 中 使 用 表 、 表 分 割 和 拥有 的 实体 
对 象 跟踪 

更 新 对 象 和 对 象 树 

用 更 新 处 理 冲 突 
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使 用 迁移 和 .NET CLI 工具 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 音源 代码 。 源 代码 也 可 以 在 EFCore 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 


Intro 

Books Sample 

UsineDependencyInjection 

Menus Sample 

Menus with Data Annotations 

Relations with Annotations/Conventions/FluentAPI 
Table per Hierarchy 

Contlict Handline Sample 


Transactions Sample 


第 26 章 Entity Framework Core | 605 


26.1 Entity Framework 简 史 


Entity Framework 和 Entity Framework Core (EF Core) 是 一 个 提供 了 实体 -关系 映射 的 架构 ， 通 过 它们 ， 可 以 
创建 映射 到 数据 库 表 的 类 型 ， 使 用 LINQ 创建 数据 库 查 询 ， 创 建 和 更 新 对 象 ， 把 它们 写 入 数据 库 。 
Entity Framework 经 过 多 年 的 改变 ，EF Core 完全 重 写 了 。 下 面 看 看 Entity Framework 的 历史 ， 了 解 改写 的 
原因 。 
ee Entity Framework 1 一 一 Entity Framework 的 第 一 个 版 本 没有 准备 用 于 .NET 3.5， 但 不 久 它 就 可 用 于 .NET 
3.5 SP1。 男 一 个 产品 是 LINQ to SQL, 它 提供 了 类 似 的 功能 , 可 用 于 .NET 3.5。 从 广义 上 看 , LINQ to SQL 
和 Entity Framework 提供 了 类 似 的 功能 .然而 , LINQ to SQL 使 用 起 来 更 简单 ,但 只 用 于 访问 SQL Server。 
Entity Framework 是 基于 提供 程序 的 ， 可 以 访问 几 种 不 同 的 关系 数据 库 。 它 包含 了 更 多 的 功能 ， 比 如 多 
对 多 映射， 不 需要 映射 对 象 ， 可 以 进行 n 到 1n 映射 。Entity Framework 的 一 个 缺点 是 ， 它 要 求 模型 类 型 
派生 自 EntityObject 基 类 。 使 用 一 个 包含 XML 的 EDMX 文件 ， 把 对 象 映射 到 关系 上 。 所 包含 的 XML 
用 三 种 模式 定义 : 概念 模式 定义 (Conceptual Schema Definition，CSD) 定 义 对 象 类 型 及 其 属性 和 关联 ; 存 
储 模 式 定义 (Storage Schema Definition, SSD) 定 义 了 数据 库 表 、 列 和 关系 ; 映射 模式 语言 (Mapping Schema 
Language，MSL) 定 义 了 CSD 和 SSD 如 何 彼此 映射 。 

® Entity Framework 4 一 一 Entity Framework 4 可 用 于 .NET 4， 进 行 了 重大 改进 ， 许 多 想法 都 来 自 LINQ to 
sQL。 因 为 改动 较 大 ， 跳 过 了 版 本 2 和 3。 在 这 个 版 本 中 ， 增 加 了 延迟 加 载 ， 在 访问 属性 时 获取 关系 。 
设计 模型 后 , 可 以 使 用 SQL 数据 定义 语言 (DDL) 创 建 数据 库 。 使 用 Entity Framework 的 两 个 模型 现在 是 
Database First 或 Model First。 添 加 的 最 重要 特性 是 文 持 Plain Old CLR Objects (POCO)， 所 以 不 再 需要 
派生 自 基 类 EntityObject。 

在 后 来 的 更 新 (如 Entity Framework 4.1、4.2) 中 ， 用 NuGet 包 添 加 了 额外 的 特性 。 这 人 允许 更 快 地 增加 功能 。 
Entity Framework 4.1 提供 了 Code First 模型 ， 其 中 不 再 使 用 定义 映射 的 EDMX 文件 。 相 反 ， 所 有 的 映射 都 使 用 
C# 代 码 定 义 一 一 使 用 特性 或 流利 API 定义 使 用 代码 的 映射 。 

Entity FramewoIk 4.3 添加 了 对 迁移 的 支持 。 有 了 迁移 ， 可 以 使 用 C# 代 码 定 义 对 数据 库 中 模式 的 更 新 。 数 据 
库 更 新 可 以 自动 应 用 到 使 用 数据 库 的 应 用 程序 上 。 

e Entity Framework S$ 一 一 Entity Framework 的 NuGet 包 文 持 NET Framework 4.5 和 .NET Framework 4.0 应 

用 程序 .。 然而 ， Entity Framework 5 的 许多 功能 可 用 于 .NET Framework 4.5。Entity Framework 仍然 基于 
安装 在 系统 上 的 类 型 和 .NET Framework 4.S。 在 这 个 版 本 中 ， 新 增 了 性 能 改进 ， 文 持 新 的 SQL Server 
功能 ， 如 空间 数据 类 型 。 而 且 ， 当 使 用 NET Framework 4.0 时 ， 这 些 特性 中 有 很 多 都 是 无 法 使 用 的 。 

。 Entity Framework 6 一 一 Entity Framework 6 解决 了 Entity Framework 5 的 一 些 问题 ， 其 部 分 原因 是 ， 该 框 

架 的 一 部 分 安装 在 系统 上 ， 一 部 分 通过 NuGet 扩展 获得 。 现 在 ，Entity Framework 的 完整 代码 都 移动 到 
NuGet 包 上 。 为 了 不 出 现 冲 突 ， 使 用 了 一 个 新 的 名 称 空间 。 将 应 用 程序 移植 到 新 版 本 上 ， 必 须 改 变 名 称 
“|; 

e Entity Framework Core (EF Core) 一 一 Entity Framework 的 这 个 版 本 有 了 新 的 名 称 ， 是 对 Entity Framework 

的 完全 重 写 。EF Core 不 仅 可 以 在 Windows 上 使 用 ， 也 可 以 在 Linux 和 Mac 上 使 用 。 它 支持 关系 数据 
库 和 NoSQL 数据 存储 。 

本 书 介 绍 Entity Framework Core 2.0。 这 个 版 本 不 文 持 XML 文件 映射 与 CSDL、SSDL 和 MSL。 只 文 持 Code 
First 一 一 用 Entity Framework 4.1 添加 的 模型 。Code First 并 不 意味 着 数据 库 不 存在 。 可 以 先 创建 数据 库 ， 或 纯 
粹 从 代码 中 定义 数据 库 ， 这 两 种 选择 都 是 可 能 的 。 


注意 : 
名 称 Code First 有 些 误 导 。 在 Code First 中 ， 代码 或 者 数据 库 都 可 以 先 创 建 。 在 最 初 Code First 的 beta 版 本 
中 ， 名 字 是 Code Only。 因 为 其 他 模型 选项 在 名 字 中 包含 First， 所 以 名 称 Code Only 也 改变 了 。 
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Entity Framework Core 1.0 不 支持 Entity Framework 6 提供 的 所 有 特性 .Entity Framework Core 2.0 有 所 改进 ， 
但 仍然 不 支持 Entity Framework 6 的 所 有 特性 。 然 而 ， 它 也 有 一 些 Entity Framework 6 没有 的 新 特性 。 

只 需要 注意 使 用 什么 版 本 的 Entity Framework。 始 终 使 用 Entity Framework 6 有 许多 有 效 的 理由 ， 但 在 非 
Windows 平台 上 使 用 ASPNET Core， 使 用 Entity Framework 与 通用 Windows 平台 ， 使 用 Xamarin， 使 用 非 关 系 
数据 人 存储， 都 需要 使 用 EF Core。 

本 章 介 绍 EF Core。 它 始 于 一 个 简单 的 模型 读 写 来 目 SQL Server 的 信息 。 后 来 ， 添 加 了 关系 ， 在 写 入 数据 
库 时 介绍 变更 退 踪 器 和 冲突 的 处 理 。 使 用 迁移 创建 和 修改 数据 库 模 式 是 本 章 的 男 一 个 重要 组 成 部 分 。 


注意 : 
本 章 使 用 Books 数据 库 。 这 个 数据 库 和 包含 在 WWWw.wrox.com 下 载 的 代码 示例 中 。 与 示例 一 起 使 用 的 其 他 数 
据 库 是 从 代码 中 创建 的 。 


26.2 EF Core 简介 


第 一 个 例子 使 用 了 一 个 Book 类 型 ， 把 这 种 类 型 映射 到 SQL Server 数据 库 中 的 Books 表 。 把 记录 写 到 数据 
库 ， 然 后 读 取 、 更 新 和 删除 它们 。 

在 第 一 个 示例 中 , 首先 创建 数据 库 或 者 从 应 用 程序 创建 数据 库 。 为 了 先 创建 数据 库 ， 可 以 使 用 Visual Studio 
2017 中 的 SQL Server Object Explorer。 选 择 数据 库 实 例 (localdb 信 MSSQLLocalDB( 随 Visual Studio 一 起 安装 ), 单 
击 树 视图 中 的 Databases 节点 ， 然 后 选择 Add New Database。 示 例 数据 库 WroxBooks 只 有 一 个 表 Books。 

为 了 创建 Books 表 , 可 以 在 WroxBooks 数据 库 中 选择 Tables 节点 , 然后 选择 Add New Table。 使 用 如 图 26-1 
所 示 的 设计 器 ， 或 者 在 工 SQL 编辑 器 中 输入 SQL DDL 语句 ， 就 可 以 创建 Books 表 。 下 面 的 代码 片段 显示 了 创 
建 表 的 工 SQL 代码 。 单 击 Update 按钮 ， 可 以 将 更 改 提交 到 数据 库 。 

CREATE TABLE [dbo].[Books] 

| [BookId] INT IDENTITY(1, 1} NOT NULL, 

[Title] NVARCHAR(50) NOT NULL, 
[Publisher] NVARCHAR(25) NULL, 

| CONSTRAINT [PK Books] PRIMARY KEY CLUSTERED ([BookId] ASC) 

本 章 使 用 的 示例 应 用 程序 都 是 NET Core 控制 台 应 用 程序 ， 使 用 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Microsott.EntityFrameworkCore 
Microsott.EntityFrameworkCore.SqlServer 
Microsott.EntityFramework.Desien 
Microsott.Extensions.DependencyInjection 
Microsoft.Extensions.Logeing.Console 
名 称 空间 
Microsott.EntityFrameworkCore 
Microsott.EntityFrameworkCore.ChangeTracking 
Microsott.EntityFrameworkCore.Dliaenostics 
Microsott.EntityFrameworkCore.Infrastructure 
Microsott.EntityFrameworkCore.Metadata.Builders 
Microsott.Extensions.DependencyInjection 
Microsott.Extensions.Logeme 
System 
System.Collections.Generic 
System.ComponentModel.DataAnnotations 
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System.ComponentModel.DataAnnotations.Schema 


System.Linqg 
System.Threading. Tasks 
-| Solutioni us 口 xX 
全 Update ”Script File: dbo.Table.sql" a 
Name Data Type Allow Nulls Default a Keys (|) 
sé Baakld int 国 <Unnarmeds (Primary Key, Clustered: Bookld) 
Title nvarchar(S0 Check Constraints (0) 
lish harfz5) 恒 Inidemes ‘0) 
Publisher nvarchar(23) Forsign Keys (0) 
= Triggers '0) 
QDesign LN Sia 四 日 贺 
| BCREATE TABLE [dbo].[Books] + 
21 | 
[BookId] INT NOT NULL PRIMARY KEY IDENTITY ， 
4 [Title] NVARCHAR(58) NOT NULL, 
5 [Publisher] NVARCHAR(25) NULI 
G0 |) 
i 
i00% = 
"Connection Ready llocaldbM\ MssSQLLocalDB | DREAMINGNchris | Books 


图 26-1 


26.2.1 创建 模型 


| 607 


访问 Books 数据 库 的 BookSample 示例 应 用 程序 是 一 个 NET Core 控制 台 应 用 程序 。 在 这 个 应 用 程序 中 ， 
Book 类 是 一 个 简单 的 实体 类 型 ， 定 义 了 三 个 属性 。BookId 属性 映射 到 表 的 主键 ，Title 属性 映射 到 Title 列 ， 
Publisher 属性 映射 到 Publisher 列 。 对 于 Title 属性 ， 应 用 Required 属性 是 因为 映射 列 在 数据 库 中 定义 为 NOT 
NULL。 使 用 StringLength 属性 应 用 Title 和 Publisher 属性 的 长 度 。 这 也 映射 到 数据 库 中 的 列 。 为 了 把 类 型 映射 


到 Books 表 ， 将 Table 特性 应 用 于 类 型 (代码 文件 mtro/Book.cs): 


[Table ("Books")] 
public class Book 
{ 
Public int BookId { get; set; } 
[Recquired] 
[StringLength (50)] 
PUublic string Title { get; set; } 
[StringLength (30)] 
PUublic string Publisher { get; set; } 
} 


26.2.2 约定、 注释 和 流利 API 


EF Core 使 用 了 三 个 概念 来 定义 模型 : 约定 、 注 释 和 流利 API。 按 照 约定 ， 有 些 事情 会 自动 发 生 。 例 如， 用 


Id 前 缀 命名 int 或 Guid 类 型 的 属性 ， 将 该 属性 映射 到 主键 。 


可 以 使 用 注释 重 写 约定 一 一 指定 特性 。 前 面 的 例子 使 用 Table 特性 将 Book 类 型 映射 到 Books 表 。 还 有 一 个 
映射 到 表格 的 约定 : 使 用 上 下 文 的 属性 名 。 下 一 节 将 展示 如 何 创建 上 下 文 。 并 不 是 每 个 注释 都 有 约定 。 还 使 用 


了 Required 和 StringLength 特性 。 注 解 比 约定 更 强大 ; 可 以 做 得 更 多 。 


除了 使 用 注释 ， 还 可 以 使 用 流利 API， 这 意味 独 配 置 是 通过 代码 完成 的 ， 而 不 是 使 用 特性 完成 的 。 在 流利 
API 中 ， 可 以 使 用 方法 的 返回 值 来 调用 下 一 个 方法 。 用 于 EF Core 的 流利 API 比 注释 更 强大 ， 可 以 做 得 更 多 。 
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26.2.3 创建 上 下 文 


通过 创建 BooksContext 类 ， 实 现 了 Book 表 与 数据 库 的 关系 。 这 个 类 派生 目 基 类 DbContext。BooksContext 
类 定义 了 DbSet<Book~ 类 型 的 Books 属性 。 这 个 类 型 允许 创建 查询 ， 添 加 Book 实例 ， 存 储 在 数据 库 中 。 要 定 
义 连 接 字 符 串 ， 可 以 重 写 DbContext 的 OnConfiguring 方法 。 在 这 里 ，UseSqlServer 扩展 方法 将 上 下 文 映射 到 
SQL Server 数据 库 (代码 文件 BooksSample/BooksContext.cs): 


Public class BooksContext: DbContext 
{ 
private const string Connectionstring = 
@"server= (localdb) \MSSQLLocalDb;database~=~WroxBookKs;" + 
"trusted connection=true"; 
public DbSset<Book> Books { get; set; } 
protected override void OncCconfiguring (DbContextOptionsBuilder optionsBuilder) 
{ 
base.onconfiguring (optionsBuilder); 
optionsBuilder.UseSqlServer (Connectionstring); 
} 
} 


注意 : 
定义 连接 字符 串 的 另 一 种 选择 是 使 用 依赖 注入 ， 参 见 本 章 后 面 的 内 容 。 


26.2.4 创建 数据 库 


前 面 定义 了 模型 和 上 下 文 类 。 现 在 还 可 以 以 编程 方式 创建 数据 库 。 首 先 实 例 化 BooksContext 对 象 。using 
语句 确保 在 using 作用 域 结束 时 关闭 数据 库 连接 。 

使 用 DbContext 的 Database 属性 时 ， 会 返回 一 个 DatabaseFacade。 可 以 使 用 它 创建 和 删除 数据 库 ， 并 直接 
发 送 SQL 语句 。 调用 EnsureCreatedAsync 方法 , 确保 创建 了 数据 库 。 如 果 数 据 库 已 经 存在 , 此 方法 将 返回 false。 
如 果 数 据 库 不 存在 ， 则 根据 上 下 文 和 模型 的 定义 创建 数据 库 ， 并 返回 tue( 代 码 文件 Intro/Program csj: 


private async Task CreateTheDatabaseAsync() 
{ 
USIing (Var context = new BooksContext()) 
{ 
bool created = await context.Database.EnsureCreatedAsync!().; 
string creationInfo = created 3 "created™ : "exists"; 
Console.WriteLine($"database {creationInfo}"™.); 
} 
} 


运行 这 个 程序 时 ， 如 果 之 前 已 经 创建 了 这 个 数据 库 , 那么 字符 串 database exists 就 会 写 入 控制 台 。 如 果 之 前 
没有 创建 数据 库 ， 就 创建 数据 库 ， 然 后 写 入 字符 串 database created。 


注意 : 

许多 代码 示例 都 使 用 了 EF Core 的 异步 方法 ， 如 EnsureCreatedAsync 和 SaveChangesAsync。 如 果 不 需 要 异 
步 功能 (例如 ,在 控制 台 应 用 程序 或 Web 应 用 程序 中 )， 则 可 以 使 用 这 些 方法 的 同步 变 体 . 尽管 异步 有 一 些 开销 ， 
但 是 这 些 API 的 同步 版 本 会 阻塞 调用 线程 。EnsureCreated 和 SaveChanges 是 同步 API， 而 EnsureCreatedAsync 
和 SaveChangesAsync 是 异步 API。 异 步 方 法 详 见 第 15 章 和 第 21 章 。 


注意 : 
使 用 上 下 文 方 法 的 异步 变 体 允许 在 后 台 局 动 操作 。 但 是 ， 不 能 在 同一 上 下 文中 并 行 地 启动 多 个 操作 。 在 开 
始 下 一 个 操作 之 前 ， 需 要 等 待 操作 完成 。 
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26.2.5 删除 数据 库 
数据 库 的 删除 与 它 的 创建 非常 类 似 。 只 需要 调用 DatabaseFacade 的 方法 EnsureDeletedAsync: 


private async Task DeleteDatabaseAsync{() 
{ 
Console.Write("Delete the database? ™). 
string input = Console.ReadLine(); 
if (input.ToLower() == "ynm) 
{ 
using (var context = new BooksContext()) 
{ 
bool deleted = await context.Database.EnsureDeletedAsync (); 
string deletionIinfo = deleted ?3 "deleted™ : "not deleted"™; 
Console .WriteLine (S$"database {deletionInfo}™).; 
} 
} 
} 


确保 不 删除 不 应 该 删除 的 数据 库 。 注 意 所 使 用 的 连接 字符 串 。 


26.2.6 与 入 数据 库 


创建 了 数据 库 和 Books 表 后 ， 就 可 以 用 数据 填充 表 了 。 创 建 AddBookAsync 方法 ， 把 Book 对 象 添 加 到 数 
据 库 中 。AddBookAsynec 方法 仅 把 Book 对 象 添加 到 上 下 文中 ， 不 写 入 数据 库 。 必 须 调用 SaveChangesAsynec 方 
法 把 Book 对 象 写 入 数据 库 ( 代 码 文件 Intro/Program.cs): 
private async Task AddBookAsync (string title, string publisher) 
{ 
USing (var context = new BooksContext()) 
{ 
var book = new Book 
{ 
Title = title, 
Publisher = publisher 
}s 
await context .Books .AMddAsync (book).; 
int records = await context.SaveChangesAsynce(); 
Console.WriteLine($"{records} record added™).; 
} 
Console .WriteLine(); 


} 
为 了 添加 一 组 图 书 ， 可 以 使 用 AddRange 方法 ; 


private async Task AddBooksAsync{() 
{ 


using (var context = new BooksContext () ) 


{ 

var bl = new Book 

{ 
Title = "Professional C# 6 and .NET Core 1.0"™, 
Publisher = "Wrox Press"™ 

下 

var b2 = new Book 

{ 
Title = "Professional C# 5 and -NET 4.5.1"™, 
Publisher = "Wrox Press"™ 

1 

var b3 = new Book 

{ 
Title = "JavaSscript for Kids"™, 
Publisher = "Wrox Press"™ 

1 

var b4 = new Book 

{ 
Title = "Web Design with HTML and CSS" ， 
Publisher = "For Dumies™ 

1 


await context.AddRangeAsync(bl, b2, b3, b4).; 
int records = awalt context.SaveChangesAsync(); 
Console.WriteLine($"{records} records added™).; 
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Console .WriteLine():; 


} 
运行 应 用 程序 ， 调 用 这 些 方法 ， 就 可 以 使 用 SQL Server Object Explorer 查看 写 入 数据 库 的 数据 。 


26.2.7” 读 取 数 据 库 
为 了 在 C# 代 码 中 读 取 数据 ， 只 需要 调用 BooksContext， 访 问 Books 属性 。 访 问 该 属性 会 创建 一 个 SQL 语 
句 ， 从 数据 库 中 检索 所 有 的 书 (代码 文件 Intro/Program.cs): 


private async Task ReadBooksAasYnC () 


{ 
USInG (Var context = new BooksContext()) 
{ 
List<Book> books = await context.Books.ToListAsync(); 
foreach (var b in books) 
{ 
Console .WriteLine{(s$"{b.Title} {b.Publisher}™); 
} 
} 
Console .WriteLine().; 
} 


在 调试 期 间 打 开 IntelliTrace Events 窗口 ， 就 可 以 看 到 发 送 到 数据 库 的 SQL 语句 (这 需要 Visual Studio 企业 
版 ): 


SELECT [bl].[BookId], [bl]. [Publisher], [bl].[Titlel] 
FROM [Books] AS [Dj 


Entity Framework 提供 了 一 个 LINQ 提供 程序 。 使 用 它 可 以 创建 LINQ 查 


private async Task QueryBookshsync() 
{ 
USing (Var context = new BooksContext () ) 
{ 
List<Book> WIOXBOOkS = context .Books 
.Where{lb 一 > b.Publisher == "Wrox Press"™) 
-TOL1iStAsync (); 


询 来 访问 数据 库 。 也 可 以 使 用 方法 


foreach (var b in wroxBooks) 


{ 
Console .WriteLine($"{b.Title} {b.Publisher}™); 


} 
} 


Console .WriteLine():; 


} 
或 使 用 声明 性 的 LINQ 查询 语法 : 


var WIOXBooks = await (from b in context .Books 
where b.Publisher == "Wrox Press" 
select bb) .ToListAsync().; 


使 用 两 个 语法 变 体 ， 将 这 个 SQL 语句 发 送 到 数据 库 : 


SELECT [b]. [BookId], [b]. [Publisher], [bl].[Titlel] 
FROM [Books] AS [bl 
WHERE [1B].[Publisher] = 'WIrox Press' 


注意 : 
LINQ 参见 第 12 章 。 


26.2.8 ”更 新 记录 
更 新 记录 很 容易 实现 : 修改 用 上 下 文 加 载 的 对 象 ， 并 调用 SaveChangesAsync( 代 码 文 件 Intro/Program.cs): 


private async Task UpdateBookAsync{() 
{ 
USing (Var context = new BooksContext()) 


{ 
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int records 一 0: 
Book book = await context.Books 
.Where (l(b => Bb.Title == "Professional C8# 了 1) 


.FirstorDpefaultAsync(); 
if (book != null) 
{ 


book .Title = "Professioconal C# 7 and .MET Core 2.0". 
records = await context.SaveChangeshsync'(); 
Console.WriteLine($"{records} record updated"™).; 
} 
Console.WriteLine(); 


I 
26.2.9 删除 记录 


最 后 ， 清 理 数据 库 ， 删 除 所 有 记录 。 为 此 ， 可 以 检索 所 有 记录 ， 并 调用 Remove 或 RemoveRange 方法 ， 把 
上 下 文中 对 象 的 状态 设置 为 删除 。 现 在 调用 SaveChangesAsync 方法 ， 从 数据 库 中 删除 记录 ， 并 为 每 一 个 对 象 调 
用 SQL Delete 语句 (代码 文件 Intro/Program.cs): 


private async Task DeleteBooksAsync () 
{ 


uSing (Var context = new BooksContext () ) 
var Dooks = context.Books.; 
context .Books .RemoveRange (books).; 
int records = await context.SaveChangesAsync (); 
Console .WriteLine(s$s"{records} records deleted™); 
} 
Console.WriteLine().; 


} 

注意 : 

对 象 -关系 映射 工具 ， 如 EF Core， 并 不 适用 于 所 有 场景 。 使 用 示例 代码 删除 所 有 对 象 不 那么 高 效 。 使 用 单 
个 SQL 语句 可 以 删除 所 有 记录 , 而 不 是 为 每 一 条 记录 使 用 一 个 DELETE 语句 。 具 体操 作 和 参见 第 25 章 。EF Core 
在 这 种 场景 中 并 没有 那么 糟糕 ， 因 为 多 个 语句 可 以 合并 为 一 个 批 处 理 语句 ， 如 本 章 后 面 所 述 ， 


了 了 解 了 如 何 添加 、 查 询 、 更 新 和 删除 记录 ， 本 章 后 面 将 介绍 后 台 的 功能 ， 讨 论 使 用 Entity Framework 的 高 


26.2.10 ”日记 记录 


为 了 查看 发 送 到 数据 库 的 SQL 语句 ， 可 以 打开 SQL Server 的 分 析 器 ， 在 Visual Studio 中 打开 Intellitrace 
Events (Debug | Windows | Intellitrace Events)， 这 需要 Visual Studio 的 企业 版 ， 或 者 只 是 启用 日 志 记 录 。 使 用 日 
志 记 录 ， 可 以 在 自己 喜欢 的 地 方 编写 跟踪 信息 。 

EF Core 在 内 部 使 用 一 个 依赖 注入 容器 (使 用 Microsoft.Extensions.DependencyInjection)， 它 注册 了 接口 
ILoggerFactory。 可 以 访问 这 个 接口 ， 并 注册 目 己 的 日 志 记 录 器 提供 程序 。 

下 面 的 代码 片段 使 用 BooksContext 注册 一 个 新 的 日 志 记 录 器 。 首 先 ， 使 用 Getmfrastructure 扩展 方法 检索 
上 下 文 的 IServiceProvider。 这 个 扩展 方法 是 在 名 称 空间 Microsoft.EntityFrameworkCore.Infrastructure 中 定义 的 。 
使 用 IServiceProvider， 可 以 检索 在 容器 中 注册 的 服务 ， 例 如 接口 ILoggerFactory。 此 接口 用 于 在 EF Core 基础 结 
构 中 编写 日 志 人 信息。 使 用 这 个 接口 ， 可 以 添加 日 志 提 供 程 序 ， 比 如 控制 台 日 志 提 供 程序 。 这 个 日 志 提 供 程 序 在 
NuGet 包 Microsoft.Extensions.Logging.Console 中 定义 。 访 提供 程序 为 ILoggerFactory 定义 了 AddConsole 扩展 方 
法 ， 以 便于 将 其 添加 为 日 志 提 供 程序 。 在 这 里 ， 日 志 提 供 程 序 配 置 为 编写 信息 日 志 ( 代 码 文件 mtro/Program.cs): 

private void addLogging () 

using (var context = new BooksContext ()) 


IServiceProvider provider = context.GetIinfrastructure<IServiceProvider> (1) ; 
ILOoggerFactory loggerFactory = provider.GetService<ILoggerFactory> (); 
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loggerFactory.AddConsole (LogLevel .Information); 
} 
} 


需要 在 只 有 一 个 上 下 文 的 情况 下 进行 此 配置 。 注 册 是 在 EF Core 的 基础 结构 中 完成 的 ， 因 此 一 旦 为 应 用 程 
序 配 置 了 这 个 基础 结构 ， 日志 记录 就 会 在 每 个 实例 化 的 上 下 文中 完成 。 例 如 ， 前 面 实 现 的 QueryBooksAsync 方 
法 现在 在 控制 台 上 显示 了 日 志 信 息 : 
info: Microsoft.EntityFrameworkCore.Database.Command[2001011] 
Executed Dbcommand (131mS) [Farameters=[], CommandType=" Text", 
CommandTimeout="30"] 
SELECT [bl]. [BookId], [bb]. [Publisher], [b].[Title] 


FROM [Books] AS [bl 
WHERE [lb]. [Publisher] = N'WIoOx PTESS 1 


注意 : 
依赖 注入 和 Microsoft Extensions.DependencyInjection 详 见 第 20 章 。 关 于 日 志和 诊断 的 信息 详 见 第 29 章 。 


26.3 ”使 用 依赖 注入 


EF Core 内 置 了 对 依赖 注入 的 支持 。 使 用 EF Core 和 依赖 注入 容器 也 得 到 了 有 力 的 支持 。 它 不 是 定义 连接 并 
利用 DbContext 派生 类 来 使 用 SQL Server， 而 是 使 用 依赖 注入 框架 来 注入 连接 和 SQL Server 选项 。 

为 了 看 到 其 操作 ， 前 面 的 示例 用 BooksSampleWithDI 示例 项 目 进行 修改 。 

BooksContext 类 现在 看 起 来 要 简单 许多 ， 只 是 定义 Books 属性 (代码 文件 UsineDependencyInjection/ 
BooksContext.cs): 


Public class BooksContext : DbContext 
{ 
Public BooksContext (DhbContextOptions<BooksContext> options) 
: base (options) { 1} 


public DbSet<Book> Books { get; set; } 
} 


BooksService 是 利用 BooksContext 的 新 类 。 在 这 里 ，BooksContext 通过 构造 函数 注入 功能 来 注入 。 方 法 
AddBooksAsync 和 ReadBooks 非常 类 似 于 前 面 的 示例 , 但 是 它们 使 用 BooksService 类 的 上 下 文成 员 , 而 不 是 创 
建 一 个 新 的 上 下 文 (代码 文件 UsingDependencyInjection/BooksService.cs): 


public class BooksService 
{ 
private readonly BooksContext booksContext; 
public BooksService (BooksContext context) => booksContext = context; 


Public async Task AddBooksAsync() 
L 


Var bl = new Book 

{ 
Title = "Professional C# 6 and -NET Core 1.0", 
Publisher = "Wrox Press™ 

Ir 

var b2 = new Book 

{ 
Title = "Professional C# 5.0 and -NET 4.5.1™, 
Publisher = "Wrox Press™ 

ys 

var b3 = new Book 

{ 
Title = "Javascript for Kids"™, 
Publisher = "Wrox Press™ 

}s 

Var bd4 = new Book 

{ 


Title = "Web Design With HTML and CSS", 
Publisher = "For Dummies"™ 
}s 


booksContext.AddRange (bl, b2, b3, bA); 
int records = awalt booksContext.SaveChangesAsync () :; 
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Console.WriteLine($"{records} records added™).; 


} 


Public async Task ReadBooksAsync() 


{ 
List<Book> books = awalt booksContext.Books.ToListAsync(); 


foreach (var b in books) 
, Console.WriteLine (S$"{b.Title} {b.Publisher}"); 
J WriteLine() ; 
} 
} 
依赖 注入 框架 的 容器 在 InitializeServices 方法 中 初始 化 。 这 里 创建 了 ServiceCollection 实例 ， 在 这 个 集合 
中 添加 BooksService 类 ,并 进行 短暂 的 生命 周期 管理 ,这 样 ,每 次 请 求 这 个 服务 时 ,就 实例 化 ServiceCollection。 
为 了 注册 Entity Framework 和 SQL Server, 可 以 使 用 扩展 方法 AddEntityFrameworkSqlServer 和 AddDbContext。 
AddDbContext 方法 需要 一 个 Action 委托 作为 参数 ， 来 接收 DbContextOptionsBuilder 参数 。 有 了 这 个 选项 参数 ， 
上 下 文 可 以 使 用 UseSqlServer 扩展 方法 来 配置 。 这 类 似 于 前 面 示 例 中 用 Entity Framework 注册 SQL Server 的 功 
能 (代码 文件 UsingsDependencyInjection/Program.cs): 


private void InitializeServices!() 
{ 
Const string ConnectionSstring = 
"server=(localdb) \MSSQLLocalDb; database=Books;trusted connection=true™"; 
VALI SeEIVices = Nnew ServiceCollection({():; 
Services.AddTransient<BooksService>() 
.AddEntityFrameworkSqlServer() 
.AddDbContext<BooksContext> (options 三 > 
optlions .UseSdqlServer (Connectionstring)); 


Pt 


Contaliner = services.BulilldServiceProvidert():; 


} 

public ServiceProvider Container { get; private set; } 

服务 的 初始 化 以 及 使 用 BooksService 在 Main0 方 法 中 完成 。 通 过 调用 IServiceProvider 的 GetService0 方 法 
检索 BooksService (代码 文件 UsingDependencyInjection/Program.cs): 


static async Task Main'() 
{ 
Var Pp = new Programl().; 
p.InitializeServices(); 
Pp.CconfigureLogging(); 
Var SerVlce = p.Container.GetService<BooksService> (); 
awalit service.AddBooksAsync(}).; 
SeErvice.ReadBooks () : 


} 

运行 应 用 程序 时 ， 可 以 看 到 ， 在 Books 数据 库 中 添加 和 读 取 记 录 。 

为 了 利用 这 个 应 用 程序 设置 配置 日 志 记 录 ， 可 以 通过 AddLogging 扩展 方法 把 ILoggerFactory 接口 添加 到 
DI 容器 中 : 


private void InitializeServices () 
{ 
Const string ConnectionSstring = 
"server=(localdb) \MSSQLLocalDb; database=Books;trusted connection=true"; 
TVaT SErIVices = new ServiceCollection():; 
services.AddTransient<BooksService>() 
.AddEntityFrameworkSqlServer () 
.AddDbContext<BooksContext> (options 三 > 
options .UseSqlServer (Connectionstring})); 
Services.AddLogging(}); 


Contalner = services.BulilldServiceProvidert{(); 


} 
接 痢 配置 日 志 记 录 。 在 ConfigureLogging 方法 的 实现 代码 中 ， 从 DI 容器 中 检索 ILoggerFactory。 使 用 这 个 
工厂 ， 会 添加 控制 人 台 ， 以 写 入 信息 日 志 : 


private void ConfigureLogging () 
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{ 
ILoggeIFactoDIY loggerFactory = Container.GetService<ILoggerFactory> (); 
loggerFactory.AddConsole (LogLevel .Information); 


EF Core 本 身 通过 注入 服务 来 使 用 ILoggerFactory 接口 ， 因 此 EF Core 日 志 现在 写 入 控制 台 ， 如 上 例 所 示 。 


26.4 创建 模型 


本 章 的 第 一 个 示例 映射 到 一 个 表 。 第 二 个 更 复杂 的 示例 展示 了 如 何 创 建 表 之 间 的 关系 。 新 数据 库 是 通过 编 
程 创 建 的 ， 当 然 也 可 以 先 创 建 数 据 库 ， 再 使 用 代码 访问 己 有 的 数据 库 。 


26.4.1 创建 关系 


下 面 开 始 创 建 模 型 。 示 例 项 目 使 用 MenuCard 和 Menu 类 型 定义 了 一 对 多 关系 。MenuCard 包含 Menu 对 
象 的 列表 。 这 个 关系 由 List<Menu> 类 型 的 Menu 属性 定义 (代码 文件 MenusSample/MenuCard.cs): 


public class MenuCard 
{ 
Public int MenuCardlId { get; set; } 
Public string Title { get; set; } 
public List<Menu> Menus { get; } = new List<Menu>(); 
public override string ToString{() => Title; 
} 


也 可 以 在 另 一 个 方向 上 访问 关系 ，Menu 可 以 使 用 MenuCard 属性 访问 MenuCard。 指 定 MenuCardId 属性 
来 定义 一 个 外 键 关系 (代码 文件 MenusSample/Menu.cs): 


Public class Menu 
{ 
public int MenuIa { get; set; } 
public string Text { get; set; } 
public decimal Price { get; set; } 
Public int MenuCardId { get; set; } 
public MenuCard MenuCard { get; set; } 
public override string ToString{} => Text; 
} 


到 数据 库 的 映射 是 通过 MenusContext 类 实现 的 。 这 个 类 的 定义 类 似 于 前 面 的 上 下 文 类 型 ; 它 只 包含 两 个 
属性 ， 映 射 两 个 对 象 类 型 ， Menus 和 MenuCards 属性 (代码 文件 MenusSamples/MenusContext.cs): 


Public class MenusContext: DbContext 
{ 
private const string Connectionstring = &"server=(]localdb) \MSSQLLocalDb;™ + 
"Database=MenuCards;Trusted Connection=True"; 


public Dhset<Menu> Menus 1{ get; set; } 
public Dbset<MenuCard> MenuCards 1{ get; set; } 


protected override void OnConfiguring (DbContextOptionsBuilder optionsBuilder) 


base .Onconfiguring (optionsBulillder); 
optionsBuilder.UseSqlServer (Connectionstring),; 


} 

在 创建 代码 中 修改 一 些 部 分 是 有 益 的 。 例 如 ，Text 和 Title 列 的 尺寸 可 以 减 小 NVARCHAR(MA 邓 ?中 的 值 。 
另外 ，SQL Server 定义 了 Money 类 型 ， 它 可 用 于 Price 列 ， 模 式 名 称 可 以 在 dbo 中 修改 。Entity Framework 提供 
了 两 个 选项 一 一 数据 注释 和 流利 API 一 一 用 于 在 代码 中 进行 这 些 修改 ， 如 下 面 所 述 。 


26.4.2 ”数据 注释 


要 影 啊 生成 的 数据 库 , 一 个 方法 是 给 实体 类 型 添加 数据 注释 。 默 认 情 况 下 , 表 的 名 称 来 自 于 上 下 文 的 属性 。 
因此 要 映射 Menu 类 ， 应 使 用 Menus 表 ， 因 为 映射 Menu 的 DbSet 属性 名 为 Menus。 有 了 数据 注释 ， 可 以 使 用 
Table 特性 来 改变 表格 。 要 改变 模式 名 称 ，Table 特性 定义 Schema 特性 。 为 了 给 字符 串 类 型 指定 男 一 个 长 度 ， 
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可 以 应 用 MaxLength 特性 (代码 文件 MenusWithDataAnnotations/MenuCard.cs): 


[Table ("MenuCcards", Schema = "mcC") ] 
Public class MenuCard 
{ 

public int MenuCardId 1{ get; set; } 


[MaxLength (120)1 
Public string Title { get; set; } 
Public List<Menu> Menus { get; } = new List<Menu> (1) ; 


注意 : 
EF Core 使 用 上 下 文中 的 属性 名 映射 到 表格 上 ， 这 不 同 于 Entity Framework。Entity Framework 使 用 一 个 字 
典 查找 单 复数 名 称 。 


在 Menu 类 中 ， 应 用 了 Table 和 MaxLength 特性 。 为 了 更 改 SQL 类 型 ， 可 以 使 用 Column 特性 (代码 文件 
MenusWithDataAnnotations/Menu.cs): 


[Table ("Menus", Schema = "mc")] 
Public class Menu 
{ 
PUublic int Menuld 1{ get; set; } 
[MaxLength (50)1] 
Public string Text { get; set; } 
[Column (TYPeName ="Money™")})] 
PUublic decimal Price { get; set; } 
Public int MenuCardId 1{ get; set; } 
public MenuCard MenuCard { get; set; } 
} 


应 用 迁移 并 创建 数据 库 后 ， 可 以 在 Tite、Text 和 Price 列 上 看 到 表 的 新 名 称 和 模式 名 称 ， 以 及 改变 了 的 数 
据 类 型 


CREATE TABLE [mc]. [Menucards] ( 

[MenuCcardId] INT IDENTITY (1, 1} NOT NULL., 

[Title] NVARCHAR (120) NULL, 

CONSTRAINT [PE MenuCardl] PRIMNARY EEY CLUSTERED ([MenuCcardId| ASC) 
) 5 


CREATE TABLE [me]. [Menus] ( 
[MenuId] INT IDENTITY {1, 1} NOT NULL, 
[MenucardId] INT NOT NULL., 
[Price] MONEY NOT NULL. 
[Text] NVARCHAR (350) NULL, 
CONSTRAINT [PE Menul PRIMARY EEY CLUSTERED ([Menuld] ASC)., 
CONSTRAINT [FE Menu MenuCard MenuCardId] FOREIGN KEY ([MenuCardId]) 
REFERENCES [me]. [MenuCcards] ([MenuCardId]} ON DELETE CASCADE 
) 5 


26.4.3 流利 API 


影响 所 创建 表 的 另 一 种 方法 是 通过 DbContext 派生 类 的 OnModelCreating 方法 使 用 流利 API。 使 用 它 的 优 
点 是 ， 实 体 类 型 可 以 很 简单 ， 不 需要 添加 任何 特性 ， 流 利 API 也 提供 了 比 应 用 特性 更 多 的 选择 。 

下 面 的 代码 片段 显示 了 BooksContext 类 的 OnModelCreating 方法 的 重 写 版 本 。 接 收 为 参数 的 ModelBuilder 
类 提供 了 一 些 方法 ， 定 义 了 一 些 扩展 方法 。HasDefaultSchema 是 一 个 扩展 方法 ， 把 默认 模式 应 用 于 模型 ， 现 在 
用 于 所 有 类 型 。Entity 方法 返回 一 个 EntityTypeBuilder， 人 允许 自 定 义 实 体 ， 如 把 它 映射 到 特定 的 表 名 ， 定 义 键 和 
索引 : 


protected override void OnModelcCreating (ModelBuilder modelBuilder) 
{ 
base.OonModelcCreating (modelBuilder).; 
modelBuilder.HasDefaultschema ("me"). 
modelBuilder.Entity<MenuCard> () 
.ToTable ("MenuCards"™) 
.HasEey (cc => c.MenuCardId}); 
/f/f..: 
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modelBuilder.Entity<Menu> () 
.ToTable ("Menus") 
.HasKey (m => m.MenulId); 


ff... 
} 
EntityTypeBuilder 定义 了 一 个 Property 方法 来 配置 属性 。Property 方法 返回 一 个 PropertyBuilder， 它 允许 用 
最 大 长 度 值 、 需 要 的 设置 和 SQL 类 型 配置 属性 ， 指 定 是 否 应 该 目 动 生成 值 (例如 标识 列 ): 


protected override void OnModelCreating (ModelBuilder modelBuilder) 


{ 
EE 
modelBuilder.Entity<MenuCard> () 
.Property({(c => c.MenuCardId) 


ValueGeneratedonAdd il():; 


modelBuilder.Entity<MenuCard> () 
.Property l(c => c.Title) 
.HasMaxLength (os0); 

le 


modelBuilder.Entity<Menu> () 
.Property (m => m.MenuId) 
ValueGeneratedOnAdd 1) 


modelBuilder.Entity<Menu> () 
.- Property (tm => m.Text) 
.HasMaxLength (120); 


modelBuilder.Entity<Menu> () 
.Property (m => m.Price) 
-HasColumnType ("Money™"); 


17。 
} 
要 定义 一 对 多 映射 ，EntityTypeBuilder 定义 了 有 映射 方法 。 方 法 HasMany 与 WithOne 结合 ， 用 一 个 祭 单 卡 定 
义 了 到 很 多 菜单 的 映射 。HasMany 需要 与 WithOne 链接 起 来 。 方 法 HasOne 需要 和 WithMany 或 WithOne 链接 
起 来 。 链 接 HasOne 与 WithMany， 会 定义 一 对 多 关系 ; 链接 HasOne 与 WithOne， 会 定义 一 对 一 关系 : 


protected override void OnModelCreating (ModelBuilder modelBuilder) 


{ 
77 
modelBuilder.Entity<MenuCard> () 


-HasMany l(c => CcC.Menus) 
-而 Ithone (mm => m.MenuCard).; 


modelBuilder.Entity<Menu> () 
.HasOne (m 一 > m.MenuCard) 


-WithMany (c => c.Menus) 
-HasForelignKey (m => m.MenuCardId); 


26.4.4” 自 包含 类 型 的 配置 
拥有 一 个 更 复杂 的 DbContext 后 ，OnModelCreating 方法 可 能 会 变 得 很 长 。EF Core 2.0 提供 了 一 个 新 选项 ， 

用 于 为 每 个 类 型 定义 配置 类 。 要 创建 一 个 配置 类 , 类 需要 使 用 方法 Configure 实现 接口 IEntityTypeConfiguration。 

为 MenuCard 类 型 创建 MenuCardConfiguration ， 可 以 简化 配置 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文 件 


MenusSample/MenuCardConfieuration.cs): 
public class MenuCardConfiguration : IEntityTypeConfiguration<MenuCard> 
{ 
Public void Configure (EntityTypeBulillder<MenuCard> bulilder) 
{ 
builder.ToTable ("MenuCards"™) 
-HasKey (cc => c.MenuCardId).; 
builder.Propertyl(c => c.MenuCardId) 
.ValueGeneratedonaAdd(}:; 
builder.Propertyl(c => c.Title) 
-HasMaxLength (S50); 


builder.HasMany (cc => c.Menus) 
.Withone (m => m.MenuCard)}):; 
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} 
} 


类 Mennu 的 配置 在 MenuConfiguration 类 中 定义 。EntityTypeBuilder 使 用 的 方法 与 前 面 使 用 的 方法 相同 。 代 
码 更 简单 ， 因 为 实体 类 型 不 需要 被 选中 ， 而 有 了 IEntityTypeConfiguration， 就 已 经 指定 了 实体 类 型 ， 


Public class MenuConfiguration : IEntityTypeConfiguration<Menu> 
{ 


Public VolIa Configure (EntityTypeBuillder<Menu> builder) 
{ 
builder.ToTable ("Menus"™) 
.HasEey (m => m.MenuId).; 


builder.Property (m => m.MenulId) 
ValueGeneratedoOnAddil(); 


builder.Property(m => m.Text) 
.HasMaxLength (120); 


builder.Property (m => m.Price) 
-HasCcolumnTyYpe ("Money™)s 


builder.Hasone (mm => m.MenuCard) 
.WithMany (m => m.Menus) 


.HasForeignKey (m => m.MenuCardId); 
} 


} 


MenusContext 类 的 OnModelCreating 方法 现在 可 以 简化 了 。 要 应 用 IEntityTypeConfiguration 类 型 的 配置 ， 
需要 调用 ModelBuilder 的 ApplyConfiguration 方法 (代码 文件 MenusSample/MenusContext.cs): 

protected override Vol OnModelCreating (ModelBuilder modelBuilder) 

{ 


base.OnModelCreating (modelBuilder).; 
modelBuilder.HasDefaultSchema ("me").; 


modelBuilder.ApplyCconfiguration (new MenuCardConfiguration()}); 


modelBuilder.ApplyConfiguration (new MenuConfiguration(})); 
} 


26.4.5 “在 数据 库 中 搭建 模型 


除了 从 模型 中 创建 数据 库 之 外 ， 也 可 以 从 数据 库 中 创建 模型 。 
为 此 ， 必 须 在 项 目的 包 列 表 中 添加 NuGet 包 Microsoft.EntityFrameworkCore.Design ， 在 
DotnetCliToolReference 元 素 中 添加 Microsoft.EntityFrameworkCore.Tools.Dotntet。 Microsoft.EntityFrameworkCore. 


Design 包 只 需要 用 于 项 目 本 身 ， 包 需要 用 于 引用 这 个 包 的 其 他 项 目 ， 所 以 可 以 指定 PrivateAssets 特性 (项 目 文 
件 ScaffoldSample/ScaffoldSample.csproj ): 


<Project Sdk="Microsoft.NET.Sdk"> 

<PropertyGroup> 
<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 
<PackageReference Include="Microsoft.EntityFrameworkCore"™" 

Version="2.0.0" /> 


<PackageReference Include="Microsoft.EntityFrameworkCore.SgqlServer" 
Version="2.0.0" /> 
«<PackageReference Include="Microsoft.EntityFrameworkCore.Design" 
Version="2.0.0" PrivateAssets="All"™" /> 
</ItemSroup> 
<ItemGroup> 
<DotNetCliToolReference 
Include="Microsoft.EntitvyFrameworkCore.Tools.Dotnet" 
Version="2.0.0" /> 
</ItemSroup> 
</Project> 


安装 了 工具 后 ， 就 可 以 在 Developer Command Prompt 中 启动 dotnet ef 命令 : 


> dotnet ef dbcontext scaffold 
"server=(localdb) \MSSOLLocalDb; database~MenuCards; 
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trus ted conne ction=true™" "Microsoft.EntityFrameworkCore.SgqlServer" 

dbcontext 命令 允许 列 出 项 目 中 的 DbContext 对 象 , 创建 DBContext 对 象 。scaffold 命令 创建 DbContext 派生 
类 以 及 模型 类 。dotnet ef dbcontext scaffold 命令 需要 两 个 参数 : 数据 库 的 连接 字符 串 和 应 该 使 用 的 提供 程序 。 
前 面 的 语句 显示 ， 在 SQL Server (localdb) \ MSSQLLocalDb 上 访问 数据 库 MenuCards。 使 用 的 提供 程序 是 
Microsoft.EntityFrameworkCore.SqlServer。 这 个 NuGet 包 和 需要 添加 到 项 目 中 。 

在 运行 了 这 个 命令 之 后 ， 可 以 看 到 生成 的 DbContext 派生 类 以 及 模型 类 型 。 模 型 的 配置 默认 使 用 流利 API 
来 完成 。 然 而 ， 可 以 改 为 使 用 数据 注释 ， 提供 --data-annotations 选项 。 也 可 以 影 啊 生成 的 上 下 文 类 名 以 及 输出 目 
录 。 使 用 选项 --help 可 以 查看 不 同 的 可 用 选项 。 


26.4.6 ”映射 到 字段 


EF Core 不 仅 允 许 将 表 列 映射 到 属性 ， 还 允许 映射 到 私有 字段 。 因 此 可 以 创建 只 读 属性 ， 使 用 在 类 之 外 无 
法 访问 的 私有 字段 。 

看 看 下 面 代码 片段 中 的 类 Book。 这 个 类 包含 一 个 私有 字段 bookId, 该 字段 只 能 在 类 中 访问 ( 它 是 在 ToString 
方法 中 使 用 的 )。Title 是 一 个 读 / 写 属性 ，Publisher 是 一 个 只 读 属性 。 发 布 者 使 用 字段 publisher。EF Core 在 类 
中 需要 的 是 一 个 默认 构造 函数 ， 但 是 这 个 构造 国 数 可 以 通过 private 访问 修饰 符 声 明 ( 代 码 文件 
BooksSample/Book.cs): 


Public class Book 

{ 
// parameterless constructor neeeded for EF Core 
private Book() 1{ } 


public Book(string title, string publisher) 
{ 

title = title; 

Publisher = publisher; 
} 


private int bookId = 0; 

public string Title { get; set; } 
private string publisher; 

public string Publisher => publisher; 


public override string ToString{() => 
"1id: { bookId}, title: {Title}, publisher: {Publisher}"™"; 
} 


为 了 避免 输入 错误 ， 对 于 列 名 ， 定 义 具 有 强 类 型 列 名 的 类 ColumnNames。 另 外 ，using static 声明 访问 没有 
类 名 的 const 值 (代码 文件 BooksSample/BooksContext.cs): 


UslIng static BooksSample.ColumnNames; 


namespace BooksSsample 
{ 
internal class ColumnNames 
{ 
Public const string LastUpdated = nameof (LastUpdated).,; 
Public const string IsDeleted = nameof (IsDeleted).; 
Public const string BookId = nameof (BookId); 
public const string AuthorId = nameof (AuthorId); 
} 
7 
} 


属性 Publisher 现在 可 以 配置 为 使 用 HasField 方法 映射 到 相应 的 字段 。_bookId 没有 相应 的 属性 ， 因 此 它 配 
置 了 Property 方法 的 一 个 重 载 , 该 方法 将 名 称 指定 为 string。 这 将 数据 库 表 中 的 BookId 列 映射 到 字段 bookId( 代 
码 文 件 BooksSample/BooksContext.cs): 


protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 

base.onModelCreating (modelBuilder); 

FB 


modelBuilder.Entity<Book> () .Propertyl(b => b.Title) 
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.IsSREeGUITeEGI) 
-HasMaxLength (50); 


modelBuilder.Entity<Book>{(}) .Property{(b => b.Publisher) 
-HasField(" publisher"™) 
.IsRedquired (false) 
-HasMaxLength (30):; 


modelBuilder.Entity<Book> (}) .Property<int»> (BookId) 
-HasField!(" bookId") 
.IsRequired(); 


modelBuilder.Entity<Book> () 
.HasEey (BookId}); 
} 


在 创建 Book 对 象 时 , 需要 使 用 构造 函数 。 属 性 没有 set 访问 器 。 初始 化 Book 对 象 后 , 使 用 AddRangeAsync 
方法 将 其 添加 到 BooksContext 中 (代码 文件 BooksSample/Program.cs): 


private async Task AddBooksAsync{) 


{ 
uUSing (Var context = new BooksContext () ) 
{ 
Var bl = new Book("Professional C# 6 and -NET Core 1.0"™, "Wrox Press"™); 
Var b2 = new Book("Professional C# 5 and -NET 4.5.1™, "Wrox Press"); 
Var b3 = new Book("JavaSscript for Kids™", "Wrox Press"™); 
Var bd = new Book("Web Design with HTML and CSS", "FoOr Dummiles™); 
await context.Books.AddRangeAsync (bl, b2, b3, b4); 
int records = awalt context.SaveChangesAsync(); 
Console.WriteLine($"{records} records added™).: 
} 
Console .WriteLine (); 
} 


26.4.7 阴影 属性 


EF Core 不 仅 允 许 将 数据 库 列 映射 到 私有 字段 ， 还 可 以 定义 一 个 在 模型 中 根本 不 显示 的 映射 。 可 以 使 用 阴 
影 属性 ， 这 些 属性 可 以 用 上 下 文中 的 实体 来 检索 ， 但 不 能 用 于 模型 。 
阴影 属性 定义 为 字符 串 。 为 了 避免 在 多 次 使 用 这 些 字符 串 时 出 现 拼 写 错 误 ， 指 定 了 一 个 定义 背 量 字符 串 的 
类 (代码 文件 BooksSample/BooksContext.cs): 
public class ColumnNames 
public const string LastUpdated = nameof (LastUpdated); 
PUublic const string IsDeleted = nameof (IsDeleted).; 


Public const string BookId = nameof (BookId); 
} 


要 访问 类 的 成 员 而 不 使 用 类 名 ， 使 用 using static 声明 : 
USing static MappingToFields.ColumnNames; 
下 面 的 代码 片段 使 用 前 面 定义 的 强 类 型 字符 串 来 定义 IsDeleted 和 LastUpdated 阴影 属性 : 


protected override void OnModelcCreating (ModelBuilder modelBuilder) 


{ 
base.OnModelCreating (modelBuilder); 


ffs 


// shadow properties 
modelBuilder.Entity<Book>(}) .Property<bool> (IsDeleted);} 
modelBuilder.Entity<Book> () .Property<DateTime> (LastUpdated); 


) 
阴影 属性 LastUpdated 用 于 编写 实体 最 后 更 新 的 实际 时 间 。IsDeleted 属性 用 于 定义 删除 实体 的 状态 ， 而 不 
是 删除 它 。 有 时 ， 不 删除 用 户 请 求 的 数据 ， 而 把 它 标记 为 已 删除 是 很 有 用 的 。 这 人 允许 执行 撤销 来 恢复 实体 ， 并 
提供 历史 信息 。 
要 自动 更 新 阴影 属性 LastUpdated， 需 要 重 写 SaveChangesAsync 方法 。 如 果 使 用 同步 SaveChanges 方法 向 
数据 库 写 入 更 改 , 那么 也 需要 重 写 此 方法 . 在 实现 代码 中 , 将 检查 实体 的 实际 状态 。 如果 状态 是 Added、 Modified 
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或 Deleted, 则 使 用 当前 时 间 更 新 阴影 属性 。 要 管理 阴影 属性 IsDeleted, 删除 的 实体 改 为 Modified 状态 , IsDeleted 
阴影 属性 设置 为 tue。 阴 影 属性 在 允许 访问 它 的 模型 中 没有 属性 ; 相反 ， 可 以 使 用 EntityEntry 的 CurrentValues 
索引 器 (代码 文件 BooksSample/BooksContext.cs): 


Public override Task<int> SaveChangeshsync (CancellationToken cancellationToken 
= default) 

{ 
ChangeTracker.DetectChanges () 7 


foreach (var item in ChangeTracker.Entries<Book> () 


-Wherel(e => e.State == EntityState.Added || 
e.State == EntityState.Modified || 
e.State == EntitySstate.Deleted)) 


{ 
item.CurrentValues[LastUpdated] = DateTime.Now; 


if (item.state == EntitySstate.Deleted) 
{ 
item.Sstate = EntitySsState.Modified.; 
item.CurrentValues[IsDeleted] = 七 TUE ; 
} 
} 


return base.SaveChangesAsync (cancellationToken); 


} 


注意 : 
示例 代码 使 用 的 更 改 跟踪 器 参见 “对 象 跟踪 ”一 节 。 


注意 : 
有 了 IsDeleted 属性 , 在 使 用 正常 查询 时 , 最 好 不 返回 设置 了 IsDeleted 属性 的 实体 ,而 可 以 使 用 EF Core 2.0 
特性 一 一 全 局 查询 过 滤器 来 实现 这 一 点 ， 该 特性 将 在 后 面 的 小 节 中 讨论 。 


为 了 显示 已 删除 的 实体 ， 定义 了 DeleteBookAsync 方法 ， 该 方法 使 用 传递 给 该 方法 的 来 删除 实体 。 在 这 
里 ， 通 过 传递 实体 对 象 来 调用 Remove 方法 ， 并 调用 SaveChanges( 代 码 文件 BooksSample/Program.cs): 


private async Task DeleteBookAsync (int id) 
{ 
USing (Var context = new BooksContext () ) 
{ 
Book b = awalt context.Books.FindAsync (id); 
if (bb == null}) return; 


Context .Books .Remove (b).; 
int records = awalt context.SaveChangesAsync(); 
Console.WriteLine(s$"{records} books deleted™}).; 
} 
Console .WriteLine'().; 


} 

在 幕后 ， 由 于 对 SaveChangesAsync 方法 的 更 改 而 设置 了 IsDeleted 阴影 属性 。 要 验证 这 一 点 ， 可 以 使 用 方 
法 EF.Property， 通 过 传递 IsDeleted 字符 串 ， 来 访问 阴影 属性 。 所 有 带 有 此 标志 的 Book 实体 都 显示 在 
QueryDeletedBooksAsync 方法 中 : 


private async Task QueryDeletedBooksAsyncl() 
{ 
USing (Var context = new BooksContext () ) 
{ 
IEnumerable<Book> deletedBooks = 
awalit context .Books 
.Wherel(lb => EF.Property<bool>(b, IsDeleted)) 
.TOListAsync (); 


foreach (var book In deletedBooks) 
{ 
Console .WriteLine (S$"deleted: {book}™):-; 
} 
} 
} 
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注意 : 

EF 是 Microsoft EntityFrameworkCore 名 称 空间 中 的 一 个 静态 类 ， 在 EF 类 型 不 可 用 时 ， 它 提供 了 有 用 的 静 
态 方法 。 本 节 介 绍 了 可 以 用 于 访问 阴影 状态 的 Property 方法 。 在 本 章 后 面 ，EF 类 与 编译 的 查询 和 EF.Functions 
一 起 使 用 。 


26.5 ”查询 


前 面 定义 了 模型 ， 下 面 了 角 
基本 查询 

在 服务 器 和 客户 端 上 评价 
原始 SQL 查询 
编译 过 的 查询 有 更 好 的 性 能 
全 局 查询 过 滤器 


FF.Functions 


尘 和 查询 的 更 多 细节 。 本 节 讨 论 : 


26.5.1 基本 查询 


如 前 所 述 ， 访 问 DbSet 的 上 下 文 属性 将 返回 指定 表 的 所 有 实体 的 列表 。 下 面 详细 讨论 。 
访问 Books 属性 ， 会 从 数据 库 中 检索 所 有 Book 记录 (代码 文件 BooksSample/QuerySamples.cs): 
A async Task QueryAllBooksAsyncl!() 


Console .WriteLine (nameof (QueryAllBooksAsync) )}; 
usSing (var context = new BooksContext () ) 
{ 
List<Book»> books = await context .Books.ToListAsync().; 
foreach (var b in books) 
{ 
Console .WriteLine (PP) ; 
} 
} 
Console .WriteLine(); 


} 
有 了 异步 API， 也 可 以 使 用 从 ToAsyncEnumerable 方法 返回 的 LAsyncEnumerable 接口 ， 使 用 ForEachAsync 
方法 而 不 是 foreach 循环 : 


awalt context.Books.ToAsyncEnumerable() 
.ForEachAsync(b 一 > 
{ 
Console.WriteLine (b}).: 


}) 5 
访问 Books 属性 ， 会 把 下 面 的 SQL 语句 发 送 到 数据 库 : 
SELECT [bl]. [BookId], [bl].[IsDeleted], [b].[LastUpdated], [lb]. [Publisherl], 


[b] . [Titlel] 
FROM [Books] aS [b] 


可 以 使 用 Find 和 FindAsync 方法 查询 具有 特定 键 的 对 象 。 如 果 没 有 找到 记录 ， 该 方法 就 返回 null: 
Book 了 = await context.Books.FindAsync (19q) ; 
if (tp != null) 


{ 
站 


这 就 得 到 了 一 个 带 有 TOP(1) 和 WHERE 子 句 的 SELECT SQL 语句 : 


SELECT TOP'(1) [el1. [BookId], [ee].[IsDeletedl, [él]. [LastUpdatedl], 
[e] . [Publisher], [el].[Titlel] 

FROM [Books] BS [ee] 

WHERE [e].[BookId] = @ get Item 0 


与 使 用 Find 方法 不 同 ， 还 可 以 使 用 同步 的 Single 或 SingleOrDefault 方法 ， 或 者 使 用 异步 变 体 SingleAsync 
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或 SingleOrDefaultAsync。Single 和 SingleOrDefault 的 区 别 在 于 ，Single 在 没有 找到 记录 时 抛 出 异常 ， 而 
SingleOrDefault 会 在 没有 找到 记录 时 返回 null。 这 些 方 法 还 在 找到 多 个 记录 时 抛 出 一 个 异常 。 
下 面 的 代码 片段 使 用 SingleOrDefaultAsync 方法 来 请 求 书 名 : 
Book book = await context.Books.SingleOrDefaultAsync (b => b.Title =- title); 
生成 的 SQL 语句 要 求 TOP(2) 记 录 ， 它 允许 在 找到 两 个 记录 时 抛 出 异常 : 
SELECT TOP(2) [bl]. [BookId], [b].[IsDeleted], [b].[LastUpdated], 
[b] . [Publisher], [b].[Title] 


FROM [Books] AS [bl| 
WHERE [Bb].[Titlel] = @ title 0 


Where 方法 允许 基于 条 件 进行 简单 的 过 滤 。 还 可 以 在 Where 表达 式 中 使 用 Contains 方法 。Where 方法 没有 
可 用 的 异步 变 体 , 因为 Where 方法 使 用 了 惰性 求 值 。 可 以 使 用 foreach 语句 来 迭代 查询 的 所 有 结果 ,然而 , foreach 
会 触发 查询 的 执行 ,阻塞 线程 , 直到 检索 到 结果 。 与 使 用 foreach 和 Where 方法 的 结果 不 同 , 可 以 使 用 ToListAsync 
立即 触发 执行 ， 但 要 在 任务 中 执行 : 

List<Book> wroxBooks = await context.Books 


-Where(b => b.Title.Contains (title})) 
.TIoListAsvnec(); 


生成 的 SQL 语句 使 用 了 SQL 子 句 中 一 个 简单 的 WHERE: 
SELECT [b]. [BookId], [bl].[IsDeleted], [Lb]. [LastUpdated], [b]. [Publisherl], 
[b] . [Title] 

FROM [Books] AS [bl 

WHERE (CHARINDEX(@ title 0, [b].[Title]) > 0) or (@ title 0 = N'') 

在 第 12 章 中 详细 介绍 了 更 多 的 LINQ 方法 和 LINQ 子 句 , 也 可 以 在 EF Core 中 使 用 它们 。 请 记 住 , LINQ to 
Objects 和 LINQ to EF Core 的 实现 是 不 同 的 。 在 LINQ to EF Core 中 ， 使 用 表达 式 树 可 以 在 运行 时 使 用 完整 的 
LINQ 表达 式 创建 SQL 查询 。 在 LINQ to Objects 中 ， 大 多 数 LINQ 坦 询 都 是 在 Enumerable 类 中 定义 的 。 带 有 表 
达 式 树 的 LINQ 在 Queryable 类 中 实现 ， 对 EF Core( 如 异步 变 体 ) 的 许多 增强 在 
EntityFrameworkQueryableExtensions 类 中 实现 。 有 关 表 达 式 树 的 更 多 信息 ， 请 参见 第 12 章 。 


26.5.2 客户 端 和 服务 器 求 值 


不 是 查询 的 每 个 部 分 都 可 以 转换 为 SQL 语句 ， 从 而 在 服务 器 上 运行 。 有 些 部 分 需要 在 客户 端 上 运行 。EF 
Core 允许 进行 透明 的 客户 端 和 服务 器 求 值 。 如 果 碍 询 不 能 解析 ， 会 自动 在 客户 端 上 运行 。 这 对 于 使 用 不 同 的 提 
供 程序 有 很 大 的 优势 。 例 如 ， 对 于 一 个 提供 程序 ， 可 以 在 服务 器 上 对 碍 询 进 行 完 全 的 求 值 。 使 用 不 转换 所 有 和 碍 
询 的 另 一 个 提供 程序 ， 程 序 仍 然 运行 ， 但 是 有 些 部 分 现在 在 客户 端 上 进行 求 值 。 

下 面 看 一 个 n-n 关系 的 示例 。Book 类 型 与 Author 类 型 通过 一 个 关联 实体 关联 。 一 本 书 可 以 由 多 名 作者 写 ， 
一 个 作者 也 可 以 写 多 本 书 。 

下 面 的 代码 片段 通过 Books 属性 访问 Book 对 象 Where 方法 用 于 过 滤 , OrderBy 方法 定义 顺序 。 使 用 Select 
方法 定义 结果 一 一 包括 使 用 BookAuthors 属性 与 作者 关联 : 

var books = context.Books 

-Where(b => b.Title.SstartsWith ("Pro™")) 
-OrderBy(b => Db.Title) 
-Select (bb => new 
b.Title, 
BAuthors = b.BookAuthors 
}); 

所 有 这 些 都 使 用 EF Core 2.0 转换 为 SQL 语句 。 求 值 完 全 在 服务 器 上 进行 , 使 用 Select, INNER JOIN、Where 
和 ORDER BY， 通 过 关联 转换 Where、OrderBy 和 Select: 

SELECT [b.BookAUuthors]. [BookId], [b.BookAuthors]. [AuthorIdl 

FROM [BookKAuUuthors] AS3 [b.BookAuthors] 

INNER JOIN ( 

SELECT [b0].[BookId], [b0].[Titlel] 


FROM [Books] A3 [lb0] 
WHERE [BB0]. [Title] LIKE N'Pro" + N'$"' AND (LEET( [Pb0] . [Titlel], LEN(N' PIOoO"')}) = 
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HN" PP -. 自 ) 

】 ES 人 [b.BookAuthors]. [BookId] = [tt]. [BookId] 

ORDER BY [七 ] . [Title], [t]. [BookId] 

如 果 将 Select 语句 修改 为 返回 包含 作者 的 逗号 分 隔 字 符 串 ， 那 么 结果 将 非 章 不同。 这 在 下 面 的 代码 片段 中 
完成 : 把 一 个 字符 串 分 配给 Authors 属性 。 使 用 关系 BookAuthors， 只 选择 作者 的 FirstName 和 LastName 属性 ， 
string.Join 把 列表 连接 到 一 个 字符 串 上 (代码 文件 BooksSample/QuerySamples.cs): 

Var books = context .Books 

.Where(b 一 > b.Title.startsWith ("Pro")) 
.OrderBy(b => b.Title) 
.SeElect (bb =»> new 
{ 
b.Title, 
Authors = string.Joint("”, ", b.BookAuthors.Selectl(a => 
ss"{a.Author.FirstName} {a.Author .LastName}") .ToArray ()) 
1) 5 


EF Core 2.0 无 法 将 此 查询 转换 为 SQL 语句 。 来 自 EF Core 的 日 志 信 息 显 示 了 这 个 警告 : 


Warn: Microsoft.EntityFrameworkCore.Query[200500] 
The LINQ expression join Author a.Author in Value 
Microsoft.EntityFrameworkCore.Query.IInternal .EntityQueryable 1[ 
BooksSsample.Author]l} on Froperty([alj, "AuthorId") equals 
Property{({[la.Author]l, "AuthorId™}'" 
could not be translated and will be evaluated locally. 


现在 执行 三 个 查询 。 这 些 查 询 的 结果 在 客户 端 上 连接 。 应 用 程序 仍然 可 以 工作 , 但 是 查询 并 没有 那么 有 效 。 
三 个 语句 在 SQL Server 中 执行 ， 而 不 是 执行 一 个 语句 。 分 析 查 询 时 ， 可 以 看 到 在 客户 机 上 执行 求 值 之 前 ， 所 有 
的 作者 都 是 从 服务 器 中 检索 的 。 这 可 能 会 导致 加 客户 端的 大 量 转移 : 

SELECT [b].[Title], [bl]. [BookId] 

FROM [Books] B23 [bl] 

WHERE [Bb].[Title] LIKE N'PIro" + N'%' AND (LEFT ([b] . [Titlel], LEN{(N'Pro" YY})} = 

RT ro") 

BY [b]. [Title] 

SELECT [Lb0]. [BookId], [b0]. [AuthorId] 

FROM [BooFKAuthors] AS [b0] 

WHERE @ outer BookId = [b0] . [BookIG] 


SELECT [a.Author]. [AuthorIid], [a.Author]. [FirstName], [a.Author]. [LastName] 
FROM [Authors] AS [a.BAuthorl] 


自动 进行 客户 端 和 服务 器 的 求 值 是 很 实用 的 。 与 EF Core 1.0 不 同 ， 用 于 EF Core 2.0 的 SQL Server 提供 程 
序 可 以 在 服务 器 上 进行 更 多 的 求 值 ， 未 来 的 版 本 甚至 可 能 在 服务 器 上 文 持 更 多 的 求 值 。 使 用 其 他 提供 程序 可 能 
会 有 不 同 的 结果 。 效 率 是 不 同 的， 但 至 少 程序 是 有 效 的 。 

为 了 避免 在 服务 器 上 进行 求 值 ， 可 以 配置 上 下 文 ， 使 求 值 仅 在 服务 器 上 进行 时 抛 出 异 利 。 为 此 ， 在 配置 上 
下 文 时 ， 可 以 在 optionsBuilder 上 调用 ConfigureWarnings 方法 : 

optionsBuilder.UsesqlServer (Connectionstring) 


.ConfigureWarnings (warnings = 
Warnings.Throw (RelationalEventId.mueryClientEvaluationWarning))}.; 


警告 : 

客户 端 和 服务 器 求 值 是 一 个 很 好 的 特性 ， 可 以 使 程序 在 不 同 的 提供 程序 之 间 工 作 。 然 而 ， 这 会 导致 性 能 损 
失 。 要 为 了 获得 最 佳 性 能 而 定义 查询 ， 可 以 通过 配置 抛 出 异常 ， 来 发 现在 客户 端 进行 求 值 的 情况 。 然 后 可 以 相 
应 地 更 改 查询 。 


26.5.3 原始 SQL 查询 


EF Core 2.0 还 允许 定义 原始 SQL 碍 询 ， 原 始 SQL 查询 返回 实体 对 象 并 跟踪 这 些 对 象 。 只 需要 调用 DbSet 
对 象 的 FromSql 方法 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文 件 BooksSample/QuerySamples.cs): 
private async Task RawSqlQuery (string publisher) 


| 


Console.WriteLine (nameof (RawSgqlQuery) ); 
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using {var context = new BooksContext () ) 
{ 

IList<Book> books = await context .Books .FromSsql( 
S$"SELECT * FROM Books WHERE Publisher = {publisher}") 
.ToListAsync(}); 

foreach {var b in books) 


Console .WriteLine($"{b.Title} {b.Publisher}™); 
} 
} 
Console .WriteLine ().; 


} 

分 配给 RawSql 方法 的 SQL 查询 需要 返回 作为 模型 一 部 分 的 实体 类 型 ， 需 要 返回 模型 所 有 属性 的 数据 。 

分 配给 FromSql 方法 的 SQL 字符 串 可 能 看 起 来 像 SQL 注入 ， 因 为 字符 串 被 定义 了 了。 然而， 事实 并 非 如 此 。 
FromSql 要 求 分 配 一 个 FormattableString 类 型 。 对 于 这 个 FormattableString, EF Core 提取 参数 并 创建 SQL 参数 。 

注意 : 

有 关 字 符 串 插值 和 FormattableString 类 型 的 更 多 信息 ， 请 参阅 第 9 章 。 


26.5.4 已 编译 查询 


对 于 需要 反复 执行 的 查询 ， 可 以 创建 一 个 只 需要 执行 的 已 编译 查询 。 可 以 使 用 EF.CompileQuery 创建 已 编 
译 的 查询 。 此 方法 提供 了 不 同 的 泛 型 重 载 ， 可 以 在 其 中 传递 不 同 数量 的 参数 。 在 下 面 的 代码 片段 中 ， 创 建 一 个 
查询 来 定义 一 个 字符 串 参数 。 该 方法 需要 一 个 委托 参数 ， 其 中 第 一 个 参数 是 类 型 BooksContext， 第 二 个 参数 是 
字符 串 一 一 这 里 使 用 的 是 publisher。 定 义 已 编译 的 查询 后 ,可 以 使 用 它 传 递 上 下 文 和 参数 (代码 文件 BooksSample/ 
QuerySamples.cs): 

private void CompiledQuery () 

Console .WriteLine (nameof (CompiledQuery)); 

Func<BooksContext, string, IEnumerable<Book>> uery = 
EF .Compilenmuervy<BooksContext, string, Book>( (context, publisher) => 
context .Books .Where(b = b.Publisher == publisher)).; 
UslIng (Var context = new BooksContext ()) 


IEnumerable<Book> books = query (context, "Wrox Press"™}; 


foreach {var b in books) 
{ 
Console.WriteLine ($"{b.Title} {b.Publisher}™); 
} 
} 
Console.WriteLine(}).; 


} 


可 以 为 成 员 字 段 创 建 一 个 已 编译 的 查询 ， 以 便 在 需要 的 时 候 使 用 它 ， 并 且 可 以 根据 需要 ， 传 递 不 同 的 上 下 
文 ， 调 用 查询 。 


26.5.5 全 局 查询 过 滤器 


本 章 的 前 面 介 绍 了 使 用 IsDeleted 列 的 阴影 状态 .不 需要 为 每 个 查询 定义 WHERE 子 句 , 以 避免 返回 ISDeleted 
为 真 的 记录 ; 相反 , 可 以 在 创建 模式 时 定义 全 局 查询 过 滤器 ,这 是 下 一 个 代码 片段 所 做 的 一 -全 局 检查 ISDeleted。 
为 IsDeleted 并 没有 映射 到 模型 ， 而 只 是 通过 阴影 状态 来 检查 ， 所 以 可 以 使 用 EF.Property 检索 值 (代码 文件 
BooksSample/BooksContext.cs): 

Bee override void OnModelCreating (ModelBuilder modelBuilder) 


base.OnModelCreating (modelBuilder); 


modelBuilder .Entity<Book>() .HasmuervFilter( 
b => IEF.Property<bool>(b, IsDeleted)).; 
| 
} 
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在 定义 了 这 个 查询 过 滤器 之 后 ， 在 该 上 下 文 使 用 的 每 个 查询 中 都 添加 了 对 IDeleted 的 WHERE 检查 。 


注意 : 

全 局 查询 过 滤器 也 适用 于 多 租户 需求 。 可 以 为 特定 的 tenant-id 筛选 上 下 文 的 所 有 查询 。 在 构建 上 下 文 时 ， 
只 需要 传递 tenant-id。 不 使 用 依赖 注入 ， 可 以 将 tenant-id 传递 给 构造 函数 。 使 用 依赖 注入 ， 只 需要 指定 一 个 用 
构造 函数 注入 的 服务 ， 其 中 ， 可 以 在 查询 过 滤器 中 检索 tenant-id。 


注意 : 
可 以 忽略 全 局 查询 过 滤器 .例如 ,要 获取 所 有 被 删除 的 实体 ,可 以 使 用 带 有 LINQ 表 达 式 的 IgnoreQueryFilters 


26.5.6 EF.Functions 


EF Core 允许 自 定 义 扩 展 方法 可 以 由 提供 程序 实现 。 为 此 , EF 类 定义 了 DbFunctions 类 型 的 Functions 属性 ， 
它 可 以 使 用 扩展 方法 进行 扩展 。 在 撰写 本 文 时 ，Like 方法 是 关系 数据 提供 程序 的 这 样 一 种 扩展 。 

下 面 的 代码 片段 使 用 EF.Functions.Like, 并 提供 包含 参数 titleSegment 的 表达 式 , 增强 了 Where 方法 的 查询 。 
参数 tileSegment 网 入 在 两 个 % 字 符 内 (代码 文件 BooksSample/QuerySample.cs): 


Public static async Task UseEFCunctions (string titleSegment) 


Console .WriteLine (nameof (UseEFCUuNnctions)).; 
usSing (var context = new BooksContext ()) 


string likeExpression = S$"%{titleSegqgment}$".; 
ILiSt<Book> books = await context.Books .Wherel 
b => EF.Functions.Like(b.Title, likeExpression)) .ToListAsync(); 


foreach (var b In books) 


Console .WriteLine ($"{b.Title} {b.Publisher}™"}); 


Console .WriteLine (}); 


} 
运行 应 用 程序 时 ， 包 含 EF.Functions.Like 的 Where 方法 转换 为 带 有 LIKE 的 SQL 子 句 WHERE: 
SELECT [pb] - [BookIQ] ， [b].[IsDeleted], [b].[LastUpdated], [bp] . [Publisher], 

[也 ] . [Titlel] 


FROM [Books] BAS [lb] 
WHERE ([b].[IsDeleted] = 0) AND [b].[Title] LIKE @ likeExpression 1 


26.6 关系 


关系 可 以 定义 为 一 对 一 或 一 对 多 。 对 于 多 对 多 关系 ， 在 EF Core 2.0 中 ， 需 要 在 关系 中 指定 一 个 中 间 类 ， 从 
而 将 该 关系 分 割 为 一 对 多 关系 和 多 对 一 关系 。 
关系 可 以 使 用 约定 、 注 释 和 流利 API 来 指定 。 下 一 节 将 讨论 这 三 种 变 体 。 


26.6.1 使 用 约定 的 关系 

定义 关系 的 第 一 个 方法 是 使 用 约定 。 下 面 看 一 下 使 用 Book 和 Chapter 类 型 的 例子 。 一 本 书 可 以 有 多 个 章节 ; 
因此 ， 这 是 一 对 多 关系 。Book 类 型 还 定义 了 与 作者 的 关系 。 这 里 ， 作 者 由 User 类 表示 。 稍 后 ， 使 用 注释 定义 
关系 时 ， 会 解释 这 个 名 称 的 原因 。 书 与 作者 定义 了 一 对 一 的 关系 。( 对 于 有 多 个 作者 的 书 ， 书 中 指定 的 作者 是 主 
要 作者 。) 
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书 是 由 Book 类 定义 的 。 这 个 类 有 一 个 主键 BookId, 它 是 根据 其 名 称 而 创建 的 。 关 系 由 Chapters 属性 定义 。 
Chapters 属性 为 List<Chapter> 类 型 ， 这 就 是 Book 类 型 定义 一 对 多 关系 所 需 的 全 部 内 容 。 书 与 作者 的 关系 由 类 
型 User 的 Author 属性 指定 。 还 可 以 定义 该 类 型 的 AuthorId 属性 来 指定 外 键 , 该 属性 与 User 类 中 的 键 相同 。 如 
果 没 有 这 个 定义 ， 就 会 创建 一 个 阴影 属性 (代码 文件 RelationUsingConventions/Book.cs): 


Public class Book 
{ 
public int BookId { get; set; } 
public string Title { get; set; } 
Public List<Chapter> Chapters { get; } = new List<Chapter>(}).; 
Public User Author {1 get; set; } 
} 


注意 : 
Chapter 属性 的 另 一 种 可 能 实现 是 定义 List<Chapter> 类 型 的 读 / 写 属性 ， 而 不 需要 事先 创建 实例 。 有 了 这 样 
的 实现 ， 实 例 将 自动 从 EF Core 上 下 文中 创建 。 


章节 由 Chapter 类 定义 。 使 用 Book 属性 定义 关系 。 一 对 多 关系 定义 了 一 方 的 集合 (Book 定义 了 Chapter 对 
象 的 集合 )， 和 男 一 方 的 简单 关系 (Chapter 定义 了 一 个 简单 的 属性 Book)。 使 用 一 章 的 Book 属性 ， 可 以 直接 访问 
相关 图 书 。 对 于 这 种 类 型 ，BookId 属性 指定 Book 的 外 键 。 正 如 Book 类 型 所 述 ， 如 果 未 将 BookId 指定 为 类 的 
成 员 ， 则 通过 约定 创建 阴影 属性 (代码 文件 RelationUsingConventions/Chapter.cs): 


Public class Chapter 

{ 
public int ChapterId { get; set; } 
public int Number { get; set; } 
public string Title { get; set; } 
Public int BookId { get; set; } 
Public Book Book { get; set; } 


= 键 的 Userld 属性 、 关 系 的 Name 属性 和 AuthoredBooks 属性 (代码 文件 RelationUsineConventions/User.cs): 


Public class User 
{ 

Public int UserId { get; set; ]} 

public string Name { get; set; } 

public List<Book> AuthoredBooks { get; set; } 
} 


上 下 文 只 需要 使 用 DbSet<T> 类 型 的 属性 为 Book、Chapter 和 User 类 型 指定 属性 (代码 文件 
RelationUsineConventions/BooksContext.cs): 


Public class BooksContext : DbContext 
{ 


private const string Connectionstring = 
&"server= (localdb) \MSSQLLocalDb; database=Books;trusted connection=true™; 


protected override void OnCconfijguring (DbContextOptionsBuilder optionsBullder) 
base .OnCconfiguring (optionsBulilder); 
optionsBuilder.UseSqlServer (Connectionstring).; 
Public DbhSet<Book> Books { get; set; 上 
Public DbhSset<Chapter> Chapters 1 get; set,; } 


Public DbhSet<User> Users { get; set; } 
} 


注意 ;: 

可 下 载 的 示例 代码 包含 生成 数据 库 的 代码 和 生成 示例 数据 的 代码 。 因 为 这 段 代 码 与 本 章 前 面 的 代码 非常 相 
似 ， 所 以 后 面 的 示例 并 没有 特别 涉及 它 。 更 多 信息 请 参考 可 下 载 的 代码 示例 。 

在 启动 应 用 程序 时 ， 使 用 按照 约定 定义 的 映射 创建 数据 库 。 图 26-2 显示 了 Books、Chapters 和 Users 表 及 
其 关系 。Book 类 不 为 Users 类 型 定义 外 键 属性 ， 而 是 创建 一 个 AuthorUserId 填充 阴影 属性 : 
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Books Chapters 
党 Bookld 人 Chapterld 
AuthorUserld Bookld 
Trtle Number 
Title 


图 26-2 
在 介绍 定义 关系 的 不 同方 法 (使 用 注释 和 流利 APD 之 前 ， 先 看 看 如 何 使 用 查询 访问 相关 数据 。 


26.6.2” 显 式 加 载 相 关 数 据 


如 果 查 询 书 籍 并 希望 显示 相关 属性 (例如 ， 相 关 章 节 和 相关 作者 )， 则 可 以 使 用 关系 的 显 式 加 载 。 

请 看 下 面 的 代码 片段 。 查 询 请 求 所 有 具有 指定 标题 的 图 书 ， 并 且 只 需要 一 个 记录 。 如 果 试 图 在 启动 查询 之 
后 访问 所 得 图 书 的 Chapters 和 Author 属性 ， 那 么 这 些 属性 的 值 为 npull。 关 系 不 是 隐 式 加 载 的 。EF Core 使 用 上 
下 文 的 Entry 方法 来 文 持 显 式 加 载 ， 该 方法 通过 传递 一 个 实体 来 返回 EntityEntry 对 象 。EntityEntry 类 定义 了 允 
许 显 式 加 载 天 系 的 Collection 和 Reference 方法 。 对 于 一 对 多 关系 ， 可 以 使 用 Collection 方法 来 指定 集合 ， 而 一 
对 一 关系 需要 Reference 方法 来 指定 关系 。 使 用 Load 方法 进行 显 式 加 载 (代码 文件 RelationUsingConventions/ 
Program.cs): 


private static void ExplicitLoading() 
{ 
Console .WriteLine (nameof (ExplicitLoading)).; 
usSing (Var context = new BooksContext () ) 
{ 
var book = context .Books 
.Where(b => b.Title.StartsWith ("Professional C# 7")) 
.FirstorDefault(); 
if (book != null) 
{ 
Console .WriteLine (book.Title}).; 
Context .Entry (book) .Collectiont(b => b.Chapters) .Load (}); 
context .Entry (book) .Reference (lb => b.AMuthor}) .Load().; 
Console .WriteLine (book.Author.Name).; 
foreach (Var chapter in book.Chapters) 
{ 
Console.WriteLine ($"{chapter.Number}. {chapter.Title}"); 
} 
} 
} 
Console .WriteLine (}); 


} 
实现 Load 方法 的 NavigationEntry 类 也 实现 了 IsLoaded 属性 ， 可 以 在 其 中 检查 关系 是 否 已 经 加 载 。 在 调用 
Load 方法 之 前 ， 不 需要 检查 加 载 的 关系 ; 在 调用 Load 方法 时 ， 如 果 关 系 已 经 加 载 ， 就 不 会 再 次 查询 数据 库 。 
当 对 图 书 的 查询 运行 应 用 程序 时 ， 下 面 的 SELECT 语句 将 在 SQL Server 上 执行 。 此 查询 仅 访 问 Books 表 : 


SELECT TOP(1) [b]. [BookId], [b]. [AuthorUserIid], [b].[Title] 

FROM [Books] BAS3 [lb] 

WHERE [lb].[Title] LIKE MProtfesslonal C# 7" + N'$%" AND (LEFT([b].[Title], 
LEN (N'PFrofessional C# 7'}} = N'Professional C# 7°') 


使 用 以 下 Load 方法 检索 书 中 的 章节 时 ，SELECT 语句 基于 图 书 ID 检索 章节 : 


SELECT [ee]. [ChapterId], [ee].[BookId], [ee]. [Number], [e]. [Title] 
FROM [Chapters] AS [el] 
WHERE [e].[BookId] = QQ get Item 0 


使 用 第 三 个 查询 ， 从 Users 表 中 检索 用 户 信息 : 


SELECT [人 ] - [UserIid], [es]. [Name] 
FROM [Users] BAS3 [el] 
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WHERE [el].[UserIid] = @ get Item 0 


EF Core 除了 显 式 地 加 载 相关 数据 ， 导 致癌 SQL Server 发 送 多 个 查询 之 外 ， 还 支持 即时 加 载 ， 如 下 所 示 。 


26.6.3 ”即时 加 载 相关 数据 


当 执 行 查询 时 ， 可 以 通过 调用 Include 方法 并 指定 关系 ,来 立即 加 载 相关 数据 。 下 面 的 代码 片段 包括 成 功 应 


用 Where 表达 式 的 书 中 的 章节 和 作者 (代码 文件 RelationUsingConventions/Program.cs): 


private static void EagerLoading() 
{ 
Console .WriteLine (nameof (了 agerLoadling) ) ; 
USInG (Var context = new BooksContext()) 
{ 
var book = context .Books 
-Include(b => b.chapters) 
-Jnclude(b = b.Author) 
.Wherelb 一 > b.Title.startsWith{"Professional C# 7")) 
.FirstoOorDefault(}); 
if (book != null) 
{ 


Console .WriteLine (book. Title):; 


foreach (var chapter in book.Chapters) 
{ 
Console.WriteLine($"{chapter.Number}. {chapter.Title}™); 
} 
} 
} 
Console .WriteLine(). 


} 
使 用 Include， 只 需要 执行 一 条 SQL 语句 来 访问 Books 表 ， 并 连接 Chapters 和 Users 表 : 


SELECT [b.chapters]. [ChapterIidl, [lb.chapters]. [BookId]j, [b.chapters] . [Number]., 
[b.chapters]. [Titlel] 
FROM [Chapters] BS [lb.chapters] 
INNER JOIN ( 
SELECT DISTINCT [七 | .六 
FROM 
SELECT TOP(1L) [b0]. [BookId] 
FROM [Books] AS [bOI] 
LEFT JOIN [Users|] AS [b.Author0] ON [Bb0]. [AuthorUserId] = 
[b.Author0]. [UserIdl] 
WHERE [b0]. [Title] LIKE N'Professional C 7" + 可 "本 AND (LEFT{([Lb0]. [Titlel], 
LEN (N'Professional C# 了 1 = N'Professional C# 7°"') 
ORDER BY [bb0]. [BookId] 
) 2S [七 ] 
) BAS [t0] oN [b.chapters]. [BookId] = [t0]. [BookId] 
ORDER BY [t0]. [BookId] 


如 果 需 要 包含 多 个 层次 的 关系 ， 那 么 方法 ThenInclude 可 以 用 于 Include 方法 的 结果 。 


26.6.4 ”使 用 注释 的 关系 


与 使 用 约定 不 同 ， 实 体 类 型 可 以 通过 应 用 关系 信息 进行 注释 。 下 面向 关系 属性 添加 ForeignKey 属性 ， 来 修改 


先前 创建 的 Book 类 型 ， 并 指定 表示 外 鲁 


的 属性 。 在 这 里 ，Book 不 仅 与 该 书 的 作者 有 关联 ， 也 与 审 稿 人 和 项 目 编 


辑 有 关联 。 这 些 关 系 映 射 到 User 类 型 。 外 键 属性 定义 为 int 类 型 吗 ? 让 它们 变 成 可 选项 。 使 用 强制 关系 ，EF Core 
创建 级 联 删除 ; 删除 Book 时 ， 相 关 的 作者 、 编 辑 和 审 稿 人 也 被 删除 (代码 文件 RelationUsingAnnotations/Book .cs): 


Public class Book 


{ 


public int BookId { get; set; } 
public string Title { get; set; } 
public List<Chapter> Chapters { get; } = new List<Chapter> (); 


public int? AuthorId { get; set; } 
[ForeignKey (nameof (AuthorId))] 
public User Author { get; set; } 
Public int? ReviewerlId { get; set; } 
[EoreignKey (nameof (ReviewerId))] 
public User Reviewer { get; set; } 
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Public int? ProjectEditorId { get; set; } 
[ForeignEeyv (nameof (ProjectEditorId))] 
PUublic User ProjectEditor { get; set; } 

} 


User 类 现在 与 Book 类 型 有 多 个 关联 。WrittenBooks 属性 列 出 了 添加 为 author 的 用 户 的 所 有 图 书 。 类似 地 ， 
ReviewedBooks 和 EditedBooks 属性 与 Book 类 型 仅 在 Reviewer 和 ProjectEditor 属性 上 相关 联 。 如 果 相 同类 型 之 
间 存 在 多 个 关系 ， 则 需要 使 用 InverseProperty 特性 对 属性 进行 注释 。 使 用 这 个 特性 ， 指 定 关 系 另 一 端的 相关 属 
性 (代码 文件 RelationUsingAnnotations/User.cs): 


Public class User 
{ 
Public int UserId 1{ get; set; } 
Public string Name { get; set; } 
[InverseProperty ("Author"})] 
Public List<Book> WrittenBooks 1{ get; set; } 
[InverseProperty ("Reviewer")] 
PUublic List<Book> ReviewedBooks { get; set; } 
[InverseProperty ("ProjectEditor")] 
Public List<Book> EditedBooks { get; set; } 
} 


图 26-3 显示 了 在 SQL Server 中 生成 的 表 的 关系 。Books 表 与 Chapters 表 关 联 ， 如 前 面 的 示例 所 示 。 现 在 ， 
Users 表 与 Books 表 有 三 个 关联 。 


Books * Users 
时 Beokld 由 Userld 
Authorld Name 
Revrewwerld 
ProjpectEditorld 
Trtle 


Chapters 
多 hapterld 
Bookld 


Nurmber 


Title 


图 26-3 


26.6.5 ”使 用 流利 API 的 关系 


指定 关系 的 最 强大 方法 是 使 用 流利 API。 在 流利 API 中 ， 使 用 HasOne 和 WithOne 方法 定义 一 对 一 关系 ， 
用 HasOne 和 WithMany 方法 定义 一 对 多 关系 ， 而 多 对 一 关系 由 HasMany 和 WithOne 定义 。 

对 于 下 面 的 代码 示例 ， 模 型 类 型 不 包括 数据 库 模 式 上 的 任何 注释 。Book 类 是 一 个 简单 的 POCO 类 型 ， 它 
定义 了 图 书信 息 的 属性 ， 包 括 关 系 属 性 (代码 文件 RelationUsingFluentAPLBook.cs):: 


public class Book 
{ 
public int BookId { get; set; |} 
public string Title { get; set; } 
public List<Chapter> Chapters { get; } = new List<Chapter>(); 


Public User Buthor { get; Set } 
PUublic User Reviewer { get; set; } 
Public User Editor { get; set; } 

} 


User 类 型 的 定义 也 是 类 似 的。 除了 具有 Name 属性 外 ，User 类 型 还 定义 了 与 Book 类 型 的 三 种 不 同 关 系 ( 代 
人 码 文 件 RelationUsineFluentAPLUser.cs): 
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Public class User 

{ 
public int UserId { get; set; } 
public string Name { get; set; } 
Public List<Book> WrittenBooks { get; set; } 
public List<Book> ReviewedBooks { get; set; } 
public List<Book> EditedBooks { get; set; } 

} 


Chapter 类 与 Book 类 有 关系 。 然 而 ，Chapter 类 与 Book 类 不 同 ， 因 为 Chapter 类 还 定义 了 一 个 属性 来 关联 
一 个 外 键 : BookId( 代 码 文件 RelationUsingFluentAPLChapter.cs): 


public class Chapter 

{ 
Public int ChapterIQG { get; set; } 
public int Number { get; set; } 
public string Title { get; set; } 
public int BookId { get; set; } 
public Book Book { get; set; } 

} 


模型 类 型 之 间 的 映射 现在 在 BooksContext 的 OnModelCreating 方法 中 定义 。Book 类 与 多 个 Chapter 对 象 相 
关联 ; 这 是 使 用 HasMany 和 WithOne 定义 的 .Chapter 类 与 一 个 Book 对 象 相关 联 ; 这 是 使 用 HasOne 和 WithMany 
定义 的 。 因 为 在 Chapter 类 中 还 有 一 个 外 键 属性 ， 所 以 使 用 HasForeignKey 方法 来 指定 这 个 键 (代码 文件 
RelationUsineFluentAPLBooksContext.cs): 


protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 
modelBuilder.Entity<Book> () 
.HasMany (b => b.chapters) 
.WithOnet(tc 一 > c.Book).; 
modelBuilder.Entity<Book> () 
-HasOne (bb => b.Author} 
.WithMany (a => a.WrittenBooks); 
modelBuilder.Entity<Book> () 
.HasOne (b => b.Reviewer) 
.WithMany (rr => Ir.RevilewedBooks)}); 
modelBuilder.Entity<Book> () 
.HasOne (b => b.Editor) 
-WithMany (e => e.EditedBooks); 


modelBuilder.Entity<Chapter> () 
-HasOne (cc =» c.Book) 
-WithMany (b => b.chapters) 
-HasFoOrelgnKey (cc => c.BookId); 


modelBuilder.Entity<User> () 
-HasMany (a => a.WrittenBooks) 
.Withone(b => b.Author): 

modelBuilder.Entity<User> II) 
.HasMany (Ir => I.ReviewedBooks) 
.WithoOne(b => b.Reviewer); 

modelBuilder.Entity<User> {() 
-HasMany (le => e.EditedBooks) 
.Withone(b => b.Editor); 


26.6.6 ”根据 约定 的 每 个 层次 结构 的 表 


EF Core 还 支持 每 个 层次 结构 中 表 (Table Per Hierarchy，TPH) 的 关系 类 型 。 使 用 这 种 关系 ， 形 成 层次 结构 的 
多 个 模型 类 用 于 映射 到 单个 表 。 这 种 关系 可 以 使 用 约定 和 流利 API 来 指定 。 

下 面 开 始 使 用 约定 和 形成 层次 结构 的 类 型 Payment、CashPayment 和 CreditcardPayment， 如 图 26-4 所 示 。 
Payment 是 一 个 基 类 ; CashPayment 和 CreditcardPayment 均 派 生 于 它 。 
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mee 


CreditcardPayment CashPayment 


图 26-4 


在 实现 代码 中 ，Payment 类 定义 了 主键 ， 其 中 包括 PaymentId 属性 、 所 需 的 Name 和 Amount 属性 。Amount 


属性 映射 到 数据 库 中 的 一 个 列 类 型 Money( 代 码 文 件 TPHWithConventions/Payment.cs): 
public class Payment 
{ 


public int PaymentId 1{ get; 


set; 1} 
[Redquired] 

Public string Name { get; set; } 
[Column (TypeName = "Money")] 


Public decimal Rmount 1{ get; set; 


} 


ent 尖 派 生 自 Payment 还 添加 了 Cred 


public class CreditcardPayment : Payment 
{ 


public string CreditcardNumber { get; 
} 


Set; 1} 


最 后 ，CashPayment 类 派生 目 Payment， 但 不 声明 任何 其 他 成 员 ( 代 码 文件 TPHWithConventions/ 
CashPayment.cs): 


Public class CashPayment : 
{ 


} 


Payment 


EF Core 的 上 下 文 类 BankContext 为 层次 结构 中 的 每 个 类 定义 了 DbSet 属性 (代码 文件 TPHWithConventions/ 
BankContext.cs): 


public class BankContext : 


DbcCcontext 
{ 


private const string Connectionstring = li"server={({localdb) \MSSOLLocalDb;"™ + 
"Database=LocalBank; Trusted Connection=True™s 


protected override void OnConfiguring (DbContextOptionsBuilder optionsBuilder) 
{ 


base .onCconfiguring (optionsBuilder); 


optionsBuilder.UseSgqlServer (Connectionstring); 
} 


Public Dhset<Payment> Payments { get; set; } 
Public DbhSet<CreditcardPayment> CreditcardPayments { get; set; } 
public Dbhset<CashPayment> CashPayments 1{ get; set; } 

} 


创建 的 示例 数据 定义 了 两 个 CashPayment 和 一 个 CreditcardPayment 支付 (代码 文件 TPHWIithConventions/ 
Program.cs): 


private static void AddsampleData () 
{ 


uSing (Var context = new BankContext()) 
1 


context .CashPayments.Bddl 
new CashPayment { Name 


= "Donald™, Amount = 0.5M }); 
context .CashPayments.Addl 

new CashPayment { Name = "Scrooge", Bmount = 20000M 上 ) 7 
context.CreditcardPayments .Add 


new CreditcardPayment 


{ 
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Name = "GUS Goose™, 
Rmount = 300M, 
CreditcardNumber = "987654321" 
Hs 
context .SaveChanges (}，; 
} 
} 


当 运 行 应 用 程序 来 创建 数据 库 时 ， 只 创建 了 一 个 表 Payments( 如 图 26-5 所 示 )。 这 个 表 定 义 了 一 个 
Discriminator 列 ， 将 记录 从 表 映 射 到 相应 的 模型 类 型 。 


CredrtcardNumber 


旱 Payrmentld 


Arnount 
Diserniminator 


Narme 


26-5 


要 只 查询 层次 结构 中 的 特定 类 型 ， 可 以 使 用 OfType 扩展 方法 。 在 下 面 的 代码 片段 中 ， 可 以 看 到 一 个 得 询 ， 
该 查询 只 返回 CreditcardPayment 类 型 的 支付 (代码 文件 TPHWithConventions/Program.cs): 


private static void QuerySample() 
{ 
USIing (Var context = new BankContext()) 
{ 
Var creditcardPayments = context.Payments.0fType<CreditcardPayment> (}); 
foreach (Var payment in creditcardPayments) 
{ 
Console .WriteLine ($s"{payment.Name}, {payment .Amount}"™"); 
} 
} 
} 


使 用 OfType, EF Core 创建 一 个 带 有 WHERE 子 句 的 查询 ， 该 子 句 只 区 分 值 为 CreditcardPayment 的 记录 : 


SELECT [pp]. [FaymentId], [Bp].[Amount], [Pp]. [Discriminator], [Pp]. [Name], 
[bp] . [CreditcardNumber] 

FROM [Payments] AS [五 ] 

WHERE [pp].[Discriminator] = N'CreditcardPayment" 


当然 ， 在 这 个 场景 中 ， 还 可 以 调用 上 下 文 属性 CreditcardPayments， 得 到 相同 的 查询 。 


26.6.7 ”使 用 流利 API 的 每 个 层次 结构 中 的 表 


使 用 流利 API， 定 义 层 族 结 构 可 以 有 更 多 的 控制 。 这 样 ，Payment 类 就 从 注释 中 和 剥离 出 来 ， 它 现在 是 一 个 
抽象 类 型 (代码 文件 TPHWithFluentAPLPayment.cs): 
Public abstract class Payment 
Bo int PaymentId { get; set; } 
public string Name { get; set; } 


public decimal Amount { get; set; } 
} 


CreditcardPayment 和 Payment 类 与 前 面 的 示例 相同 ， 因 此 这 里 不 重复 。 但 上 下 文 是 不 同 的 。 鉴 别 器 的 新 名 
称 是 Type。 这 应 该 是 Payments 表 中 的 一 列 , 但 不 应 该 显示 在 Payment 类 型 中 .应 该 使 用 字符 串 Cash 和 Creditcard 
来 区 分 模型 类 型 。 对 于 所 有 字符 串 ， 定 义 了 ColumnNames 和 ColumnValues 类 (代码 文件 
TPHWIithFluentAPLBankContext.cs): 

ee static class ColumnNames 


public const string Type = nameof (Type); 
} 


Public static class ColumnValues 
{ 


public const string Cash = nameof (Cash); 
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Public const string Creditcard = nameof (Creditcard); 


} 

这 次 ， 上 下 文 为 所 有 不 同 的 Payment 类 型 定义 了 一 个 属性 Payments。 当 然 ， 也 可 以 有 专门 的 属性 ， 但 是 在 
前 面 的 示例 中 ， 这 是 必需 的 。 对 于 Name 属性 和 Amount 属性 的 Money 类 型 ， 需 要 的 模式 信息 现在 是 在 方法 
onModelCreating 中 指定 的 ， 而 不 是 使 用 注释 指定 。 使 用 HasDiscriminator 方法 指定 TPH 层次 结构 。 鉴 别 器 的 名 
称 是 Type, 它 也 指定 为 一 个 阴影 属性 。 派生 类 型 的 差异 用 HasValue 方法 指定 。 HasValue 是 DiscriminatorBuilder 
的 一 个 方法 ， 它 是 从 HasDiscriminator 方法 返回 的 。 


Public class BankContext : DbContext 
{ 
Ee 
protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 
modelBuilder.Entity<Payment>() .Property(p => p.Name) .IsRequired(); 
modelBuilder.Entity<Payment> () .Property(p => p.Amount) 
-HasCcolumnTYype ("Money™)s 


// shadow property for the discriminator 
modelBuilder .Entity<Pavyment2>() .Property<string> (ColumnNames .Type); 
modelBuilder .Entity<Payment.> () 
.HasDiscriminator<string»> (ColumnNames .TYype) 
.HasValue<CashPayment> (ColumnValues.Cash) 
.HasValue<CreditcardPayment2> (ColumnValues.Creditcard)}).:; 
} 


public Dbhset<Payment> Payments 1{ get; set; } 
} 
创建 的 数据 库 与 以 前 类 似 ， 只 是 表 Payments 现在 定义 了 Type 列 ， 而 不 是 Discriminator 列 ， 就 像 创建 模型 
时 指定 的 那样 。 询 问 信用 卡号 码 的 新 查询 会 第 选 Type 列 : 
SELECT [pl].[PaymentId], [pl].[Amount], [pj.[Name], [pl].[Type], 
[pl] . [creditcardNumber] 


FROM [Payments] AS [BI] 
WHERE [pl].[Type] = N'Creditcard" 


26.6.8 表 的 拆 分 


表 的 拆 分 是 EF Core 2.0 的 男 一 个 新 特性 。 通 过 表 的 拆 分 ， 可 以 将 数据 库 表 拆 分 为 多 个 实体 类 型 。 使 用 表 拆 
分 特性 ， 属 于 同一 个 表 的 每 个 类 都 需要 一 个 一 对 一 关系 ， 并 定义 目 己 的 主键 。 但 是 ， 因 为 它们 共享 同一 个 表 ， 
所 以 也 共享 相同 的 主键 。 

下 面 是 一 个 Menu 类 的 示例 ， 它 表示 关于 午餐 菜单 的 信息 ，MenuDetails 包含 厨房 的 信息 。Menu 类 为 琳 单 
定义 了 一 些 属性 , 包括 Details 属性 .Details 属性 将 关系 映射 到 MenuDetails 类 (代码 文件 TableSplitting/Menu.cs): 


Public class Menu 
{ 
Public int MenuIa 1{ get; set; } 
Public string Title { get; set; ]} 
Public string Subtitle { get; set; } 
Public decimal Price { get; Set } 
Public MenuDetails Details { get; set; } 
} 


MenuDetails 类 看 起 来 会 映射 到 它 上 自己 的 表 ( 带 有 主键 )， 并 映射 到 具有 Menu 属性 的 Menu 类 (代码 文件 
TableSplitting/MenuDetails.cs): 


public class MenuDetails 

{ 
public int MenuDetailsId { get; set; } 
Public string KitchenIlInfo 1{ get; set; } 
PUublic int MenusSold { get; set; } 
Public Menu Menu { get; set; } 

} 


在 上 下 文中 ，Menus 和 MenuDetails 是 两 个 DbSet 属性 。 在 OnModelCreating 方法 中 ，Menu 类 使 用 HasOne 
和 WithOne 配置 为 与 MenuDetails 的 一 对 一 关系 。 现 在 ， 应 该 注意 ToTable 方法 的 调用 。 如 果 没 有 这 些 代 码 行 ， 
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默认 情况 下 ， 类 Menu 和 MenuDetails 将 映射 到 两 个 不 同 的 表 。 这 里 ,传递 给 ToTable 方法 的 参数 指定 了 相同 的 
表 名 。Menu 和 MenuDetails 都 映射 到 相同 的 表 Menu 。 这 就 造成 了 表 分 割 的 差异 (代码 文件 
TableSplitting/MenusContext.cs): 


Public static class SchemaNames 
{ 
public const string Menus = nameof (Menus)}.; 


} 


Public class MenusContext : DbContext 
{ 
FA 
protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 
modelBuilder .Entity<Menu> () 

.HasOne<MenuDetails»> (m =»> m.Details) 

.WithOoOnet(td => d.Menu) 

.HasForeignEevy<MenuDetails>(d => d.MenuDetailsId).; 
modelBuilder.Entity<Menu>{() .ToTable (SchemaNames .Menus); 
modelBuilder.Entity<MenuDetails>() .ToTable (SchemaNames .Menus):; 

} 


public DbSet<Menu> Menus 1{ get; set; } 
public Dbhset<MenuDetails> MenuDetails { get; set; } 
} 


验证 表 是 如 何在 数据 库 中 生成 时 , 可 以 通过 下 面 的 SQL 语句 看 到 , Menu 表 包 含 Menu 和 MenuDetails 类 的 
列 ， 以 及 只 用 于 Menu 类 的 主键 : 


CREATE TABLE [dbol]. [Menus] i 
[MenuId] [int] IDENTITY {1,1}) NOT NULL, 
[PFrice] [decimal] (18, 2) NOT NULL, 
[Subtitle] [nvarchar] (max) NULL, 
[Title] [nvarchar] (max} NULL, 
[KitchenInfo] [nvarchar] (max) NULL, 
[MenusSsold] [int] NOT NULL, 
CONSTRAINT [PR Menus] PRIMARY EEY CLUSTERED 
( 
[MenuId] ASC 
) WITH (PAD INDEX = OFF, STIATISTICS NORECOMPUTE = OFF, IGNORE DUP KEY = OFF., 
ALLOW ROW LOCKS = ON, ALLOW PAGE LOCES = ODN) ON [PRIMARY | 
) ON [PRIMARY] TEXT IMAGE ON [ERIMARY | 
GO 


注意 ， 
实体 分 割 是 表 分 割 的 反 过 程 ， 其 中 ,一 个 实体 被 分 割 成 多 个 表 。 这 一 功能 尚未 在 EF Core 2.0 中 使 用 ， 但 计 
划 在 EF Core 的 后 续 版 本 中 使 用 。 


26.6.9 拥有 的 实体 


将 表 分 割 为 多 个 实体 类 型 的 另 一 种 方法 是 使 用 所 谓 “ 拥 有 的 实体 ”的 特性 。 拥 有 的 实体 不 需要 主键 ; 它们 
可 以 是 在 正音 实体 中 拥有 的 类 型 。 拥 有 实体 的 实体 类 可 以 映射 到 单个 表 一 一 使 用 表 拆 分 特性 一 一 也 可 以 映射 到 
不 同 的 表 。 当 使 用 不 同 的 表 时 ， 它 们 共享 相同 的 主键 。 
下 面 看 一 个 例子 ， 它 展示 了 这 两 种 场景 : 使 用 拥有 的 实体 和 单个 表 ， 并 将 其 映射 到 另 一 个 表 。 
下 面 的 代码 片段 显示 了 主要 的 实体 类 型 Person。 这 是 带 主 键 PersonId 的 拥有 实体 的 所 有 者 。 该 类 型 包含 两 
个 地 址 :PrivateAddress 和 CompanyAddress( 代 码 文件 OwnedEntities/Person.cs): 
public class Person 
public int PersonId { get; set; ] 
public string Name { get; set; } 
public Address PrivateAddress { get; set; } 


public Address CompanyAddress { get; set; } 
} 


Address 是 一 个 拥有 的 实体 一 一 该 类 型 没有 它 目 己 的 主键 


。 该 类 型 有 两 个 字符 串 属性 ， 以 及 一 个 类 型 为 
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Location 的 关系 Location。Location 是 男 一 个 拥有 的 实体 (代码 文件 OwnedEntities/Address.cs): 


Public class Address 

{ 
Public string LineOne { get; set; } 
public string LineTwo { get; set; } 
public Location Location { get; set; } 


} 

Location 只 包含 County 和 City 属性 ， 作 为 一 个 拥有 的 实体 ， 它 也 没有 定义 一 个 键 (代码 文件 
OwnedEntities/Location.cs): 

public class Location 

public string Country { get; set; } 


Public string City { get; set; } 
} 


最 有 趣 的 部 分 现在 出 现在 上 下 文中 ， 其 中 在 OnModelCreating 方法 中 定义 了 拥有 的 实体 。 为 给 Person 类 定 
制 模 型 ，OwnsOne 的 第 一 次 调用 指定 Person 实体 拥有 从 CompanyAddress 属性 (这 是 一 种 Address 类 型 ) 引 用 的 
实体 。 对 OwnsOne 的 第 二 个 调用 现在 使 用 第 一 个 OwnsOne 调用 (一 个 ReferenceOwnershipBuilder) 的 返回 类 型 调 
用 OwnsOne。 这 样 ，Address 就 定义 为 拥有 一 个 Location。 对 于 第 二 个 调用 ， 使 用 OQwnsOne 的 另 一 个 重 载 ， 允 
许 进行 一 些 定制 。 显 示 此 自 定义 后 ,指定 City 和 Country 属性 的 列 名 与 默认 名 称 不 同 。CompanyAddress 定制 的 
结果 是 , 用 于 CompanyAddress 和 Location 的 列 都 包含 在 People 表 中 , 为 City 和 Country 属性 提供 定制 的 列 名 。 
使 用 下 一 个 OwnsOne 调用 的 定制 定义 了 PrivateAddress 属性 的 所 有 权 。 这 一 次 ，Address 类 型 映射 到 男 一 个 表 : 
映射 到 名 为 Addr 的 表 。 这 个 表 还 包含 了 Location 类 中 的 列 ， 且 带 有 默认 列 名 (代码 文件 OwnedEntities/ 


OwnedEntitiesContext.cs): 
Public class OwnedEntitiesContext : DbContext 
{ 
i/... 
protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 


modelBuilder.Entity<Person> () 
.OWNSONeE(p => p.CompanyAaddress) 
.OwnsoOne<Location> (a => a.Location, builder => 
{ 
builder.Property(p => p.City) .HasColumnName ("BusinessCity");} 
builder.Property(p => p.Country) .HasColumnName ("BusinessCountry"™); 
}1)5; 
modelBuilder.Entity<Person>() 
.OwnsOne (p => p.PrivateAddress) 
.ToTable ("Addr™") 
.OwnsOneta 一 > a.Location); 


} 


Public DbSet<Person> People 1{ get; set; ]} 
} 


运行 示例 应 用 程序 时 ， 它 将 使 用 两 个 表 创 建 数据 库 。 第 一 个 表 是 这 里 所 示 的 People 表 。 该 表 包 含 Person 
类 的 所 有 列 ， 以 及 映射 自 CompanyAddress 属性 的 Address 和 Location 类 。LineOne 和 LineTwo 具有 属性 名 连接 
的 默认 命名 ， 在 分 级 属性 名 之 间 使 用 下 划 线 : 


CREATE TABLE [dbol].[Peoplel ( 
[PersonId] [int] IDENTITY(1,1) NOT NULL, 
[Name] [nvarchar] (max) NULL, 
[CompanyAddress LineOne] [nvarchar] (max}) NULL,., 
[CompanyAddress LineTwo] [nvarchar] (max) NULL,., 
[BusinessCity] [nvarchar] (max) NULL, 
[BusinessCountry] [nvarchar] (max) NULL, 
CONSTRAINT [PK Peoplel PRIMARY REY CLUSTERED 
( 
[PersonId] ASC 
} WITH (PAD INDEX = OFF, STATISTICS NORECOMPUTE = OFF, IGNORE DUP KEY = OFF, 
ALLOW ROW LOCKS = ON, ALLOW PAGE LOCKES = ON) ON [ERIMARYI] 
} ON [PERIMARY ] TEXTIMAGE ON [ERIMARY |] 
GO 


创建 的 第 二 个 表 (Addr) 是 由 于 PrivateAddress 属性 上 的 ToTable 映射 。 这 些 列 有 默认 命名 ， 因 为 没有 其 他 定 
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义 。 此 表 的 键 值 与 People 表 相 同 (PersonId): 


CREATE TABLE [dbol]. [Addr] ( 
[FersonId] [int] NOT NULL, 
[LineOne] [nvarchar] (max) NULL, 
[LineTwo] [nvarchar] (max) NULL., 
[Location City] [nvarchar] (max) NULL, 
[Location Country] [nvarchar] (max) NULL, 
CONSTRAINT [PR Addrl] PRIMARY KEY CLUSTERED 
( 
[PersonId] ASC 
} WITH (PAD INDEX 二 人 FE ， STATISTICS NORECOMPUTE = 人 FE ， IGNORE DUP REY = 人 FE ， 
ALLOW ROW LOCKS = ON, ALLOW PAGE LOCES = DDN) ON [ERIMARY | 
) ON [PRIMARYI] TEXTIMAGE ON [ERIMARY | 
GO 


26.7 ”保存 数据 


在 使 用 模型 和 关系 创建 数据 库 之 后 ， 可 以 对 其 进行 写 入 。26.2 节 “EF Core 简介 ”展示 了 如 何 添加 、 更 新 
和 删除 记录 ， 但 是 现在 深入 了 解 如 何 影响 这 些 记录 并 包括 关系 。 


26.7.1 用 关系 添加 对 象 


下 面 的 代码 片段 写 入 一 个 关系 : MenuCard 包含 Menu 对 象 。 其 中 ， 实 例 化 MenuCard 和 Menu 对 象 ， 再 指 
定 双 同 天 联 。 对 于 Menu， 将 MenuCard 属性 分 配给 MenuCard， 对 于 MenuCard， 用 Menu 对 象 填充 Menus 属 
性 。 调 用 MenuCards 属性 的 方法 Add， 把 MenuCard 实例 添加 到 上 下 文中 。 将 对 象 添 加 到 上 下 文 时 ， 默 认 情 况 
下 所 有 对 象 都 添加 到 树 中 , 并 添加 状态 。 不 仅 保 存 MenuCard, 还 保存 Menu 对 象 , 在 上 下 文中 调用 SaveChanged， 
会 创建 4 个 记录 (代码 文件 MenusSample/Program .cs): 


private static void AddRecords () 
{ 
1 --- 
USing (Var context = new MenusContext()) 
{ 
Var soupcCcard 
Menul[] soups 
{ 
new Menu 
{ 
Text = "Consommé Célestine (with shredded pancake)™, 
Price = 4.8m, 
MenuCard = soupcard 
}, 
new Menu 
{ 
Text = "Baked Potato Soup", 
Price = 4.8m, 
MenuCard = soupCard 


new MenuCard().; 


}, 
new Menu 
{ 
Text = "Cheddar Broccoll Soup"™, 
Price = 4.8m, 
MenuCard = soupcard 
}, 
上 7 
soupCard.Title = "Soups™; 
soupCcard.Menus .AddRange (soups)}); 
context .MenuCards .BAMdd (soupCard).; 
ShowSstate (context) ; 
int records = context .SaveChanges (); 
Console .WriteLine(s' recordsl added"™); 
FE 
} 
} 


给 上 下 文 添加 4 个 对 象 后 调用 的 方法 ShowState 显示 了 所 有 与 上 下 文 相关 的 对 象 的 状态 DbContext 类 有 一 
个 相关 的 ChangeTracker， 使 用 ChangeTracker 属性 可 以 访问 它 。ChangeTracker 的 Entries 方法 返回 变更 跟踪 器 
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了 解 的 所 有 对 象 。 在 foreach 循环 中 ， 每 个 对 象 包括 其 状态 都 写 入 控制 全 (代码 文件 MenusSample/Program.cs): 


Public static void Showstate (MenusContext context) 
{ 
foreach (EntityEntry entry in context.ChangeTracker.Entries(})) 
{ 
Console.WriteLine($"type: {entry.Entity.GetType() .Name}, ™ + 
$s"state: {entry.State}, {entry.Entity}"); 
} 
Console .WriteLine (}); 


} 
运行 应 用 程序 ， 盘 看 4 个 对 象 的 Added 状态 : 


type: MenuCcard, state: Added, Soups 

type: Menu, state: Added, Consommé Célestine (with shredded pancake) 
type: Menu, state: Added, Baked Potato Soup 

type: Menu, state: Added, Cheddar Broccoli Soup 


因为 这 个 状态 ，SaveChanges 方法 创建 SQL Insert 语句 ， 把 每 个 对 象 写 到 数据 库 。 


26.7.2 对象 的 跟踪 


如 前 所 述 ， 上 下 文 知道 添加 的 对 象 。 然 而 ， 上 下 文 也 需要 了 解 变 更 。 要 了 解 变更 ， 每 个 检索 的 对 象 就 需要 
它 在 上 下 文中 的 状态 。 为 了 查看 这 个 状态 ， 下 面 创建 两 个 不 同 的 查询 ， 但 返回 相同 的 对 象 。 下 面 的 代码 片段 定 
义 了 两 个 不 同 的 查询 ， 每 个 查询 都 用 菜单 返回 相同 的 对 象 ， 因 为 它们 都 存储 在 数据 库 中 。 事 实 上 ， 只 有 一 个 对 
象 会 物化 ， 因 为 在 第 二 个 查询 的 结果 中 ， 返 回 的 记录 具有 的 主键 值 与 从 上 下 文中 引用 的 对 象 相同 。 验 证 在 返回 
相同 的 对 象 时 ， 变 量 ml 和 m2 的 引用 是 否 具 有 相同 的 结果 (代码 文件 MenusSample/Program cs): 


private static void ObjectTracking 1 ) 

{ 
using (var context = new MenusContext ()) 
{ 

Var ml = {from m in context.Menus 
where m.Text.SsStartsWith ("Con™)y 
select m) .FirstorDefault (}); 

var m2 = {from m in context.Menus 
where m.Text.cCcontains({™(") 
select m) .FirstorDefault().; 

if (object.ReferenceEquals (ml, m2)) 

{ 

Console .WriteLine("the same object"); 

} 

忆 ] Se 

{ 

Consol]le .WriteLine ("not the same"™),; 

} 

show3tate (context).; 

} 
} 


第 一 个 LINQ 查询 得 到 一 个 市 LIKE 比较 的 SQL SELECT 语句 ， 来 比较 以 Con 开头 的 字符 串 : 


SELECT TOP(1) [ml]. [MenuId], [ml]. [MenuCardId], [ml]. [Price], [ml]. [Text] 
FROM [mcl]. [Menus] AS3 [ml 
WHERE [ml]. [Tezxt] LIFEE "Con' + "$6" 


在 第 二 个 LINQ 碍 询 中 ， 也 需要 咨询 数据 库 。 其 中 LIKE 用 于 比较 文字 中 间 的 “(”: 


SELECT TOP(1) [m]. [MenuId], [ml]. [MenuCardId], [ml]. [Frice], [ml]. [Text] 
FROM [mc]. [Menus] A3 [ml 
WHERE [ml] . [Tezxt] ILIKEE ("各 ”+ "(") 十 第" 


运行 应 用 程序 时 ， 同 一 对 象 写 入 控制 人 台 ， 只 有 一 个 对 象 用 ChangeTracker 保存 。 状 态 是 Unchanged: 


the same object 
type: Menu, state: Unchanged, Consommée CcCélestine (with shredded pancake) 


为 了 不 跟踪 在 数据 库 中 运行 查询 的 对 象 ， 可 以 通过 DbSet 调用 AsNoTracking 方法 : 


Var ml = (Erom m in context.Menus .AsNoTracking{() 
where m.Text.SsStartsWith ("Con"™) 
select m) .FirstorDefault()}):; 
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可 以 把 ChangeTracker 的 默认 跟踪 行为 配置 为 QueryTrackingBehaviorNoTracking: 
UslIng (var context = new MenusContext()) 
{ 
context .ChangeTracker QueryIrackingBehavior = 
QueryIrackingBehavior.NMoTracking; 
FF 
} 


对 于 更 全 局 的 配置 ， 跟 跨行 为 也 可 以 用 SQL Server 配置 来 配置 ; 


protected override void OnConfiguring (DbhbCcontextOptionsBuilder optionsBuilder) 
{ 
base.OnConfiguring (optionsBuilder); 
optionsBuilder .UseSdqlServer (ConnectionSstring) 
.UseQmueryIrackingBehavior (QUuervyITIrackingBehavior.NoTlTracking).; 
} 


有 了 这 样 的 配置 ， 给 数据 库 建立 两 个 查询 ， 物 化 两 个 对 象 ， 状 态 信息 是 空 的 。 


注意 : 
当 上 下 文 只 用 于 读 取 记 录 时 ， 可 以 使 用 NoTracking 配置 ， 但 无 法 修改 . 这 减少 了 上 下 文 的 开销 ， 因 为 不 保 
存 状态 信息 . 


26.7.3 ”更 新 对 象 


跟踪 对 象 时 ， 对 象 可 以 轻松 地 更 新 ， 如 下 面 的 代码 片段 所 示 。 首 先 ， 检 索 Menu 对 象 。 使 用 这 个 被 跟踪 的 
对 象 ， 修 改 人 价格， 再 把 变更 写 入 数据 库 。 在 所 有 的 变更 之 间 ， 将 状态 信息 写 入 控制 台 ( 代 码 文件 
MenusSample/Program.cs): 


private static void UpdateRecords{() 
{ 


USing (Var context = new MenusContext () ) 
{ 
Menu menu = context .Menus 
.Skip (1) 


.FirstoOrDefault(}:; 
ShowSstate (contexty.: 
menu.Price += 0 .2m:; 
Show3tate (context}; 
int records = context .SaveChanges().; 
Console.WriteLine($"{records} updated" ) : 
Showstate (contexty}). 
} 
} 


运行 应 用 程序 时 , 可 以 看 到 , 加 载 记 录 后 , 对 象 的 状态 是 Unchanged, 修改 属性 值 后 , 对 象 的 状态 是 Modified， 
保存 完成 后 ， 对 象 的 状态 是 Unchanged: 

type: Menu, state: Unchanged, Baked Potato Soup 

type: Menu, state: Modified, Baked Potato Soup 


1 updated 
type: Menu, state: Unchanged, Baked Potato Soup 


访问 更 改 跟 踪 器 中 的 条 目 时 ， 默 认 情 况 下 会 目 动 检测 到 变更 。 要 配置 这 个 ， 应 设置 ChangeTracker 的 
AutoDetectChangesEnabled 属性 。 为 了 手动 检查 更 改 是 否 已 经 完成 ， 调 用 DetectChanges 方法 。 调 用 
SaveChangesAsync 后 ， 状 态 改 回 Unchanged。 调 用 AcceptAllChanges 方法 可 以 手动 完成 这 个 操作 。 


26.7.4 ”更 新 未 跟踪 的 对 象 


DB 上 下 文通 常 非常 短 寿 。 使 用 EF Core 与 ASPNET Core MVC ， 通 过 一 个 HTTP 请 求 创建 一 个 对 象 上 下 
文 ， 来 检索 对 象 。 从 客户 端 接收 一 个 更 新 时 ， 对 象 必 须 再 在 服务 器 上 创建 。 这 个 对 象 与 对 象 的 上 下 文 相关 联 。 
为 了 在 数据 库 中 更 新 它 ， 对 象 需要 与 DB 上 下 文 相关 联 ， 修 改 状 态 ， 创 建 INSERT、UPDATE 或 DELETE 语句 。 

这 样 的 情景 用 下 一 个 代码 片段 模拟 。 本 地 函数 GetMenu 返回 一 个 脱离 上 下 文 的 Menu 对 象 ; 上 下 文 在 该 本 
地 函数 的 最 后 销毁 。GetMennu 方法 由 ChangeUntracked 方法 调用 。 这 个 方法 修改 不 与 任何 上 下 文 相关 的 Menmu 


第 26 章 Entity Framework Core | 639 


对 象 。 改 变 后 ，Menu 对 象 传递 到 方法 UpdateUntracked， 保 存 到 数据 库 中 (代码 文件 MenusSample/Program.cs): 


private static void ChangeUntrackeda() 
{ 
Menu GetMenu'l) 
{ 
using (var context = new MenusContext()) 
{ 
Menu menu = CoOnteXt .MeTmnus 
-Skip (2) 
-FirstorDefault (}); 
return menu; 
} 
} 
Menu m = GetMenut(); 
m. Price += 0.7m;: 
UpdateUntracked (m).; 

} 

UpdateUntracked 方法 接收 已 更 新 的 对 象 ， 需要 把 它 与 上 下 文 关 联 起 来 。 对象 与 上 下 文 关联 起 来 的 一 个 方法 
是 调用 DbSet 的 Attach 方法 ， 并 根据 需要 设置 状态 。Update 方法 用 一 个 调用 完成 这 两 个 操作 : 关联 对 象 ， 把 
状态 设置 为 Modified (代码 文件 MenusSample/Program.cs): 

private static void UpdateUntracked (Menu m) 

{ 

using (var context = new MenusContext () ) 

{ 
show3state (context).; 
// EntityEntry<Menu> entry = context.Menus.Attach (m); 
/i entry.SsState = EntitySsState.Modified; 
context .Menus .Update (m} ; 
show3state (context).; 
Context .SaveChanges'(}); 


} 
} 


通过 ChangeUntracked 方法 运行 应 用 程序 时 ， 可 以 看 到 状态 的 修改 。 对 象 起 初 没有 被 跟踪 ， 但 是 ， 因 为 显 
式 地 更 新 了 状态 ， 所 以 可 以 看 到 Modified 状态 : 


type: Menu, state: Modified, Cheddar Broccoli Soup 


26.7.5 批 处 理 


对 象 映 射 工 具 不 文 持 所 有 场景 。 例 如 ， 如 果 城 市 的 邮政 编 但 更 改 为 新 代码 ， 并 且 和 希望 把 所 有 客户 的 旧 邮 政 
编码 更 新 为 新 代码 ， 最 好 调用 一 个 SQL UPDATE 语句 来 更 新 所 有 这 些 记 录 。 使 用 EF Core， 为 每 个 客户 生成 更 
新 语句 。 

但 是 , EF Core 对 于 通过 一 个 SaveChanges 调用 发 送 一 系列 单独 的 SQL 语句 并 没有 那么 糟糕 。 EF Core 支持 
批 处 理 。SaveChanges 同 SQL Server 发 送 一 个 命令 ， 其 中 仅 用 一 条 语句 执行 多 个 搬入 或 更 新 操作 。 可 以 控制 批 
处 理 的 大 小 一 一 例如 ， 当 配置 SQL Server 时 ， 通 过 调用 值 为 1 的 MaxBatchsize0 来 禁用 批 处 理 : 


protected override Vvoid OncCconfiguring (DbContextOptionsBuilder optionsBuilder) 
{ 
base.onconfiguring (optionsBuilder).; 
optionsBuilder .UseSgqlServer (Connectionstring, 
options => options .MaxBatchSize(l1)).; 
} 


下 面 的 代码 片段 创建 了 100 个 订单 对 象 ， 并 将 它们 作为 添加 对 象 添加 到 上 下 文中 ， 用 SaveChanges 方法 将 
其 写 入 数据 库 ( 代 码 文 件 MenusSample/Program.cs): 


private static void addHunadreadRecorads () 
{ 


Console .WriteLine (nameof (AddHundredRecords)})).;. 
uSing (Var context = new MenusContext () ) 


{ 
Var card = context.MenuCards .FirstoOrDefault():; 
if (card != null) 
{ 


Var menus = Enumerable.Range(l, 100) .Select (KX => new Menu 
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{ 
MenuCard = card., 
Text = $"menu {XX}", 
Price = 9.9m 

})s 


context .Menus .AddRange (menmUS 
stopwatch stopwatch = Stopwatch.SstartNewt(); 
int records = context.SaveChanges () ，; 
stopwatch.Sstop(}); 
Console .WriteLine($"{records} records added after ™ 十 
s"{stopwatch.EllapsedMilliseconds} milliseconds"™"),;) 
} 
} 


Console .WriteLine(); 


} 

局 用 批 处 理 ， 运 行 应 用 程序 时 ，EF Core 提供 程序 创建 一 个 TABLE MERGE 语句 ， 其 中 使 用 一 条 语句 写 入 
100 条 新 菜单 记录 。 将 批 处 理 的 大 小 更 改 为 1100 个 INSERT 语句 ， 发 送 到 数据 库 。 数 据 库 在 同一 个 系统 上 运行 
时 , 启用 了 批 处 理 的 时 间 间 隔 是 56 毫秒 , 而 没有 批 处 理 的 时 间 间 隔 是 105 毫秒 . 如 果 数 据 库 在 不 同系 统 上 运行 ， 
差异 会 更 大 。 


26.8 ”冲突 的 处 理 


如 果 多 个 用 户 修 改 同一 个 记录 ， 然 后 保存 状态 ， 会 发 生 什么 ?最 后 谁 的 变更 会 保存 下 来 ? 

如 果 访 问 同一 个 数据 库 的 多 个 用 户 处 理 不 同 的 记录 ， 就 没有 冲突 。 所 有 用 户 都 可 以 保存 他 们 的 数据 ， 而 不 
干扰 其 他 用 户 编 辑 的 数据 。 但 是 ， 如 果 多 个 用 尸 处 理 同一 记录 ， 就 需要 考虑 如 何 解 决 神 突 。 有 不 同 的 方法 来 处 
理 冲突 。 最 简单 的 一 个 方法 是 最 后 一 个 用 户 获 胜 。 最 后 保存 数据 的 用 户 履 盖 以 前 用 户 执 行 的 变更 。 

EF Core 还 提供 了 一 种 方式 ， 使 第 一 个 保存 数据 的 用 户 获 胜 。 采 用 这 一 选项 ， 保 存 记录 时 ， 需 要 验证 最 初 
读 取 的 数据 是 否 仍 在 数据 库 中 。 如 果 是 ， 就 继续 保存 数据 ， 因 为 读 写 操作 之 间 没 有 发 生变 化 。 然 而 ， 如 果 数 据 
发 生 了 变化 ， 就 需要 解决 冲突 。 

下 面 看 看 这 些 不 同 的 选项 。 


26.8.1 最 后 一 个 更 改 获 胜 


默认 情况 是 ， 最 后 一 个 保存 的 更 改 获胜 。 为 了 查看 对 数据 库 的 多 个 访问 ， 扩 展 BooksSample 应 用 程序 。 

为 了 简单 地 模拟 两 个 用 户 , 方 法 ConflictHandling 调用 两 次 方法 PrepareUpdate, 对 两 个 引用 相同 记录 的 Book 
对 象 进行 不 同 的 改变 ， 并 调用 Update 方法 两 次 。 最 后 ， 把 书 的 IJD 传递 给 CheckUpdate 方法 ， 它 显示 了 数据 库 
中 书 的 实际 状态 (代码 文件 BooksSample/Program.cs): 


Public static void ConflictHandling () 
{ 
// user 1 
Var tuplel = awalt PrepareUpdate (); 
tuplel .book.Title = "updated from user 1"™"; 


// user 2 
Var tuple? = await PrepareUpdate (); 
tuple2.book.Title = "updated from user 2"™; 


// user 1 
Update (tuplel .context, tuplel .book, "user 工 ") 5; 


// user 2 
UpdateAsync (tuple2 .context, tuple2.book, "User 2™); 


tuplel Context .Dispose (); 
tuple2.context.D1lispose (); 


CheckUpdate (tuplel .book.BookId}); 
} 


PrepareUpdate 方法 打开 一 个 BookContext， 并 在 元 组 中 返回 上 下 文 和 图 书 。 记 住 ， 该 方法 调用 两 次 ， 返 回 
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与 不 同 context 对 象 相关 的 不 同 Book 对 象 (代码 文件 ConflictHandlingSample/Program.cs): 


private static (BooksContext context, Book book) PrepareUpadate () 


Var Context = new BooksContext (}); 
Book book = await context.Books 
.Where lb 一 > b.Title == BookTitle) 


.FirstoOrDpefault(); 
return (context, book); 


} 


注意 : 
元 组 在 第 13 章 介 绍 。 


Update 方法 接收 打开 的 BooksContext 与 更 新 的 Book 对 象 ， 把 这 本 书 保存 到 数据 库 中 。 记 住 ， 该 方法 调用 
两 次 (代码 文件 BooksSample/Program.cs): 
private static void Update (BooksContext context, Book book, string user) 
int records = context.SaveChanges () ; 
Console.WriteLine ($s$"{user}: {records} record updated from {user}"™); 


} 
CheckUpdate 方法 把 指定 id 的 图 书写 到 控制 台 ( 代 码 文 件 BooksSample/Program.cs): 
private static void CheckUpdate (int id) 
using (Var context = new BooksContext ()) 
Book book = context.Books.Find(1id); 
Console.WriteLine($"updated: {book.Title}"),; 


} 
} 


运行 应 用 程序 时 ， 会 发 生 什么 ?第 一 个 更 新 会 成 功 ， 第 二 个 更 新 也 会 成 功 。 更 新 一 条 记录 时 ， 不 验证 读 取 
记录 后 是 否 发 生变 化 ， 这 个 示例 应 用 程序 吏 是 这 样 。 第 二 个 更 新 会 履 兰 第 一 个 更 新 的 数据 ， 如 应 用 程序 的 输出 
所 示 : 

user 1: 1 record updated from user 1 


USeEr 2: 1 record updated from user 2 
this is the updated state: updated from user 2 


26.8.2 第 一 个 更 改 获 胜 


如 果 需 要 不 同 的 行为 ， 如 第 一 个 用 户 的 更 改 保 存 到 记录 中 ， 就 需要 做 一 些 改 变 。 示 例 项 目 
ConflictHandlingSample 像 以 前 一 样 使 用 Book 和 BookContext 对 象 ， 但 它 处 理 第 一 个 更 改 获 胜 的 场景 。 

为 了 解决 冲突 ， 需 要 指定 属性 ， 如 果 在 读 取 和 更 新 之 间 发 生 了 变化 ， 就 应 使 用 并 发 性 令 牌 验证 该 属性 。 基 
于 指定 的 属性 ， 修 改 SQL UPDATE 语句 ， 不 仅 验 证 主键 ， 还 验证 用 并 发 性 令 牌 标记 的 所 有 属性 。 给 实体 类 型 
添加 许多 并 发 性 令 牌 会 在 UPDATE 语句 中 创建 一 个 巨大 的 WHERE 子 句 ， 这 不 是 非常 有 效 。 相 反 ， 可 以 添 
加 一 个 属性 ,在 SQL Server 中 用 每 个 UPDATE 语句 更 新 一 一 这 就 是 Book 类 完成 的 工作 .属性 TimeStamp 在 SQL 
Server 中 定义 为 tmestamp( 代 码 文件 ConflictHandlingSample/Book.cs): 

Public class Book 

public int BookId { get; set; } 

public string Title { get; set; } 
Public string Publisher { get; set; ]} 

| Eublic byte[] TimeStamp { get; set; } 

在 SQL Server 中 将 TimeStamp 属性 定义 为 timestamp 类 型 ， 要 使 用 Fluent API。SQL 数据 类 型 使 用 
HasColumnType 方法 定义 ,方法 ValueGeneratedOnAddOrUpdate 通知 上 下 文 ,在 每 一 个 SQL INSERT 或 UPDATE 
语句 中 ， 可 以 改变 TimeStamp 属性 ， 这 些 操 作 后 ， 它 需要 用 上 下 文 设置 。IsConcurrencyToken 方法 将 这 个 属性 
标记 为 必要 ， 检 查 它 在 读 取 操 作 完 成 后 是 否 没 有 改变 (代码 文件 ConflictHandlingSample/BooksContext.cs): 
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protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 
base.onModelCreating (modelBuilder); 
Var book = modelBuilder.Entity<Book> (); 
book.HasKey (Pp => DpD.BookId}); 
book.Property(p => p.Title) .HasMaxLength (120}) .IsRequired(); 
book.Property(p => p.Publisher) .HasMaxLength (50).; 
book.Property (pp => PB.TimeSstamp) 
.HasColummTlype(" timestamp") 
.ValueGeneratedoOnAddOrUpdate () 
.IsConcurrencyTIoken().:; 


} 


注意 : 

不 使 用 IsSConcurrencyToken 方法 与 Fluent API, 也 可 以 给 应 检查 并 发 性 的 属性 应 用 ConcurrencyCheck 特性 。 

检查 冲突 处 理 的 过 程 类 似 于 之 前 的 操作 。 用 户 1 和 用 户 2 都 调用 PrepareUpdate 方法 ,改变 了 书 名 ， 并 调用 
Update 方法 修改 数据 库 (代码 文件 ConflictHandlingSample/Program.cs): 


Public static void ConflictHandling {() 


{ 
// user 1 
Var tuplel = PrepareUpdate () ; 
tuplel .book.Title = "user 1 wins™; 
// user 2 
Var tuple2 = await PrepareUpdate (}); 
tuple2.book.Title = "user 2 wins™; 
// user 1 


Update (tuplel .context, tuplel .book): 
// user 2 
Update (tuple2 .context, tuple2.book):; 
tuplel .context .Dispose ().; 
tuple2.context .Dispose(),; 
CheckUpdate (contextl .book.BookId); 

} 


这 里 不 重复 PrepareUpdate 方法 ， 因 为 该 方法 的 实现 方式 与 前 面 的 示例 相同 。Update 方法 则 截然 不 同 。 为 
了 得 看 更 新 前 和 更 新 后 不 同 的 时 间 惟 ,实现 字 节 数组 的 目 定 义 扩 展 方法 StringOutput, 将 字 节 数组 以 可 读 的 形式 
写 到 控制 台 。 接 着 ， 调 用 ShowChanges 辅助 方法 ， 显 示 对 Book 对 象 的 更 改 。 调 用 SaveChanges 方法 ， 把 所 有 
更 新 写 到 数据 库 中 。 如 果 更 新 失败 ， 并 抛 出 DbUpdateConcurrencyException 异常 ， 就 把 失败 信息 写 入 控制 台 ( 代 
码 文 件 ConflictHandlingSample/Program.cs): 


private static Update (BooksContext context, Book book, string user) 
{ 
try 
{ 
Console.WriteLine(s$"{user}: updating id {book.BookId}, ™ + 
ss"timestamp: {book.TimeStamp.Sstringoutput()}"); 
Showchanges (book.BookId, context .Entry (book})}.; 
int records = await context.SaveChangeshAsync (); 
Console.WriteLine($»{user}: updated {lbook.TimeStamp.Stringoutput () }»); 
Console.WriteLine(s$"{user}: {records} record(s)} updated while updating ™ + 
Ss"{book.Title}™); 
} 
catch (DbUpdateConcurrencyException ex) 
{ 
Console.WriteLine($"{user}: update failed with {book.Title}™"); 
Console.WriteLine ($s"error: {ex.Message}™"); 
foreach (Var entry in ex.Entries) 
{ 
if (entry.Entity is Book b) 
{ 
Console.WriteLine ($"{b.Title} {b.TimeSstamp.stringoutput () }"); 
ShowCchanges (book.BookId, context.Entry (book})}; 
} 
} 
} 
} 


对 于 与 上 下 文 相关 的 对 象 ， 使 用 PropertyEntry 对 象 可 以 访问 原始 值 和 当前 值 。 从 数据 库 中 读 取 对 象 时 获取 
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的 原始 值 ， 可 以 用 OriginalValue 属性 访问 ， 其 当前 值 可 以 用 CurrentValue 属性 访问 。 在 ShowChanges 和 
ShowChange 方法 中 ，PropertyEntry 对 象 可 以 用 EntityEntry 的 属性 方法 访问 ， 如 下 所 示 ( 代 码 文 件 
ConflictHandlingSample/Program.cs): 


private static void ShowChanges (int id, EntityEntry entity) 
{ 
Volad Showchange (PropertyEntry propertyEntry) 三 > 
Console.WriteLine($"id: {id}, current: {propertyEntry.CurrentVvalue}, ™ + 
$s"original: {propertyEntry.0OriginalValue}, ™ + 
s"modified: {propertyEntry.IsModified}"); 


ShowChange (entity.Property("Title™)); 
ShowChange (entity.Property ("Publisher™)); 
} 


为 了 转换 SQL Server 中 更 新 的 TimeStamp 属性 的 字 节 数组 , 以 可 视 化 输出 ,定义 了 扩展 方法 StingOutput( 代 
码 文 件 ConflictHandlingeSample/ByteArrayExtensions.cs): 


static class ByteArrayExtension 
{ 
Public static string Stringoutput (this byte[] data) 
{ 
Var sb = new StringBuilder(); 
foreach (byte b In data) 
{ 
sb-.Append (5"{b}."); 
} 
return sb.ToString(); 
} 
} 


当 运 行 应 用 程序 时 ， 可 以 看 到 如 下 和 输出。 时间 戳 值 和 图 书 DD 在 每 次 运行 时 都 不 同 。 第 一 个 用 户 把 书 的 原 
标题 sample book 更 新 为 新 标题 user 1 wins。IsModified 属性 给 Title 属性 返回 tue, 但 给 Publisher 属性 返回 false。 
因为 只 有 标题 改变 了 。 原 来 的 时 间 惟 以 1.1.209 结尾 ; 更 新 到 数据 库 中 后 ， 时 间 惟 改 为 1.17.114。 与 此 同时 ， 用 
户 2 打 开 相 同 的 记录 ; 该 书 的 时 间 戳 仍然 是 1.1.209。 用 户 2 更 新 该 书 ， 但 这 里 更 新 失败 了 ， 因 为 该 书 的 时 间 玲 
不 匹配 数据 库 中 的 时 间 惟 。 这 里 会 殷 出 一 个 DbUpdateConcurrencyException 异常 。 在 异常 处 理 程序 中 ， 异 常 的 
原因 写 入 控制 台 ， 如 程序 的 输出 所 示 : 


user 1: updating id 1, timestamp 0.0.0.0.0.0.7.209. 

id: 1, current: user 1 wins, original: sample book, modified: True 

id: 1, current: Sample, original: Sample, modified: False 

USer 1: updated 0.0.0.0.0.0.7.210. 

usSer 1: 1 record(s) updated while updating user 1 wins 

User 2: updating id 1, timestamp 0.0.0.0.0.0.7.209. 

id: 1, current: user 2 wins, original: sample book, modified: True 

id: 1, current: Sample, original: Sample, modified: False 

user 2 update failed with user 2 wins 

USer 2 error: Database operation expected to affect 1 row(s) but actually 
affected 0 row(s). Data may have been modified or deleted since entities were loaded. 
See http://go.microsoft.com/fwlink/?LinkIid=527962 for information on 
understanding and handling optimistic concurrency exceptions. 

User 2 Wins 0.0.0.0.0.0.7.209. 

id: 1, current: user 2 wins, original: sample book, modified: True 

id: 1, current: Sample, original: Sample, modified: False 

this is the updated state: user 1 wins 


当 使 用 并 发 性 令 牌 和 处 理 DbConcurrencyException 时 ， 可 以 根据 需要 处 理 并 发 冲突 。 例 如 ， 可 以 自动 解决 
并 发 问题 。 如 果 改 变 了 不 同 的 属性 ， 可 以 检索 更 改 的 记录 并 合并 更 改 。 如 果 改 变 的 属性 是 一 个 数字 ， 要 执行 一 
些 计 算 ， 例 如 点 系统 ， 就 可 以 在 两 个 更 新 中 递增 或 递减 值 ， 如 果 达 到 极限 ， 就 抛 出 一 个 异常 。 也 可 以 给 用 户 提 
供 数据 库 中 目前 的 信息 ， 询 问 他 要 进行 什么 修改 ， 要 求 用 户 解决 并 发 性 问题 。 不 要 要 求 用 户 提 供 太 多 的 信息 。 
用 户 可 能 只 是 想 摆 脱 这 个 很 少 显 示 的 对 话 框 ， 这 意味 着 他 可 能 会 单 击 OK 或 Cancel， 而 不 阅读 其 内 容 。 对 于 军 
见 的 冲突 ， 也 可 以 编写 日 志 ， 通 知 系统 管理 员 ， 需 要 解决 一 个 问题 。 
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26.9 上 下 文 池 


在 EF Core 2.0 中 ， 可 以 把 上 下 文 放 在 池 中 ， 以 提高 性 能 。 连 接 已 经 放 在 池 中 好 长 时 间 了 。 应 在 需要 连接 之 
前 打开 它们 ， 使 用 之 后 立即 关闭 它们 。 在 EF Core 中 ， 这 个 行为 已 经 在 框架 中 实现 了 。 关 闭 连接 时 ， 对 数据 库 
服务 器 的 连接 并 没有 真正 关闭 ， 而 是 把 连接 返回 连接 池 ， 以 便 在 打开 下 一 个 连接 时 重用 。 连 接 池 用 连接 字符 串 
配置 。 

DB 上 下 文 的 用 法 规则 与 连接 类 似 。 它 们 也 应 在 需要 之 前 创建 ， 在 使 用 之 后 立即 关闭 〈 销 毁 )。 其 开销 没有 
我 们 想象 的 那么 大 。 模 型 不 是 在 调用 每 个 新 上 下 文 时 初始 化 ， 而 是 重用 模型 。 在 Entity Framework 和 XML 文 
件 映射 中 ， 创 建 上 下 文 的 开销 比 目 前 的 EF Core 大 许多 。 但 是 ， 如 果 上 下 文 比较 大 ， 创 建 它 的 开销 仍 可 能 比较 
可 观 。 此 时 就 可 以 使 用 上 下 文 池 来 提高 性 能 。 

为 了 使 用 上 下 文 池 ， 必 须 使 用 依赖 注入 。 要 激活 上 下 文 池 ， 只 需要 把 EF Core 注册 从 AddDbContext 改 为 
AddDbContextPool。 这 样 ， 注 入 的 上 下 文 〈 示 例 代 码 中 是 BooksContext) 就 可 以 从 上 下 文 池 中 检索 出 来 : 

VAaAI SEIVicCes = new ServiceCollectiont():; 

services.RddTransient<BooksController>(}); 

Services.AddTransient<BooksService>(); 

SeErvices.AddEntityFrameworkSdqlServer (); 

Services.AddDbContextPool<BooksContext> (options => 

optiocons.UseSgqlServer (ConnectionSstring))}).; 
Services.AddLogging (}); 


Container = servyvices.BuildServiceProvidert().: 


26.10 ”使 用 事务 


第 25 章 介 绍 了 使 用 事务 编程 的 内 容 。 每 次 使 用 Entity Framework 访问 数据 库 时 ， 都 涉及 事务 。 可 以 隐 式 地 
使 用 事务 或 根据 需要 使 用 配置 显 式 地 创建 它们 。 此 节 使 用 的 示例 项 目 以 两 种 方式 展示 事务 。 这 里 ，Menu、 
MenuCard 和 MenuContext 类 的 用 法 与 前 面 的 MenusSample 项 目 相 同 。 


26.10.1 使 用 隐 式 的 事务 


SaveChanges 方法 的 调用 会 自动 解析 为 一 个 事务 。 如 果 需 要 进行 的 一 部 分 变更 失败 ， 例 如 ， 因 为 数据 库 约 
束 ， 就 回 深 所 有 已 经 完成 的 更 改 。 下 面 的 代码 片段 演示 了 这 一 点 。 其 中 ， 第 一 个 Menu (m1) 用 有 效 的 数据 创建 。 
对 现 有 MenuCard 的 引用 是 通过 提供 MenuCardId 完成 的 。 更 新 成 功 后 ，Menu ml 的 MenuCard 属性 自动 填充 。 
然而 ， 所 创建 的 第 二 个 菜单 mInvalid， 因 为 提供 的 MenuCardId 高 于 数据 库 中 可 用 的 最 高 ID， 所 以 引用 了 无 效 
的 沫 单 卡 。 因 为 MenuCard 和 Menu 之 间 定 义 了 外 键 关 系 ， 所 以 添加 这 个 对 象 会 失败 (代码 文件 
TransactionsSample/Proeram.cs): 


private static void AddTwoRecordsWithOneTx () 


Console .WriteLine (nameof (AddTWwoRecordsWithOneTx)}); 


try 
{ 
usSing (Var context = new MenusContext () ) 
{ 
var card = context.MenuCards.Firsti'{).;: 
var ml = new Menu 
{ 


MenuCardId = card.MenuCardId., 
Text = "added™, 
Price = 99.99m 
上 


int hightestCardId = Context_-Menucards -MaxI(c => c.MenuCardId).; 

Var mInvalid = new Menu 

{ 
MenuCardId = ++hightestcCardId., 
Text = "invalid"™, 
Price = 999.99m 
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}s 

context .Menus.AddRange (ml, mInvalid); 

int records = context.SaveChanges ();} 

Console .WriteLine (S$"{records} records added™}).; 
} 


} 
catch (DbUpdateException ex) 


{ 
Console.WriteLine($"{ex.Message}"); 
Console.WriteLine($"{ex?.InnerException.Message}™"™); 
} 
Console.WriteLine(); 


} 
在 调用 AddTwoRecordsWithOneTx 方法 运行 应 用 程序 之 后 ， 可 以 验证 数据 库 的 内 容 ， 确 定 没 有 添加 一 个 记 
录 。 异 冰 消 息 以 及 内 部 异 芝 的 消息 给 出 了 细节 : 


AddTwoRecordsWithoneTx 

trying to add one invalid record to the database, this should fail... 

An error occurred while updating the entries. See the inner exception for details. 
The MERGE statement conflicted with the FOREIGN KEY constraint 

"EE Menus MenuCards MenuCardId". 

The conflict occurred in database "ProCSsharpMenuCards", 

table “mc.MenuCards™, column "MenuCardId". 

The statement has been terminated. 


如 果 第 一 条 记录 写 入 数据 库 应 该 是 成 功 的 ,即使 第 二 条 记录 写 入 失败 ， 也 需要 多 次 调用 SaveChanges 方法 ， 
如 下 面 的 代码 片段 所 示 。 在 AddTwoRecordsWithTwoTx 方法 中 , 第 一 次 调用 SaveChanges 插入 了 ml 菜单 对 象 ， 
而 第 二 次 调用 试图 插入 mInvalidMenu 对 象 (代码 文件 TransactionsSample/Program.cs): 

private static void AddTwoRecordsWithTwoTx{() 


| 


Console .WriteLine (nameof (AddTwoRecordsWithTwoTx)}). 


try 
{ 
usSing (var context = new MenusContext()) 
{ 
var card = context.MenuCards.First({):; 
Var ml = new Menu 


{ 
MenucCcardId = card.MenuCardId., 


Text = "addeqd™, 
Frice = 99.99m 
}; 
context .Menus .Add (ml}. 
int records = context .SaveChanges().; 
Consol]e .WriteLine ($"{records} records added"™}; 


int hightestCardId = context.MenuCards.Max(c => c.MenuCardId); 
Var mInvalid = new Menu 


{ 
MenuCardId = ++hightestCardId, 
Text = "invalid™, 
Frice = 999.99m 

上 7 


Context .Menus.Add (mInvalid}.: 
records = context .SaveChanges(); 
Console .WriteLine ($"{records} records added™}).; 
} 
} 
catch (DbUpdateException ex) 
{ 
Console.WriteLine($"{ex.Message}"™); 
Console.WriteLine ($"{ex?.InnerException.Message}™); 
} 
Console.WriteLine(); 


} 
运行 应 用 程序 ， 添加 第 一 个 INSERT 语句 成 功 ， 当 然 第 二 个 语句 的 结果 是 DbUpdateException。 可 以 验证 数 
据 库 ， 这 次 添加 一 个 记录 : 


AddTwoRecordsWithTwoTx 

adding two records with two transactions to the database. 
One record should be written, the other not.... 

1 records added 
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An error occurred while updating the entries. See the inner exception for details. 
The INSERT statement conflicted with the FOREIGN KEY constraint “FE Menus MenuCards MenuCardId". 
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The conflict occurred in database "ProCsharpMenuCards™, 
table "mc.MenuCcards", column ‘MenuCcardId". 
The statement has been terminated. 


26.10.2 ”创建 显 式 的 事务 


除了 使 用 隐 式 创建 的 事务 之 外 ， 也 可 以 显 式 地 创建 它们 。 其 优势 是 如 果 一 些 业 务 逻 辑 失 败 ， 也 可 以 选择 回 
深 ， 还 可 以 在 一 个 事务 中 结合 多 个 SaveChanges 调用 。 为 了 开始 一 个 与 DbContext 派生 类 相关 的 事务 ， 需 要 调 
用 DatabaseFacade 类 中 从 Database 属性 返回 的 BeginTransaction 方法 。 返回 的 事务 实现 了 IDbContextTransaction 
与 DbContext 相关 的 SQL 语句 通过 事务 建立 起 来 。 为 了 提 区 或 回 深 , 必须 显 式 地 调用 Commit 或 Rollback 
在 示例 代码 中 ， 当 达到 DbContext 作用 域 的 末尾 时 ，Commit 完成 ， 在 发 生 异 稼 的 情况 下 回 滚 (代码 文件 


接口 。 
方法 。 


TransactionsSample/Program.cs): 


private static void TwoSaveChangesWithOoneTx () 


{ 


} 


当 运 行 应 用 程序 时 可 以 看 到 ， 没 有 添加 记录 ， 但 多 次 调用 了 SaveChanges 方法 。SaveChanges 的 第 一 次 返 
回 列 出 了 要 添加 的 一 个 记录 ， 但 基于 后 面 的 Rollback， 删 除了 这 个 记录 。 根 据 隔离 级 别 的 设置 ， 回 深 完 成 之 前 ， 


Console .WriteLine (nameof (TwoSaveChangesWithOneTxAsync) ) ; 


IDbContextTransaction tx = null.:; 
try 
{ 


US]InG (Var context = new MenusContext () ) 


{ 
Var card = context.MenuCards.Firsti'().; 
var ml = new Menu 
{ 
MenuCardId = card.MenuCardId, 
Text = "added with explicit tx", 
Erice = 99.99m 
}i; 
Context .Menus .BAdd (ml}); 
Int records = await context.SaveChanges (}); 


Console .WriteLine ($"{records} records added™}).: 


int hightestCardId = context.MenuCards.Maxl(c => c.MenuCardId).; 


Var mInvalid = new Menu 
{ 
MenuCardId = ++hightestcCardId, 
Text = "invalid"™, 
Price = 999.99m 
上 7 
context .Menus .Add (mInvalid).;} 
records = await context.SaveChanges ();} 


Console .WriteLine ($"{records} records added™}).: 
tx.Commit().; 
} 
} 
catch (DbUpdateException ex) 
{ 
Console.WriteLine($"{ex.Message}™"); 
Console.WriteLine ($"{ex?.InnerException.Message}"™); 
Console.WriteLine ("rolling back..."); 
tx .Rollback().:; 
} 


Console .WriteLine():; 


更 新 的 记录 只 能 在 事务 内 可 见 ， 但 在 事务 外 部 不 可 见 。 


TwoSaveChangesWithoneTx 


USing cone explicit transaction, writing should roll back... 


1 


an error occurred while updating the entries. See the inner exception for details. 
The INSERT statement conflicted with the FOREIGN KEY constraint 


records added 


"FE Menus MenuCards MenuCardId". 
The conflict occurred in database "ProCcsharpMenuCards™, 
table "mc.MenuCards", column ‘MenuCardId". 


using (tx = await context.Database.BeginTransaction()) 
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The statement has been terminated. 
rolling back... 


注意 : 
使 用 BeginTransaction 方法 ， 也 可 以 给 隔离 级 别提 供 一 个 值 ， 指 定数 据 库 中 所 需 的 隔离 要 求 和 锁 。 隔 离 级 
别 参 见 第 25 章 。 


26.11 迁移 


可 以 在 现 有 的 数据 库 中 使 用 EF Core( 称 为 “数据 库 优 先 ”)。 在 许多 使 用 EF Core 的 场景 中 ， 数 据 库 已 经 存 
在 。 数 据 库 的 更 新 独立 于 应 用 程序 ， 并 且 在 数据 库 更 改 完成 后 更 新 应 用 程序 。 在 这 种 情况 下 ，EF Core 迁移 没 
有 多 大 帮助 。 

如 果 使 用 应 用 程序 创建 数据 库 ，EF Core 迁移 将 非常 有 用 。 更 改 代码 模型 时 ， 可 以 自动 更 新 数据 库 。 如 果 
客户 都 有 上 自己 的 数据 库 ， 并 且 使 用 应 用 程序 的 更 新 版 本 更 改 数据 库 模 式 ， 那 么 使 用 旧 的 应 用 程序 版 本 更 新 客户 
可 能 是 一 个 挑战 。EF Core 迁移 可 以 解决 这 个 问题 通过 迁移 ， 可 以 轻松 地 从 版 本 x 升级 到 版 本 y。 数 据 库 的 当 
前 版 本 是 从 数据 库 中 读 取 的 ， 而 迁移 则 包含 了 升级 到 最 新 版 本 的 每 一 步 所 需 的 信息 。 还 可 以 升级 或 降级 到 特定 
的 版 本 。 

有 不 同 的 选项 来 升级 数据 库 。 使 用 升级 命令 可 以 直接 从 应 用 程序 迁移 。 还 可 以 使 用 dotnet 命令 从 命令 行 上 
更 新 数据 库 。 另 一 个 选项 是 创建 一 个 SQL Server 脚本 ， 数 据 库 管 理 员 可 以 使 用 该 脚本 更 新 数据 库 。 

显示 迁移 的 示例 应 用 程序 存在 于 NET 标准 库 和 .NET Core Web 应 用 程序 中 。 通 常 ， 数 据 访 问 代码 是 在 库 中 
实现 的 ， 需 要 一 些 额外 的 命令 行 选项 来 处 理 这 个 问题 ， 这 就 是 为 什么 在 这 样 的 场景 中 演示 迁移 的 原因 。 


26.11.1 准备 项 目 文 件 


下 面 从 NET 标准 2.0 库 开 始 。 这 个 库 包 含 定 义 模 型 的 Menu 和 MenuCard 类 、 实 现 接口 
IEntityTypeConfieuration 来 配置 对 应 模型 类 型 的 映射 的 MenuConfiguration 和 MenuCardConfiguration 类 , 以 及 上 
下 文 类 MenusContext。 

项 目 文 件 需要 准备 的 不 仅 仪 是 引用 NuGet 包 Microsoft EntityFrameworkCore 和 Microsoft EntityFrameworkCore.SqlServer， 
还 需要 EF Core 工具 扩展 与 dotnet 命令 行 , 这 是 一 个 引用 Microsoft.EntityFrameworkCore.Tools.Dotnet 的 工具 (项 
目 文 件 MigrationsLib/MigrationsLib.csproj): 
<Project Sdk="Microsoft.NET.Sdk"> 
<PIropertyGroup> 
<TargetFramework>netstandard2.0</TargetFramework> 
</PropertyGroup> 
<ItemSroup> 
<PackageReference Include="Microsoft.EntityFrameworkCore" 
Version="2.0.0"™ /> 
<PackageReference Include="Microsoft.EntityFrameworkCore.SgqlServer" 
Version="2.0.0™ /> 
</ItemGroup> 
<ItemGroup> 
<DotNetCliTloolReference 
Include="Microsoft.EntityFrameworkCore.Tools.Dotnet"™" 
Version="2.0.0" /> 
</ItemSroup> 


</Project> 


为 了 使 用 Web 应 用 程序 中 的 上 下 文 类 ， 实 现 了 MenusContext， 以 使 用 依赖 注入 和 需要 DbContextOptions 
的 构造 函数 (代码 文件 MigrationsLib/MenusContext.cs): 
Public class MenusContext : DbContext 


{ 
Eublic MenusContext (DbContextOptions<MenusContext> options): 
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base(loptions) { } 


Public DbSet<Menu> Menus 1{ get; set; } 
public Dbset<MenuCard> MenuCards 1{ get; set; } 


protected override void OnModelcCreating (ModelBuilder modelBuilder) 
{ 
base.onModelCreating (modelBuilder); 
modelBuilder.HasDefaultSschema ("mc"); 


modelBuilder.ApplyConfiguration (new MenuCardConfiguration())}); 
modelBuilder.ApplyConfiguration (new MenuConfiguration()); 
} 
} 


26.11.2 ”利用 ASPNET Core MVC 托管 应 用 程序 


在 新 的 ASPNET Core MVC Web 应 用 程序 中 ， 使 用 Microsoft.Extensions.DependencylInjection 的 依赖 注入 已 
经 构建 到 模板 中 。 要 启用 迁移 , 只 需要 使 用 扩展 方法 AddDbContext 添 加 EF Core DB 上下文, 并 使 用 UseSqlServer 
配置 SQL Server。 需 要 在 配置 文件 中 配置 到 数据 库 的 连接 字符 串 。 这 样 ， 就 可 以 使 用 命令 行进 行 迁移 (代码 文件 
Mierations WebApp/Startup.cs): 

Public Vvoid ConfigureServices (IServiceCollection services) 

SEIVices.AddMvc (}).- 

services.AddDbContext<MenusContext»> (options => 
options.UseSgqlServerl 


Configuration.GetConnectionstring("MenusConnection™)}))).， 
} 


注意 : 
ASPNET Core MVC 详 见 第 31 章 。 在 此 之 前 ， 应 该 阅读 第 20 章 和 第 30 章 。 


26.11.3 ”托管 .NET Core 控制 台 应 用 程序 


如 果 EF Core DB 上 下 文 没有 使 用 依赖 注入 ,就 可 以 使 用 配置 了 工具 的 上 下 文 类 。 在 这 种 情况 下 ,可 以 使 用 
上 下 文 的 OnConfiguration 方法 检索 连接 字符 串 。 使 用 依赖 项 注入 ， 连 接 字 符 串 从 外 部 注入 。ASP .NET Core 在 
访问 Web 应 用 程序 的 Main0 方 法 ， 以 通过 依赖 注入 容器 获取 连接 字符 串 方面 有 工具 的 特殊 文 持 。 控 制 台 应 用 程 
序 (以 及 UWP、WPF 和 Xamarin 应 用 程序 ) 中 的 Main0 方 法 看 起 来 有 所 不 同 。 在 这 里 ,需要 实现 一 个 工厂 类 , 通 
过 实现 接口 IDesignTimeDbContextFactory 返回 DB 上 下 文 。 当 访问 程序 集 时 ， 在 .NET Core 工具 中 目 动 检测 到 
实现 该 接口 的 类 。 这 个 接口 定义 的 CreateDbContext 方法 需要 返回 一 个 已 配置 的 上 下 文 (代码 文件 
NigrationsConsoleApp/'MenusContextFactory.cs): 

public class MenusContextFactory : IDesignTimeDbContextFactory<MenusContext> 

private const string Connectionstring = 


"server=(localdb}) \mssgqllocaldb;database=ProCcSharpMigrations;"™ + 
"trusted connection=true™"s 


public MenusContext CreateDbContext (string[] args) 
{ 
Var optionsBuilder = new DbContextOptionsBuilder<MenusContext> (); 
optionsBuilder.UseSqlServer (Connectionstring),;} 
return new MenusContext (optionsBuilder.0Options).; 
} 
} 


.NET Core 工具 使 用 的 控制 台 应 用 程序 的 项 目 文件 需要 引用 NuGet 包 Microsoft.EntityFrameworkCore.Design。 
该 工具 只 需要 设计 库 ， 不 需要 从 调用 应 用 程序 中 引用 ， 这 就 是 为 什么 可 以 设置 PrivateAssets 特性 的 原因 (项 目 文 
件 MigrationsConsoleApp/MierationsConsoleApp.csproj): 

<Project Sdk="Microsoft.NET.Sdk"> 


<PropertyGroup> 
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<OutputType>Exe</OutputType> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.EntityFrameworkCore" 
Version="2.0.0"™ /> 
<PackageReference Include="Microsoft.EntityFrameworkCore.SsSgqlServer" 
Version="2.0.0"™ /> 
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" 
Version="2.0.0"™ PrivateAssets="Al]l™ /> 
</ItemGroup> 


<ItemGroup> 
<ProjectReference Include="..\MigrationsLib\MigrationsLib.csproj]" /> 
</ItemSroup> 


</Project> 
26.11.4 创建 迁移 


有 了 这 些 ， 就 可 以 创建 一 个 初始 迁移 。 使 用 以 下 命令 ， 当 前 目录 必须 是 库 的 目录 一 一 定义 工具 引用 的 目录 。 
以 下 命令 创建 名 为 mitMenus 的 初始 迁移 。 使 用 选项 --startup-project 引用 的 局 动 项 目 包 含 初始 代码 ， 其 中 包括 到 
服务 器 的 连接 字符 串 一 一 或 者 使 用 从 ASPNET Core Web 应 用 程序 的 默认 项 目 模板 中 生成 的 Main0 方 法 , 或 实现 
IDesignTimeContextFactory 的 对 象 ， 如 前 一 节 所 示 : 


> dotnet ef migrations add InitMenus -—-startup-project ../MigrationsConsoleApp 


如 果 项 目 包 含 多 个 DB 上下文， 就 需要 提供 附加 选项 --context， 并 提供 DB 上 下 文 类 的 名 称 。 
运行 此 命令 ， 会 创建 一 个 带 有 快照 的 Migrations 文件 来， 以 基于 模型 创建 完整 的 数据 库 模 式 (代码 文件 
MigrationsLib/Nieration/MenusContextModelSnapshot.cs): 


[DbcCcontext (typeof (MenusContext)})}] 
partial class MenusContextModelSsSnapshot : Modelsnapshot 
{ 
protected override void BulilldModel (ModelBuilder modelBuilder) 
{ 
#pragma warning disable 612, 618 
modelBuilder 
.HasDefaultschema ("me") 
-HasAnnotation ("ProductVersion™, "2.0.0-rtm-26452") 
.HashAnnotation ("SqlServer:ValueGenerationstrategy", 
SqlServerValueGenerationstrategy.IdentityColumn).; 


modelBuilder.Entity("MigrationsLib.Menu", b => 
{ 
b.Property<int> ("MenuIlId"™) 
-ValueGeneratedonAdqd () 7 
D -PTOPeITtY<Int> ("MenuCardId"™); 


b.Property<decimal> ("Price") 
-HasColummType ("Money™"}.; 


b.Property<string> ("Text™") 
.HasMaxLength (120); 


b.HasKEey ("MenuId™); 
b.HasIndex ("MenuCardId™).: 


b.ToTable ("Menus™); 
}} 5 
modelBuilder.Entity("MigrationsLib.MenuCard™", b => 
{ 
b.Property<int> ("MenuCardId") 
.ValueGeneratedoOonAdd (); 
b.Property<bool> ("IsDeleted™}); 


b.Property<DateTime> ("LastUpdated"™),; 
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b.Property<string> ("Title™) 
-HasMaxLength (50); 


b.HasKey ("MenuCcardId™).,; 


b.ToTable ("MenuCards™).; 
Hs 


modelBuilder.Entity("MigrationsLib.Menu", b => 
{ 
b.Hasone ("MigrationsLib.MenuCard™", "MenuCard"™) 
.WithMany ("Menus") 
.HasForelgnKey ("MenuCardId"™) 
.CnDelete (DeleteBehavior.Cascade).; 
}); 
#pragma warning restore 612, 618 
} 
} 


对 于 每 次 迁移 ， 都 会 创建 一 个 从 基 类 Migration 派生 的 迁移 类 。 这 个 基 类 定义 了 Up 和 Down 方法 ， 以 允许 
将 迁移 应 用 到 这 个 迁移 版 本 中 ， 或 者 癌 后 一 步 ( 代 码 文件 MigrationsLib/<version> InitialMenus.cs): 


Public partial class InitialMenus : Migration 

{ 
protected override void Up (MigrationBuilder migrationBuilder) 
{ 


migrationBuilder.EnsureSchema (name: "mec™);) 


migrationBuilder.createTablel( 

name: "MenuCards", 

schema: "mc"™, 

columns: table => new 

{ 
MenuCardId = table.cCcolumn<int> (type: "int", nullable: false) 

.Annotation ("SqlServer:ValueGenerationstrategy™, 
SqlServerValueGenerationstrategy.lIdentityColumn), 

IsDeleted = table.Ccolumn<bool> (type: "bit", nullable: false), 

LastUpdated = table.Column<DateTime> (type: "datetime2", 
nullable: false}), 

Title = table.column<string> (type: "nvarchar (S50})", maxLength: 50， 
nullable: true) 

} ， 

constraints: table 三 > 
table.PrimaryKey ("PR MenuCards", => xX.MenuCardId}); 

}) 5 


migrationBuilder.createTable!l 
name: "Menus™, 
schema: "mc"™, 
columns: table => new 
{ 
MenulId = table.column<int> (type: "int", nullable: false) 
.Annotation ("SqlServer:ValueGenerationstrategy™, 
SqlSserverVvalueGenerationstrategy.IdentityColumn), 
MenuCardId = table.Ccolumn<int> (type: "int", nullable: false), 
Frice = table.colum<decimal> (type: "Money", nullable: false), 
Text = table.column<string> (type: "nvarchar(120})", maxLength: 120, 
nuljlable: true) 
} ， 
constraints: table => 
{ 
table.PrimaryKey ("PR Menus"， 六 一 > XKX.MenuId).: 
table.ForeignKey ( 
name: "FRK Menus MenuCards MenuCardId"™, 
coOlum: KX 一 > KX.MenuCcardId., 
principalSschema: "mec™, 
principalTable: "MenuCards™, 
principalColumn: "MenuCardId"™, 
onDelete: ReferentialAction.Cascade).; 


})s 


migrationBuilder.CreateIndex( 
name: “IX Menus MenucardIq ， 
schema: “mc™, 
table: "Menus™, 
columm: "MenuCardId™).: 
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} 
protected override void Down (MigrationBuilder migrationBuilder) 


migrationBuilder.DropTable( 
name: "Menus"™, 
schema: "mc™); 


migrationBuilder.DropTablel( 
name: "MenuCards™, 
schema: "mec™); 
} 
} 


在 对 模型 进行 更 改 之 后 ， 例 如 向 Menu 类 添加 Allergens( 代 码 文 件 MigrationsLib/Menu.cs): 


public class Menu 
{ 
public int MenuId { get; set; } 
Public string Text { get; set; } 
public decimal Price { get; set; } 
Public string Allergens { get; set; } 
public int MenuCardId { get; set; } 
public MenuCard MenuCard { get set; } 
Public override string ToString{() => Text; 
} 
就 需要 一 个 新 迁移 : 
> dotnet ef migrations add AddAllergens -—-startup-project ..‘\MigrationsConsoleApp 
使 用 新 的 迁移 ， 将 更 新 快照 类 ， 以 显示 当前 状态 ， 并 添加 新 的 Migration 类 型 ， 以 使 用 Up 和 Down 方法 添 
加 和 删除 allergen 列 (代码 文件 MigrationsLib/<version> AddAllergens.cs): 
public partial class AddAllergens : Migration 
{ 
protected override void Up(MigrationBuilder migrationBuilder) 
{ 
migrationBuilder .AddColumn<string>( 
name: "Allergens", 
schema: "me", 
table: "Menus", 
type: "nvarchar (max)™, 
nullable: true):; 
} 


protected override void Down (MigrationBuilder migrationBuilder) 
migrationBuilder .DropColumn( 
name: "Allergens", 
schema: "me", 
table: "Menus"™).: 


} 
} 


在 应 用 新 的 迁移 之 前 ， 请 注意 构建 库 。 否 则 ， 新 的 迁移 就 可 能 是 空 的 。 


注意 : 

对 于 所 做 的 每 一 个 更 改 ， 都 可 以 创建 另 一 个 迁移 。 新 的 迁移 只 定义 了 从 旧版 本 到 新 版 本 所 需 的 更 改 。 如 果 
客户 的 数据 库 需 要 从 任何 早期 版 本 更 新 ， 那 么 在 迁移 数据 库 时 将 调用 必要 的 迁移 。 

在 开发 过 程 中 ， 可 能 会 出 现 许多 生产 中 不 需要 的 迁移 。 只 需要 为 可 能 在 客户 站 点 上 运行 的 所 有 版 本 保留 迁 
移 。 要 从 开发 时 删除 迁移 ， 可 以 调用 dotnet ef migrations remove 来 删除 最 新 的 迁移 代码 。 然 后 添加 新 的 较 大 迁 
移 ， 其 中 包含 自 上 次 迁移 以 来 的 所 有 更 改 . 


26.11.5 ”以 编程 方式 应 用 迁移 


配置 好 迁移 后 ， 可 以 直接 在 应 用 程序 中 局 动 数 据 库 的 迁移 过 程 。 为 此 ， 控 制 台 应 用 程序 配置 为 使 用 依赖 注 
入 容器 来 检索 DB 上 下 文 , 然后 调用 Database 属性 的 Migrate 方法 (代码 文件 MigrationsConsoleApp/Program.cs): 


class Program 
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{ 
private const string Connectionstring = 
@"server= (localdb) \mssgqllocaldb;database=ProCsharpMigrations;" + 
"trusted connection=true"™; 


static void Main(string[] args) 

{ 
RegisterServices (); 
Var context = Container.GetService<MenusContext»>({().:; 
context .Database .Migrate (); 

} 

private static void RegisterServices!() 

{ 
Var SETWICES = new ServiceCollection({(); 
Services.AddDbContext<MenusContext> (options 三 > 

options.UseSgqlServer (Connectionstring)); 

Container = services.BulilldServyviceProviderl():; 

} 

public static IServiceProvider Container { get; private set; } 


} 

如 果 数 据 库 还 不 存在 ， 那 么 Migrate 方法 将 创建 数据 库 一 一 使 用 模型 定义 的 模式 一 一 以 及 一 个 
”EFMigrationsHistory 表 ， 该 表 列 出 了 已 应 用 到 数据 库 的 所 有 迁移 。 不 能 像 前 面 那样 使 用 EnsureCreated 方法 来 
创建 数据 库 ， 因 为 该 方法 不 向 数据 库 应 用 迁移 信息 。 

使 用 现 有 的 数据 库 ， 数 据 库 将 更 新 到 迁移 的 当前 版 本 。 通 过 编程 ， 可 以 使 用 GetMigrations 方法 在 应 用 程序 
中 获得 所 有 可 用 的 迁移 。 要 查看 所 有 应 用 的 迁移 ， 可 以 使 用 GetAppliedMigrations 方法 。 对 于 数据 库 中 丢失 的 
所 有 迁移 ， 请 使 用 GetPendingMigrations 方法 。 


26.11.6 ”应 用 迁移 的 其 他 方法 
除了 以 编程 方式 应 用 迁移 之 外 ， 还 可 以 使 用 命令 行 来 应 用 迁移 : 


> dotnet ef database update --startup-project ../MigrationsConsoleApp 

该 命令 将 最 新 的 迁移 应 用 到 数据 库 。 还 可 以 向 该 命令 提供 迁移 的 名 称 ， 以 便 将 数据 库 放 到 迁移 的 特定 版 
本 中 。 

如 果 数 据 库 管 理 员 需要 对 数据 库 进 行 完全 控制 , 且 不 允许 进行 编程 更 改 , 不 允许 对 .NET Core CLI 命令 行 之 
类 的 工具 进行 任何 更 改 ， 就 可 以 创建 一 个 SQL 脚本 ， 并 将 其 提交 或 目 己 使 用 。 

下 面 的 命令 行 创建 SQL 脚本 migrationsscript.sql， 其 中 包括 从 最 初创 建 的 数据 库 到 最 近 的 迁移 。 还 可 以 为 
脚本 中 应 该 应 用 的 迁移 范围 提供 特定 的 fronyto 值 : 


> dotnet ef migrations script -~-output migrationsscript.sql 
—-—startup-project ..‘\MigrationsConsoleApp 


26.12 小结 


本 章 介 绍 了 EF Core 的 特性 ， 学 习 了 对 象 上 下 文 如 何 了 解 检 索 和 更 新 的 实体 ， 以 及 变更 如 何 写 入 数据 库 。 
还 讨论 了 迁移 如 何在 C# 代 码 中 用 于 创建 和 更 改 数据 库 模 式 。 至 于 模式 的 定义 ,本 章 论 述 了 如 何 使 用 数据 注释 进 
行 数 据 库 映射 ， 流 利 API 提供 了 比 注 释 更 多 的 功能 。 

本 章 前述 了 多 个 用 户 处 理 同一 记录 时 应 对 冲突 的 可 能 性 ， 以 及 隐 式 或 显 式 地 使 用 事务 ， 进 行 更 多 的 事务 
控制 。 

本 章 论述 了 EF Core 2.0 的 新 功能 ， 例 如 已 编译 的 查询 、 全 局 查询 过 滤器 、 表 的 分 割 和 拥有 的 实体 ， 用 户 可 
以 开始 使 用 它们 了 。 

下 一 章 介绍 NET 的 全 球 化 和 本 地 化 ,包括 使 用 区 域 化 特定 的 日 期 、 时 间 和 数字 格式 ， 以 及 为 不 同 语言 定义 
不 同文 本 的 资源 。 


六 


本 地 化 


本 章 要 点 

e 数字 和 日 期 的 格式 化 

e 为 本 地 化 内 容 使 用 资源 

e 本 地 化 ASP.NET Core Web 应 用 程序 
e 本 地 化 通用 Windows 应 用 程序 


本 章 源 代 码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Localization 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 
® NumberAndDateFormatting 
SortneDemo 
CreateResource 
UWPCultureDemo 
ResourcesDemo 
WebApplicationSample 
ASPNETCoreMVCSample 
UWPLocalization 


27.1 全球 市 场 


价值 1.25 亿美 元 的 NASA 的 火星 气象 卫星 在 1999 年 9 月 23 日 失踪 了 ,其 原因 是 一 个 工程 组 为 一 个 关键 的 
太 衬 操作 使 用 了 米 制 单位 ， 而 另 一 个 工程 组 以 英寸 为 单位 。 当 编写 的 应 用 程序 要 在 世界 各 国 发 布 时 ， 必 须 考 虑 
不 同 的 区 域 性 和 区 域 。 

不 同 的 区 域 性 在 日 历 、 数 字 和 日 期 格式 上 各 不 相同 。 按 照 字 母 A 一 Z 给 字符 串 排序 也 会 导致 不 同 的 结果 ， 
因为 存在 不 同 的 文化 差异 。 为 了 使 应 用 程序 可 应 用 于 全 球 市 场 ， 就 必须 对 应 用 程序 进行 全 球 化 和 本 地 化 。 

本 章 将 介绍 .NET 应 用 程序 的 全 球 化 和 本 地 化 。 全 球 化 (globalizatiom 用 于 国际 化 的 应 用 程序 : 使 应 用 程序 可 
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以 在 国际 市 场 上 销售 。 采 用 全 球 化 策略 ， 应 用 程序 应 根据 区 域 性 、 不 同 的 日 历 等 支持 不 同 的 数字 和 日 期 格式 。 
本 地 化 (localization) 用 于 为 特定 的 区 域 性 翻译 应 用 程序 。 而 字符 串 的 翻译 可 以 使 用 资源 ， 如 .NET 资源 或 WPF 资 
源 字典 。 

NET 文 持 Windows 和 Web 应 用 程序 的 全 球 化 和 本 地 化 。 要 使 应 用 程序 全 球 化 ， 可 以 使 用 
System.Globalization 名 称 空间 中 的 类 ; 要 使 应 用 程序 本 地 化 ， 可 以 使 用 System.Resources 名 称 空间 文 持 的 资源 。 


27.2 System.Globalization 名 称 空间 


System.Globalization 名 称 空间 包含 了 所 有 的 区 域 性 和 区 域 类 ， 以 文 持 不 同 的 日 期 格式 、 不 同 的 数字 格式 ， 
甚至 由 GregorianCalendar 类 、HebrewCalendar 类 和 JapaneseCalendar 类 等 表示 的 不 同日 历 。 使 用 这 些 类 可 以 根 
据 不 同 的 地 区 显示 不 同 的 表示 法 。 

本 节 讨 论 使 用 System.Globalization 名 称 空间 时 要 考虑 的 如 下 问题 ; 

e Unicode 问题 

e 区 域 性 和 区 域 

e 显示 所 有 区 域 性 及 其 特征 的 例子 

e 排序 


27.2.1 Unicode 问题 


因为 一 个 Unicode 字符 有 16 位 ， 所 以 共有 65 536 个 Unicode 字符 。 这 对 于 当前 在 信息 技术 中 使 用 的 所 有 
语言 够 用 吗 ? 例如 ， 汉 语 就 需要 80 000 多 个 字符 。 但 是 ，Unicode 可 以 解决 这 个 问题 。 使 用 Unicode 必须 区 分 
基本 字符 和 组 合 字 和 付 。 可 以 给 一 个 基本 字符 添 加 奎 干 个 组 合 字 从， 组 成 一 个 可 显示 的 字符 或 一 个 文本 元 素 。 

例如 , 冰岛 的 字符 Ogonek 可 以 使 用 基本 字符 0x006F( 拉 丁 小 写 
字母 0)、 组 合 字符 0x0328( 组 合 OQgonek) 和 0x0304( 组 合 Macron) 组 四 | - | 
合 而 成 ， 如 图 27-1 所 示 。 组 合 字符 定义 的 范围 是 0x0300~0x0345， 
对 于 美国 和 欧洲 市 场 ， 预 定义 字符 有 助 于 处 理 特殊 的 字符 。 字 符 人 
Ogonek 也 可 以 用 预定 义 字 符 0x01ED 来 定义 。 

对 于 亚洲 市 场 ， 只 有 汉语 需要 80 000 多 个 字符 ， 但 没有 这 人 么 多 的 预定 义 字符 。 在 亚洲 语言 中 ， 总 是 要 处 理 
组 合 字符 。 其 问题 在 于 获取 显示 字符 或 文本 元 素 的 正确 数字 ， 人 得 到 基本 字符 而 不 是 组 合 字符 。 
System.Globalization 名 称 空 间 提供 的 StringInfo 类 可 以 用 于 处 理 这 个 问题 。 

表 27-1 列 出 了 StringInfo 类 的 静态 方法 ， 这 些 方法 有 助 于 处 理 组 合 字符 。 


表 27-1 
方 ”法 说 明 
GetNextTextElement( 返回 指定 字符 串 的 第 一 个 文本 元 素 (基本 字符 和 所 有 的 组 合 字符 ) 
GetTextElementEnumerator( 返回 一 个 允许 迁 代 字符 串 中 所 有 文本 元 素 的 TextElementEnumerator 对 象 
ParseCombiningCharacters 返回 一 个 引用 字符 串 中 所 有 基本 字符 的 整 型 数组 


注意 : 

一 个 显示 字符 可 以 包含 多 个 Unicode 字符 。 要 解决 这 个 问题 ， 如 果 编写 的 应 用 程序 要 在 国际 市 场 销售 ， 就 
不 应 使 用 数据 类 型 char， 而 应 使 用 string。string 可 以 包含 由 基本 字符 和 组 合 字符 组 成 的 文本 元 素 ， 而 char 不 具 
备 该 作用 。 
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27.2.2 区域 性 和 区 域 


世界 分 为 多 个 区 域 性 和 区 域 ， 应 用 程序 必须 知道 这 些 区 域 性 和 区 域 的 差异 。 区 域 性 是 基于 用 户 的 语言 和 文 
化 习惯 的 一 组 首选 项 。RFC 4646(www.ietf.oreg/rfc/rfec4646.txt) 定 义 了 区 域 性 的 名 称 ， 这 些 名 称 根据 语言 和 国家 或 
区 域 的 不 同 在 世界 各 地 使 用 。 例 如，en-AU、en-CA、en-GB 和 en-USs 分 别 用 于 表示 澳大利亚 、 加 拿 大 、 英 国 和 
美国 的 英语 。 

在 System.Globalization 名 称 空间 中 ， 最 重要 的 类 是 CultureInfo。 这 个 类 表示 区 域 性 ， 定 义 了 日 历 、 数 字 和 
日 期 的 格式 ， 以 及 和 区 域 性 一 起 使 用 的 排序 字符 串 。 

RegionInfo 类 表示 区 域 设 置 (如 货币 )， 说 明 该 区 域 是 否 使 用 米 制 系统 。 在 茶 些 区 域 中 ， 可 以 使 用 多 种 语言 。 
例如 ， 西 班 牙 区 域 就 有 Basque(eu-ES)、Catalan(ca-ES)、Spanish(es-ES) 和 Galician(gl-ES) 区 域 性 。 一 个 区 域 可 以 
有 多 种 语言 ， 同 样 ， 一 种 语言 也 可 以 在 多 个 区 域 使 用 ; 例如 ， 墨 西 哥 、 西 班 攻 、 和 危地马拉 、 阿 根 廷 和 秘鲁 等 都 
使 用 西班牙 语 。 

本 章 的 后 面 将 介绍 一 个 示例 应 用 程序 ， 以 说 明 区 域 性 和 区 域 的 这 些 特征 。 

1. 特定 、 中 立 和 不 变 的 区 域 性 

在 NET Framework 中 使 用 区 域 性 , 必须 区 分 3 种 类 型 : 特定 、 
中 立 和 不 变 的 区 域 性 。 特 定 的 区 域 性 与 真正 存在 的 区 域 性 相关 ， 
这 种 区 域 性 用 RFC 4646 定义 。 特 定 的 区 域 性 可 以 映射 到 中 立 的 
区 域 性 。 例 如 ，de 是 特定 区 域 性 de-AT、de-DE、de-CH 等 的 中 立 
区 域 性 。de 是 德语 (German) 的 简写 ，AT、DE 和 CH 分 别 是 奥 地 
利 (Austria)、 德 国 (Germany) 和 瑞士 (Switzerland) 等 国家 的 简写 。 

在 翻译 应 用 程序 时 ， 通 彰 不 需要 为 每 个 区 域 进 行 翻译 ， 
为 奥地利 和 瑞士 等 国 使 用 的 德语 没有 太 大 的 区 别 。 所 以 可 以 使 用 
中 立 的 区 域 性 来 本 地 化 应 用 程序 ， 而 不 需要 使 用 特定 的 区 域 性 。 

不 变 的 区 域 性 独立 于 真正 的 区 域 性 。 在 文件 中 存储 格式 化 的 
数字 或 日 期 ， 或 通过 网 络 把 它们 发 送 到 服务 器 上 时 ， 最 好 使 用 独 
立 于 任何 用 户 设置 的 区 域 性 。 

图 27-2 显示 了 区 域 性 类 型 的 相互 关系 。 

2. CurrentCulture 和 CurrentUICulture 


设置 区 域 性 时 ， 必 须 区 分 用 户 界 面 的 区 域 性 和 数字 及 日 期 格式 的 区 域 性 。 区 域 性 与 线程 相关 ， 通 过 这 两 种 
区 域 性 类 型 ， 就 可 以 把 两 种 区 域 性 设置 应 用 于 线程 。CultureInfo 类 提供 了 静态 属性 CurrentCulture 和 
CurentUICulture。CurmentCulture 属性 用 于 设置 与 格式 化 和 排序 选项 一 起 使 用 的 区 域 性 ， 而 CurrentUICulture 属 
性 用 于 设置 用 户 界 面 的 语言 。 

使 用 Windows 设置 中 的 Time 有 && Language， 再 从 中 选择 REGION & LANGUAGE 选项 用户 就 可 以 在 
Windows 10 操作 系统 中 安装 其 他 语言 ， 如 图 27-3 所 示 。 配 置 为 默认 的 语言 是 当前 的 UI 区 域 性 。 
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ttings 


Region & language 


Find a setting 局 Country or region 


Windews and apps might use your country orregion to give you 
Time & Language lacal content 


8 , Austria ~ 
Date & time at > 


各 Region & language 
Languages 
Speech 
You can type in any language you add to the list. Windows, apps 


and websites will appear in the first language in the list that they 
support 


十 Add a language 
fu English (United States) 
A 字 ‘Windows display language 
(DY Deutsch (Osterreich) 


A Language pack installed 


Related settings 


Additional date, time, & regional settings 
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要 改变 当前 的 区 域 性 ， 可 以 使 用 对 话 框 中 的 Additional date, time, & regional settings 链接 ， 如 图 27-3 所 示 。 
其 中 ， 单 击 Change Date, Time, or Number Formats 选项 ， 查 看 如 图 27-4 所 示 的 对 话 框 。 格 式 的 语言 设置 会 影响 
当前 的 区 域 性 。 也 可 以 改变 独立 于 区 域 性 的 数字 格式 、 时 间 格 式 、 日 期 格式 的 默认 设置 。 

全 Region 


Format: English (United States) 


Match Windows display language (recommended) 


Language praferences 


Date and time formats 
short date: Md/iyyyy 
Long date: dddd, MMMIM d, yyyy 


shart time: h:mm tt 


Long time: h:mm:ss tt 


First day of week: IMonday 


Examples 

Short date: 9/1772017 

Long date: sunday, September 17 2017 
shert time: 1:17 PM 

Long time: 1:17:26 PM 


Additional settings... 


sores 
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这 些 设 置 都 提供 了 很 好 的 默认 值 ， 在 许多 情况 下 ， 不 需要 改变 默认 行为 。 如 果 需 要 改变 区 域 性 ， 只 需要 把 
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线程 的 两 个 区 域 性 改 为 Spanish 区 域 性 ， 如 下 面 的 代码 片段 所 示 ( 使 用 名 称 空 间 System.Globalization): 
Var cl = new CultureInfo("es-ES"); 
CultureInfo.currentCulture = ci; 


CultureInfo.currentUICulture = ci1; 


前 面 已 学 习 了 区 域 性 的 设置 ， 下 面 讨论 CurrentCulture 设置 对 数字 和 日 期 格式 化 的 影响 。 
3. 数字 格式 化 


System 名 称 空间 中 的 数字 结构 Int16、Int32 和 Int64 等 都 有 一 个 重 载 的 ToString0 方 法 。 这 个 方法 可 以 根据 
区 域 设置 创建 不 同 的 数字 表示 法 。 对 于 Int32 结构 ，ToString0 方 法 有 下 述 4 个 重 载 版 本 : 

public string ToString(}); 

public string ToString (IFormatProvider); 


Public string ToString (string); 
Public string ToString (string, IFormatProvider); 


不 市 参数 的 ToString0 方 法 返回 一 个 没有 格式 化 选项 的 字符 串 ， 也 可 以 给 ToString0 方 法 传递 一 个 字符 串 和 
一 个 实现 IFormatProvider 接口 的 类 。 

该 字符 串 指定 表示 法 的 格式 ， 而 这 个 格式 可 以 是 标准 数字 格式 化 字符 串 或 者 图 形 数字 格式 化 字符 串 。 对 于 
标准 数字 格式 化 ， 字 符 串 是 预定 义 的 ， 其 中 C 表示 货币 符号 ，D 表示 输出 为 小 数 ，E 表示 输出 用 科学 计数 法 表 
示 ， 下 表示 定点 输出 ，G 表示 一 般 输出 ，N 表示 输出 为 数字 ，X 表示 输出 为 十 六 进 制 数 。 对 于 图 形 数字 格式 化 
字符 串 ， 可 以 指定 位 数 、 节 和 组 分 隔 符 、 昌 分 号 等 。 图 形 数字 格式 字符 串 规 #， 草 障 表 示 : 两 个 三 位 数 块 被 一 个 
组 分 隔 符 分 开 。 

IFormatProvider 接口 由 NumberFormatInfo、DateTimeFormatInfo 和 CultureInfo 类 实现 。 这 个 接口 定义 了 
GetFormat0 方 法 ， 它 返回 一 个 格式 对 象 。 

NumberFormatInfo 类 可 以 为 数字 和 定义 目 定 义 格式 。 使 用 NumberFormatInfo 类 的 默认 构造 函数 ， 可 以 创建 独 
立 于 区 域 性 的 对 和 象 或 不 变 的 对 象 。 使 用 这 个 类 的 属性 ， 可 以 改变 所 有 格式 化 选项 ， 如 正 号 、 百 分 号 、 数 字 组 分 
隔 符 和 货币 符号 等 。 从 静态 属性 InvariantInfo 返回 一 个 与 区 域 性 无 关 的 只 读 NumberFormatInfo 对 象 。 
NumberFormatInfo 对 象 的 格式 化 值 取决 于 当前 线程 的 CultureInfo 类 ， 该 线程 从 静态 属性 CurrentInfo 返回 。 

示例 代码 NumberAndDateFormatting 使 用 如 下 名 称 空间 : 


System 
system.Globalization 


下 一 个 示例 使 用 一 个 简单 的 控制 台 应 用 程序 ((NET Core) 项 目 。 在 这 段 代 码 中 , 第 一 个 示例 显示 了 在 当前 
线程 的 区 域 性 格式 (这 里 是 English-US， 是 操作 系统 的 设置 ) 中 所 显示 的 数字 。 第 二 个 示例 使 用 了 带 有 
IFormatProvider 参数 的 ToString0 方 法 。CultureInfo 类 实现 下 ormatProvider 接口 ， 所 以 创建 一 个 使 用 法 国 区 
域 性 的 CultureInfo 对 象 。 第 3 个 示例 改变 了 当前 线程 的 区 域 性 。 使 用 CulmreInfo 实例 的 CurrentCulture 属性 ， 
把 区 域 性 改 为 德国 (代码 文件 NumberAndDateFormatting/Program.cs): 


Public static voilid NumberFormatDemo() 

{ 
int wal = 1234567890; 
/culture of the current thread 
Console .WriteLine (val.Tostring("N")); 
// use IFormatProvider 
Console .WriteLine (val.ToString("N", new CultureInfo(" fr-FR"))).; 
// change the current culture 
CultureInfo.CurrentCulture = new CultureInfol("de-DE"). 
Console .WriteLine (val.Tostring("N")); 

} 


可 以 把 这 个 结果 与 前 面 列举 的 美国 、 英 国 、 法 国 和 德国 区 域 性 的 结果 进行 比较 。 


1,234,567,890.00 
1 234 567 890,00 
1.234.567.890,00 
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4. 日 期 格式 化 


对 于 日 期 , Visual Studio 也 提供 了 与 数字 相同 的 支持 。 DateTime 结构 有 一 些 把 日 期 转换 为 字符 串 的 ToString 
方法 的 重 载 。 可 以 传送 字符 串 格 式 并 指定 男 一 种 区 域 性 ;: 

public string Tostring(); | 

PublLLe string ToString (IFormatProvider); 


Public string ToString (string); 
Public string ToString (string, IFormatProvider); 


使 用 ToString(0 方 法 的 字符 串 参数 ， 可 以 指定 预定 义 格 式 字符 或 自 定 义 格式 字符 串 ， 把 日 期 转换 为 字符 串 。 
DateTimeFormatImfo 类 指定 了 可 能 的 值 。DateTimeFormatImfo 类 指定 的 格式 字符 串 有 不 同 的 含义 。 例 如 ，D 表示 
长 日 期 格式 ，d 表示 短 日 期 格式 ，ddd 表示 一 星期 中 某 一 天 的 缩写 ，dddd 表示 一 星期 中 某 一 天 的 全 称 ，yyyy 表示 
年 份 , 工 表 示 长 时 间 格 式 ,t 表 示 短 时 间 格 式 。 使 用 IFormatProvider 参数 可 以 指定 区 域 性 ,使 用 不 带 正 ormatProvider 
参数 的 重 载 方法 ， 表 示 所 使 用 的 是 当前 线程 的 区 域 性 (代码 文件 NumberAndDateFormatting/Program.cs): 


public static void DateFormatDemo{() 

{ 
Var d = new DateTime (2017, 09, 17); 
/current culture 
Console .WriteLine'{(d.ToLongDatestring()); 
/use IFormatProvider 
Console .WriteLine(d.ToString{("D", new CultureInfo ("fr-FR"))); 
// use current culture 
Console .WriteLine($"{CultureInfo.currentculture}: {d:D}"™):; 
CultureInfo.cCcurrentcCulture = new CultureInfol(™"™es— ES"); 
Console.WriteLine($"{CultureInfo.CurrentcCulture}: {d:D}"™); 


} 

这 个 示例 程序 的 结果 说 明了 使 用 线程 的 当前 区 域 性 的 ToLongDateString0 方 法 ， 其 中 给 ToString0 方 法 传递 
一 个 CultureInfo 实例 ， 则 显示 其 法 国 版 本 ; 把 线程 的 CurrentCulture 属性 改 为 es-ES， 则 显示 其 西班牙 版 本 ， 
如 下 所 示 。 

Sunday, september 17, 2011 

dimanche 17 septembre 2011 


en—US: Sunday, September 1i1, 2017 
es-ES: domingo, 17 de septiembre de 2017 


27.2.3 使 用 区 域 性 


为 了 全 面 介绍 区 域 性 ， 下 面 使 用 一 个 UWP 应 用 程序 示例 ， 该 应 用 程序 列 出 所 有 的 区 域 性 ， 描 述 区 域 性 属 
性 的 不 同 特征 。 在 UI 的 左边 ， 树 视图 用 于 显示 所 有 的 区 域 性 。 右 边 是 一 个 用 户 控件 ， 显 示 了 所 选区 域 性 和 区 
域 的 相关 信息 。 图 27-5 显示 了 该 应 用 程序 在 Visual Studio 2017 Designer 中 的 用 户 界 面 。 


Culture Name: Neutral Culture 


English Name: 


Native Name: 
Default Calendar: 


Optional Calendars: 


Samples 
Number 
Full Date 


Time 


Region Information 
Region 
Curreney 


|s Aetrie 
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注意 : 

示例 代码 使 用 了 树 控 件 。Windows 10 运行 库 不 包括 Fall Creators Update 2017 中 的 树 视图 控件 , 但 预计 以 后 
会 有 树 视图 控件 。 有 几 个 第 三 方 的 树 控 件 可 以 用 于 UWP。 微软 的 Windows Universal Samples 在 
https://github.com/MicrosofyVWindows-universal-samples 中 ， 它 也 包含 树 视图 控件 。 此 控件 用 于 这 个 UWP 示例 。 
因为 这 个 控件 是 用 C++ 代码 编写 的 ， 所 以 需要 使 用 Universal Windows Platform 开发 工作 负载 安装 C++ 组 件 。 


在 应 用 程序 的 初始 化 阶段 , 所 有 可 用 的 区 域 性 都 添加 到 应 用 程序 左边 的 TreeView 控件 中 。 这 个 初始 化 工作 
在 SetupCultures0 方 法 中 进行 ， 该 方法 在 CulturesViewModel 类 的 构造 图 数 中 调用 (代码 文件 UWPCultureDemo/ 
Cultures ViewModel.cs): 


Public CulturesViewModel () 
{ 
SetupCcultures(}s 


对 于 在 用 户 界面 上 显示 的 数据 ,创建 自 定义 类 CultureData。 这 个 类 可 以 绑 定 到 TreeView 控件 上 ， 因 为 它 
的 SubCultures 属性 包含 一 列 CultureData。 因 此 TreeView 控件 可 以 遍历 这 个 树 状 结构 。CulmreData 不 包含 子 区 
域 性 ， 而 包含 数字 、 日 期 和 时 间 的 CultureInfo 类 型 以 及 示例 值 。 数 字 以 适用 于 特定 区 域 性 的 数字 格式 返回 一 个 
字符 串 ， 日 期 和 时 间 也 以 特定 区 域 性 的 格式 返回 字符 串 。CultureData 包含 一 个 RegionInfo 类 来 显示 区 域 。 对 于 
一 些 中 立 区 域 性 (例如 English)， 创 建 RegionInfo 会 抛 出 一 个 异常 ， 因 为 条 些 区 域 有 特定 的 区 域 性 。 但 是 ， 对 于 其 
他 中 立 区 域 性 (例如 German)， 可 以 成 功 创建 RegionInfo， 并 映射 到 默认 的 区 域 上 。 这 里 抛 出 的 异常 应 这 样 处 理 ( 代 
人 码 文件 UWPCultureDemo/CultureData.cs): 
Public class CultureData 
{ 
Public CultureInfo CultureInfo { get; set; } 
Public List<CultureData> SubCultures !{ get; set; } 
double numberSsample = 981716543.21]:; 
Public string NumberSample => numberSample.ToString("N", CultureInfo}),; 
public string DateSample => DateTime.Today.ToString("D", CultureInfo); 
public string TimeSample => DateTime.Now.ToString("T", CultureInfo)}).; 
Public ReglonInfo RegionIinfo 
get 
RegionIinfo ri; 
try 
{ 
ri = new ReglonIinfo(CultureInfo.Name); 


} 
catch (ArgumentException) 


// with some neutral cultures regions are not available 
return null; 
} 
return ri; 
} 
} 
} 


在 SetupCultures0 方 法 中 ， 通 过 静态 方法 CultureInfo.GetCultres0 获 取 所 有 区 域 性 。 给 这 个 方法 传递 
CultureTypes.AllCultures， 就 会 返回 所 有 可 用 区 域 性 的 未 排序 数组 。 该 数组 按 区 域 性 名 称 来 排序 。 有 了 排 好 序 的 
区 域 性 ， 就 创建 一 个 CultureData 对 象 的 集合 ， 并 分 配 CultureInfo 和 SubCultures 属性 。 之 后 ， 创 建 一 个 字典 ， 
以 快速 访问 区 域 性 名 称 。 

对 于 UI 中 应 该 显示 的 数据 ， 创 建 一 个 CultureData 对 象 列 表 ， 在 执行 完 foreach 语句 后 ， 该 列表 将 包含 树 状 
视图 中 的 所 有 根 区 域 性 。 可 以 验证 根 区 域 性 ， 以 确定 它们 是 否 把 不 变 的 区 域 性 作为 其 父 区 域 性 。 不 变 的 区 域 性 
把 LCID(Locale IdentifienD) 设 置 为 127， 每 个 区 域 性 都 有 目 己 的 唯一 标识 待 ， 可 用 于 快速 验证 。 在 代码 段 中 ， 根 
区 域 性 在 站 语句 块 中 添加 到 rootCultures 集合 中 。 如 果 一 个 区 域 性 把 不 变 的 区 域 性 作为 其 父 区 域 性 ， 它 就 是 根 
区 域 性 。 
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如 果 区 域 性 没有 父 区 域 性 ， 它 就 会 添加 到 树 的 根 节 点 上 。 要 得 找 父 区 域 性 ， 必 须 把 所 有 区 域 性 保存 到 一 个 
字典 中 。 相 关内 容 参 见 前 面 章 节 ， 其 中 第 10 章 介 绍 了 字典 ， 第 8 章 介绍 了 lambda 表达 式 。 如 果 所 迁 代 的 区 域 
性 不 是 根 区 域 性 , 它 就 添加 到 父 区 域 性 的 SubCultures 集合 中 。 使 用 字典 可 以 快速 找到 父 区 域 性 。 在 最 后 一 步 中 ， 
把 根 区 域 性 赋予 窗口 的 DataContext， 使 根 区 域 性 可 用 于 UI( 代 码 文件 UWPCultreDemo/CulturesViewModel.cs): 


private void SetupCultures {() 
{ 
Var CultureDataDict = CultureInfo.GetCultures (CultureTypes.AllCultures) 
.OrderByit{c => c.NMame) 
-Select(c => new CultureData 
{ 
CultureInfo = c, 
Subcultures = new List<CultureData>() 
}) 


.TODilctionary{c => c.cultureInfo.Name); 


Var IootCultures = new List<CultureData>({():; 
foreach (var cd in cultureDataDict .Values) 
{ 
if (cd.cultureInfo.Parent.LcoID == 127) 
{ 
rootcultures.Add (cd}.: 
} 


三 ] Se 


If (cultureDataDict.TryGetValue (cd.cultureInfo.Parent.Name, 
out CultureData parentcCultureData)) 
{ 
parentcCultureData.Subcultures.Add (lcd); 
} 
= 
{ 
throw new InvalidoperationException( 
"parent culture not found™}; 
} 
} 
} 


foreach {var rootCulture in rootCultures.oOrderBy! 
cd => cd.CcultureInfo.EnglishName)) 
{ 
RootcCultures.Add {rootcCuljture}).; 
} 
} 


Public IList<CultureData> RootCultures { get; } = new List<CultureData> (}); 

现在 看 看 显示 内 容 的 XAML 代码 。 一 个 树 型 视图 用 于 显示 所 有 的 区 域 性 。 对 于 在 树 型 视图 内 部 显示 的 项 ， 
使 用 项 模板 。 这 个 模板 使 用 一 个 文本 块 ， 该 文本 框 绑 定 到 CultureInfo 类 的 EnglishName 属性 上 。( 代 码 文件 
UWPCultureDemo/MaimnPasge.Xam]): 


<tvc:TreeView KX:Name="treeViewl" 
IsMultjsSelectcheckBoxEnabled="False" 
IsItemClickEnabled="True"™" 
SelectionChanged="{Xx:Bind OnselectionChanged, Mode=OneTime} "> 
<tvc:TreeView.ItemTemplate> 
<DataTemplate> 
<StackPanel Orientation="Horizontal™" Height="40" 
Margin="{Binding Depth ， 
Converter={StaticResource IntegerToIndConverter}}"> 
<FoONtIcon xX:Name="expandCollapseCchevIron™ 
Glyph="{Binding IsExpanded, 
Converter={StaticResource ExpandCollapseGlyphConverter}}" 
Visibility="{Binding Data.subCultures, 
Converter={StaticResource EmptyConverter}}" 
FOoONtSize="12" 
Margin="12,8,12,8" 
FontFamily="Segoe MDL2 Assets"™" /> 
<TextBlock Text="{Binding Data.CultureInfo.EnglishName}" /> 
</StackPanel> 
</DataTemplate> 
</tve:TreeView.ItemTemplate> 
<tvc:TreeView.ItemContainerTransitions> 
<TransitionCollection> 
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<ContentThemeTransition /> 
<ReorderThemeTransition /> 
<EntranceThemeTransition IsSstaggeringEnabled="False"™ /> 
</TransitionCollection> 
</tvec:TreevVview.ItemContainerTransitions> 
</tvc:TreevVview> 


在 隐藏 代码 文件 中 ， 通 过 访问 视图 模型 中 的 CultureData 对 象 来 初始 化 TreeView。 使 用 CultureData 对 象 ， 为 
TreeView 创 建 TreeNode 对 象 。TreeNode 类 定义 了 一 个 Data 属 性 ， 在 这 个 属性 中 ,分 配 CultureData 对 象 。TreeNode 
的 Add 方 法 允许 添加 子 对 象 。 通 过 递归 调用 本 地 函数 AddSsubNodes 来 添加 子 对 象 (代码 文件 UWPCultureDemo/ 
MainPage.xaml.cs): 


protected override Vvoid OnNavigatedTo (NavigationEventArgs e) 
{ 
VO1id AddsubNodes (TreeNode parent) 
{ 
if (Parent .Data is CultureData cd && cd.sSubCultures != null) 
{ 
foreach {var culture in cd.Subcultures) 
{ 
Var node = new TreeNode 
{ 
Data = culture, 
ParentNode = parent 
}s 
parent.Add (node}).; 


foreach (var subculture In culture.SubCcultures) 
{ 
LddsubNodes (noae) ， 
} 
} 
} 
} 


base.OnNavigatedTo (e)} 
Var rootNodes = ViewModel .RootcCcultures.Select {cd => new TreeNode 
{ 
Data = Cdq 
1 5 


foreach (var node In rootNodes) 
{ 
treeVviewl .RootNode.Add (node); 
AddSubNodes (node).: 
} 

} 

在 用 户 选 择 树 中 的 一 个 节点 时 ， 就 会 调用 TreeView 类 的 SelectedItemChanged 事件 的 处 理 程序 。 在 下 面 的 
代码 段 中 , 这 个 处 理 程 序 在 OnSelectionChanged0 方 法 中 实现 。 在 这 个 实现 代码 中 , 通过 实现 , 把 关联 ViewModel 
的 SelectedCulture 属性 设置 为 所 选 的 CultureData 对 象 (代码 文件 UWPCultureDemo/MainPage.xamlcs): 

private void OnSelectionChanged (object sender, SelectionChangedEventArgs e) 

{ 

ViewModel .Selectedculture = 
(treeViewl .SelectedItems?.FirstorDefault(}) as TreeNode) ? .Data 


as CultureData; 


} 


为 了 显示 所 选项 的 值 ， 使 用 了 几 个 TextBlock 控件 ， 它 们 绑 定 到 CultureData 类 的 CultureInfo 属性 上 ， 从 而 
绑 定 到 从 Culturemfo 返回 的 CultureImfo 类 型 的 属性 上 , 例如 Name、ISNeutralCulture、EnglishName 和 NativeName 
等 。 要 把 从 NeutralCulture 属性 返回 的 布尔 值 转换 为 Visiblility 枚 举 值 ， 并 显示 日 历 名 称 ， 应 使 
件 UWPCultureDemo/CultureDetailUC xam): 
<TextBlock Grid.Row="0" Grid.Column="0" Text="Culture Name:” /> 
<TextBlock Grid.Row="0" Grid.Columnm="1" 
Text="{X:Bind CultureData.CultureInfo.Name, Mode=OneWay}" 
Width="100" /> 


<TextBlock Grid.Row="0" Grid.Column="2"™ Text="Neutral Culture™ 
Visibility="{x:Bind CultureData.CcultureInfo.IsNeutralCulture, Mode=OneWay}"™" /> 


<TextBlock Grid.Row="1" Grid.Ccolumn="0" Text="English Name:" /> 
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<TextBlock Grid.Row="1" Grid.Column="1" Grid.ColummSspan="2" 
Text="{x:Bind CultureData.CultureInfo.EnglishName, Mode~OoneWay}™" /> 


<TextBlock Grid.Row="2" Grid.Column="0" Text="Native Name:"™ /> 
<TextBlock Grid.Row="2"™ Grid.cCcolumn="1" Grid.Ccolummnspan="2" 
Text="{x:Bind CultureData.CultureInfo.NativeName}"™ /> 


<TextBlock Grid.Row="3" Grid.Column="0" Text="Default Calendar:™ /> 

<TextBlock Grid.Row="3" Grid.Ccolumn="1" Grid.Ccolummnspan="2" 
Text="{X:Bind CultureData.CcultureInfo.Calendar, Mode=OneWay 
Converter={StaticResource calendarConverter}}™ /> 


<TextBlock Grid.Row="4" Grid.Column="0" Text="Optional Calendars:" /> 
<ListBox Grid.Row="4" Grid.Ccolumn="1" Grid.Columnspan="2" 
ItemsSource="{X:Bind CultureData.CultureInfo.OptionalCalendars}"> 
<ListBox.ItemTemplate> 
<DataTemplate> 
<TextBlock Text="{Binding 
Converter={StaticResource calendarConverter}}™" /> 
</DataTemplate> 
</ListBox.ItemTemplate> 
</ListBox> 


要 显示 日 历 文 本 , 可 使 用 实现 了 IValueConverter 的 对 象 ,下 面 是 CalendarTypeToCalendarInformationConverter 
类 中 Convert 方法 的 实现 代码 ， 该 实现 代码 使 用 类 名 和 日 历 类 型 名 称 ， 给 日 历 返 回 一 个 有 用 的 值 (代码 文件 
UWPCultreDemo/Converters/CalendarlypeToCalendarIntormationConverter.cs): 


public object Convert (object value, Type targetType, object parameter., 
string language) 
{ 
if (value is Calendar cal) 
{ 
var CalText = new StringBuilder (50); 
calText.Append (cal .ToString(}))}); 
calText.Remove (0, 21}); // remove the namespace 
CalText.Replace ("Calendar™™, ™™); 


if (cal is GregorianCcalendar gregCal) 
{ 

calText .Append($" {gregCal.calendarType}"); 
} 


return calText.ToString (); 
} 
[= 
{ 
return null; 
} 
} 


CultureData 类 包含 的 属性 可 以 为 数字 、 日 期 和 时 间 格 式 显 示 示 例 信息 ， 这 些 属性 用 下 面 的 TextBlock 元 素 
绑 定 (XAML 文件 UWPCultureDemo/CultureDetailUC.xaml): 


<TextBlock Grid.Row="0"™ Grid.cCcolumn="0" Text="Number™ /> 
<TextBlock Grid.Row="0" Grid.Column="1" 

Text="{x:Bind CultureData.NumberSample, Mode=OneWay}"™ /> 
<TextBlock Grid.Row="1" Grid.Column="0" Text="FUu]ll1 Date™ /> 
<TextBlock Grid.Row="1" Grid.cCcolumn="1" 

Text="{x:Bind CultureData.DateSample, Mode=~OneWay}™ /> 
<TextBlock Grid.Row="2" Grid.Column="0" Text="Time"™" /> 
<TextBlock Grid.Row="2" Grid.Column="1" 

Text="{x:Bind CultureData.TimeSample, Mode=OneWay}™ /> 


区 域 的 信息 用 XAML 代码 的 最 后 一 部 分 显示 。 如 果 RegionInfo 不 可 用 ， 就 隐藏 整个 GroupBox。TextBlock 
元 素 绑 定 了 RegionInfo 类 型 的 DisplayName、CurrencySymbol、ISOCurrencySymbol 和 IsMetric 属性 : 


<GIrid Grid.Row="6" Grid.columm="0"™" Grid.ColumnSspan="3" 

ViSsibility="{xXx:Bind CultureData.RegionIinfo, Mode=OneWay, 

Converter={StaticResource NullcConverter}} "> 

<1-- ... -> 

<TextBlock Grid.Row="0"™ Grid.Column="0" Text="Region Information™ 
style="{StaticResource SubheaderTextBlockstyle"™" /> 

<TextBlock Grid.Row="0"™ Grid.Column="1"™" Grid.Ccolumnspan="2" 
Text="{XxX:Bind CultureData.RegionInfo.DisplayName, Mode~OneWay}™ /> 
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<TextBlock Grid.Row="1" Grid.Column="0" Text="Currency" /> 
<TextBlock Grid.Row="1" Grid.Column="1" 
Text="{x:Bind CultureData.RegionInfo.cCcurrencySymbol, Mode=OneWay}™ /> 


<TextBlock Grid.Row="1™" Grid.Column="2" 
Text="{x:Bind CultureData.RegionInfo.ISOCurrencySymbol, Mode~OneWay}" /> 


<TextBlock Grid.Row="2" Grid.Column="1" Text="Is Metric"™" 
Visibility="{x:Bind CultureData.RegionInfo.IsMetric, Mode=OneWay}" /> 
</Grid> 
启动 应 用 程序 ， 在 树 型 视图 中 就 会 看 到 所 有 的 区 域 性 ， 选 择 一 个 区 域 性 后 ， 就 会 列 出 该 区 域 性 的 特征 ， 如 
27-6 所 示 。 


Culture Demo 一 口 
i Culture Name: gd-GB 
English Name: scottish Gaelic (United Kingdom) 
» Rwa Native Name: Gaidhlig (An Rioghachd Aonaichte) 
> caho Default Calendar: Gregorian Localized 


Optional Calendars: Gregorian Localized 


» Sakha 


I Samples 
Number 9 8176.3543.21 
> Sango Full Date Disathairne, 30mh dhen t-sultain 2017 
Time 10:12:29 
» Sangu 
| Region Information 
» Sanskrit 
Region United Kingdom 
“ Scottish Gaelic Currency £ GBP 
ls Metrie 
» Sena 
>» Serbian 
» Sesotho 
» Sesotho sa Leboa 
2 Setewana 
图 27-6 


27.2.4 排序 


SortingDemo 示例 使 用 如 下 名 称 空间 : 
System 
System.Collections 
System.Collections.Generic 
System.Globalization 
排序 字符 串 取 决 于 区 域 性 。 在 默认 情况 下 ， 为 排序 而 比较 字符 串 的 算法 依赖 于 区 域 性 。 例 如 在 芬兰 ， 字 符 V 
和 W 束 是 相同 的 。 为 了 说 明 分 兰 的 排序 方式 ， 下 面 的 代码 创建 一 个 小 型 控制 台 应 用 程序 示例 ， 其 中 对 数组 中 尚未 
排序 的 一 些 美国 州 名 进行 排序 。 
下 面 的 DisplayName0 方 法 用 于 在 控制 台 上 显示 数组 或 集合 中 的 所 有 元 系 ( 代 人 码 文件 SortingeDemo/Program.cs): 
public static void DisplayNames (string title, IEnumerable<string> names) 
Console.WriteLine (title); 
Console -WriteLine (string.Join("-", names)); 


Console .WriteLine (); 


} 
在 Main0 方 法 中 ， 在 创建 了 包含 一 些 美国 州 名 的 数组 后 ， 就 把 线程 的 CurrentCulture 属性 设置 为 Finnish 区 
域 性 ， 这 样 ， 下 面 的 Array.Sort0 方 法 就 使 用 芬兰 的 排列 顺序 。 调 用 DisplayName(0 方 法 在 控制 台 上 显示 所 有 
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的 州 名 : 


Public static void Maint{) 
{ 
string[] names = {"Alabama™", "Texas™", "Washington™"., "Virginia™, 
"Wisconsin™.”, "Wyoming", "Kentucky", "Missouri™", "Utah™, 
"Hawali", "Kansas™", "Loulsiana", "Alaska™"., "Arizona™}; 
CultureIinfo.CurrentcCulture = new CultureInfo("fi-—FI"); 
Array.Sort (names); 
DisplayNames ("Sorted using the Finnish culture™", names); 
Ey 
} 


在 以 芬兰 排列 顺序 第 一 次 显示 美国 州 名 后 ， 数 组 将 再 次 排序 。 如 果 和 希望 排序 独立 于 用 户 的 区 域 性 ， 束 可 以 
使 用 不 变 的 区 域 性 。 在 要 将 已 排序 的 数组 发 送 到 服务 器 上 或 存储 到 茶 个 地 方 时 ， 就 可 以 采用 这 种 方式 。 

为 此 ， 给 Array.Sort0 方 法 传递 第 二 个 参数 。Sort0 方 法 希望 第 二 个 参数 是 实现 IComparer 接口 的 一 个 对 象 。 
System.Collections 名 称 空 间 中 的 Comparer 类 实现 IComparer 接口 .Comparer DefaultInvariant 返回 一 个 Comparer 
对 象 ， 该 对象 使 用 不 变 的 区 域 性 比较 数组 值 ， 以 进行 独立 于 区 域 性 的 排序 。 

public static void Main() 

Re 

// sort using the invariant culture 
Array.Ssort (names, System.Collections.Comparer.DefaultInvariant); 


DisplayNames ("Sorted using the invariant culture"™", names); 

} 

这 个 程序 的 输出 显示 了 用 Finnish 区 域 性 进行 排序 的 结果 和 独立 于 区 域 性 的 排序 结果 。 在 使 用 独立 于 区 
域 性 的 排序 方式 时 ，Virginia 排 在 Washington 的 前 面 。 用 Finnish 区 域 性 进行 排序 时 ，Virginia 排 在 Washington 
的 后 面 。 

Sorted using the Finnish culture 

Alabama—Alaska—Arizona—Hawalii—Kansas—-Kentucky-Louisiana~-Missouri—Texas—-Utah— 

Washington—Virginia~-Wisconsin-Wyoming 

Sorted using the invariant culture 


Alabama—Alaska—-Arizona—Hawali—Kansas—Kentucky-Loulisiana~Missouri—Texas—-Utah— 
Virginia~-Washington-Wisconsin-Wyoming 


注意 : 
如 果 对 集合 进行 的 排序 应 独立 于 区 域 性 ， 该 集合 就 必须 用 不 变 的 区 域 性 进行 排序 。 在 把 排序 结果 发 送 给 服 
务 器 或 存储 在 文件 中 时 ， 这 种 方式 尤其 有 效 。 为 了 给 用 户 显示 排序 的 集合 ， 最 好 用 用 户 的 区 域 性 给 它 排 序 。 


除了 依赖 区 域 设置 的 格式 化 和 测量 系统 之 外 ， 文 本 和 图 片 也 可 能 因 区 域 性 的 不 同 而 有 所 变化 。 此 时 就 需要 


27.3 ”资源 


像 图 片 或 字符 串 表 这 样 的 资源 可 以 放 在 资源 文件 或 附属 程序 集中 。 在 本 地 化 应 用 程序 时 ， 这 种 资源 非常 有 
用 , .NET 对 本 地 化 资源 的 搜索 提供 了 内 置 支持 。 在 说 明 如 何 使 用 资源 本 地 化 应 用 程序 之 前 ， 先 讨论 如 何 创 建 和 
读 取 资源 ， 而 不 需要 考虑 语言 因素 。 


27.3.1 资源 读 取 器 和 写 入 器 


在 .NET Core 中， 资源 读 取 器 和 写 入 器 与 完整 的 NET 版 本 相 比 是 有 限 的 (在 撰写 本 文 时 )。 然 而 ， 在 许多 情 
形 下 (包括 多 平台 文 持 )， 资 源 读 取 器 和 写 入 器 提供 了 必要 的 功能 。 
CreateResource 示例 应 用 程序 动态 创建 了 一 个 资源 文件 ， 并 从 文件 中 读 取 资源 。 这 个 示例 使 用 以 下 名 称 
空间 : 
System 


System.Collections 
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System.IO 
System.Resources 
ResourceWriter 允许 创建 二 进 制 资源 文件 。 写 入 器 的 构造 函数 需要 一 个 使 用 File 类 创建 的 Stream。 利 用 
AddResource 方法 添加 资源 (代码 文件 CreateResource/Program.cs): 


private const string ResourceFile = "Demo.resources"™; 
public static Vol CreateResource() 


FileSstream stream = File.OpenWrite (ResourceFile); 
usSing (var writer = new ResourceWriter (stream)) 
{ 
writer.AddResource ("Title", "Professional C#") : 
writer .AddResource ("Author", "Christian Magel").:; 
writer .AddResource ("Publisher”", "Wrox Press").; 
} 
} 
要 读 取 二 进 制 资源 文件 的 资源 ， 可 以 使 用 ResourceReader 。 读 取 器 的 GetEnumerator 方法 返回 一 个 
IDictionaryEnumerator， 在 以 下 foreach 语句 中 使 用 它 访 问 资源 的 键 和 值 : 


Public static volid ReadResource{) 


FileStream stream = File.OpenRead (ResourceFile); 
USslIno (Var reader = new ResourceReader (stream)) 
{ 
foreach (DictionaryEntry resource in reader) 
{ 
Console .WriteLine ($"{resource.Key} {resource.Value}™"); 
} 
} 
} 


运行 应 用 程序 ， 返 回 写 入 二 进 制 资源 文件 的 键 和 值 。 如 下 一 节 所 示 ， 还 可 以 使 用 命令 行 工具 -一 资源 文件 生 
成 器 (resgem) 一 一 创建 和 转换 资源 文件 。 


27.3.2 ”使 用 资源 文件 生成 器 


资源 文件 包 仿 图片、 字符 串 表 等 条 目 。 要 创建 资源 文件 , 可 以 使 用 一 般 的 文本 文件 , 或 者 使 用 那些 利用 XML 
的 TesX 文件 。 下 面 从 一 个 简单 的 文本 文件 开始 。 

内 嵌 字 符 串 表 的 资源 可 以 使 用 一 般 的 文本 文件 来 创建 。 该 文本 文件 只 是 把 字符 串 赋 予 键 。 键 是 可 以 用 来 从 
程序 中 获取 值 的 名 称 。 键 和 值 都 可 以 包含 空格 。 

这 个 例子 显示 了 Wirox.ProCSharp.Localization.MyResources.txt 文件 中 的 一 个 简单 字符 串 表 : 

Title = Professional C# 

Chapter = Localization 


Author = Christian Nagel 
Publisher = WIox Press 


注意 : 
在 保存 带 Unicode 字符 的 文本 文件 时 ， 必 须 将 文件 和 相应 的 编码 一 起 保存 。 为 此 ， 可 以 在 Save As 对 话 框 
中 选择 UTF8 编码 . 


可 以 使 用 资源 文件 生成 器 (Resgen.exe) 实 用 程序 在 Wrox.ProCSharp.Localization.MyResources.txt 的 外 部 创建 
一 个 资源 文件 ， 输 入 如 下 代码 : 

resgen Wrox.ProCSharp.Localization.MyResources .txt 

这 会 创建 Wrox.ProCSharp.Localization.MyResources.resources 文件 。 得 到 的 资源 文件 可 以 作为 一 个 外 部 文件 
添加 到 程序 集中 ， 或 者 内 风 到 DLL 或 EXE 中。Resgen 还 可 以 创建 基于 XML 的 .resX 资源 文件 。 构 建 XML 文 
件 的 一 种 简单 方法 是 使 用 Resgen 本 身 : 


resgen Wrox.Procsharp.Localization.MyResources.txt 
WIox.ProCcSsharp.Localization.MyResources.resX 
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这 条 命令 创建 了 XML 资源 文件 Wrox.ProCSharp.Localization.MyResources.resX。Resgen 支持 强 类 型 化 的 资 
源 。 强 类 型 化 的 资源 用 一 个 访问 资源 的 类 表示 。 这 个 类 可 以 用 Resgen 实用 程序 的 /str 选项 创建 : 


resgen /str:C#,Wrox.Procsharp.Localization,MyResources,MyResources.cs 
WIOX.PIoCSharp.Locallzation.MyResources .resXx 


在 /str 选项 中 ， 按 照 语言 、 名 称 空间 、 类 名 和 源 代 码 文件 名 的 顺序 定义 资源 。 
27.3.3 通过 ResourceManager 使 用 资源 文件 


默认 情况 下 ， 资 源 文件 都 葡 入 程序 集 。 可 以 自 定义 它 一 一 例如 ， 在 项 目 文件 中 把 带 有 Remove 属性 的 
EmbeddedResource 元 率 添 加 到 ItemGroup 中 ， 就 可 以 从 程序 集中 删除 资源 ， 如 下 所 示 : 
<ItemSroup> 


<EmbeddedResource Remove="Resources\Messages.de.resx" /> 
</ItemGroup> 


要 了 解 资源 文件 如 何 使 用 ResourceManager 类 加 载 ， 创 建 一 个 控制 台 应 用 程序 LNET Core)， 命 名 为 
ResourcesDemo。 这 个 示例 使 用 以 下 名 称 空间 : 
System 
System.Globalization 
System.Reflection 
System.Resources 

创建 一 个 Resources 文件 夹 ， 在 其 中 添加 Messages.resx 文件 。Messages.resx 文件 填充 了 English-US 内 容 的 
键 和 值 ， 例 如 键 GoodMorning 和 值 Good Morming! 这 是 默认 的 语言 。 可 以 添加 其 他 语言 资源 文件 和 命名 约定 ， 
把 区 域 性 添加 到 资源 文件 中 ， 例 如 ，Messages.de.resx 表示 德语 ，Messages.de-AT.resx 表示 奥地利 口音 。 

要 访问 能 入 式 资源 ， 使 用 System.Resources 名 称 空 间 中 的 ResourceManager 类 和 NuGet 包 
System Resources.ResotrceManager。 实 例 化 ResourceManager 时 ， 一 个 重 载 的 构造 函数 需要 资源 的 名 称 和 程序 
集 。 应 用 程序 的 名 称 空 间 是 ResourcesDemo; 资源 文件 在 Resources 文件 夹 中 ， 它 定义 了 子 名 称 空间 Resources， 
其 名 称 是 Messages.resx。 它 定义 了 了 名称 ResourcesDemo.Resources.Messages。 可 以 使 用 Program 类 型 的 
GetTypeInfo 方法 检索 资源 的 程序 集 ， 它 定义 了 一 个 Assembly 属性 。 使 用 resources 实例 ，GetString 方法 返回 从 
资源 文件 传递 的 键 的 值 。 给 第 二 个 参数 传递 一 个 区 域 性 ， 例 如 de-AT， 就 在 de-AT 资源 文件 中 查找 资源 。 如 果 
没有 找到 ， 就 提取 中 性 语言 de， 在 de 资源 文件 中 查找 资源 。 如 果 没 有 找到 ， 就 在 没有 指定 区 域 性 的 默认 资源 
文件 中 查找 ， 返 回 值 (代码 文件 ResourcesDemo/Program.cs): 

var resources = new ResourceManager ("ResourcesDemo .Resources.Messages", 

typeof (Program) .GetTypeInfo() .Assembly) ; 
string goodMorning = resources.Getstring ("GoodMorning", 


new CultureInfo(" de-AT")).; 
Console.WriteLine (goodMorning); 


ResourceManager 构造 函数 的 男 一 个 重 载 版 本 只 需要 类 的 类 型 。 这 个 ResourceManager 查找 Program.resx 资 
源 文件 : 


Var PIogramResources = new ResourceManager (typeof (Program))}).:; 
Console.WriteLine (programResources.GetSstring ("Resourcel"™)),;} 


27.3.4 System.Resources 名 称 空间 


在 举例 之 前 ， 本 节 先 复习 一 下 System.Resources 名 称 空间 中 处 理 资源 的 类 : 

e ResourceManager 类 可 以 用 于 从 程序 集 或 资源 文件 中 获取 当前 区 域 性 的 资源 。 使 用 ResourceManager 类 
还 可 以 获取 特定 区 域 性 的 ResourceSet 类 。 

e ResourceSet 类 表示 特定 区 域 性 的 资源 。 在 创建 ResourceSet 类 的 实例 时 ， 它 会 枚 举 一 个 实现 
IResourceReader 接口 的 类 ， 并 在 散 列 表 中 存储 所 有 的 资源 。 

se IResourceReader 接口 用 于 从 ResourceSet 中 枚 举 资源 。ResourceReader 类 实现 这 个 接口 。 
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@ ResourceWriter 类 用 于 创建 资源 文件 。ResourceWTiiter 类 实现 IResourceWTriter 接口 。 
27.4 使 用 ASP.NET Core 本 地 化 


注意 : 
使 用 本 地 化 与 ASPNET Core, 需要 了 解 本 章 讨论 的 区 域 性 和 资源 , 以 及 如 何 创 建 ASPNET Core 应 用 程序 。 
如 果 以 前 没有 使 用 ASPNET Core 创建 ASPNET Core Web 应 用 程序 ， 就 应 该 阅读 第 30 章 ， 再 继续 学 习 本 章 的 


本 地 化 ASPNET Core Web 应 用 程序 时 ， 可 以 使 用 CultureInfo 类 和 资源 ， 其 方式 类 似 于 本 章 前 面 的 内 容 ， 
但 有 一 些 额 外 的 问题 需要 解决 。 设 置 完整 应 用 程序 的 区 域 性 不 能 满足 一 般 需 求 ， 因 为 用 户 来 目 不 同 的 区 域 。 所 
以 有 必要 给 到 服务 器 的 每 个 请 求 设置 区 域 性 。 

如 何 知道 用 户 的 区 域 性 呢 ? 这 有 不 同 的 选项 。 浏 览 器 在 每 个 请 求 的 HITP 标题 中 发 送 首选 语言 。 浏 览 器 中 
的 这 个 信息 可 以 来 自 浏览 器 设置 ， 或 浏览 器 本 身 会 检查 安装 的 语言 。 男 一 个 选项 是 定义 URL 参数 ， 或 为 不 同 
的 语言 使 用 不 同 的 域名 。 可 以 在 一 些 场景 中 使 用 不 同 的 域名 , 例如 为 网 站 www. cninnovation.com 使 用 英文 版 本 ， 
为 www.cninnovation.de 使 用 德语 版 本 。 但 是 www.cninnovation.ch 呢 ?应 该 提供 德语 、 法 语 和 意大利 语 版 本 。 这 
里 ，URL 参数 ， 如 www.cninnovation.com/culture=de， 会 有 所 帮助 。 使 用 www.cninnovation.comyde 的 工作 方式 
类 似 于 定义 特定 路 由 的 URL 参数 。 另 一 个 选择 是 允许 用 户 选 择 语言 ， 定 义 一 个 cookie， 来 记 住 这 个 选项 。 

ASPNET Core 支持 所 有 这 些 场景 。 


27.4.1 注册 本 地 化 服务 


为 了 开始 注册 操作 ， 使 用 Empty ASPNET Core 项 目 模板 创建 一 个 新 的 ASPNET Core Web 应 用 程序 。 本 项 
目 利 用 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Microsott.AspNetCore.All 
名 称 空间 
Microsott.AspNetCore 
Microsott.AspNetCore.Builder 
Microsott. AspNetCore.Hosting 
Microsott.AspNetCore.Http 
Microsott.AspNetCore.Localization 
Microsott.Extensions.DependencyInjection 
Microsott.Extenslons.Localization 
System 
System.Globalization 
System.Text.Encodings.Web 
在 Startup 类 中 ， 需 要 调用 AddLocalization 扩展 方法 来 注册 本 地 化 的 服务 (代码 文件 WebAppli 
cationSample/Startup.cs): 
public void Configureservices (IServiceCollection services) 
services.AddLocalization (options => options.ResourcesPath = 


"CuStomResources™).; 


} 
AddLocalization 方法 为 接口 IStringLocalizerFactory 和 IStringLocalizer 注册 服务 。 在 注册 代码 中 ， 类 型 
ResourceManagerStringLocalizerFactory 注册 为 singleton ， StringLocalizer 注册 短暂 的 生存 期 。 类 
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ResourceManagerStrineLocalizerFactory 是 ResourceManagerStringLocalizer 的 一 个 工厂 。 这 个 类 利用 前 面 的 
ResourceManager 类 ， 从 资源 文件 中 检索 字符 串 。 


27.4.2 注入 本 地 化 服务 


将 本 地 化 添加 到 服务 集合 后 ， 就 可 以 在 Startup 类 的 Configure 方法 中 请 求 本 地 化 。UseRequestLocalization 
方法 定义 了 一 个 重 载 版 本 ， 在 其 中 可 以 传递 RequestLocalizationOptions。RequestLocalizationOptions 允许 定制 应 
该 支持 的 区 域 性 并 设置 默认 的 区 域 性 。 这 里 ，DefaultRequestCulture 被 设置 为 en-us。 类 RequestCulture 只 是 一 
个 小 包装 ， 其 中 包含 了 用 于 格式 化 的 区 域 性 ( 它 可 以 通过 Culture 属性 来 访问 ) 和 使 用 资源 的 区 域 性 (UICulture 属 
性 )。 示 例 代 码 给 SupportedCultures 和 SupportedUICultures 接受 en-US、en.de-AT 和 de 区 域 性 (代码 文件 
WebApplicationSample/Startup.cs): 


Public void Configure (IApplicationBuilder app, IHostingEnvironment em， 
IStringLocalizer<Startup> sr) 


{ 
| 
Var supportedcultures = newl] 
new CultureInfo("en—US™"), 
new CultureInfo("en™). 
new CultureInfo("de-AT™")., 
new CultureInfo("de"™) 


bs 


Var options = new RequestLocalizationOptions 

{ 

DefaultRequestculture = new ReaquestcCculture (new CultureInfo("en—USs"))})., 
SupportedCcultures = supportedCultures, 

SupportedUICUultuyures = supportedCcultures 

} 7 


app.UseRequestLocalization (optIons) :， 
下 
有 了 RequestLocalizationOptions 设置 , 也 设置 属性 RequestCultureProviders。 默认 情况 下 配置 3 个 提供 程序 : 
QueryStringRequestCultureProvider、CookieRequestCultureProvider 和 AcceptLanguage HeaderRequestCultureProvider。 


27.4.3 ”区域 性 提供 程序 


下 面 详 细 讨 论 这 些 区 域 性 提供 程序 。QueryStringRequestCultureProvider 使 用 查询 字符 串 检 索 区 域 性 。 默 认 
情况 下 ， 查 询 参 数 culture 和 ui-culture 用 于 这 个 区 域 性 提供 程序 ， 如 下 面 的 URL 所 示 : 


http://localhost: 5000/2culture=deg&ui—culture=en—US 
http://localhost:5000/?culture=de&ui-culture=en-—Us 


还 可 以 通过 设置 QueryStringRequestCultureProvider 的 QueryStringKey 和 UIQueryStringKey 属性 来 更 改 查 询 

CookieRequestCultureProvider 定义 了 名 为 ASPNET CULTURE 的 cookie (可 以 使 用 CookieName 属性 设置 )。 
检索 这 个 cookie 的 值 ， 来 设置 区 域 性 。 为 了 创建 一 个 cookie， 并 将 其 发 送 到 客户 端 ， 可 以 使 用 静态 方法 
MakeCookieValue， 从 RequestCulture 中 创建 一 个 cookie， 并 将 其 发 送 到 客户 辣 。CookieRequestCultureProvider 
使 用 静态 方法 ParseCookieValue 获得 RequestCulture。 

设置 区 域 性 的 第 三 个 选项 是 ， 可 以 使 用 浏览 器 发 送 的 HTTP 标题 信息 。 发 送 的 HTTP 标题 如 下 所 示 : 

Accept-Language: en-us, de-at;q=0.8, it;q=0.7 

AcceptLanguageHeaderRequestCultureProvider 使 用 这 些 信息 来 设置 区 域 性 。 使 用 至 多 三 个 语言 值 ， 其 顺序 
由 quality 值 定义 ， 找 到 与 文 持 的 区 域 性 匹配 的 第 一 个 值 。 

下 面 的 代码 片段 现在 使 用 请 求 的 区 域 性 生成 HITML 输出 。 盲 先 ,使 用 耻 equestCultureFeature 协 定 访问 请 求 的 
区 域 性 。 实 现 接 口 了 下 equestCultureFeature 的 RequestCultureFeature 使 用 匹配 区 域 性 设置 的 第 一 个 区 域 性 提供 程序 。 
如 果 URIL 定 义 了 一 个 匹配 区 域 性 参数 的 碍 询 字 符 串 ， 就 使 用 QueryStringRequestCultureProvider 返 回 所 请 求 的 区 


第 27 章 本 地 化 | 669 


域 性 。 如 果 URIL 不 匹配 ， 但 收 到 名 为 ASPNET CULTURE 的 cookie， 就 使 用 CookieRequestCultureProvider， 否 


则 使 用 AcceptLanguageRequestCultureProvider。 使 用 返回 的 RequestCulture 的 属性 ， 把 由 此 产生 的 、 用 户 使 用 的 
区 域 性 写 入 响应 流 。 接着, 使 用 当前 的 区 域 性 把 当前 的 日 期 写 入 流 。 这 里 使 用 的 IStringLocalizer 类 型 的 变量 需要 
一 些 更 多 的 检查 ， 如 下 所 示 ( 代 码 文件 WebApplicationSample/Startup.cs): 


Public void Confijgure (IApplicationBuilder app, IHostingEnvironment enyv, 
IStringLocalizer<Startup> sr) 
{ 
FF -=- 
app.Run (async context 三 > 
{ 
IRecuestCultureFeature requestCultureFeature = 
context .Features .Get<IRequestCultureFeature>(); 
RequestCulture regquestCulture = requestCultureFeature.RequestCulture; 
Var today = DateTime.Today; 
await context.Response.WriteAsync ("<hl>Sample Localization</h1l>"); 
awalt context.Response.WriteAsync! 
s"<div>{requestCulture.culture} {requestcCulture.UICulture}</div>"); 
await context.Response.WriteAsync ($"<div>{today:D}</div>"); 


/i/... 
})5; 
} 


27.4.4 在 ASP.NET Core 中 使 用 资源 


资源 文件 可 以 用 于 ASPNET Core。 样 例 项 目 添加 了 CustomResources 文件 夹 并 在 其 中 添加 了 文件 
Startup.resx。 资源 的 本 地 化 版 本 用 Startup.de.resx 和 Startup.de-AT.resx 提供 。 
在 注入 本 地 化 服务 时 ， 存 储 资 源 的 文件 夹 名 称 用 选项 定义 (代码 文件 WebApplicationSample/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 
{ 
services.AddLocalizationt 
options => options.ResourcesPath = "CustomResources").,; 


} 


在 依赖 注入 中 ，IStringLocalizer <Startup> 注 入 为 Configure 方法 的 一 个 参数 。 使 用 泛 型 类 型 的 Startup 参数 ， 
在 resources 目录 中 找到 一 个 具有 相同 名 称 的 资源 文件 ， 它 匹配 Startup.resx。 


Public Vvold Configure (IApplicationBuilder app, IHostingEnvironment env, 
IStringLocalizer<Startup> sr) 

{ 
/7 --- 

} 


注意 : 
依赖 注入 参见 第 20 章 。 


下 面 的 代码 片段 利用 IStringLocalizer<Startup> 类 型 的 变量 sr， 通 过 一 个 索引 器 和 GetString 方法 访问 资源 
messagel。 资 源 message2 使 用 字符 串 格 式 占 位 待 ， 它 用 GetString 方法 的 一 个 重 载 版 本 注入 ， 其 中 可 以 传递 任 
何 数 量 的 参数 : 


Public void Configure (IApplicationBuilder app, IHostingEnvironment enyv, 
IStringLocalizer<Startup> sr) 

{ 
fp 


app .Run (asYnc Context =2> 


/i-.-- 

awalit context.Response.WriteAsync! 
s"<div>{HtmlEncoder .Default .Encode (sr["messagel"™])}</div>").; 

await context.Response.WriteAsync'l 
s"<div>{HtmlEncoder.Default.Encode (sr.GetString ("messagel"™)})</div>").; 

awalt ConteXt -Response -WIIteasYnc 
s"<div>{HtmlEncoder.Default.Encode (sr.GetString("message2", 

requestCulture.Culture, requestCulture.UICulture)) }</div>"); 
1)5; 
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注意 : 
在 示例 代码 中 ，HtmlEncoder 用 于 修改 资源 的 输出 ， 之 后 把 它 传 递 给 HttpResponse 的 WriteAsync 方法 。 通 
ee 资源 值 会 转换 为 HIML 格式 ， 正 确 显示 特殊 的 字符 ， 例 如 德语 中 的 站 和 8。 进 行 HIML 编码 


后 ， 字符 会 转换 为 HTML 格式 &#xFC; 和 &#xDF;。 

messagel 的 资源 是 一 个 简单 的 字符 串 ; message2 的 资源 用 字符 串 格式 占 位 符 定义 : 

Using culture {0} and UI culture {1} 

注意 : 

在 资源 中 使 用 格式 化 的 字符 囊 ， 就 不 能 使 用 带 插值 字符 串 的 新 语法 。 占 位 符 中 与 插值 字符 囊 一 起 使 用 的 变 
量 或 表达 式 不 能 用 于 资源 。 

运行 Web 应 用 程序 ， 得 到 的 视图 如 图 27-7 所 示 。 

里 localhost x | 二 


() 有 | 0) localhost:59601/ 


Sample Localization 


en-US en-US 

Saturday, September 30, 2017 

Greeting all readers of Professional C# 
Greeting all readers of Professional C# 
Using culmre en-US and Ulcultre en-US 


27-7 


给 URL 请 求 添加 ?culture=de-AT( 它 使 用 了 QueryStrineRequestCultureProvider)， 输 出 就 如 图 27-8 所 示 。 传 
递 URL 请 求 不 支持 的 区 域 性 ， 输 出 就 使 用 默认 的 区 域 性 。 
OH localhost | 十 
一 C) I (lecalhost58601 
Sample Localization 


de-AT de-AT 


Samstag. 30. September 2017 

Osterreichische Griifle an alle Leser von Professional C# 
Osterreichische CriBe an alle Leser von Professional Cs 
Verwende Culture de-AT und UI Culture de-AT 


图 27-8 


27.4.5 ”使 用 控制 妖 和 视图 进行 本 地 化 


使 用 ASPNET Core MVC， 有 对 本 地 化 的 特殊 支持 。 可 以 为 控制 器 和 视图 创建 特定 的 资源 文件 ， 可 以 同 用 
于 从 资源 中 检索 值 的 模型 数据 添加 注释 。 
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注意 : 
ASPNET Core MVC 详 见 第 31 章 。 注 释 详 见 第 16 章 。 


本 节 使 用 的 ASPNET Core Web 应 用 程序 ASPNETCoreMVCSample 基于 Web Application (Model View 

Controller) 模 板 ， 使 用 以 下 依赖 项 和 名 称 空间 : 

依赖 项 

Microsotft.AspNetCore.All 

名 称 空间 

Microsott.AspNetCore 

Microsott.AspNetCore.Builder 

Microsott.AspNetCore.Hosting 

Microsott.AspNetCore.Localization 

Microsott.AspNetCore.Myvc.Localization 

Microsott. AspNetCore.Mvc.Razor 

Microsott.Extensions.Confieuration 

Microsott.Extensions.DependencyInjection 

Microsott.Extensions.Localization 

System 

System.ComponentModel 

System.Diaenostics 

System.Globalization 

下 面 从 创建 资源 开始 。 资 源 现在 存储 在 Resources 文件 夹 中 。 使 用 AddLocalization 辅助 方法 的 选项 指定 文 

件 夹 名 (代码 文件 ASPNETCoreMVCSample/Startup.cs): 


Public void ConfijgureServices (IServiceCollection services) 

{ 
SeErvices.AddLocalization (options => options.ResourcesPath = "Resources"™); 
FF -。 

} 


可 以 将 控制 器 、 视 图 和 模型 的 资源 放 在 子 文 件 夹 中 ， 也 可 以 使 用 文件 名 的 点 表示 法 。 例 如 ， 可 以 将 
HomeController 的 资源 放 入 子 目 录 Resources\Controllers 一 一 例如 ,使 用 默认 语言 的 资源 文件 HomeControllerresx， 
以 及 特定 于 语言 的 资源 文件 (如 HomeController.de.resx)。 不 使 用 目录 结构 , 而 可 以 使 用 文件 名 的 点 表示 法 。 这 里 ， 
将 资源 文件 直接 存储 在 Resources 文件 夹 中 。 使 用 这 个 约定 ，HomeController 的 资源 文件 需要 命名 为 
Controllers.HomeControllerTesX。 

对 于 从 HomeController 中 激活 的 Hello 视图 ,可 以 对 资源 文件 Hello.resx 使 用 目录 表示 法 , 将 其 放 入 目录 结 
构 Resources/Views/Home。 使 用 点 表示 法 ， 资 源 文件 Views.Home.Hello.resx 需要 保存 在 文件 夹 Resources 中 。 

使 用 的 资源 文件 版 本 由 AddViewLocalization 方法 指定 ，AddViewLocalization 方法 是 IMvcBuilder 接 
口 的 扩展 方法 。 实 现 此 接口 的 对 象 从 AddMvc 方法 返回 ， 此 可 以 使 用 流利 API 语法 调用 
AddViewLocalization。 传 递 选项 LanguageViewLocationExpanderFormat. SubFolder 时 ， 它 指定 使 用 子 文件 
夹 资源 。 男 一 个 选项 是 LaneuageViewLocationExpanderFormat.Suffix。 在 下 面 的 代码 片段 中 ， 还 调用 扩展 方法 
AddDataAnnotationsLocalization 来 局 用 数据 注释 的 本 地 化 (代码 文件 ASPNETCoreMVCSample/Startup.cs): 

public void configqureservices(IServiceCcollection services) 

services.AddLocalization (options => options.ResourcesPath = "Resources"); 

services .AddMvc () 
.AddViewLocalization (LanguageViewLocationExpanderFormat .SubFolder) 


.ALAddDataAnnotationsLocalization().:; 
} 


使 用 HomeController， 可 以 注入 IStringLocalizer， 就 像 在 WebSampleApp 示例 的 Configure 方法 中 也 注入 了 
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IStringLocalizer。 在 下 面 的 代码 片段 中 ， 将 IStringLocalizer<homecontroller> 注 入 HomeController 的 构造 函数 中 ， 
并 与 Hello 操作 方法 一 起 使 用 (代码 文件 ASPNETCoreMVCSample/Controllers/HomeController.cs): 


private readonly ISstringLocalizer<HomeController> localizer; 
public HomeController (IStringLocalizer<HomeController> localizer) 
{ 

localizer = localizer; 


} 


public IActionResult Hello{() 

{ 
ViewBag.Messagel = localizer.GetString("Messagel"); 
return View{(); 


} 
在 视图 中 ， 直 接 访 问 从 控制 器 传递 的 Messagel( 代 码 文 件 ASPNETCoreMVCSample/Views/Home/Hello. 
cshtml): 


<h3>@ViewBag .Messagel</h3> 

要 在 视图 的 资源 中 直接 访问 资源 ， 可 以 使 用 @inject 声明 注入 IViewLocalizer。 这 里 定义 了 一 个 本 地 变量 
Localizer， 然 后 用 于 访问 名 为 Message2 的 资源 ， 资 源 只 需要 保存 在 资源 文件 Resources/Views/Home/Hello.resx 
中 (代码 文件 ASPNETCoreMVCSample/Views/Home/Hello.cshtml): 

Qusing Microsoft.AspNetCore.Mvc.Localization 

einject IViewLocalizer Localizer 

@1{ 

ViewData["Title"] = "Hello"; 

<h2>Hello</h2> 

<h3>@ViewBag .Messagel</h3> 


<h3>8Localizer["Message2"]</h3> 


运行 应 用 程序 ， 并 访问 链接 /Home/Hello， 从 控制 器 和 视图 中 获取 资源 ， 如 图 27-9 所 示 。 


右 | | Hello - ASPNETCoreMw X | 十 吧 二 口 x 
二 及 () 个 7) localhost 丰 站 车 | 


Hello 


Message from the Home Controller 


Message from the View 


SS 2017 - ASPNETCoreMVC Sample 


图 27-9 


男 一 种 使 用 ASPNET Core MVC 检索 资源 值 的 方法 是 通过 应 用 注解 实现 的 。 要 查看 操作 中 的 注释 ， 可 以 在 
Models 目录 中 定义 Book 类 型 。 这 种 类 型 把 DisplayName 特性 添加 到 属性 Booktitle 和 Publisher 中 (代码 文件 
ASPNETCoreMVCSample/Models/Book.cs): 


public class Book 
{ 
[DisplayName ("Booktitle")] 
public string Booktitle { get; set; } 
[DisplayName ("Publisher™)] 
Public string Publisher { get; sets; } 


第 27 章 本 地 化 | 673 


注意 : 
不 要 忘记 通过 调用 Startup 类 中 的 方法 AddDataAnnotationsLocalization 来 启用 注释 的 本 地 化 。 


资源 文件 Bookresx 现在 添加 到 目录 Resources/Models 中 (资源 文件 ASPNETCoreMVCSample 
/Resources/Models/Book.resx): 


中 

<data name="Publisher™" xml:space="preserve"> 
<value>Publisher</value> 

</data> 

<data name="Booktitle"™" xml:space="preserve"> 
<value>Title</value> 


</data> 

le 

还 添加 了 German 语言 表示 (资源 文件 ASPNETCoreMVCSample/Resources/Models/Book.de.resx): 
ss 


<data name="Publisher™. xml :space="preserve"> 
<value>Verlag</value> 

</data> 

<data name="Booktitle"™" xml:space="preserve"> 
<value>Titel</value> 

</data> 

le 


HomeController 中 的 Book 操作 方法 将 Book 模型 传递 给 视图 (代码 文件 ASPNETCoreMVCSample/Controllers/ 
HomeController.cs): 


Public IActionResult Book() 
{ 
var b = new Book 
{ 
Booktitle = "Professijonal C# 7 and .NET Core 2"™, 
Publisher = "Wrox Press" 
bs 
return View(b}).: 


} 
要 显示 图 书 ， 使 用 HIML Helper 方法 EditorForModel 来 显示 带 有 输入 字段 的 模型 的 所 有 属性 (代码 文件 
ASPNETCoreMVCSample/Views/Home/Book.cshtml): 
@{ 
ViewDatal[l"Title"] = "BOOK" ， 
} 


<h2>Book</h2> 


GHtal EditorForiiodel() 
图 27-10 显示 正在 运行 的 应 用 程序 用 German 区 域 性 访问 Home/Book。 


避 三 | | The Book-AspNETCor X | 十 w 


三 C) 位 (1) localhost 


Professional C# 7 and .N 
Verlag 


Wrox Press | 


B2017 - ASPNETCoreMVvCSample 


图 27-10 


674 | 第 中部 分 .NET Core 与 Windows Runtime 


注意 : 
控制 器 、 视 图 和 HTML Helper 详 见 第 31 章 。 


27.5 本 地 化 UWP 


用 Universal Windows Platform (UWP) 进 行 本 地 化 基于 前 面 学 习 的 概念 ， 但 带 来 了 一 些 新 理念 ， 如 下 所 述 。 
为 了 获得 最 佳 的 体验 ， 需 要 通过 Visual Studio Extensions and Updates 安装 Multilingual App Toolkit。 

区 域 性 、 区 域 和 资源 的 概念 是 相同 的 ， 但 因为 Windows 应 用 程序 可 以 用 C# 和 XAML、C++ 和 XAML、 
JavaScript 和 HIML 来 编写 ， 所 以 这 些 概念 必须 可 用 于 所 有 的 语言 。 只 有 Windows Runtime 能 用 于 所 有 这 些 编 
程 语 言 和 UWP 应 用 程序 。 因 此 ， 用 于 全 球 化 和 资源 的 新 名 称 空间 可 通过 Windows Runtime 来 使 用 : 
Windows.Globalization 和 Windows.AppalicationModel.Resources 。 在 全 球 化 名 称 空 间 中 包含 Calendar 、 
GeographicRegion( 对 应 于 .NET 的 RegionInfo) 和 Language 类 。 在 其 子 名 称 空 间 中 ， 还 有 一 些 数字 和 日 期 格式 化 
类 随 大 语言 的 不 同 而 改变 。 在 C# 和 Windows 应 用 程序 中 ， 仍 可 以 使 用 NET 类 表示 区 域 性 和 区 域 。 

下 面 举 一 个 例子 ， 说 明 如 何 用 Universal Windows 应 用 程序 进行 本 地 化 。 使 用 Blank App (Universal 
Windows)Visual Studio 项 目 模板 创建 一 个 小 应 用 程序 。 在 页 面 上 添加 两 个 TextBlock 控件 和 一 个 TextBox 控件 。 

在 代码 文件 的 OnNavigatedTo0 方 法 中 ， 可 以 把 具有 当前 格式 的 日 期 赋予 textl 控件 的 Text 属性 。DateTime 
结构 可 以 用 非常 类 似 于 本 章 前 面 控制 台 应 用 程序 的 方式 使 用 (代码 文件 UWPLocalization/MainPage.xaml.cs): 

protected override void OnNavigatedTo (NavigationEventArgs e) 

base.OnNavigatedTo (e) ; 
textl.Text = DateTjime .Today.Tostring("D") ; 


} 


27.5.1 给 UWP 使 用 资源 


在 UWP 中 ,可 以 用 文件 扩展 名 resw 蔡 代 resx, 以 创建 资源 文件 。 FE a 
在 后 台 ，resw 文件 使 用 相同 的 XML 格式 ， 可 以 使 用 相同 的 Visual 。 | ot 
studio 资源 编辑 器 创建 和 修改 这 些 文件 。 下 例 使 用 如 图 27-11 所 示 EEC 
的 结构 。 子 文件 夹 Message 包含 一 个 子 目 录 en-us, 在 其 中 创建 了 两 ed 


个 资源 文件 Errors.resw 和 Messages.resw。 在 Strines\en-us 文件 夹 中 ， 0 

创建 了 资源 文件 Resources.resw。 He 
Messages.resw 文件 包含 一 些 英 语文 本 资源 ，Hello 的 值 是 Hello be sine 

World， 资 源 的 名 称 是 GoodDay、GoodEvening 和 GoodMorning。 文 SRR Loren 

件 Resources.resw 包含 资源 Text3.Text 和 Text3.Width， 其 值 分 别 是 es 

“ This is a sample message for Text4 和 300。 nr 

在 代码 中 ， 使 用 Windows.AppalicationModel.Resources 名 称 空 

间 中 的 ResourcesLoader 类 可 以 访问 资源 。 这 里 使 用 字符 捉 Dr 


“Messages” 作 为 GetForCurrentView 方法 的 参数 。 因 此 ， 要 使 用 资源 文件 Messages.resw。 调 用 GetString 方法 ， 
会 检索 键 为 “Hello” 的 资源 (代码 文件 UWPLocalization/MainPage.xaml.cs)。 


protected override void OnNavigatedTo (NavigationEventArgs e) 

{ 
7 
Var resourceLoader = ReSDUITCeLoOaadeIT .GetEoOICUITITentLtVIeW( "MessagesS") : 
text2.Text = TSOUTCeLoadeTrT .GetString("Hel1o") ，; 


} 
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在 UWP Windows 应 用 程序 中 ， 也 可 以 直接 在 XAML 代码 中 使 用 资源 。 对 于 下 面 的 TextBox， 给 x:Uid 特 
性 赋予 值 Text3 。 这 样 ,就 会 在 资源 文件 Resources.resw 中 搜索 名 为 Text3 的 资源 ,这 个 资源 文件 包含 键 Text3.Text 
和 Text3.Width 的 值 。 检 索 这 些 值 ， 并 设置 Text 和 Width 属性 (代码 文件 UWPLocalization/MainPage.xaml): 


<TextBox Xx:Uid="FileName Text3" HorizontalAlignment="Left" Margin="40" 
TextWrapping="Wrap" Text="TextBox"™" VerticalAlignment="Top"/> 


在 这 个 阶段 运行 应 用 程序 ， 可 以 看 到 资源 文件 中 的 英语 文本 ， 如 图 27-12 所 示 。 


saturday, September 30, 2017 


Hello, World 


Irhis is a sample message for Text 4 


27-12 


27.5.2 ”使 用 多 语言 应 用 程序 工具 集 进 行 本 地 化 


为 了 本 地 化 UWP 应 用 程序 ， 可 以 下 载 Multilingual App Toolkit。 这 个 工具 包 和 集成 在 Visual Studio 2017 中 。 
安装 了 该 工具 包 后 ,就 可 以 通过 Tools | Multilingual App Toolkit | Enable Selection 菜单 ,为 UWP 应 用 程序 启用 它 。 
这 会 在 项 目 文件 中 添加 一 个 生成 命令 ， 在 Solution Explorer 的 上 下 文 菜单 中 添加 一 个 菜单 项 。 打 开 该 上 下 文 菜 
单 ， 选 择 Multilingual App Toolkit | Add Translation Laneuages， 打 开 如 图 27-13 所 示 的 对 话 框 ， 在 其 中 可 以 选择 
要 翻译 为 哪 种 语言 。 该 示例 选择 Pseudo Laneuage、French、German 和 Spanish。 对 于 这 些 语言 , 可 以 使 用 Microsoft 
Translator。 这 个 工具 现在 创建 一 个 MultilineualResources 子 目 录 ， 其 中 包含 所 选 语言 的 .xlf 文件 。.xlf 文件 用 
XLIFF(XML Localization Interchange File Format, XML 本 地 化 数据 交换 格式 ) 标 准 定义 , 这 是 Open Architecture for 
XML Authoring and Localization(OAXAL) 参 考 架 构 的 一 个 标准 。 


注意 : 
Multilineual App Toolkit 也 可 以 在 http://aka.ms/ matinstallv4 上 安装 , 不 需要 使 用 Visual Studio, 下 载 Multilineual 
App Toolkit, 


下 次 启动 项 目的 生成 过 程 时 ，XLIFF 文件 就 会 从 所 有 资源 中 填充 相应 的 内 容 。 在 Solution Explorer 中 选择 
XLIFF 文件 , 就 可 以 把 它们 直接 发 送 给 翻译 过 程 。 为 此 ,在 Solution Explorer 中 打开 上 下 文 华 单 , 选择 .xf 文件， 
选择 Multilingual App Toolkit | Export Translations， 打 开 如 图 27-14 所 示 的 对 话 框 ， 在 其 中 可 以 配置 应 发 送 的 信 
恩 ， 也 可 以 发 送 电 子 邮件 ， 添 加 XLIFF 文件 作为 附件 。 
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Translation Languages 


Available Languages 


本 | Pseudo Language (Pseudo) [gps-ploc] (sactive) GE 


Export string resources 


Output 


®) Mail recipient 
DO File folder location 


Path: 
Format 


Export as: | XLIFF 2.0 (ea 人 


Translated 
Final 


New 
Needs review 


b [| Afar [aal 

F 器] Afrikaans [af 全 
[Aghem lagq] 

P [| Akan [ak 

5 [L Albanian [sql 9 
hb [Alsatian [gswl 

b DD Amharic [am] 生 
b 口 Arabic [arl 人 


;DArmenian [hy 号 
DO 
i 


Inelude: 


Excluded non-Translatable resources 
Total resources included after applhy filters: 24 


“| Use compressed (zipped) tolder 


Name: UWPLocalization- 2017 09 30zip 


Included files 
UWPLocalization.de.xlf 
UWPLocalization.es.xlf 
UWpLocalization fr.xlf 


bt [| | Assamese |as] 
P DD Asturian [ast] 
:LL] Asu [asal 

bp [OD Azerbaijani (Cyrillic) [az-Cyr] 
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UWPLocalization.qps-plocxlf 


Multilingual App Toolkit Feedback 7 


图 27-13 27-14 


对 于 翻译 ， 还 可 以 使 用 微软 的 翻译 服务 。 在 Visual Studio Solution Explorer 中 选择 .xlf 文件 ， 打 开 上 下 文 菜 
单 后 ， 选 择 Multilineual App Toolkit | Generate Machine Translations。 为 了 使 这 个 操作 可 用 于 本 书 撰写 时 的 版 本 ， 
需要 创建 一 个 Microsoft Azure 账户 ， 添 加 Translator Speech API of Microsoft Coegnitive Services。 这 个 服务 
Multilingual App Toolkit 的 翻译 服务 使 用 。 还 有 人 免费 的 服务 ， 允 许 每 个 月 翻译 2 000 000 个 字符 。 

打开 .xlf 文件 时 ， 会 打开 Multilingual Editor (参见 图 27-15)。 有 了 这 个 工具 ， 就 可 以 验证 自动 翻译 ， 并 进行 
必要 的 修改 。 


Filter 
一 ET Translation 
Piasle 


Resource ID 


a3 到 


Translate Sugqgest 


要 :Reset 


a 
午 | Ieai 


站 品 


Open 。 Save 


”| 会 二 


Previous Next 
row TO 
LIFT lipboard Mavication ramslation Aark Seach 


地 


HelP 


日 村 


en 
we 


State 
Filter 


Good Morning Resource ID: | GoodMoming 


state: | 局 Needs Review 

Translatable: Tes 
Cormiments: 

| Guten Morgen | 


<<ilick to add a comment> > 


声 
时 
EF 
| 
Bri 
在 
加 
[于 


Translation i; 


Guten Abend 


Source 


Good Eveaning GoodEvening [Orginal 
file LWPLOCALLZATION) 
MESSAGES/EN- LS 
IMIESSAGES,RESW] 
Goodhoming [OQriginal 
tileLMWWPLOCALIZATION) 
MESSAGES/EN-US/ 
MESSAGES.RESW] 

Halls [Qriginal 
fileWPLOCALIZATIONY 


Good Morning 可 Guten Morgen 


Hello World Haella World 


Messages Suggestions 国 


| strings 
ltern & of 7 | English tfUnited States) [em-US] to German [del 


| New: 0 | Needs Review 7 | Translated: 0 | Finak: 0 | SI)—— 0 —— Wo% 
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注意 : 
没有 人 工 检 查 ， 就 不 要 使 用 机 器 翻译 。 该 工具 会 为 每 个 已 翻译 的 资源 显示 状态 。 自 动 翻译 完成 后 ， 状 态 设 
置 为 Needs Review。 自 动 翻译 的 结果 可 能 不 正确 ， 有 时 还 很 可 和英 . 


27.6 小结 


本 章 讨论 了 .NET 应 用 程序 的 全 球 化 和 本 地 化 。 对 于 应 用 程序 的 全 球 化 ， 我 们 讨论 了 System.Globalization 名 
称 空间 ， 它 用 于 格式 化 依赖 于 区 域 性 的 数字 和 日 期 。 此 外 ， 说 明了 在 默认 情况 下 ， 字 符 串 的 排序 取决 于 区 域 性 。 
我 们 使 用 不 变 的 区 域 性 进行 独立 于 区 域 性 的 排序 。 

应 用 程序 的 本 地 化 使 用 资源 来 实现 。 资 源 可 以 放 在 文件 或 附属 程序 集中 。 本 地 化 所 使 用 的 类 位 于 
System.Resources 名 称 空间 中 。 

我 们 还 学 习 了 如 何 本 地 化 ASPNET Core 应 用 程序 , 给 ASPNET Core MVC 使 用 特殊 的 功能 以 及 使 用 UWP 
的 本 地 化 应 用 程序 。 

下 一 章 介 绍 测试 ， 学 习 如 何 创 建 单元 测试 ， 以 及 用 于 Windows 和 Web 应 用 程序 的 UI 测试 。 


第 
测 试 


本 章 要 点 

se 使 用 MSTest 和 xUnit 的 单元 测试 

e 使 用 xUnit 和 .NET Core 的 单元 测试 
e@ 使 用 EF Core 的 单元 测试 

es 编码 的 UI 测试 

es Web 测试 


本 章 源 代 码 下 载 : 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 tests 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 如 下 主要 示例 : 
® Unlt Testmg Sample 
Mockine Sample 
EF Core Sample 
Windows App Sample 
ASPNETCore Integratlon Test Sample 
Web Application Load Test Sample 


单元 测试 可 用 于 Visual Studio 的 所 有 版 本 ， 其 他 所 有 的 测试 功能 ， 例 如 实时 单元 测试 、Web 负载 和 性 能 测 
试 、 编 码 的 UI 测试 、 测 试 履 益 、IMicrosoft Fakes 和 IntelliTest 都 需要 Visual Studio 2017 企业 版 。 


28.1 概述 


应 用 程序 开发 正在 变 得 敏捷 。 使 用 瀑布 过 程 模型 来 分 析 需 求 时 ， 设 计 应 用 程序 架构 ， 实 现 它 ， 两 三 年 后 发 
现 所 建立 的 应 用 程序 没有 满足 用 户 的 需求 ， 这 种 情形 并 不 少见 。 相 反 ， 软 件 开发 变 得 敏捷 ， 发 布 周 期 更 短 ， 最 
终 用 户 在 开发 早期 就 参与 进来 。 看 看 Windows 10: 数 以 百 万 计 的 Windows 内 部 人 士 给 早期 的 构建 版 本 提供 反 
局 ， 每 隔 几 个 月 甚至 几 周 就 更 新 一 次 。 在 Windows 10 的 Beta 程序 中 ，Windows 内 部 人 士 曾 经 在 一 周 内 收 到 
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Windows 10 的 3 个 构建 版 本 。Windows 10 是 一 个 巨大 的 程序 ， 但 微软 设法 在 很 大 程度 上 改变 开发 方式 。 同 样 ， 
如 果 参 与 NET Core 开源 项 目 ， 每 晚 都 会 收 到 NuGet 包 的 构建 版 本 。 如 果 袁 欢 冒 险 ， 甚 至 可 以 写 一 本 关于 未 来 
技术 的 书 。 

如 此 快速 和 持续 的 改变 一 一 每 晚 都 创建 构建 版 本 一 一 等 不 及 内 部 人 士 或 最 终 用 户 发 现 所 有 问题 。Windows 
10 每 隔 几 分 钟 就 月 省 一 次 ，Windows 10 内 部 人 士 就 不 会 满意 。 修 改 方法 的 实现 代码 的 频率 是 多 少 ， 才 能 发 现 
似乎 不 相关 的 代码 不 工作 了 ? 为 了 试图 避免 这 样 的 问题 ， 不 改变 方法 ， 而 是 创建 一 个 新 的 方法 ， 复 制 原来 的 代 
码 ， 并 进行 必要 的 修改 ， 但 这 将 极 难 维护 。 在 一 个 地 方 修 复方 法 后 ， 太 容易 在 记 修 改 其 他 方法 中 重复 的 代码 。 

为 了 避免 这 样 的 问题 ， 可 以 给 方法 创建 测试 程序 ， 使 测试 程序 自动 运行 ， 签 入 源 代码 或 在 每 晚 的 构建 过 程 
中 检查 。 从 一 开始 就 创建 测试 程序 ， 会 在 开始 时 增加 项 目的 成 本 ,但 随 着 项 目的 继续 进行 和 维护 期 间 ， 创 建 测 
试 程序 有 其 优点 ， 降 低 了 项 目的 整体 成 本 。 

本 章 解释 了 各 种 各 样 的 测试 ， 从 测试 小 功能 的 单元 测试 开始 。 这 些 测试 应 该 验证 应 用 程序 中 可 测试 的 最 小 
部 分 的 功能 ， 例 如 方法 。 传 入 不 同 的 输入 值 时 ， 单 元 测试 应 该 检查 方法 的 所 有 可 能 路 径 。 

MSTest 是 Visual Studio 用 于 创建 单元 测试 的 测试 框架 。 建 立 .NET Core 时 ，MSTest 不 支持 为 .NET Core 库 
和 应 用 程序 创建 测试 。 这 就 是 为 什么 微软 使 用 xUnit 为 NET Core 创建 单元 测试 的 原因 。 现 在 可 以 使 用 MSTest 
和 XUnit 为 .NET Core 创建 单元 测试 。 本 章 介绍 微软 的 测试 框架 MSTest 和 xUnit。 

使 用 Web 测试 ， 可 以 测试 Web 应 用 程序 ， 发 送 HITP 请 求 ， 模 拟 一 群 用 户 。 创 建 这 些 类 型 的 测试 ， 人 允许 
模拟 不 同 的 用 户 人 负载， 允许 进行 压力 测试 。 可 以 使 用 测试 控制 器 ， 来 创建 更 高 的 负载 ， 模 拟 成 干 上 万 的 用 户 ， 
从 而 也 知道 需要 什么 基础 设施 ， 应 用 程序 是 否 可 伸缩 。 

本 章 介 绍 的 最 后 一 个 测试 特性 是 UI 测 试 。 可 以 为 基于 XAML 的 应 用 程序 创建 自动 化 测试 。 当 然 ， 更 容易 
为 视图 模型 创建 单元 测试 ， 用 ASPNET Core 创建 视图 组 件 ， 但 本 章 不 可 能 涉及 测试 的 方方面面 。 可 以 自动 化 
UU 测试 ,想象 一 下 数 百 种 不 同 的 Android 移动 设备 。 你 会 购买 每 一 个 型 号 , 在 每 个 设备 上 手动 测试 应 用 程序 吗 ? 
最 好 使 用 云 服 务 ， 在 确实 要 安装 应 用 程序 的 、 数 以 百 计 的 设备 上 ， 发 送 要 测试 的 应 用 程序 。 不 要 以 为 人 们 会 在 
数 以 百 计 的 设备 上 局 动 云 中 的 应 用 程序 ， 并 与 应 用 程序 进行 可 能 的 交互 ， 这 需要 使 用 UI 测试 上 自动 完成 。 

首先 ， 创 建 单元 测试 。 


28.2 使 用 MSTest 进行 单元 测试 


编写 单元 测试 有 助 于 代码 维护 。 例 如 ， 在 更 新 代码 时 ， 想 要 确信 更 新 不 会 破坏 其 他 代码 。 创 建 自动 单元 测 
试 可 以 帮助 确保 修改 代码 后 ， 所 有 功能 得 以 保留 。Visual Studio 2017 提供 了 一 个 健壮 的 单元 测试 框架 ， 还 可 以 
在 Visual Studio 内 使 用 其 他 测试 框架 。 


28.2.1 使 用 MSTest 创建 单元 测试 


下 面 的 示例 测试 类 库 UnitTestingSamples 中 一 个 非常 简单 的 方法 。 这 是 一 个 .NET 标准 2.0 类 库 。 当 然 ， 可 
以 创建 其 他 基于 MSBuild 的 项 目 。 类 DeepThought 包含 TheAnswerToTheUltimateQuestionOfLifeTheUniverse- 
AndEverything 方法 ， 该 方法 返回 42 作为 结果 (代码 文件 UnitTestingSamples/DeepThought.cs): 

public class DeepThought 

ne int TheanswerOfTheUltimateouestionofLifeTheUniverseandEverythindg() => 

} 


为 了 确保 没有 人 改变 返回 错误 结果 的 方法 ， 创 建 一 个 单元 测试 。 要 创建 单元 测试 ， 可 以 使 用 dotnet 命令 : 

> dotnet new mstest 

也 可 以 使 用 Visual Studio 中 的 Unit Test Project (.NET Core) 项 目 模板 。 

开始 创建 党 一 个 测试 之 前 ,最 好 考虑 一 下 测试 和 测试 项 目的 命名 。 当 然 ， 可 以 使 用 任何 名 称 , 但 .NET Core 
团队 提供 了 较 好 的 命名 规则 ， 参 阅 : 
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https://github.com/aspnet/Home/wiki/Engineering-guidelines#unit-tests-and-functional-tests 

下 面 是 规则 汇总 : 

e 测试 项 目的 名 称 是 在 项 目 名 后 加 上 Tests， 例 如 ， 对 于 项 目 UnitTestingSamples， 测 试 项 目的 名 称 是 
UnltTIestmigSamples.Tests。 

e 测试 类 名 与 被 测试 的 类 名 相同 ， 后 跟 Test， 例 如 ，UnitTestingSamples.DeepThought 的 测试 类 是 
UnitTestneSamples.DeepThoughtTest。 

e 单元 测试 名 采用 描述 性 的 名 称 ， 例如， 名 称 AddOrUpdateBookAsync ThrowsForNull 表示 ,一 个 单元 测 
试 调用 AddOrUpdateBookAsync 方法 ， 检 查 传 递 null 时 它 是 否 抛 出 异常 。 

MSTest 项 目 包 含 对 NuGet 包 Microsoft.NET.Test.Sdk、MSTest.TestAdapter 和 MSTest.TestFramework 的 引用 

(项 目 文件 UnitTestingSamplesMSTests/UnitTestingSamples.MSTests.csproj): 
<Project Sdk="Microsoft.NET.Sdk"> 
<PropertyGroup> 

<TargetFramework>netcoreapp2.0</TargetFramework> 


<IsPackable>false</IsPackable> 
</PropertyGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.5.0" /> 
<PackageReference Include="MSTest.TestAdapter™ Version="1.2.0" /> 
<PackageReference Include="MSTest.TestFramework" Version="1.2.0" /> 
</ItemGroup> 


<ItemGroup> 
<ProjectReference Include="..\UnitTestingSamples\UnitTestingSamples.csproj" /> 
</ItemGroup> 


</Project> 

单元 测试 类 标 有 TestClass 特性 ， 测 试 方法 标 有 TestMethod 特性 。 该 实现 方式 创建 DeepThought 的 一 个 实 
例 ， 并 调用 要 测试 的 方法 TheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEverything 。 返 回 值 使 用 
Assert.AreEqual 与 42 进行 比较 。 如 果 Assert.AreEqual 失败 ， 测 试 就 失败 (代码 文件 UnitTestingSamples.MSTests/ 
DeepThouehtTests.cs): 


[TestcClass] 
public class TestProgram 
{ 
[TestMethodl] 
public void 
ResultofTheAnswerToTheUltimateQuestionofLifeTheUniverseAndEverything!() 
{ 
// arrange 
int expected = 42; 
Var dt = new DeepThought (}).; 


// act 


int actual = 
dt .TheAnswerToTheUltimateQuestionofLifeTheUniverseAndEverything(); 


// assert 
Assert.AreEdqual (expected, actual}s 
} 
} 


单元 测试 由 3 个 A 定义， Arrange、Act 和 Assert。 首 先 ， 一 切 都 安排 好 了 ， 单 元 测试 可 以 开始 了 。 在 安排 
阶段 , 在 第 一 个 测试 中 , 给 变量 expected 分 配 调用 要 测试 的 方法 时 预期 的 值 , 调用 DeepThought 类 的 一 个 实例 。 
现在 准备 好 测试 功能 了 。 在 行动 阶段 ， 调 用 方法 。 在 完成 行动 阶段 后 ， 需 要 验证 结果 是 否 与 预期 相同 。 这 在 断 
言 阶段 使 用 Assert 类 的 方法 来 完成 。 

Assert 类 是 Microsoft.VisualStudio.TestTools.UnitTesting 名 称 空间 中 MSTest 框架 的 一 部 分 。 这 个 类 提供 了 
一 些 可 用 于 单元 测试 的 静态 方法 。 默 认 情 况 下 ，Assert Fail 方法 添加 到 目 动 创建 的 单元 测试 中 ， 提 供 测 试 还 没 
有 实现 的 信息 。 其 他 一 些 方法 有 : AreNotEqual 验证 两 个 对 象 是 否 不 同 ，ISFalse 和 IsTrue 验证 布尔 结果 ; IsNull 
和 ISNotNull 验证 空 结果 ;IsInstanceOfType 和 IsNotInstanceOfType 验证 传 入 的 类 型 。 
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28.2.2 ”运行 单元 测试 
使 用 Test Explorer( 通 过 Test | Windows | Test Explorer 打开 )， 可 以 在 解决 方案 中 运行 测试 ( 见 图 28-1)。 


Run All | Run.., = | Playlist: Al Tests = 


A Passed Tests (1) ResultOfTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEv... Copy All 


© ResultDfTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEverything 14 ms 


source; Deeploughtilest.cs line 10 


© Test Passed - ResultOfTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEverythit 
Elapsed time: OOMO0.0144115 


图 28-1 


图 28-2 显示 了 一 个 失败 的 测试 ， 列 出 了 失败 的 所 有 细节 。 


全 [= 二 search 


EE 
Run All | Run.., = | Playlist: A Tests = 
a Failed Tests [1) ResultOfTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEv.., Copy All 


6 ResultOfTheAnswerToTheUlimateQuestionOfLifeTheUniverseAndEverything 48 ms Source: DespToughtTestes line 10 


全 Test Failed - ResultOfTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEveryt 和 
Message: hssert.AreEqual falled. Expected:<d2». Actual: <d1>. 
Elapsed time: 00000.0487618 


图 28-2 


要 在 命令 行 上 运行 测试 ， 可 以 调用 dotmet test: 


> dotnet test 


在 示例 应 用 程序 中 ， 会 得 到 成 功 的 结果 : 


Build started, please walit... 
Build completed. 


Test run for 
C:\procsharp\Tests\UnitTestingSamples\UnitTestingSamples .MSTests\bin\Debug\ 
netcoreapp2.0\UnitTestingSamples .MSsTests.dl1l (.NETCoreApp,Version=v2 .0) 
Microsoft (R) Test Execution Command Line Tool Version 15.5.0 

Copyright (c) Microsoft Corporation. All rights reserved. 


starting test execution, please wailt... 


Total tests: 1. Passed: 1. Failed: 0. Skipped: 0. 
Test Run SUuccessful. 
Test execution time: 1.23123 Seconds 


当然 ， 这 只 是 一 个 很 简单 的 场景 ， 测 试 通常 是 没有 这 么 简单 的 。 例 如 ， 方 法 可 以 抛 出 异 肖 ， 用 其 他 的 路 径 
返回 其 他 值 ， 或 者 使 用 了 不 应 该 在 单个 单元 中 测试 的 代码 (例如 数据 库 访问 代码 或 者 调用 的 服务 )。 接 下 来 介绍 
一 个 比较 复杂 的 单元 测试 场景 。 

下 面 的 类 StringSample 定义 了 一 个 带 字符 串 参 数 的 构造 函数 、 方 法 GetStringDemo 和 一 个 字段 。 方 法 
GetStringDemo 根据 first 和 second 参数 使 用 不 同 的 路 径 ， 并 返回 一 个 从 这 些 参数 得 到 的 字符 串 (代码 文件 
UnitTestineSamples /StrineSample.cs): 


public class StringSample 
{ 
Public StringSample (string init) 
{ 
if (init is null]l) 
throw new ArgumentNullException (nameof (init)); 


_ nlt = init; 


} 


private string jnits; 
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public string GetStrIngDemo (strlIng first, string second) 
{ 
if (first is null’ 
{ 
throw new ArgumentNullException (nameof (first)); 
} 
if (string.IsNulloOrEmpty (first))} 
{ 
throw new ArgumentException ("empty string is not allowed™", first); 
} 
if (second is null) 
{ 
throw new ArgumentNullException (nameof (secona) ) ; 
} 
if (second.Length > first.Length) 
{ 
throw new ArgumentoOutofRangeException (nameof (second), 
must be shorter than first"™); 
} 
int startIindex = first.Indexof (second).; 
if (startIndex < 0) 
{ 
return S$"{second} not found in {first}"™; 
} 
else if (startIindex < 5) 
{ 
string result = first.Remove (startIindex, second.Length); 
return S$"removed {second} from {first}: {result}™; 
} 
] Se 
{ 
return 1init.ToUpperIinvariant (}; 
} 
} 
} 


注意 : 

为 复杂 的 方法 编写 单元 测试 时 ， 有 时 单元 测试 也 会 变 得 复杂 起 来 。 这 有 助 于 调试 单元 测试 ， 找 出 当前 执行 
的 操作 。 调试 单元 测试 很 简单 : 给 单元 测试 代码 添加 断 点 ,并 从 Test Explorer 的 上 下 文 菜单 中 选择 Debug Selected 
Tests (参见 图 28-3)。 


全 | Search PP- 


Run All | Run.. = | Playlist : All Tests = 
a Passed Tests (1) ResultOfTheAnswerToTheUltimateQuestionOQfLifeTheUnmverseAndEy... copy 点 
Vv) ResultOfTheAnswerTol it 1 mms Fa Flammm Tsai Tanh en lam a di 
Run Selected Tests | 
Ss | teQuestionOQfLifeTheUniverseAndEverythi 
Debug | Tests 
和 te Test Case 


Analyze Code Coverage for Selected Tests 
Profile Test 


Group By k 
Add to Playlist lh 
DJ Copy 
请。 Select Al Ctrl+A 


Open Test Fi 


28-3 
单元 测试 应 该 测试 每 个 可 能 的 执行 路 径 ， 并 检查 异 稍 。 
28.2.3 使 用 MSTest 预期 异常 


以 null 为 参数 调用 StringSample 类 的 构造 函数 和 GetStringDemo 方法 时 ， 可 以 预计 会 发 生 
ArgumentNullException 异常 。 在 测试 代码 中 很 容易 测试 这 一 点 ， 只 需要 像 下 面 的 示例 那样 对 测试 方法 应 用 
ExpectedException 特性 。 这 样 ， 测 试 方法 将 成 功 地 捕捉 到 异常 (代码 文件 UnitTestingSamples.MSTests/ 
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StringSampleTests.cs): 


[TestMethod] 
[ExpectedException (typeof (ArgumentNullException))})] 
Public void ConstructorShouldThrowOnNull () 
{ 

var sample = new StringSample (null)}).; 
} 


对 于 GetStringDemo 方法 抛 出 的 异 曾 ， 可 以 采取 类 似 的 处 理 。 


28.2.4 测试 全 部 代码 路 径 


为 了 测试 全 部 代码 路 径 ， 可 以 创建 多 个 测试 ， 每 个 测试 针对 一 条 代码 路 径 。 下 面 的 测试 示例 将 字符 串 a 和 
b 传递 给 GetStringDemo 方法 。 因 为 第 二 个 字符 串 没有 包含 在 第 一 个 字符 串 内 ， 所 以 站 语句 的 第 一 个 路 径 生 效 。 
结果 将 被 相应 地 检查 (代码 文件 UnitTestingSamples.MSTests/StringSampleTests.cs): 


[TestMethod l] 

Public void GetStringDemoBNotInA() 

{ 
string expected = "b not found in a"; 
Var Sample = new StringSample (String.Empty); 
string actual = sample.GetStringDemo("a™"., "b"); 
Assert .AreEdqual (expected, actual}):; 

} 


下 一 个 测试 方法 验证 GetStringDemo 方法 的 男 一 个 路 径 。 在 这 个 示例 中 ， 第 二 个 字符 串 包含 在 第 一 个 字符 
串 内 ， 并 且 索 引 小 于 5， 所 以 将 执行 让 语句 的 第 二 个 代码 块 ; 


[TestMethodl] 
Public void GetstringDemoRemoveBCFIroOmABCD() 
{ 
string expected = "removed bc from abcd: ad"; 


var Sample = new StringSample (string.Empty); 
string actual = sample.GetStringDemo ("abcd™", "bc"™); 
Assert .AreEdqual (expected, actual); 

} 


其 他 所 有 代码 路 径 都 可 以 以 类 似 的 方式 测试 。 为 了 得 看 单元 测试 覆 兰 了 哪些 代码 ， 以 及 还 缺少 什么 代码 ， 
可 以 局 动 Visual Studio 2017 中 的 Code Coverage， 使 用 dotnet test 命令 的 --collect 选项 。 在 Visual Studio 2017 的 
Code Coverage Results 窗口 (Test | Windows | Code Coverage Results) 中 ， 可 以 看 到 单元 测试 覆盖 代码 的 百分比 。 


28.2.5 外 部 依赖 


许多 方法 都 依赖 于 不 受 应 用 程序 本 身 控制 的 某 些 功能 ， 例 如 调用 Web 服务 或 者 访问 数据 库 。 在 测试 外 部 资 
源 的 可 用 性 时 ， 可 能 服务 或 数据 库 并 不 可 用 。 更 糟 的 是 ， 数 据 库 和 服务 可 能 在 不 同 的 时 间 返 回 不 同 的 数据 ， 这 
就 很 难 与 预期 的 数据 进行 比较 。 在 单元 测试 中 ， 必 须 排除 这 种 情况 。 

下 面 的 示例 依赖 于 外 部 的 某 些 功 能 。 方 法 ChampionsByCountry0 访 问 一 个 Web 服务 器 上 的 XML 文件 ， 该 
文件 以 Firsmhame、Lastname、Wins 和 Country 元 系 的 形式 列 出 了 一 级 方程 式 世界 冠军 。 这 个 列表 按 国家 筛选 ， 
并 使 用 Wins 元 素 的 值 按 数字 顺序 排序 。 返 回 的 数据 是 一 个 XElement， 其 中 包含 了 转换 后 的 XML 代码 : 


Public XElement ChampionsByCountryl(string country) 
{ 
XElement champions = XElement.Load(FlAddresses.RacersUrl); 
var 可 = from r in champlions.Elements ("Racer"™") 
where I.Element ("Country"} .Value == country 
orderby int.Parsel(r.Element ("Wins") .Value) descending 
Select new XElement ("Racer™, 
new XAttribute ("Name", r.Element ("Firstname") .Value + "十 
r.Elementt"Lastname") .Value})., 
new XAttribute{("Country", Ir.Element ("Country") .Valuel) ， 
new XAttribute ("Wins", r.Element ("Wins") .Value) ); 
return new XElement ("Racers™", dd.ToArray(}}; 
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注意 : 
关于 LINQ to XML 的 更 多 信息 ， 请 参考 网 上 附加 第 2 章 。 


到 XML 文件 的 链接 由 F1Addresses 类 定义 (代码 文件 UnitTestingSamples/FlAddresses.cs): 


Public class FlAddresses 
{ 
public const string RacersUrl = 
"nttp://www.cninnovation.com/downloads/Racers.xml"s 


} 


应 该 为 ChampionsByCountry 方法 创建 一 个 单元 测试 。 测试 不 应 依赖 于 服务 器 上 的 数据 源 。 一 方面 ， 服务 器 
可 能 不 可 用 。 另 一 方面 ， 服 务 器 上 的 数据 可 能 随时 间 发 生 改 变 ， 返 回 新 的 冠军 和 其 他 值 。 正 确 的 测试 应 该 确保 
按 预 期 方式 完成 稀 选 ， 并 以 正确 的 顺序 返回 正确 科 选 后 的 列表 。 

创建 独立 于 数据 源 的 单元 测试 的 一 种 方法 是 使 用 依赖 注入 模式 ， 重 构 ChampionsByCountry 方法 的 实现 代 
码 。 在 这 里 ， 创 建 一 个 返回 XElement 的 工厂 ， 来 取代 XElement.Load 方法 。IChampionsLoader 接口 是 在 
ChampionsByCountry 方法 中 使 用 的 唯一 外 部 要 求 。IChampionsLoader 接口 定义 了 方法 LoadChampions， 可 以 代 
蔡 上 述 方法 (代码 文件 UnitTestingSamples /IChampionsLoader.cs): 

Bite interface IChampionsLoader 


XElement LoadCchampions (); 
} 


类 ChampionsLoader 使 用 XElement.Load 方法 实现 了 接口 IChampionsLoader, 该 方法 由 ChampionsByCountry 
方法 预先 使 用 (代码 文件 UnitTestingSamples/ChampionsLoader.cs): 


Public class ChampionsLoader: IChampionsLoader 
{ 

public XElement LoadChampions() => XElement.Load(FlAddresses.RacersUrl); 
} 


注意 : 
依赖 注入 模式 参见 第 20 章 。 


现在 就 能 修改 ChampionsByCountry0 方 法 的 实现 , 使 用 接口 而 不 是 直接 使 用 XElement.Load 方法 0 来 加 载 冠 
军 。IChampionsLoader 传递 给 类 Formulal 的 构造 图 数 ， 然 后 ChampionsByCountry0 将 使 用 这 个 加 载 器 (代码 文 
件 UnitTestingSamples/Formulal.cs): 


public class Formulal 
{ 
private IChampionsLoader loader; 
public Formulal (IChampionsLoader loader) 
{ 
lJoader = loader; 


} 


public XElement ChampionsByCountryl(string country) 
{ 
Var 9q = from r in loader.LoadChampions () .Elements ("Racer"™") 
where Ir.Element ("Country") .Value == country 
orderby int.Parse(r.Element ("Wins") .Value) descending 
Select new KElement ("Racer™, 
new XAttribute ("Name", IrI.Element ("Firstname") -Value + ™ ™ + 
r.Elementt{("Lastname") .Value), 
new XAttribute ("Country", Ir.Element ("Country") -Valuel) ， 
new XAttribute ("Wins", Ir.Element ("Wins") .Value)); 
return new XElement ("Racers", dq.ToArray())}); 
} 
} 


在 典型 的 实现 代码 中 , 会 把 一 个 ChampionsLoader 实例 传递 给 Formulal 构造 函数 , 以 从 服务 器 检索 赛车 手 。 
创建 单元 测试 时 ， 可 以 实现 一 个 目 定义 方法 来 返回 一 级 方程 式 冠 军 ， 如 方法 FormulalSampleData0 所 示 ( 代 
码 文 件 UnitTestingSamples.MSTests/FormulalTests.cs): 


internal static string FormulalsampleData() 
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{ 
return 和 
<Racers> 

<Racer> 
<Firstname>Nelson</Firstname> 
<Lastname>Piquet</Lastname> 
<Country>Brazil</Country> 
<Starts>204</starts> 
<Wins>23</Wins> 

</Racer> 

<Racer> 
<Firstname>Ayrton</Firstname> 
<Lastname>Senna</Lastname> 
<Country>Brazil</Country> 
<Starts>161</starts> 
<Wins>A4l</Wins> 

</Racer> 

<RAaAcer> 
<Firstname>Nigel</Firstname> 
<Lastname>Mansell</Lastname> 
<Country>England</Country> 
<Starts>187</SsStarts> 
<Wins>31</Wins> 

</Racer> 

/:/... more sample data 


方法 FormulalVerificationData 返回 符合 预期 结果 的 样品 测试 数据 (代码 文件 UnitTestingSamples.MSTests/ 
Formulal Test.cs): 


internal static XElement FormulalverificationData'l() 
{ 
return XElement.Parse (8@" 
<Racers> 
<Racer Name=""Mika Hakkinen™"™" Country=""Finland™"™" Wins=""20"™" /> 
<Racer Name=""Kimi Raikkonen™"™™" Country=""Finland"™" Wins=""18"" /> 
</Racers>");} 
} 


测试 数据 的 加 载 器 实现 了 与 ChampionsLoader 类 相同 的 接口 : IChampionsLoader。 这 个 加 载 器 仅 使 用 样本 
数据 ， 而 不 访问 Web 服务 器 (代码 文件 UnitTestingSamples.MSTests/FormulalTest.cs): 


Public class FlTestLoader: IChampionsLoader 
{ 

Public XElement LoadChampions() => XElement.Parse (FormulalsampleData()); 
} 


ne A 二 ”AF 二 aa CO 和 
现在 ， 很 容易 创建 一 个 使 用 样本 数据 的 单元 测试 (代码 文件 UnitTestingSamples.MSTests/FormulalTest.cs): 
[TestMethod ] 
public void ChampionsByCountryFilterFinland't{) 
{ 

Formulal fl1 = new Formulal (new FlTestLoader(}))}); 

XpElement actual = fi.championsByCountry("Finland"); 

Assert.AreEqual (FormulalVerificationData() .ToString{(}, actual.ToSsString())}); 
} 


当然 ， 真 正 的 测试 不 应 该 只 履 兰 传递 Finland 作为 一 个 字符 串 并 在 测试 数据 中 返回 两 个 冠 盏 这 样 一 种 情况 。 
还 应 该 针对 其 他 情况 编写 测试 ， 例 如 传递 没有 匹配 结果 的 字符 串 ， 返 回 两 个 以 上 的 冠军 的 情况 ， 可 能 还 包括 数 
字 排 序 顺 序 与 字母 数字 排序 顺序 不 同 的 情况 。 


注意 : 


要 测试 不 使 用 依赖 注入 的 方法 ， 用 测试 类 替代 在 内 部 使 用 的 依赖 项 ， 可 以 使 用 Fakes Framework。 这 只 能 用 
于 Visual Studio 企业 版 的 NET Framework 项 目 。 


28.3 ”使 用 xUnit 进行 单元 测试 


实现 NET Core 时 , xUnit 可 用 于 创建 单元 测试 ，NET Core 团队 使 用 了 该 产品 。 xUnit 是 一 个 开源 实现 方案 ， 
创建 NUnit 2.0 的 开发 人 员 也 创建 了 它 。 现 在 ，.NET Core 命令 行 界面 支持 MSTest 和 xUnit。 
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提示 : 
xUnit 的 文档 可 参阅 https://xunit.github.io/。 


Visual Studio 测试 环境 支持 其 他 测试 框架 。 测 试 适配器 ， 如 NUnit、xUnit、Boost( 用 于 C++)、Chutzpah( 用 
于 JavaScript) 和 Jasmine( 用 于 JavaScript) 可 通过 扩展 和 更 新 来 使 用 ; 这 些 测 试 适 配器 与 Visual Studio Test Explorer 
集成 。 

XxUnit 是 .NET Core 中 一 个 杰出 的 测试 框架 ， 也 由 微软 的 .NET Core 和 ASPNET Core 开源 代码 使 用 ， 所 以 
xUnit 是 本 节 的 重点 。 


28.3.1 使 用 xUnit 和 .NET Core 
使 用 NET Core 应 用 程序 ， 可 以 创建 xUnit 测试 ， 其 方式 与 MSTest 测试 类 似 。 从 命令 行 ， 可 以 使 用 : 


> dotnet new xXxunit 

创建 xUnit 测试 项 目 。 在 Visual Studio 2017 中 ， 可 以 选择 项 目 类 型 xUnit Test Project(.NET Core)。 

在 示例 项 目 中 ， 测 试 与 以 前 相同 的 .NET 标准 库 UnitTestingSamples。 这 个 库 包 含 之 前 所 示 的 测试 的 类 型 ; 
DeepThought 和 StringSample。 测 试 项 目的 名 称 是 UnitTestingSamples.xUnit.Tests。 

这 个 项 目 需 要 引用 xunit( 对 于 单元 测试 ， 是 xunitrunnervisualstudio[ 在 Visual Studio 中 运行 测试 ]) 和 
UnitTestingSamples 项 目 ( 应 测试 的 代码 )。 为 了 与 .NET Core 命令 行 集成 ， 添 加 domet-xunit 的 
DotNetCliToolReference( 项 目 文 件 UnitTestingSamples.xUnit.Tests/UnitTestineSamples.xUnit.Tests.csproj)。 

<Project sdk="Microsoft.NET.Sdk"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
<IsPackable>false</IsPackable> 

</PropertyGroup> 


<Itemoroup> 
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.5.0" /> 
<PackageReference Include="xunit"™" Version="2.3.1" /> 
<PackageReference Include="xunit.runner.visualstudio™ Version="2.3.1" /> 
<DotNetcCliToolReference Include="dotnet—xunit™" Version="2.3.1"™ /> 
</ItemGroup> 


<ItemGroup> 
<ProjectReference Include="..\UnitTestingSamples\UnitTesting3Samples.csproj" /> 
</ItemSroup> 


</Project> 


28.3.2 创建 Fact 属性 


创建 测试 的 方式 非常 类 似 于 之 前 的 方法 。 在 MSTest 中 , 需要 给 测试 类 添加 属性 。 但 在 xUnit 中 是 不 必要 的 ， 
因为 会 在 所 有 的 公共 类 中 搜索 测试 方法 。 在 MSTest 和 xUnit 中 测试 方法 TheAnswerToTheUltimateQuestion- 
OfLifeTheUniverseAndEverything 的 差异 只 是 带 注 释 和 Fact 特 性 的 测试 方法 和 不 同 的 Assert.Equal 方 法 (代码 文件 
UnitTestineSamples.xUnit.Tests/DeepThouehtTests.cs): 


Public class DeepThoughtTest 
{ 
[Factl] 
public void 
ResultofTheAnswerToTheUltimateQuestionOfLifeTheUniverseAndEverythingTest() 
{ 
int expected = 42; 
var dt = new DeepThought (}; 
int actual = 
dt .TheAnswerToTheUltimateQuestionofLifeTheUniverseAndEverything(); 
LAssert.Ecqgual (expected, actual).; 
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现在 使 用 的 Assert 类 在 XUnit 名 称 空间 中 定义 。 与 MSTest 的 Assert 方法 相 比 ， 这 个 类 定义 了 更 多 的 方法 ， 
用 于 验证 。 例如， 不 是 添加 一 个 特性 来 指定 预期 的 异常 ， 而 是 使 用 Assert.Throws 方法 ， 人 允许 在 一 个 测试 方法 中 
多 次 检查 异常 (代码 文件 UnitTestingSamples.xUnit.Tests/StringeSampleTest.cs): 


[Factl] 

Public void GetStringDemoExceptions() 

{ 
var sample = new StringsSample (string.Empty); 
Assert.Throws<ArgumentNullException>(() => sample.GetstringDemo (null, "a™)); 
Lssert.Throws<ArgumentNullExcepticon>(() => sample.GetstringDemo("a", null)); 
Assert.Throws<ArgumentException>{(() => 

sample.GetSstringDemo (string.Empty, "a")); 
} 


28.3.3 创建 Theory 特性 


xUnit 为 不 需要 参数 的 测试 方法 定义 Fact 特 性 ,使 用 xUnit 还 可 以 调用 需要 参数 的 单元 测试 方法 ;使 用 Theory 
特性 提供 数据 ， 添 加 一 个 派生 于 Data 的 特性 。 这 样 就 可 以 通过 一 个 方法 定义 多 个 单元 测试 了 。 

在 下 面 的 代码 片段 中 ，Theory 特性 应 用 于 GetStringDemoImlineData 单元 测试 方法 。StringSample. 
GetStringDemo 方法 定义 了 取 雇 于 输入 数据 的 不 同 路 径 。 如 果 第 二 个 参数 传递 的 字符 串 不 包含 在 第 一 个 参数 中 ， 
就 到 达 第 一 条 路 径 。 如 果 第 二 个 字符 串 包 仿 在 第 一 个 字符 串 的 前 5 个 字符 中 ， 就 到 达 第 二 条 路 径 。 第 三 条 路 径 
是 用 else 子 句 到 达 的 。 要 到 达 所 有 不 同 的 路 径 ，3 个 InlineData 特性 要 应 用 于 测试 方法 。 每 个 特性 都 定义 了 4 
个 参数 ,它们 以 相同 的 顺序 直接 发 送 到 单元 测试 方法 的 调用 中 。 特性 还 定义 了 被 测试 方法 应 该 返回 的 值 (代码 文 
件 UnitTestineSamples.xUnit.Tests /StringSampleTest.cs): 


[TIhecrvy] 
[InlineDatal(™"", "longer string”, "nger", 

"removed nger froem longer string: lo string")] 
[InlineDatat("init™”, "longer string", "string”", "INIT"}] 
Public void GetSstringDemoInlineDatal(string init, string a, string b, 

string expected) 
{ 

Var Sample = new StringSample (init),;) 

string actual = sample.GetSstringDemo(a, b); 

Assert .Edqual (expected, actual}); 

} 


特性 InlineData 派生 于 Data 特性 。 除 了 通过 特性 直接 把 值 提供 给 测试 方法 之 外 ， 值 也 可 以 来 目 于 属 
性 、 方 法 或 类 。 以 下 例子 定义 了 一 个 静态 方法 ， 它 用 下 numerable<object> 对 象 返 回 相 同 的 值 (代码 文件 
UnitTestineSamples.xUnit.Tests/StrneSampleTest.cs): 


public static IEnumerable<object[]> GetStringSampleData() => 
newl] 
{ 
new object[] { "", "a™, "b", "Db not found in an }, 
new object[] { "“™", "longer string™", "nger™, 
"removed nger from longer string: lo string™" }, 
new object[] { vinit™, "longer string™", "string™", "INIT™ } 


}; 
单元 测试 方法 现在 用 MemberData 特性 改变 了 。 这 个 特性 允许 使 用 返回 下 numerable<object> 的 静态 属性 或 
方法 ， 填 写 单元 测试 方法 的 参数 (代码 文件 UnitTestingSamples.xUnit.Tests/StrineSampleTest.cs): 


[Theoryl] 

[MemberData("GetstringsSampleData"™)] 

Public void GetSstringDemoMemberData (string init, string a, string b, 
string expected) 


var Sample = new StringSample (init),; 
string actual = sample.GetStringDemo(a, b); 
Assert .Equal (expected, actual}); 

} 
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28.34 使 用 Mocking 库 


下 面 是 一 个 更 复杂 的 例子 : 在 MVVM 应 用 程序 中 ， 为 客户 端 服务 库 创 建 一 个 单元 测试 。 本 章 的 示例 代码 
仅 包 含 该 应 用 程序 使 用 的 一 个 库 。 这 个 服务 使 用 依赖 注入 功能 ， 注 入 接口 IBooksRepository 定义 的 存储 库 。 用 
于 测试 AddOrUpdateBookAsync 方法 的 单元 测试 不 应 该 测试 该 库 ， 而 只 测试 方法 中 的 功能 。 对 于 库 ， 应 执行 另 
一 个 单元 测试 : 下 面 的 代码 段 显示 了 类 的 实现 (代码 文件 MockingSamples/BooksLib/Services/BooksService.cs): 


Public class BooksService: IBooksService 
{ 
private ObservableCollection<Book> books = new ObservableCollection<Book>(}):; 
private IBooksRepository booksRepository; 
public BooksService (IBooksRepository repository) 
| 
booksRepository = repository; 


} 


public async Task LoadBooksAsync{() 
{ 
if ( books.Count > 0) return; 
IEnumerable<Book> books = awalt booksRepository.GetItemsAsync(); 
books.cClear (}); 
foreach (var b in books) 


{ 
books.Add (b); 
} 
} 


Public Book GetBook(int bookId) 三 > 
_books.Where(b => b.BookId == bookId) .SingleorDefault (}); 


public async Task<Book> AddoOrUpdateBookAsync (Book book) 
{ 


if (book == null}) throw new ArgumentNullException (nameof (book) ) ， 


Book updated = null; 


if (book.BookId =— 0) 
{ 
updated = await booksRepository.AddAsync (book); 
if (updated == null}) throw new InvalidoOperationException(}); 


books.Add (updated)}); 


} 
el1se 
{ 
updated = awalt booksRepository.UpdateAsync (book); 
if (updated == null) throw new InvalidOperationException(); 


Book old = books.Where(b => b.BookId == updated.BookId) .Single (); 
int ix = books.IndexOof (old); 
books.RemoveAt (1x); 
_books.Insert (i1x, updated); 
} 
return updated; 
} 


public IEnumerable<Book> Books => books; 
} 


因为 AddOrUpdateBookAsync 的 单元 测试 不 应 该 测试 用 于 IBooksRepository 的 存储 库 ， 所 以 需要 实现 一 个 
用 于 测试 的 存储 库 。 为 了 简单 起 见 ， 可 以 使 用 一 个 模拟 库 自 动 填充 空 日 。 一 个 常用 的 模拟 库 是 Moq。 对 于 单元 
测试 项 目 ， 添 加 NuGet 包 Moq。 


注意 : 
除了 使 用 Moq 框架 之 外 ， 还 可 以 用 示例 数据 实现 一 个 内 存 中 的 存储 库 。 在 用 户 界面 的 设计 过 程 中 ， 可 以 这 
么 做 来 处 理应 用 程序 的 示例 数据 。 


使 用 xUnit 时 ， 每 次 运行 测试 都 会 创建 测试 类 的 一 个 新 实例 。 如 果 多 个 测试 需要 相同 的 功能 ， 就 可 以 把 这 
个 功能 移动 到 构造 函数 中 。 如 果 每 次 运行 测试 后 需要 释放 资源 ， 就 可 以 实现 IDisposable 接口 。 
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在 BooksServiceTest 类 的 构造 函数 中 ， 实 例 化 一 个 Mock 对 象 ， 传 递 泛 型 参数 IBooksRepository。Mock 构 
造 函数 创建 接口 的 实现 代码 。 因 为 需要 从 存储 库 中 得 到 一 些 非 空 结果 来 创建 有 用 的 测试 ， 所 以 Setup 方法 定义 
可 以 传递 的 参数 ，RetumsAsync 方法 定义 了 方法 存根 返回 的 结果 。 使 用 Mock 类 的 Object 属性 访问 模拟 对 象 ， 
并 传递 它 ， 以 创建 BooksService 类 的 实例 。 有 了 这 些 设置 ， 就 可 以 实现 单元 测试 (代码 文件 
MockingeSamples/BooksLib. Tests/Services/BooksServiceTest.cs): 


Public class BooksServiceTest : IDisposable 
{ 
private const string TestTitle = "Test Title™; 
private const string UpdatedTestTitle = "Updated Test Title"™; 
public const string APublisher = "A Publisher"™; 
private BooksService booksService; 
private Book _ newBook = new Book 
{ 
BookId = 0., 
Title = TestTitle, 
Publisher = APubllisher 
上 
private Book expectedBook = new Book 
{ 
BookId = 1, 
Title = TestTitle, 
Publisher = APublisher 
上 
private Book notInRepositoryBook = new Book 
{ 
BookId = 42 ， 
Title = TestTitle, 
Publisher = APuUublisher 
上 
private Book updatedBook = new Book 
{ 
BookId = 工 ， 
Title = UpdatedTestTitle, 
Publisher = APublisher 
上 


Public BooksServiceTest() 
{ 
Var mock = new Mock<IBooksRepository2>(); 
mock.Setup (repository => 
repository.AddAsync!( newBook)) .ReturnsAsync( expectedBook); 
mock.Setup (lrepository => 
repository.UpdateAsynce!( notInRepositoryBook)) .ReturnsAsync (null as Book); 
mock.Setup (repository => 
repository.UpdateAsync!( updatedBook)) .ReturnsAsync!( updatedBook).; 


_booksService = new BooksService (mock .Object).; 
} 
Ff 


注意 : 
IDisposable 接口 参见 第 17 章 。 


实现 的 第 一 个 单元 测试 AddOrUpdateBookAsync ThrowsForNull 证 明 ， 如 果 把 nul 传递 给 
AddOrUpdateBookAsync 方法 ， 就 会 抛 出 ArgumentNullException 异常 。 该 实现 代码 只 需要 在 构造 函数 中 实例 化 
成 员 变 量 booksService， 而 不 需要 模拟 设置 。 这 个 代码 示例 还 说 明 ， 单 元 测试 方法 可 以 实现 为 返回 Task 的 异步 
方法 (代码 文件 MockingSamples/BooksLib.Tests/Services/BooksServiceTest.cs): 


[Factl] 
Public async Task AddOrUpdateBookAsync ThrowsForNull () 
{ 
// arrange 
Book nullBook = null; 
// act and assert 
await Assert.Throwshsvync<ArgumentNullException2>(() =»> 
_booksService.AddOrUpdateBookAsync (nullBook)).; 
} 
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单元 测试 方法 AddOrUpdateBook AddedBookReturmsFromRepository 给 服务 添加 了 一 本 新 书 (变量 
newBook)， 并 期 望 返回 expectedBook 对 象 。 在 AddOrUpdateBookAsync 方法 的 实现 代码 中 ， 调 用 了 
IBooksRepository 的 AddAsynec 方法 ， 因 此 ， 应 用 了 以 前 给 这 个 方法 定义 的 模拟 设置 。 这 个 方法 的 结果 应 是 ， 返 
回 的 Book 等 于 expectedBook， expectedBook 也 需要 添加 到 BooksService 的 图 书 集合 中 (代码 文件 
MockmeSamples/BooksLib.Tests/Services/BooksServiceTest.cs): 


[Fact] 
Public async Task AddOrUpdateBook AddedBookReturnsFromRepository () 
{ 
// arrange in constructor 
AAA ac 
Book actualAdded = awalit _booksService.AddOorUpdateBookAsync( newBook); 


// assert 
Assert.Equal( expectedBook, actualAdded). 
Assert.Contains( expectedBook, booksService.Books); 


} 
AddOrUpdateBook _UpdateNotExistingBookThrows 单元 测试 证 明 ， 尝 试 更 新 服务 中 不 存在 的 图 书 ， 应 抛 出 
InvalidOperationException 异常 (代码 文件 MockingSamples/BooksLib.Tests/Services/BooksServiceTest.cs): 


[Fact] 
Public async Task AddOorUpdateBook UpdateNotEx1stingBookThrows () 
{ 

// arrange in constructor 

// act and assert 

await Assert.ThrowsAsync<InvallidoOperationException>(() 三 > 

booksService.AddOrUpdateBookAsync( notInRepositoryBook)); 

} 


更 新 图 书 的 常见 情形 用 单元 测试 AddOrUpdateBook UpdateBook 来 处 理 。 这 里 需要 做 额外 的 准备 ， 中 更 新 
， 先 把 图 书 添加 到 服务 中 (代码 文件 MockingSamples/BooksLib.Tests/Services/BooksServiceTest.cs): 
[Factl] 


Public async Task AddorUpdateBook UpdateBook () 
{ 


// arrange 
翌 W 有 lt booksService.AddOrUpdateBookAsync( newBook); 


/i act 
Book updatedBook = awalt booksService.AddorUpdateBookAsync!( updatedBook); 


// assert 
Assert.Equal( updatedBook, updatedBook}); 


Assert.contains( updatedBook, booksService.Books)}.; 


} 

当 使 用 MVVM 模式 与 基于 XAML 的 应 用 程序 ， 以 及 使 用 MVC 模式 和 基于 Web 的 应 用 程序 时 , 会 降低 用 
户 界 面 的 复杂 性 ， 减 少 复杂 UI 测试 的 需求 。 然 而 ， 仍 有 一 些 场 景 应 该 用 UI 测试 ， 例 如， 浏览 页 面 、 拖 电 元 素 
等 。 此 时 应 使 用 Visual Studio 的 UI 测试 功能 。 


28.4 ”实时 单元 测试 


Visual Studio 2017 的 企业 版 提供 了 一 个 非常 好 的 单元 测试 功能 : 实时 单元 测试 。 最 好 尽早 看 到 错误 ， 而 能 
看 到 它们 的 第 一 个 地 方 是 Visual Studio 编辑 器 .从 Test 菜单 中 , 可 以 启动 Live Unit Testing。 打 开 Live Unit Testing 
后 ， 可 以 在 编辑 器 中 直接 看 到 测试 覆 兰 的 代码 行 以 及 测试 运行 成 功 的 代码 (参见 图 28-4)。 

如 果 在 代码 编辑 器 中 引入 了 一 些 错误 ， 就 可 以 立即 看 到 这 个 问题 一 一 即使 不 保存 文件 也 能 看 到 。 如 果 编 译 
器 在 用 户 编辑 时 运行 成 功 ， 那 么 与 刚刚 编辑 过 的 方法 相关 联 的 单元 测试 就 会 运行 ， 可 以 看 到 结果 (如 图 28-5 所 
示 )， 并 可 以 做 出 相应 的 反应 。 
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| hoeHnassmples 


| Se BookslibServices booksService -| @ hddOrUpdateBeoakAsynelBoak eekl 


public Book GetBook(int bookId) =» 
_books .Where(b => b.Bookld == bookId).SingleOrDefault(); 


public asynec Task<*Book> AddOrUpdateBookAsync (Book book) 
| 


if (tbook is null) throw new ArgumentNullException(nameof(book)):; 


Book Updated = null;| 
if (book.BookId == @) 
{ 
updated = await booksRepository.AddAsync(book); 
books.Add(updated); 
} 
吾 ] 5e 
{ 
updated = await bookshepository.UpdateAsync (book); 
if (updated == nully throw rrew InvalidOperationException(); 


Book old = books .Wherelb =» b.BookId == updated,.BookId).Singler):; 
int ix = books,1Index0f(o01d); 
_books.RemoveAt (ix); 
_books.Insert(ix, updated); 
} 
return updated: 


< RARA 


} 


public lIEnumerable<Booky Books =》 books,; 


图 28-4 


"| tr BeaoksLib Services. Booksservice | | ® AddOrUpdateBookhrynclBeoak boak) 


public Book GetBook(int bookId) =»> 
books.Wheretb => b.BookId == bookId).singleOrDefault(); 


public async Task<Booky AddOrUpdateBookAsync(Book book) 


{ 
i if (book is null) throw new ArgumentNullException(nameoft(book)),; 


Book updated = null; 
ift (book.BookId == 日 ) 
{ 
updated = await booksRepository.AMddAsynctbook); 
_books.Add(updated); 
} 
else 
{ 
updated = await booksRepository.UpdateAsync(book); 
if (updated == null) throw new InvalidoperationException(); 


Book old = books.Where(b =» b.BookId == updated,.BookId).Single(); 
int ix = books,Index0f(old); 
_books.Removeht (ix); 
books.Insert(ix, updated); 
} 


return updated; 


A 


} 


public IEnumerable*Book> Books => books; 


图 28-5 


在 编辑 时 运行 的 所 有 测试 都 应 该 运行 得 很 快 。 不 应 该 使 用 Live Unit Testing 运行 集成 测试 。 在 Solution 
Explorer 中 ， 可 以 选择 要 从 Live Unit Testing 中 排除 或 包含 的 测试 项 目 和 测试 类 。 

还 可 以 使 用 注释 排除 特定 的 测试 方法 一 一 使 用 Trait 属性 的 xUnit: 

[Trait ("Category", "SkipWhenLiveUnitTesting")] 

对 MSTest 使 用 TestCategory 属性 : 


[Testcategory ("SkipWhenLiveUnitTesting")] 
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当 电 池 电 量 不 足 30% 时 ， 实 时 单元 测试 不 能 运行 。 在 Visual Studio 中 选择 Tools | Options， 可 以 配置 这 个 设 
置 和 其 他 Live Unit Test 设置 。 


28.5 “使 用 EF Core 进行 单元 测试 


创建 单元 测试 时 , 需要 用 提供 测试 数据 的 测试 类 蔡 换 依赖 项 。Entity Framework Core(EF Core) 上 下 文中 的 依 
赖 项 又 如 何 呢 ? 通 闸 没有 一 个 接口 是 由 上 下 文 实 现 的 , 但 是 上 下 文本 身 ( 例 如 ，BooksContexb 是 被 注入 的 。EF Core 
基于 内 存 的 提供 程序 提供 了 一 个 解决 方案 ， 可 以 将 其 用 作 模 拟 类 ， 而 不 是 使 用 EF Core SQL Server 提供 程序 。 


注意 : 
EF Core 详 见 第 26 章 。 


下 面 从 一 个 简单 的 Book 类 型 、BooksContext 和 BooksService 开始 。BooksService 类 应 该 在 单元 测试 中 进行 
测试 。 
Book 是 一 个 简单 的 类 ， 它 保留 了 一 些 属性 (代码 文件 EFCoreSample/EFCoreSample/Book.cs): 


Public class Book 

{ 
public int BookId { get; set; } 
public string Title { get; set; } 
public string Publisher 1{ get; set; } 

} 


类 BooksContext 管理 到 数据 库 的 连接 ， 并 将 Book 类 型 映射 到 Books 表 ( 代 三文 件 EFCoreSample/ 
EFCoreSample/BooksContext.cs): 


Public class BooksContext : DbContext 
{ 
public BooksContext (DhbContextOptions<BooksContext> options) 
: base (options) 1{ } 


public DbSet<Book> Books { get; set; } 
} 


最 后 ， 类 BooksService 通过 依赖 注入 使 用 BooksContext， 并 定义 GetTopBooksByPublisher 方法 。 这 个 方法 
应 该 只 返回 10 本 书 (代码 文件 EFCoreSample/EFCoreSample/BooksService.cs): 

public class BooksService 

{ 


private readonly BooksContext booksContext; 


public BooksService (BooksContext booksContext) 


{ 
booksContext = booksContext; 
} 
public IEnumerable<Book> GetTopBooksByPublisher (string publisher) 
{ 
if (publisher == null) throw new ArgumentNullException (nameof (publisher))}); 


return booksContext.Books 
-Where(b => b.Publisher == publisher) 
-Take (10) 
-TOL1ist (); 
} 
} 


对 于 单元 测试 , 创建 一 个 xUnit 项 目 。 为 了 使 用 EF Core 内 存 提供 程序 , 除了 添加 EFCoreSample 项 目 之 外 ， 
还 要 添加 NuGet 包 Microsoft.EntityFrameworkCore.InMemory。 

现在 ， 可 以 使 用 DbContextOptionsBuilder 来 创建 内 存 中 数据 库 的 选项 。UseInMemoryDatabase 是 包 
Microsoft.EntityFrameworkCore.InMemory 中 的 扩展 方法 ， 用 于 添加 EF Core 内 存 提供 程序 。 在 InitContext 方法 
中 ， 将 创建 1000 个 book 对 象 ， 并 保存 到 上 下 文 的 对 象 列表 中 ， 以 备 单元 测试 使 用 (代码 文件 EFCoreSample/ 
EFCoreSample.Tests/BooksServiceTest.cs): 
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Public class BooksServiceTest : IDisposable 
{ 
private BooksContext booksContext.; 
private const String PublisherName = "A Publisher™; 
PUublic BooksServiceTest() 
{ 
InitContext (}); 
} 


private void InItContext () 


{ 
Var builder = new DbContextOptionsBuilder<BooksContext> () 


-UseInMemoryDatabase ("BookKsDB™); 
booksContext = new BooksContext (builder .Options); 


/i init with 1000 books 
Var books = Enumerable.Range (1l, 1000) 
.Select (1 一 > 
new Book 
{ 
BookId = 工 ， 
Title = $"Sample {1}", 
Publisher = PublisherName }) 
-开口 LIS 七 () ; 
_bookscContext .Books -AddRange (books) : 
booksContext -SaVvechanges () 7 


} 
Ek 


Public void Dispose() 
{ 
booksContext?.Dispose(); 
} 
} 


注意 : 
Enumerable 类 和 Range 方法 详 见 第 12 章 。 


现在 ， 单 元 测试 方法 GetTopBooksByPublisherCount 在 arrange 部 分 实例 化 BooksService， 在 act 部 分 调用 
GetTopBooksByPublisher 方法 ， 最 后 在 assert 部 分 检查 返回 的 图 书 数量 (代码 文件 EFCoreSample/ 
EFCoreSample.Tests/BooksServiceTest.cs): 


[Fact] 
Public void GetTopBooksByPublisherCcount () 
{ 
// arrange 
Var booksService = New BooksServicel( booksContext).: 
/ / act 加 
var topbooks = booksService.GetTopBooksByPublisher (PublisherName).,; 
// assert 
Assert .Equal (10, topbooks.Count()); 


28.6 ”使 用 Windows 应 用 程序 进行 UI 测试 


为 了 测试 用 户 界面 , Visual Studio 为 通用 Windows 应 用 程序 ,WPF 应 用 程序 和 Windows Forms 提供 了 Coded 
UI Test Project 模板 。 当 新 建 项 目 时 ， 可 以 在 Test 组 中 找到 用 于 WPF 和 Windows Forms 的 项 目 模板 。 但 是 ， 这 
个 模板 不 适用 于 Windows 应 用 程序 。 通 用 Windows 应 用 程序 的 项 目 模板 在 Windows Universal 组 中 。 请 注意 ， 
Windows 应 用 程序 不 支持 自动 记录 。 


注意 : 
创建 Windows 应 用 程序 详 见 第 33 一 36 章 。 
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本 章 将 为 一 个 简单 的 Windows 应 用 程序 创建 UI 测试 。 这 个 应 用 程序 是 本 章 可 下 载 文 件 的 一 部 分 ， 因 此 可 
以 使 用 它 进 行 测试 。 这 个 应 用 程序 只 包含 用 来 输入 一 些 文本 的 TextBox 控件 、Button 控件 和 TextBlock 控件 ， 
当 用 户 单 击 按钮 时 ，TextBlock 控件 应 该 显示 输入 的 文本 ， 如 图 28-6 所 示 。 


WindowsApp 


| 


Click Me! 


图 28-6 


创建 新 的 Coded UI Test Project(Universal Windows) 时 ， 会 显示 如 图 28-7 所 示 的 对 话 框 。 选 择 Edit UI Map 
或 Add Assertions 选项 时 ， 可 以 从 正在 运行 的 应 用 程序 中 选择 控件 ， 该 应 用 程序 将 控件 的 自动 化 对 等 点 添加 到 
映射 中 ， 因 此 可 以 轻松 地 以 编程 方式 访问 它 。 
Generate Code for Coded UI| Test 
How do you want to create your coded UI test? 


0 The code file for the coded UI test has been added to your test project, To 
proceed, you can select from the options below. 


是 | Edit UI Map or add assertions 

Use the cross-hair tool to add controls to UIMap and generate code. 
1 Manualhy edit the test 

Wirite code for the test manually, without using the cross-hair tool, 
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单 击 OK 创建 新 项 目 后 ， 就 打开 Coded UI Test Builder (参见 图 28-8)。Windows 应 用 程序 不 支持 记录 操作 ， 
所 以 这 个 选项 是 灰色 的 ， 但 是 可 以 在 正在 运行 的 应 用 程序 中 拖 蝶 控件 上 的 横 线 ， 来 同 UI 映射 添加 控件 。 


F 
| 


UIMap - Coded Ul Test Builder ? X 


os 
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选择 控件 时 ， 它 们 的 列表 显示 在 工具 的 左边 ， 而 右边 部 分 显示 所 选 控件 的 属性 (参见 图 28-9)。 需 要 单 击 最 
左边 的 按钮 (Add Control to UI Control Map)， 最 后 将 控件 添加 到 映射 中 。 

最 后 一 步 ， 需 要 在 UIMap - Coded UI Test Builder 窗口 中 单 击 Generate 按钮 ( 见 图 28-10)。 所 显示 的 对 话 框 
包含 一 个 方法 ， 但 与 Windows 应 用 程序 一 样 ， 仅 生成 控件 ， 不 需要 方法 名 ， 只 需要 单 击 Generate 按钮 。 
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Add Assertions: UllextOutlext - Coded Ul lest Builder 


只 | 站 » | Add Assertion | 心 “ 口 * | 0 


a UMWindowsAppWindow Lo Property Value 

UlclickMeButton 下 Search 

UITextinEdit ControlType Text 
Automatlonld textOut 
TechnalegyName UIA 

a Control Specific 

Font System._ComObject 
Faentsize 15 
Font\Weighi 400 
Acceleratorkey 
Arcesskey 
LabeledBy 
Item status 


图 28-9 


Ganerate Code = Coded UI| Test Builder 


Method Narme: 
[for example: MyMethod) 


各 There is no new method required. Code will only be 
generated for the changes to the Ul control map. 


UiMap - Coded Ul Test Builder ? Xx 
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可 以 在 UIMap.Designercs 文件 的 一 个 部 分 类 中 找到 生成 的 代码 。 在 UIMap.cs 文件 中 可 以 扩展 这 个 类 。 如 
果 再 次 月 动 Coded UI Test Builder， 设 计 器 生成 的 文件 将 被 履 新 。 

设计 器 生成 的 代码 定义 了 UIMap 类 ， 该 类 包含 UIWindowsAppWindow 的 一 个 属性 。 这 个 类 表示 带 有 被 包 
会 控件 的 窗口 (代码 文件 WindowsApp /WindowsApp.UITest/UIMap.Desiener.cs): 


[GeneTratedcode ("Coded UITest Builder™, "15.0.26621.2")] 
public partial class UIMap 
{ 
Public UIWindowsAppWindow UIWindowsAppWindow 
{ 
get 


{ 
if ((this.mUJUIWindowsAppWindow == null)) 
{ 
this.mUIWindowsAppWindow = new UIWindowsAppWindow(); 
} 
return this.mUIWindowsAppWindows; 
} 
} 
private UIWindowsAppWindow mUIWindowsAppWindow; 
} 


UIWindowsAppWindow 类 派生 自 基 类 XamlWindow， 并 定义 了 应 用 程序 启动 时 使 用 的 SearchProperties。 如 
果 应 用 程序 已 经 在 运行 ， 就 可 以 使 用 窗口 的 名 称 找到 应 用 程序 。 在 示例 应 用 程序 中 ， 它 设置 为 WindowsApp， 
类 名 是 Windows.UI.Core.CoreWindow (代码 文件 WindowsApp/WindowsApp.UITest/UIMap.Desiener.cs): 


[GeneTratedcode ("Coded UITest Builder™, "15.0.26621.2")] 
public class UIWindowsAppWindow : XamlWindow 
{ 
Public UIWindowsAppWindow (} 
{ 
this.SearchProperties[XamlControl.PropertyNames.Name] = "WindowsApp"; 
this.SearchProperties [XamlControl.PropertyNames.ClassName] = 
"Windows .UI.Core.CoreWindow"™"; 
this.WindowTitles.Add ("WindowsApp"}); 
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} 
f/f... 
对 于 使 用 Coded UI Test Builder 选择 的 每 个 控件 ， 都 会 创建 一 个 字段 和 一 个 属性 。 在 下 面 的 代码 片段 中 ， 

可 以 看 到 为 TextBox 控件 生成 的 代码 .每 个 UWP 控件 都 有 一 个 目 动 化 对 等 点 .对 于 TextBox 控件 , 它 是 XamlEdit 
类 。 要 将 UITextInEdit 属性 映射 到 相应 的 TextBox 控件 ， 可 以 使 用 AutomationId 。 使 用 附加 的 属性 
AutomationProperties.AutomationId 可 以 在 控件 定义 中 设置 AutomationId。Windows 应 用 程序 的 示例 代码 在 文件 
MainPageXaml 的 XAML 代码 中 定义 了 这 个 附加 属性 。 如 果 没 有 直接 设置 AutomationId, 则 使 用 与 控件 的 Name 
属性 相同 的 名 称 生成 它 。 该 属性 的 get 访问 器 在 第 一 次 访问 属性 时 实现 XamlEdit 控件 的 创建 。 在 初始 创建 之 后 ， 
返回 字段 的 值 (代码 文件 WindowsApp/WindowsApp.UITest/UIMap.Desiener.cs): 


Public XamlEdit UITextInEdit 
{ 
Det 
{ 
if {({(this.mJUITextInEdit == null)) 
{ 
this.mUITextInEdit = new XamlEdit (this).; 
this.mUITextInEdit 
.SearchPproperties [XamlEdit.PropertyNames.AutomationId] = "textIn™; 
this.mUITextInNnEdit.WindowTitles.Add ("WindowsApp"); 
} 
return this.mUITextInEdit:; 
} 
} 
private XamlEdit mUITextInEdit; 


注意 : 
附加 属性 参见 第 33 章 。 


测试 类 MainPageTest 用 CodedUITest 特性 进行 了 注释 。 这 个 特性 派生 自 基 类 TestClassExtensionAttribute， 
并 识别 UI 测 试 的 类 型 。 要 局 动 应 用 程序 ， 需 要 应 用 程序 的 目 动 化 ID。 要 获得 这 个 ID， 可 以 使 用 Coded UTI Test 
Builder 中 的 十 字 ， 并 选择 应 用 程序 的 磁 贴 ， 或 者 打开 Package.appxmanifest 编辑 器 中 的 Packaging 标签 。 在 
Packaging 选项 卡 (参见 图 28-11) 中 ， 可 以 复制 包 系 列 名 称 ， 并 添加 !App 作为 后 级 。 要 访问 生成 的 UIMap， 测 试 
类 应 定义 一 个 属性 (代码 文件 WindowsApp/WindowsApp.UITest MainPageTest.cs): 


[CodeadUITest (CodedUITestType.WindowsSstore)] 
Public class MalInPageTesSt 
{ 
Private string TileAutomaticnId = 
"Qe0Tecab-af0f-4129-96Sb-eedlaSbeefi15 p2wxv0rybmvBg!App"; 


下 


public TestContext TestContext 
{ 

get => testContextInstance; 

Set =» testContextInstance = value; 
} 


private TestContext testContextInstance; 


Public UIMap UIMap 
{ 
det 
{ 
if (this.map == null) 
{ 
this.map = new UIMap (); 
} 
return this.map; 
} 
} 
private UIMap map; 
} 
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Application Visual Assets Capabilities Declarations Content URIs Packaging 


se this 有 ee te set tne Propenl es that Identify and descnbe yeur Dackage Wen it Is deplayved 


Package name: De07ecab-afof-4129-965b-eed7a5beef75 
| Package display name: WindowsApp 
MAalar Bear Bunld 
Version: 1 0 0 Maore information 
Publisher Choose Certificate.. 
Publisher display name: |ehrlis 


Package family name: 


图 28-11 


测试 在 测试 方法 EnterTextAndButtonClick 中 定义 。 首 先 ， 使 用 应 用 程序 先前 定义 的 目 动 化 D 启动 应 用 程 
序 。 接 下 来 ， 通 过 设置 自动 化 对 等 点 XamiEdit 控件 的 Text 属性 ， 来 填充 TextBox 控件 的 Text 属性 。 诸 如 按钮 
单 击 之 类 的 手势 是 通过 Gesture 类 完成 的 .Gesture.Tap 轻 击 或 单 击 控件 ;在 代码 片段 中 ,使 用 UIClickMeButton( 它 
是 关联 的 XamlButton 对 等 控件 ) 选 择 单 击 的 控件 。 最 后 ， 从 与 XamlText 控件 关联 的 TextBlock 中 读 取 文本 (代码 
文件 WindowsApp/WindowsApp.UITest/MainPageTest.cs): 


[TestMethod l] 

Public void EnterTextAndButtonCcClick!() 

{ 
string inText = "Hello, Windows!"™; 
XamlWindow xamlWindow = XamlWindow.Launch (TileButomationId).:; 
UIMap .UIWindowsAppWindow.UITextInEdit.Text = jnText; 
Gesture.Tap (UIMap .UIWindowsAppPWindow.UICl1ickMeButton),; 
string outText = UIMap.UIWindowsApPpWindow.UITextOutText .DisplayText; 
XamlW1indow.Close():; 
Assert.AreEdqual (inText, outText),; 

} 


现在 ， 可 以 以 运行 单元 测试 的 方式 运行 开 测试 ， 如 本 章 前 面 所 示 。 


28.7 Web 集成、 负载 和 性 能 测试 


要 测试 Web 应 用 程序 ， 可 以 创建 单元 测试 ， 调 用 控制 器 、 存 储 库 和 实用 工具 类 的 方法 。Tag 辅助 程序 是 简 
单 的 方法 ， 在 其 中 ， 测 试 可 以 由 单元 测试 覆盖 。 单 元 测试 用 于 测试 方法 中 算法 的 功能 ， 换 名 话说， 就 是 方法 内 
部 的 逻辑 。 在 Web 应 用 程序 中 ,创建 性 能 和 人 负载 测试 也 是 一 个 很 好 的 实践 。 应 用 程序 会 伸缩 吗 ? 应 用 程序 用 一 
个 服务 器 可 以 支持 多 少 用 户 ? 需要 多 少 台 服务 器 支持 特定 数量 的 用 户 ? 不 容易 伸缩 的 瓶颈 是 什么 ? 为 了 回答 这 
些 问 题 ，Web 测试 可 以 提供 帮助 。 

ASPNET Core 提供 了 一 个 托管 类 来 创建 集成 测试 。Visual Studio Enterprise 2017 为 Web 负载 和 性 能 测试 提 
供 了 一 个 记录 器 ， 来 记录 HTTP 请 求 。 记 录 器 需要 在 Intemet Explorer 中 添加 一 个 插件 。 


28.7.1 ASPNET Core 集成 测试 

通过 集成 测试 ,可 以 测试 Web 应 用 程序 从 HTTP 请 求 到 后 端的 所 有 内 容 。 应 该 有 比 集成 测试 更 多 的 单元 测 
试 。 单 元 测试 可 能 有 数 千 个 ， 但 只 有 几 个 集成 测试 。 如 果 单 元 或 集成 测试 可 以 履 兰 相同 的 功能 ， 就 应 该 选择 单 
元 测试 。Visual Studio 的 特性 “实时 单元 测试 ”对 于 运行 单元 测试 是 有 用 的 ， 但 是 不 应 该 在 集成 测试 中 使 用 它 。 
需要 进行 集成 测试 以 获得 完整 的 了 解 ， 查 看 从 前 端 到 后 端的 所 有 操作 。 
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创建 一 个 ASPNET Core 集成 测试 ， 使 用 空 模 板 创建 一 个 ASPNET Core Web 应 用 程序 ， 命 名 为 
ASPNETCoreSample。 从 生成 的 代码 中 运行 应 用 程序 ,返回 字符 串 “Hello World!”， 这 将 使 用 xUnit 进行 集成 测试 。 


注意 : 

ASPNET Core 详 见 第 30 一 32 章 ， 以 及 网 上 附加 第 3 章 。 

xUnit 项 目 ASPNETCoreSample.InteerationTest 需要 一 个 对 Microsoft.AspNetCore.TestHost 包 的 引用 。 这 个 包 包 
会 TestServer 类 来 托管 和 启动 Web 应 用 程序 ， 并 发 送 请 求 。 还 需要 对 Web 项 目 ASPNETCoreSample 进行 引用 。 

集成 测试 的 常见 安排 是 在 构造 函数 中 处理 。 在 这 里 ， 实 例 化 TestServer， 将 TIWebHostBuilder 传递 给 TestServer 
类 的 构造 函数 。 与 ASPNET Core Web 应 用 程序 的 Program.cs 文件 一 样 ， 需 要 进行 类 似 的 设置 ， 启 用 相同 的 配置 
文件 和 相同 的 中 间 件 (代码 文件 ASPNETCoreSample/ASPNETCoreSample. IntegrationTest/AspNetCoreSample Test.cs): 


Public class ASPNETCoreSampleTest : IDisposable 
一 TestServer testServer,; 
Public ASPNETCoreSampleTest () 
| _testServer = new TestServerl( 
WebHost.CreateDefaultBuilder() .UseStartup<Startup>()}).; 
} 


public void Dispose() => testServer?.Dispose(); 


Ee 
} 


在 集成 测试 中 ， 可 以 使 用 _testServer 变量 创建 对 主页 的 请 求 ， 并 调用 返回 的 RequestBuilder 的 GetAsync 方 
法 。 在 使 用 Content 属性 的 ReadAsStringAsync 读 取 内 容 之 前 ， 检 查 返 回 的 HttpResponseMessage 中 成 功 的 状态 
代码 。 在 assert 部 分 ， 比 较 结 果 与 预期 的 字符 串 ( 代 码 文件 ASPNETCoreSample/ASPNETCoreSample.Integration- 
Test/AspNetCoreSampleTest.cs): 


[Factl] 

Public async Task ReturnHelloWorld!{) 

{ 
// act 
RequestBuilder requestBuilder = testServer.createRequest ("™/"); 
HttpResponseMessage response = await requestBuilder.GetAsync(); 
response.EnSUureSuccessStatuscCode (}; 


Var responseSstring = await response.Content.ReadAsSstringAsync (); 


// assert 
Assert.Equal ("Hello World!™", responsestring}); 
} 


通过 RequestBuilder 类 ， 可 以 创建 HITP GET、POST、PUT 等 请 求 ， 并 添加 HTTP 头 信息 。GetAsync 方法 
的 结果 与 第 23 章 中 HttpClient 类 的 结果 相似 。 实 际 上 ,可 以 通过 调用 CreateClient 方法 ， 从 TestServer 中 直接 访 
问 HttpClient 类 。CreateWebSocketClient 方法 返回 一 个 WebSocketClient 实例 , 因此 也 可 以 创建 WebSocket 请 求 。 


28.7.2 创建 Web 测试 


现在 已 经 为 ASPNET Core 创建 了 一 个 集成 测试 ， 下 面 介绍 Visual Studio Enterprise 2017 的 一 个 特性 ，Web 
性 能 和 负载 测试 。 

为 了 创建 Web 测试 ,可 以 选择 Web Application (Model-View-Controller), 确保 Authentication 设置 为 Individual 
User Accounts， 创 建 一 个 新 的 ASPNET Core Web 应 用 程序 。 这 个 模板 内 置 了 足够 的 功能 ， 人 允许 创建 测试 。 在 创 
建 Web 测试 之 前 ， 局 动 应 用 程序 ， 并 回应 用 程序 注册 用 户 。 

要 创建 Web 测试 ， 需 要 给 解决 方案 添加 一 个 Web Performance and Load Test Project， 命 名 为 
WebAndLoadTest。 单 击 自动 生成 的 WebTestl.webtest 文件 , 打开 Web Test Editor。 然后 单 击 Add Recording 按钮 ， 
开始 一 个 Web 记录。 对 于 这 个 记录 , 必须 在 Internet Explorer 中 安装 Web Test Recorder 插 件 ,该 插件 随 Visual Studio 
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一 起 安装 。 该 记录 器 记录 发 送 到 服务 器 的 所 有 HTTP 请 求 。 单 击 Web 应 用 程序 WebApplicationSample 上 的 一 些 
链接 ， 例 如 About 和 Contact， 并 注册 一 个 新 用 户 。 然 后 单 击 Stop 按钮 ， 停 止 记录 。 

记录 完成 后 ， 可 以 用 Web Test Editor 编辑 记录 。 一 个 记录 如 图 28-12 所 示 。 对 于 所 有 的 请 求 ， 可 以 看 到 标 
题 信 息 以 及 可 以 影响 和 改变 的 表单 POST 数据 。 


-| WebApplicationSsample - WeabTest|.webtest 


-| 


六 WebTest1 
总] https://localhost44336/ 
和 万] https://localhost44336/lib/bootstrap/dist/fonts/ghyphicons-halflings-regular.eot 
二 硬 ] https://localhost44336/Home/About 
村 万] https://localhost44336/Home/Contact 
书 帮 ] https://localhost44336/ 
| https://localhostd4336/lb/bootstrap/dist/tonts/glyphicons-halflings-regular.eot 
i™Y httpsii/localhostd4336/Account/Register 
二 Ey https://localhostd4336/Account/Register 
+ 各 ] https://localhost44336/Account/Register 
二 Ey https://localhostd4336/b/bootstrap/dist/tonts/gtyphicons-halflings-regular.eot 
十 杞 ] https'localhost44336/ 
二 硬 ] hitps://localhostd44336/ib/bootstrap/dist/tonts/ghtyphicons-halflings-regular.eot 
= Validation Rules 
口 Response URL 
同 Response Time Goal 


图 28-12 


删除 不 需要 的 记录 ， 然 后 单 击 带 有 测试 名 称 NavigateAndRegisterTest 的 Generate Code 按钮 ， 生 成 源 代码 ， 
以 编程 方式 发 送 所 有 的 请 求 。 对 于 Web 测试 , 测试 类 派生 目 基 类 WebTest, 重 写 了 GetRequestEnumerator 方法 。 
该 方法 一 个 接 一 个 地 返回 请 求 (代码 文件 WebApplicationSample/WebAndLoadTest/NavigateAndRegisterTest.cs): 


public class NaVvIdateanadRegdISteIrTITesSt: WebTest 
{ 
public NavigateAndRegister () 
{ 
this.PreAuthenticate = true; 
this.Proxy = "default"™; 
} 


public override IEnumerator<WebTestRequest> GetRequestEnumerator() 
{ 
a 
} 
} 


方法 GetRequestEnumerator 定义 了 对 网 站 的 请 求 , 例如 对 About 页 面 的 请 求 . 对 于 这 个 请 求 , 添加 一 个 HTTP 
标题 ， 把 该 请 求 定义 为 源 目 于 主页 : 


public override IEnumerator<WebTestRequest> GetRequestEnumerator () 
{ 
Ess 
WebTestRequest request2 = 
new WebTestRequest ("http://localhost:44336/Home/About"); 
request2.ThinkTime = 1; 
request2.Headers.Add (new WebTestRequestHeader ("Referer™., 
"http://localhost:44336/")); 
yield return request2; 
Irequest2z = null; 
Ef 
} 


下 面 发 送 一 个 对 Register 页 面 的 HTTP POST 请 求 ， 传 递 表 单数 据 : 


WebTestRequest requesté = 
new WebTestRequest ("http://localhost:44336/Account/Register™); 
requesté.Method = "POST 
request6.ExpectedResponseUrl = "http://localhost:44336/™; 
reoquest6.Headers.Add (new WebTestRequestHeader ("Referer"., 
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"nttp://localhost:44336/Account/Register™"™)); 
FOImPostHttpBody requestéBody = new FormPostHttpBody'(); 
request6Body.FormPostParameters.Add ("Email™", "samplel@test.com™"™); 
request6Body.FormPostParameters.Add ("Password™"™, "Pas$s$wOrd"™),; 
request6Body.FormPostParameters.Add ("ConfirmPpassword", "Pas$$wOrd™); 
request6Body .FormPostParameters.Add{(" RequestvVverificationToken", 
this.Context["$HIDDEN1. RequestVverificationToken"] -ToString()); 
requesté.Body = requestéBody; 
Yield return requeste; 
redquest6é = null; 


在 表单 中 输入 一 些 数 据 时 ， 最 好 从 数据 源 中 提取 数据 ， 以 增加 灵活 性 。 使 用 Web Test Editor， 可 以 添加 数 
据 库 、CSYV 文件 或 XML 文件 作为 数据 源 ( 见 图 28-13)。 使 用 此 对 话 框 可 以 改变 表单 参数 ， 从 数据 源 中 提取 数据 。 


New Test Data Source Wrzard 


图 ， Select the type of data source 


Data source name 


Data source type 


| 证 这 


Database SW File LL Fil 印 


Please select the type of data that will be the basis for this data source 


tneel 


图 28-13 


添加 数据 源 就 改变 了 测试 代码 。 对 于 数据 源 , 测试 类 用 DeploymentItem 特性 (如 果 使 用 CSV 或 XML 文件 )、 
DataSource 和 DataBinding 特性 注释 : 


[DeploymentItem("webandloadtestproject\\EmailTests .csyv", 
"webandloadtestproject")] 
[Datasource ("EmalillDataSsource"™, 
"Microsoft .VisualSstudio.TestTools.DataSource.CSsyV", 
"|IDataDirectory|\‘\webandloadtestproject\\EmailTests.csv", 
Microsoft.VisualStudio.TestTools.WebTesting.DataBindingAccessMethod 
-Sequential, 
Microsoft.Visualstudio.TestTools.WebTesting.DataBindingSelectColumns 
.SelectonlyBoundColumns, "EmailTests#csv")] 
[DataBinding ("EmailDataSource", "EmailTests#csv", "samplelltest#com", 
"EmailDataSource.EmailTests#csv.samplelftest#com") ] 
Public class NavigatenndRegisterl: WebTest 
{ 
7/ ..- 
} 


现在 ， 在 代码 中 ， 可 以 使 用 WebTest 的 Context 属性 访问 数据 源 ， 该 属性 返回 一 个 WebTestContext， 以 通 
过 索引 访问 所 需 的 数据 源 : 


request6é6Body.FormPostParameters.Add ("Email™", 
this.context["EmailDataSource.EmailTests#csv.samplel@test#com"] .ToString ()}); 


28.7.3 运行 Web 测试 
有 了 测试 后 ， 就 可 以 启动 测试 了 。 可 以 直接 在 Web Test Editor 中 运行 并 调试 测试 。 在 开始 测试 之 前 ， 记 得 
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要 启动 Web 应 用 程序 。 在 Web Test Editor 中 运行 测试 时 ， 可 以 看 到 生成 的 Web 页 面 以 及 请 求 和 啊 应 的 细节 信 
息 ， 如 图 28-14 所 示 。 


la| 知 |@@| 生 [| 室 | 名 各 <3| 各 | 如 忆 


Le | Failad Click here to run again lIntermat Explorer 90 LAN Edit rn settings 


Tetal Time Request Time Request Bytes Response Bytes 
https//localhost:d4336/ O179 see DOSd see 
https//localhost:d4336/Home/About .081 sec 0011 sec 
httpe//localhestdd4336/Home/Ceontect O116 sue D030 ste 
https localhost:d4336/ O172 sec O02 sec 
https/Nocalhostdd336/Account/Register 0.113 see 0016 se 
https://ocalhostdd336/Account/Register D0007 sec QOD sec 
httpss/ /ocalhost:44336/Account/Register 0.036 sec D036 sec 
https//ocalhost:dd336 , D180 sec 心口 17 sec 


Nl Request Response Context Details 


s ctaect 


* Register 
"Log in 


About 


Vanr nnnliratinn Maserrintinn naore 


28-14 


使 用 Web Load Tests， 可 以 在 Web 应 用 程序 上 模拟 高 负载 。 单 击 Local.testsettings 解决 方案 项 ， 可 以 选择 在 
Visual Studio Team Services 上 运行 测试 ， 在 多 个 服务 器 上 运行 测试 (参见 图 28-15)。 示 例 则 使 用 本 地 机 器 。 


Test Settings 


A Specify name, description and run location of test settings 


Name: 


Roles Leecal 


Data and Diagnostics Description: 

Deployment These are default test settings for a local test run. 
Setup and Cleanup Scripts 
Test Results Names 

Hosts 


Test Tirmeouts . 
Test Fun leeatisn: 


Unit Test 二 Run tests using local computer or a test controller 


Web Test | 
OO Run tests using Visual Studio Team Services，Learn More 


< Previous Apply 
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在 Web Test 对 话 框 中 ， 可 以 通过 指定 浏览 器 类 型 、 模 拟 思考 时 间 和 多 次 运行 测试 来 确定 测试 运行 情况 ( 参 
见 图 28-16)。 
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注意 : 


使 用 Visual Studio 对 Web 应 用 程序 进行 负载 测试 ， 需 要 使 用 Visual Studio 的 企业 版 
以 查看 另 一 种 选择 : Selenium 一 一 http:// www.seleniumhq.org/。 


Test Settings 


4 Set the properties to control how Web tests are run， 


General 

Roles 

Data and Diagnostics 
Deployment 

Setup and Cleanup Scripts 
Test Results Names 

Hosts 


Test Timeouts 


Unit Test 


28.8 “小结 


(®) Fixed run count 
1 


本 


OO One run per data source row 


Browser type: 


Internat Explerer 9.0 “ 


IChrarme 2 


Firefox 2.0 
Firefox 3.0 
Internet Explarer 10.0 


Internet Explorer 11.0 


Imternmet Explorer 3.5 
Internet Explarer 6§,.0 
Internet Explorer 7.0 
Internet Explorer 8.0 


Intaermnet Explerer 9.0 


Netscape .0 


Pocket IE 3.02 


Sohari 3 


Safari for iPhone 
smartphone 


图 28-16 


。 如 果 没 有 企业 版 ， 可 


本 章 介 绍 了 对 测试 应 用 程序 最 重要 的 方面 : 创建 单元 测试 、 编 码 的 UI 测试 和 Web 测试 。 

Visual Studio 提供 了 Test Explorer 来 运行 单元 测试 ， 而 无 论 它 们 是 用 MSTest 还 是 xUnit 创建 的 。 xUnit 的 优 
势 是 支持 NET Core。 本 章 还 介绍 了 3A 动作 : 安排 (Arrange)、 行 动 (Act) 和 断言 (Assert)。 

在 编码 的 全 测试 中 ， 学 习 了 如 何 创 建 记录 ， 改 编 记录 ， 根 据 需 要 修改 所 需 的 UI 测试 代码 。 

在 ASPNET Core Web 应 用 程序 中 ， 介 绍 了 如 何 将 TestHost 类 用 于 集成 测试 ， 本 章 介 绍 了 Visual Studio 


的 Web 负载 和 性 能 测试 。 


测试 有 助 于 在 部 署 应 用 程序 之 前 解决 问题 ， 而 第 29 章 儿 助 解决 正在 运行 的 应 用 程序 的 问题 。 


六 


跟踪 、 日 志和 分 析 


本 章 要 点 

e 用 EventSource 进行 简单 的 跟踪 

e 用 EventSource 进行 高 级 跟 跨 

e 创建 目 定 义 跟踪 侦 听 器 

e 使 用 ILogger 接口 

e 给 Windows 应 用 程序 使 用 Visual Studio App Center 


本 章 源 代 码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Diagnostics 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® SimpleEventSourceSample 
EventSourceSampleInheritance 
EventSourceSampleAnnotations 
ClientApp/MyApplicationEvents 
LogglingsSample 
WimAppAnalytics 


29.1 诊断 概述 


应 用 程序 的 发 布 周 期 变 得 越 来 越 短 ， 了 解 应 用 程序 在 生产 环境 中 运行 时 的 行为 越 来 越 重 要 。 会 发 生 什 么 异 
常 ? 知道 使 用 了 什么 功能 也 是 要 关注 的 。 用 户 找到 应 用 程序 的 新 功能 了 吗 ? 他 们 在 页 面 上 停留 多 长 时 间 ?为 了 
答 这 些 问 题 ， 需 要 应 用 程序 的 实时 信息 。 

获得 应 用 程序 的 信息 时 ， 需 要 区 分 日 志 、 跟 踪 和 分 析 。 对 于 日 志 ， 错 误 信 息 记录 到 集中 的 位 置 上 。 这 些 信 
恩 由 系统 管理 员 用 于 查找 应 用 程序 的 问题 。 跟 踪 有 助 于 找 出 哪个 方法 调用 了 什么 方法 。 这 些 信息 可 用 于 开发 ， 
应 用 程序 在 生产 环境 下 运行 时 ， 应 关闭 它 。 对 于 .NET， 这 个 技术 可 通过 名 称 空间 System.Diagnostics 中 的 类 用 
于 日 志和 跟踪 。 分 析 提 供 了 用 户 的 信息 : 他 们 在 什么 地 方 ， 使 用 的 操作 系统 版 本 是 什么 ， 使 用 了 应 用 程序 中 的 
什么 功能 等 。 这 有 助 于 根据 位 置 、 硬 件 或 操作 系统 ， 确 定 应 用 程序 是 否 有 什么 问题 。 它 还 有 助 于 理解 用 户 当前 
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的 操作 。 如 果 很 难 找到 应 用 程序 的 菜 个 新 功能 ， 用 户 就 可 能 找 不 到 它 。 

本 章 介 绍 如 何 获 得 正在 运行 的 应 用 程序 的 实时 信息 , 找 出 应 用 程序 在 生产 过 程 中 出 现 某 些 问 题 的 原因 ， 
或 者 监视 需要 的 资源 ， 以 确保 适应 较 高 的 用 户 猴 载 。 这 就 是 名 称 空间 System.Diagnostics.Tracing 的 作用 。 这 个 
名 称 空间 提供 了 使 用 Event Tracing for Windows (ETW) 进 行 跟踪 的 类 。 

当然 ， 在 应 用 程序 中 标记 错误 的 一 种 方式 是 抛 出 异 前 。 然 而 ， 有 可 能 应 用 程序 不 抛 出 异 音 ， 但 仍 不 像 期 望 
的 那样 运行 。 应 用 程序 可 能 在 大 多 数 系 统 上 都 运行 良好 ， 只 在 几 个 系统 上 出 问题 。 在 实时 系统 上 ， 可 以 启动 跟 
蹊 收集 器 ， 改 变 日 志 行 为 ， 获 得 应 用 程序 运行 状况 的 详细 实时 信息 。 这 可 以 用 ETW 功能 来 实现 。 

如 果 应 用 程序 出 了 问题 ， 束 需要 通知 系统 管理 员 。 事 件 得 看 器 是 一 个 前 用 的 工具 ， 并 不 是 只 有 系统 管理 员 
才 需 要 使 用 它 ， 软 件 开发 人 员 也 需要 它 。 使 用 事件 查看 器 可 以 交互 地 监视 应 用 程序 的 问题 ， 通 过 添加 订阅 功能 
来 了 解 发 生 的 特定 事件 。ETW 允许 写 入 应 用 程序 的 相关 信息 。 

Application Insights 是 一 个 Microsoft Azure 云 服务 ， 可 以 监视 云 中 的 应 用 程序 。 只 需要 几 行 代码 ,就 可 以 得 
到 如 何 使 用 应 用 程序 或 服务 的 详细 信息 。 

Visual Studio App Center 允许 监控 Windows 和 Xamarin 应 用 程序 。 注 册 了 该 应 用 程序 后 ， 只 需要 几 行 代码 
就 可 以 接收 到 应 用 程序 的 有 用 信息 。 

本 章 解 释 了 这 些 功能 ， 演 示 了 如 何 为 应 用 程序 使 用 它们 。 


29.2 使 用 EventSource 跟踪 


利用 跟踪 功能 可 以 从 正在 运行 的 应 用 程序 中 得 看 消息 。 为 了 获得 关于 正在 运行 的 应 用 程序 的 信息 ， 可 以 在 
调试 器 中 局 动 应 用 程序 。 在 调试 过 程 中 ， 可 以 单 步 执行 应 用 程序 ， 在 特定 的 代码 行 上 设置 断 点 ， 在 满足 某 些 条 
件 时 设置 断 点 。 调 试 的 问题 是 包含 发 布 代码 的 程序 与 包含 调试 代码 的 程序 以 不 同 的 方式 运行 。 例 如 ， 程 序 在 断 
点 处 停止 运行 时 ， 应 用 程序 的 其 他 线程 也 会 挂 起 。 男 外 ， 在 发 布 版 本 中 ， 编 译 嚣 生成 的 输出 进行 了 优化 ， 因 此 
会 产生 不 同 的 效果 。 在 经 过 优化 的 发 布 代码 中 ， 垃 圾 收集 要 比 在 调试 代码 中 更 加 积极 。 方 法 内 的 调用 次 序 可 能 
发 生变 化 ， 甚 至 一 些 方 法 会 被 彻底 删除 ， 改 为 就 地 调用 。 此 时 也 需要 从 程序 的 发 布 版 本 中 获得 运行 时 信息 。 跟 
踩 消 息 要 写 入 调试 代码 和 上 及 布 代码 中 。 

下 面 的 场景 描述 了 跟踪 功能 的 作用 。 在 部 署 应 用 程序 后 ， 它 运行 在 一 个 系统 中 时 没有 问题 ， 而 在 另 一 个 系 
统 上 很 快 出 现 了 问题 。 在 出 问题 的 系统 上 打开 详细 的 跟踪 功能 ， 就 会 获得 应 用 程序 中 所 出 现 问题 的 详细 信息 。 
在 运行 没有 问题 的 系统 上 , 将 跟踪 功能 配置 为 把 错误 消 恩 重 定 同 到 Windows 事件 日 志 系 统 中 。 系 统管 理 员 会 查 
看 重要 的 错误 ， 跟 踩 功能 的 系统 开销 非常 小 ， 因 为 仅 在 需要 时 配置 跟踪 级 别 。 

.NET 中 的 跟踪 有 相当 长 的 历史 。.NET 的 第 一 个 版 本 只 有 简单 的 跟踪 功能 和 Trace 类 ， 而 .NET 2.0 对 跟踪 
进行 了 巨大 的 改进 ， 引 入 了 TraceSource 类 。TraceSource 背后 的 染 构 非常 灵活 ， 分 离 出 了 源 代码 、 侦 听 器 和 一 
个 开关 ， 根 据 一 组 跟踪 级 别 来 打开 和 关闭 跟踪 功能 。 

从 NET 4.5 开始 ， 又 引入 了 一 个 新 的 跟踪 类 EventSource， 并 在 NET 4.6 中 增强 。 这 个 类 在 NuGet 包 
System.Diaenostics 的 System.Diaenostics.Tracing 名 称 空 间 中 定义 。 

新 的 跟踪 架构 基于 Windows Vista 中 引入 的 Event Tracing for Windows(ETW)。 它 允许 在 系统 范围 内 快速 传 
递 消 奶 ，Windows 事件 日 志 记 录 和 性 能 监视 功能 也 使 用 它 。 

下 面 看 看 ETW 跟踪 和 EventSource 类 的 概念 。 

e ETW 提供 程序 是 一 个 触发 ETW 事件 的 库 。 本 章 创 建 的 应 用 程序 是 ETW 提供 程序 。 

es ETW 清单 描述 了 可 以 在 ETW 提供 程序 中 触发 的 事件 。 使 用 预定 义 清单 的 优点 是 ， 只 要 安装 了 应 用 程 

序 ， 系 统管 理 员 就 己 经 知道 应 用 程序 可 以 触发 的 事件 了 了。 这样， 管理 员 就 可 以 配置 特定 事件 的 侦 听 。 
新 版 本 的 EventSource 支持 目 描 述 的 事件 和 清单 描述 的 事件 。 

。 ETW 关键 字 可 以 用 来 创建 事件 的 类 别 。 它 们 定义 为 位 标志 。 

es ETW 任务 是 分 组 事件 的 男 一 种 方式 。 任 务 可 以 基于 程序 的 不 同 场 景 来 创建 ， 以 定义 事件 。 任 务 通 常 和 

操作 码 一 起 使 用 。 
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e ETW 操作 码 识别 任务 中 的 操作 。 任 务 和 操作 码 都 用 整 型 值 定义 。 

e 事件 源 是 触发 事件 的 类 。 可 以 直接 使 用 EventSource 类 ， 或 创建 一 个 派生 自 基 类 EventSource 的 类 。 

se 事件 方法 是 事件 源 中 触发 事件 的 方法 。 派 生 自 EventSource 类 的 每 个 void 方法 ， 如 果 没 有 用 NonEvent 
特性 加 以 标注 ， 就 是 一 个 事件 方法 。 事 件 方 法 可 以 使 用 Event 特性 来 标注 。 

e 事件 级 别 定 义 了 事件 的 严重 性 或 见长 性 。 这 可 以 用 于 区 别 关 键 、 错 误 、 和 警告 、 信 息 和 详细 级 事件 。 

ss ETW 通道 是 事件 的 接收 器 。 事 件 可 以 写 入 通道 和 日 志文 件 。Admin、Operational、Analytic 和 Debusg 是 
预定 义 的 通道 。 

使 用 EventSource 类 时 ， 要 运用 ETW 概念 。 


29.2.1 EventSource 的 简单 用 法 


使 用 EventSource 类 的 示例 代码 利用 如 下 名 称 空间 : 
System 
System.Collections.Generic 
System.D1iaenostics.lracine 
System.IO 
System.Net.Http 
System.Threadine.Tasks 
EventSource 类 提供 了 各 种 使 用 方法 。 有 一 种 简单 的 方法 实例 化 这 个 类 ， 调 用 方法 进行 日 志 记 录 ， 还 有 一 种 
更 高 级 的 方法 把 它 用 作 基 类 。 也 有 一 种 添加 注释 的 方法 。 
使 用 EventSource 的 第 一 个 例子 显示 了 一 个 在 小 型 项 目 中 使 用 的 简单 案例 。 在 Console App(.NET Core) 项 
目 中 ， 将 EventSource 实例 化 为 Program 类 的 一 个 静态 成 员 。 在 构造 函数 中 ， 指 定 了 事件 源 的 名 称 (代码 文件 
SimpleEventSourceSample /Program.cs): 


private static EventSource sampleEventSource = 
new EventSource ("Wrox—EventSourceSamplel™).; 


在 Program 类 的 Main0 方 法 中 , 事件 源 的 唯一 标识 符 使 用 Guid 属性 检索 。 这 个 标识 符 基 于 事件 源 的 名 称 创 
建 。 之后， 编写 第 一 个 事件 ， 调 用 EventSource 的 Wiite 方法 。 所 需 的 参数 是 需要 传递 的 事件 名 。 其 他 参数 可 通 
过 对 象 的 重 载 使 用 。 第 二 个 传递 的 参数 是 定义 Info 属性 的 匿名 对 象 。 它 可 以 把 关于 事件 的 任何 信息 传递 给 事件 
日 志 ( 代 码 文件 SimpleEventSourceSample/Program.cs): 
static async Task Main{) 
Console.WriteLine ($s"Log Guld: {sampleEventSource.Guiqd}").; 
Console.WriteLine($s"Name: {sampleEventSource.Name}").; 
sampleEventSource .Write("Startup", new { Infoe = "started app™" 1}); 
await NetworkRequestsampleAsync(); 
Console.ReadLine (); 
sampleEventSource?.Dispose(); 


} 


注意 : 
不 是 把 带 有 自 定义 数据 的 匿名 对 象 传递 给 Wiite 方法 ， 而 是 可 以 创建 一 个 类 ， 它 派生 自 基 类 EventSource， 
用 EventData 特性 标记 它 。 这 个 特性 在 本 章 后 面 介 绍 。 


在 Main0 方 法 中 调用 的 NetworkRequestSampleAsync0 方 法 发 出 一 个 网 络 请 求 ， 写 入 一 个 跟踪 日 志 ， 把 请 求 
的 URL 发 送 到 跟踪 信息 中 。 完 成 网 络 调用 后 ， 再 次 写 入 跟踪 信息 。 红 背 处 理 代 码 显 示 了 写 和 人 跟踪 信息 的 另 一 
个 方法 重 载 。 不 同 的 重 载 版 本 允许 传递 下 一 节 介 绍 的 特定 信息 。 下 面 的 代码 片段 显示 了 设置 跟 踩 级 别 的 
EventSourceOptions 。 写 入 错误 信息 时 设 定 Error 事件 级 别 。 这 个 级 别 可 以 用 来 过 滤 特 定 的 跟踪 信息 。 在 过 滤 时 ， 
可 以 决定 是 只 读 取 错误 信息 (例如 ， 错 误 级 别 信息 和 比 错 误 级 别 更 重要 的 信息 )。 在 男 一 个 跟 踊 会话 期 间 ， 可 以 
决定 使 用 详细 级 别 读 取 所 有 的 跟 踊 信息 。EventLevel 枚 举 定 义 的 值 有 LogAlways、Critical、Error、Warming、 
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Informational 和 Verbose( 代 码 文件 SimpleEventSourceSample/Program.cs): 
private static async Task NetworkRequestSample() 
{ 


七 工科 
{ 


using (var client = new HttpClient (})) 


string url = "http://www.cninnovation.com"™s 

sampleEventSource .Write("Network", new { Info = S$"requesting {url}"™ }); 
string result = await client.GetSstringAsync (url).; 

sampleEventSource .Write("NMNetwork”™., 


new 
{ 
Infoe = 
$"completed call to {url}, result string length: {result.Length}" 
}); 
} 
Console.WriteLine("Complete......-..-.-.-.-.-.-.-.-.. 二 


catch (Exception ex) 
{ 
sampleEventSource .Write(l"Network Error™, 
new EventSourceOptions { Level = EventLevel .Error }, 
new {1 Message = ex.Message, Result = ex.HResult }).; 
Console.WriteLine (ex.Message).,; 
} 
}} 


在 运行 应 用 程序 之 前 ， 需 要 进行 一 些 准 备 工 作 : 下 载 并 配置 用 于 读 取 跟踪 信息 的 工具 。 下 一 节 将 解释 如 何 
这 样 做 。 


29.2.2 ”跟踪 工 具 


为 了 分 析 跟 踪 信 息 ， 可 以 使 用 几 种 工具 。logman 工具 是 Windows 的 一 部 分 。 使 用 logman， 可 以 创建 和 管 
理事 件 跟踪 会 话 , 把 ETW 跟踪 信息 写 入 二 进 制 日 志文 件 ,tracerpt 也 可 用 于 Windows。 这 个 工具 允许 将 从 logman 
写 入 的 二 进 制 信息 转换 为 CSV、XML 或 EVTX 文件 格式 。PerfView 工具 提供 了 ETW 跟踪 的 图 形 化 信息 。 


1. logman 


下 面 开始 使 用 logman 从 以 前 创建 的 应 用 程序 中 创建 一 个 跟踪 会 话 。 需要 先 局 动 应 用 程序 , 复制 为 应 用 程序 
创建 的 GUID。 需 要 这 个 GUID 和 logman 启动 日 志 会 话 。start 选项 开始 一 个 新 的 会 话 来 进行 记录 。-p 选项 定义 
了 提供 程序 的 名 称 ， 这 里 的 GUID 用 来 确定 提供 程序 。-o 选项 定义 了 输出 文件 ，-ets 选项 直接 把 命令 发 送 给 事 
件 跟踪 系统 ， 不 需要 调度 。 确 保 在 有 写 入 权限 的 目录 中 局 动 logman， 否 则 它 就 不 能 写 入 输出 文件 mytrace.etl: 


loqman start mysession -pp {3b0eiTfaé6-0346-5181-db55-49d84d7103de] 
一 口 mYtrace.etl ~ets 


运行 应 用 程序 之 后 ， 可 以 用 stop 命令 停止 跟踪 会 话 : 


logman stop mysession -ets 


注意 : 

logman 有 更 多 的 命令 , 这 里 不 做 介绍 . 使 用 logman 可 以 看 到 所 有 已 安装 的 ETW 跟踪 提供 程序 、 它 们 的 名 
字 和 标识 符 ， 创 建 数据 收集 器 ， 在 指定 的 时 间 启 动 和 停止 ,定义 最 大 日 志文 件 的 大 小 等 。 使 用 logman - h 可 以 
看 到 logman 的 不 同 选项 。 

2. tracerpt 

日 志文 件 是 二 进 制 格式 。 为 了 得 到 可 读 的 表示 ， 可 以 使 用 实用 工具 tracerpt。 有 了 这 个 实用 工具 ， 指 定 -of 
选项 ， 可 以 提取 CSV、XML 和 EVTX 格式 : 

tracerpt mytrace.etl 一 口 mytrace.xml ~of XML 


现在 ,信息 可 以 用 可 读 的 格式 获得 。 有 了 应 用 程序 记录 的 信息 ， 就 可 以 在 Task 元 素 中 看 到 传递 给 Wiite 方 
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法 的 事件 名 ， 也 可 以 找到 EventData 元 素 内 的 匿名 对 象 : 


<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event"> 
<SVySstem> 
<Provider Name="Wrox—-SimpleEventSourceSample™ 
Guid="{3b0e7Tfaé-0346-5781-db55-49984d7103de}"™ /> 
<EventID>2</EventID> 
<Version>0</Version> 
<Level>5</Level> 
<Task>0</Task> 
<Opcode>0</Opcode> 
<FKeywords>0x0</Eeywords> 
<TimeCreated SystemTime="2017-12-23T10:42:07.960330900+00:59"™ /> 
<Correlation ActivityID="{00000000-0000-0000-0000-000000000000}™ /> 
<Execution ProcessID="12700"™ ThreadID="19340™" ProcessorID="1" 
KernelTime="30"™" UserTime="15" /> 
<Channel /> 
<Computer /> 
</System> 
EVventData> 
<Data Name="Info">started app</Data> 
</EventData> 
<RenderingInfo Culture="en—US"> 
<Task>Sstartup</Task> 


</RenderingInfo> 
</Event> 
错误 信息 与 跟踪 信息 一 起 显示 ， 如 下 所 示 : 
<EventData2 


<Data Name="Message">An error occurred while sending the request.</Data> 
<Data Name="Result">-2146233088</Data> 
</EventData> 


3. PerfView 

读 取 跟踪 信息 的 男 一 个 工具 是 PerfView。 可 以 从 Microsoft 下 载 页 面 (http://www.microsoft.com/downloads 
/details .aspx?id=28567) 上 下 载 这 个 工具 。 这 个 工具 的 1.9 版 本 有 很 大 改进 ， 可 将 它 用 于 Visual Studio 2017 和 
EventSource 中 目 摘 述 的 ETW 格式 。 这 个 工具 不 需要 安装 ， 只 需要 把 它 复制 到 需要 的 地 方 即 可 。 局 动 这 个 工具 
后 , 它 使 用 它 所 在 的 子 目 录 ， 并 允许 直接 打开 二 进 制 ETL 文件 。 图 29-1 显示 了 PerfView 打开 logman 创建 的 文 
件 mytrace.etl。 


EY Events mytrace.etl in SimpleEventSourceSsample (CN\procsharpsourcesydiagnostics\ProfessionaltSshapn\Diagnostics\EventSsourceSsamples\simpleEventSourcesample\mytrace.etl) 口 部 
File Halp Event View Help (ET) Troublesheoting Tips 
UP Startl 0.000 "End 30284.482 “| lazet 10000 本 Find: 
Process Filter -| Text Filter: “ Columns Tn Display: |Cols 
: Mh 
Event Types Filter Histogram; 
WSNT Systemiracer/Eventiracer/PartitionInfoExtensic| Ewart Narme Time MSee Process Narme Rest 
Windows Kernel/EventTlrace Wrox-SimpleEy dd ede Fk | 站 , 百 了 时 . 日 号 百 et 700) 站 2700) [Tt [el 19,340" Info="calli ng i Hie novation,carr" 
| Wrox-SimpleEventSourceSample/Network Wrox-SimpleEventSourcesamep pp Paeaesr12a7D0 71 2 700 | Th re 1 ee ee 


Wrox-SimpleEventdounceSample/startup 


Found 2 Records, 2 total events., Ready Cance 


图 29-1 


29.2.3 派生 自 EventSource 


除了 直接 使 用 EventSource 的 实例 之 外 ， 最 好 在 一 个 地 方 定义 所 有 可 以 追踪 的 信息 。 对 于 许多 应 用 程序 而 
言 ， 定 义 一 个 事件 源 就 足够 了 了。 这 个 事件 源 可 以 在 一 个 单独 的 日 志 程序 集中 定义 。 事 件 源 类 需要 派生 目 基 类 
EventSource。 有 了 这 个 上 自 定 义 类 ， 所 有 应 写 入 的 跟踪 信息 就 可 以 用 独立 的 方法 来 定义 ， 这 些 独立 方法 调用 基 类 
的 WriteEvent 方法 。 类 的 实现 采用 单 例 模 式 ， 提 供 一 个 静态 的 Log 属性 ， 返 回 一 个 实例 。 把 这 个 属性 命名 为 
Log 是 使 用 事件 源 的 一 个 惯例 。 私 有 构造 函数 调用 基 类 的 构造 函数 ， 设 置 事件 源 名 称 (代码 文件 
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EventSourceSampleInhenitance/SampleEventSource.cs): 


public class SampleEventSource : EventSource 
{ 
private SampleEventSourcel() 
: hbase ("WIox-SampleEventSourcez") 1{ } 


Public static SampleEventSource Log = new SampleEventSource().; 
public void Startup() => WriteEvent (1).; 
public void CallSsService (string url) => WriteEvent (2, url); 


public void CalledSsService (string url, int length) => 
WriteEvent(3, url, length).; 


Public void ServiceError(string message, int error) => 
WriteEvent(4, message, error).,; 


} 

事件 源 类 的 所 有 void0 方 法 都 用 来 写 入 事件 信息 。 如 果 定 义 一 个 辅助 方法 ， 就 需要 用 NonEvent 特性 加 以 
标记 。 

在 只 应 写 入 信息 性 消息 的 简单 场景 中 ， 不 需要 其 他 内 容 。 除 了 把 事件 ID 传递 给 跟踪 日 志 之 外 ，WriteEvent 
方法 有 18 个 重 载 版 本 ， 人 允许 传递 消息 string、int 和 1long 值 ， 以 及 任意 数量 的 object。 

在 这 个 实现 代码 中 ， 可 以 使 用 SampleEventSource 类 型 的 成 员 写 入 跟踪 消息 ， 如 Program 类 拷 示 。Main0) 
方法 使 跟踪 日 志 调用 Startup0 方 法 , 调用 NetworkRequestSample0 方 法 , 通过 CallService0 方 法 创建 一 个 跟踪 日 志 ， 
并 使 跟踪 日 志 避 人 免 错误 (代码 文件 EventSourceSampleInheritance/Program.cs): 


Public class Program 
{ 
static async Task Main{) 
{ 
SampleEventSource.Log.Startup (); 
Console.WriteLine($"Log Guid: {SampleEventSource.Log.Guid}"); 
Console.WriteLine($"Name: {SampleEventSource.Log.Name}"); 
awalt NetworkRequestSsampleAsync(); 
Console.ReadLine{().， 


} 


private static async Task NetworkReaquestSampleAsync!() 
{ 
try 
{ 
Var client = new HttpClient () ; 
string url = "http://www.cninnovation.com"™; 
SampleEventSource.Log.CallService (url); 
string result = await client.GetStringAsync (url)}); 
SampleEventSource .Log.CalledSservice (url, result.Length).; 
Console .WriteLine ("Complete.......-...-..-.-..-.. my 
} 
catch (Exception ex) 
{ 
SampleEventSource .Log.ServiceErrorl(lex.Message, ex.HResult). 
Console .WriteLine (ex.Message);} 


} 
} 


用 这 些 命 令 ， 在 项 目 目录 的 开发 命令 提示 符 下 运行 应 用 程序 时 ， 会 产生 一 个 XML 文件 ， 其 中 包含 跟踪 的 


> logman start mysession -p "{lcedea2a-a420-5660-1ff0-f7l1l8b8ea5Sl138}" 
一 口 logz2.etl1 ets 

> dotnet run 

> logman stop mysession -ets 

> tracerpt log2.etl1 一 口 LO 可 -xm ~of XML 


服务 调用 的 事件 信息 如 下 : 


<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event"> 
<System> 


<Provider Name="Wrox—-SampleEventSource2" 
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Guid="{lcedea2a-a420-5660-1ff0-f7l8b8ea5138]}"™ /> 
<EventID>7</EventID> 
<Version>0</Version> 
<Level>A4</Level> 
<Task>0</Task> 
<Opcode>0</oOpcode> 
<Keywords>0xF00000000000</Keywords> 
<TimeCreated SystemTime="2017-12-23T13:32:59.015066500+00:59"™ /> 
<Correlation ActivityID="{00000000-0000-0000-0000-000000000000}™ /> 
<Execution ProcessID="6196" ThreadID="36392™ ProcessorID="0" 
KernelTime="30"™" UserTime="45" /> 
<Channel /> 
<Computer /> 
</Svystem> 
EventData> 
<Data Name="url">http:/ /waw .cninnovation.com</Data> 
</EventData> 
<RenderingInfo Culture="en-US"»> 
<Task>CallService</Task> 
</RenderingInfo> 
</Event> 


29.2.4 ”使 用 注释 和 EventSource 


创建 一 个 派生 于 EventSource 的 事件 源 类 ， 对 跟踪 信息 的 定义 就 有 更 多 的 控制 。 使 用 特性 可 以 给 方法 添加 
注释 。 

默认 情况 下 ， 事 件 源 的 名 字 与 类 名 相同 ， 但 应 用 EventSource 特性 ， 可 以 改变 名 字 和 唯一 标识 符 。 每 个 事 
件 跟踪 方法 都 可 以 附 市 Event 特性 。 在 这 里 可 以 定义 事件 的 也 、 操 作 码 、 跟 踊 级 别 、 目 定义 关键 字 以 及 任务 。 
这 些 信 息 用 来 为 Windows 创建 清单 信息 ， 以 定义 要 记录 的 信息 。 方 法 内 使 用 EventSource 调用 的 基本 方法 
WriteEvent 需要 匹配 Event 特性 定义 的 事件 ID， 传递 给 WriteEvent 方法 的 变量 名 需要 匹配 所 声明 方法 的 参数 
名 称 。 

在 示例 类 SampleEventSource 中 ， 目 定义 关键 字 由 内 部 类 Keywords 定义 。 这 个 类 的 成 员 强 制 转换 为 
EventKeywords 枚 举 类 型 。EventKeywords 是 基于 标识 的 long 类 型 枚 举 ， 仅 定义 高 位 从 42 开始 的 值 。 可 以 使 用 
所 有 的 低位 来 定义 目 定 义 关 键 字 。Keywords 类 为 设置 为 Network、Database、Diagnostics 和 Performance 的 最 低 
四 位 定义 了 值 。 枚 举 EventTask 是 一 个 类 似 的 、 基 于 标识 的 枚 举 。 与 EventKeywords 相反 ，int 足以 用 作 后 备 存 
储 ，EventTask 没有 预定 义 的 值 (只 有 枚 举 值 None = 0 是 预定 义 的 )。 类 似 于 Keywords 类 ，Task 类 为 EventTask 
枚 举 定 义 了 自 定义 任务 (代码 文件 EventSourceSampleAnnotations /SampleEventSource.cs): 


class SampleEventSource : EventSource 
{ 
Public class Keywords 
{ 
Public const EventKeywords Network = (EventKeywords)1; 
Public const EventKeywords Database = (EventReywords)2; 
Public const EventKeywords Diagnostics = (EventKeywords)4; 
Public const EventKeywords Performance = (EventKeywords)8; 
} 


Public class Tasks 

{ 
PUublic const EventTask CreateMenus = (EventTask)1; 
Public const EventTask QueryMenus = (EventTask)2; 


} 
private SampleEventSource() 
{ 
} 


public static SampleEventSource Log = new SampleEventSource (); 


[Event (1, Opcode=EventOpcode.Start, Level=EventLevel .Verbose)] 
Public Vvoid Startup()} => WriteEvent (1) ; 


[Event (2, Opcode=EventOpcode.Info, Keywords=Keywords .Network, 
Level=EventLevel .Verbose, Message="{0}")] 
PUublic Vvoid CallSsService(string url}) => WriteEvent (2, url); 
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[Event (3, Opcode=EventOpcode.Info, Keywords=Keywords .Network, 
Level=EventLevel .Verbose, Message="{0}, length: {1}")] 

Public void CalledService (string url, int length}) => 
WriteEvent (3, url, length).; 


[Event (4, Opcode=EventOpcode.Info, Keywords=Keywords .Network, 
Level=EventLevel .Error, Message="{0} error: {1}")] 

Public void ServiceError{(string message, int error) => 
WriteEvent (4, message, error); 


[Event (5, Opcode=EventOpcode.Info, Task=Tasks .CreateMenus, 
Level=EventLevel .Verbose, Keywords=Keywords .Metwork)})] 
Public void SomeTask() => WriteEvent (51) ; 
} 


编写 这 些 事件 的 Program 类 是 不 变 的 。 这 些 事件 的 信息 现在 可 以 用 于 使 用 侦 听 器 ， 为 特定 的 关键 字 、 特 定 
的 日 志 级 别 或 特定 的 任务 过 滤 事 件 。 


29.2.5 创建 事件 清单 模式 


创建 目 定 义 事件 源 类 的 优点 是 ， 可 以 创建 一 个 清单 ， 掺 述 所 有 的 跟 踊 信息。 使 用 没有 继承 的 EventSource 
类 ， 将 Settings 属性 设置 为 枚 举 EventSourceSettings 的 EtwSelfDescribineEventFormat 值 。 事 件 由 所 调用 的 方法 
直接 描述 。 当 使 用 一 个 继承 自 EventSource 的 类 时 ，Settings 属性 的 值 是 EtwManifestEventFormat。 事 件 信 息 由 
一 个 清单 描述 。 

使 用 EventSource 类 的 静态 方法 GenerateManifest 可 以 创建 清单 文件 。 第 一 个 参数 定义 了 事件 源 的 类 ; 第 二 
个 参数 摘 述 了 包含 事件 源 类 型 的 程序 集 的 路 径 (代码 文件 EventSourceSampleAnnotations/Program.cs): 


Public static void GenerateManifest() 
{ 
string Schema = SampleEventSource.GenerateManifest!( 
typeof (SampleEventSource}, ™.™); 
File.WriteAllText ("sampleeventsource.xml", schema); 


} 


这 是 包含 任务 、 关 键 字 、 事 件 和 事件 消息 模板 的 清单 信息 (代码 文件 EventSourceSampleAnnotations/ 
sampleeventsource.xml): 


<instrumentationManifest 
xmlns="http://schemas.microsoft.com/win/2004/08/events"> 
<instrumentation xmlns:xs="http://Wwww.w3.0rg/2001/xXMLSchema™" 
xmlns:xsi="http://www.w3.o0rg/2001/xXMLSchema-instance" 
xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"> 
<events xmlns="http://schemas.microsoft.com/win/2004/08/events"> 
<provider name="EventSourceSample" 
guid=" {45fff0e2-7198-4e4f-9fc3-df6934680096}" resourceFileName="." 
messageFileName="."™" symbol="EventSourceSample"> 
<tasks> 
<task name="CreateMenus™ message="$ (string.task CreateMenus)" 
value="1"/> 
<task name="QueryMenus" message="$ (string.task QueryMenus)" 
value="2"/> 
<task name="ServiceError" message="$ (string.task ServiceError)" 
value="65530"/> 
<task name="CalledService™" message="$ (string.task Calledservice)™" 
value="65531"/> 
<task name="CallService”" message="5 (string.task CallSsService)}" 
value="65532"/> 
<task name="EventSourceMessage™ 
message="$ (string.task EventSourceMessage)" value="65534"/> 
</tasks> 
<OpPpCoOdes> 
</opcodes> 
<keywords> 
<keyword name="Network" message="$ (string.keyword Network)" 
mask="0x1"/> 
<keyword name="Database" message="5s (string.keyword Database)™" 
mask="0x2"/> 
<keyword name="Diagnostics" message="$ (string.keyword Diagnostics)" 
mask="0x4"/> 
<keyword name="Performance" message="5 (string.keyword Performance)™" 
mask="0x8"/> 
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<keyword name="Session3" message="$ (string.keyword Session3)" 
mask="0x100000000000"/> 
<keyword name="Sessilon2" message="$ (string.keyword Session2)" 
mask="0x200000000000"/> 
<keyword name="Sessionl™" message="$ (string.keyword Sessionl1)" 
mask="0x400000000000"/> 
<keyword name="Session0™" message="$ (string.keyword Session0)" 
mask="0x800000000000"/> 
</keywords> 
<EVEenNnts> 
<event value="0"™ version="0"™ level="win:LogAlways" 
Symbol="EventSourceMessage™" task="EventSourceMessage" 
template="EventSourceMessageArgs"/> 
<event value="1"™" version="0"™ level="win:Verbose™" symbol="Startup™" 
opcode="win:Sstart"/> 
<event value="2™ version="0"™ level="win:Verbose™" symbol="CallService"™ 
message="$ (string.event CallService)™" keywords="Network" 
task="CallService" template="CallServiceArgs"/> 
<event value="3" version="0"™ level="win:Verbose"™ 
symbol="CalledSservice™" message="$ (string.event Calledservice}" 
Keywords="Network" task="CalledService"™ 
template="CalledServiceArgs"/> 
<event value="4" version="0"™ level="win:Error™. symbol="ServiceError™. 
message="$ (string.event ServiceError)™ keywords="Network"™" 
task="ServiceError™" template="ServiceErrorArgs"/> 
<event value="5" version="0"™ level="win:Verbose™ symbol="SomeTask" 
keywords="Network" task="CreateMenus"/> 
</events> 
<templates»> 
<template tid="EventSourceMessageArgs"> 
<data name="message" inType="win:Unicodestring"/> 
</template> 
<template tid="CallServiceArgs"> 
<data name="url" inType="win:Unicodestring"/> 
</template> 
<template tid="CalledServiceArgs"> 
<data name="url" inType="win:Unicodestring"/> 
<data name="length" inType="win:Int32"/> 
</template> 
<template tid="ServiceErrorArgs"> 
<data name="message" inType="win:Unicodestring"/> 
<data name="error™" inType="win:Int32"/> 


</template> 
</templates> 
</provider> 
</events> 
</instrumentation> 
<localization> 
<IESOUICeES CUlture="en—US"> 
<stringTable> 
<string id="event CalledService" value="$1 length: %2"/> 
<string id="event CallService™ value="$1"/> 
<string id="event ServiceError™" value="®] error: 和 2" /> 
<string id="keyword Database" value="Database"/> 
<string id="keyword Diagnostics" value="Diagnostics"/> 
<string id="keyword Network" value="Network"/> 
<string id="keyword Performance™" value="Performance"/> 
<string id="keyword Session0™ value="Session0"/> 
<string id="keyword Session1"” value="Sessionl"/> 
<string id="keyword Session2"” value="Session2"/> 
<string id="keyword Session3" value="Session3"/> 
<string id="task CalledService™" value="CalledService"/> 
<string id="task CallService™" value="CallSsService"/> 
<string id="task CreateMenus" value="CreateMenus"/> 
<string id="task EventSourceMessage" value="EventSourceMessage"/> 
<string id="task QueryMenus" value="QueryMenus"/> 
<string id="task ServiceError™" value="ServiceError"/> 
</stringTable> 
</resources> 
</localization> 


</instrumentationManifest> 

有 了 这 些 元 数据 ， 通 过 系统 注册 它 ， 人 允许 系统 管理 员 过 滤 特 定 的 事件 ， 在 有 事 发 生 时 得 到 通知 。 可 以 用 两 
种 方式 处 理 注册 : 静态 和 动态 。 静 态 注 册 需 要 管理 权限 ， 通 过 wevtutil.exe 命令 行 工 具 注册 。 该 工具 传递 包含 清 
单 的 DLL。EventSource 类 也 提供 了 首选 的 动态 注册 。 这 种 情况 发 生 在 运行 期 间 ， 不 需要 管理 权限 ， 就 可 以 在 
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事件 流 中 返回 清单 ， 或 者 回应 标准 的 ETW 命令 。 


29.2.6 ”使 用 活动 ID 


TraceSource 新 版 本 的 新 特性 可 以 轻松 地 编写 活动 下。 一 旦 运行 多 个 任务 ， 它 就 有 助 于 了 解 哪些 跟踪 消息 
属于 彼此 ， 没 有 仅 基于 时 间 的 跟踪 消息 。 例 如 ， 对 Web 应 用 程序 使 用 跟踪 时 ， 如 果 知 道 哪些 跟踪 消息 属于 一 个 
请 求 ， 就 并 发 处 理 多 个 来 自 客 户 端的 请 求 。 这 样 的 问题 不 仅 会 出 现在 服务 器 上 ， 只 要 运行 多 个 任务 ， 或 者 使 用 
C# async 和 await 关键 字 调 用 异步 方法 ， 这 个 问题 也 会 出 现在 客户 器 应 用 程序 上 。 此 时 应 使 用 不 同 的 任务 。 

当 创建 派生 于 TraceSource 的 类 时 ， 为 了 创建 活动 ID， 只 需要 定义 以 Start 和 Stop 作为 后 级 的 方法 。 

对 于 显示 活动 D 的 示例 ， 创 建 一 个 类 库 (.NET 标准 )。 这 个 库 可 以 在 NET Framework 和 .NET Core 应 用 程 
序 中 使 用 。 

.NET 的 以 前 版 本 不 支持 活动 ID 的 TraceSource 新 功能 。ProcessingStart 和 RequestStart 方法 用 于 局 动 活 
动 ; ProcessingStop 和 RequestStop 停止 活动 (代码 文件 MyApplicationEvents/SampleEventSource): 

public class SampleEventSource : EventSource 

private SampleEventSource () 

: base ("Wrox-SampleEventSource") { } 
public static SampleEventSource Log = new SampleEventSource (); 
public void Processingstart (int x) => WriteEvent (1, x); 
public void Processing(int x) => WriteEvent (2, x); 
Public void ProcessingSstop (int x) => WriteEvent (3, xXx}; 
public void Requeststart() => WriteEvent(4) ; 


public void ReduestStop () => WriteEvent (5); 


} 
编写 事件 的 客 尸 端 应 用 程序 利用 如 下 依赖 项 和 名 称 空间 : 
依赖 项 
MyApplicatonEvents 
名 称 空间 
System 


System.Collections.Generic 
System.Dlaenostics.Tracing 
System.Net.Http 
System.Threadine.Tasks 
ParallelRequestSample 方法 调用 RequestStart 和 RequestStop 方法 来 开始 和 停止 活动 。 在 这 些 调 用 之 间 ， 使 
用 Parallel.For 创建 一 个 并 行 循环 。Parallel 类 通过 调用 第 三 个 参数 的 委托 ,使 用 多 个 任务 并 发 运行 。 这 个 参数 实 
现 为 一 个 lambda 表达 式 ， 来 调用 ProcessTaskAsynec 方法 (代码 文件 ClientApp/Program.cs): 
Ek static void ParallelRequestSample () 


SampleEventSource.Log.Requeststart().; 
Parallel .FoOr{0, 20, asYne KX => 


awalt ProcessTaskAsync (x); 


]} 


SampleEventSource.Log.RedquestSstop(),; 
Console .WriteLine ("Activity complete"™").,; 


} 


注意 : 
Parallel 类 详 见 第 21 章 。 
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方法 ProcessTaskAsync 使 用 ProcessingStart 和 ProcessingStop 写 入 跟踪 信息 。 在 这 里 , 一 个 活动 在 另 一 个 活 
动 内 部 局 动 。 在 分 析 日 志 的 输出 中 ， 活 动 可 以 带 有 层次 结构 (代码 文件 ClientApp/Program.cs): 


private static async Task ProcessTaskAsyncl{(int x) 
{ 

SampleEventSource.Log.ProcessingSstart (x) ; 

var I = new Random(}); 

await Task.Delay(r.Next (500)); 
using (Var client = new HttpClient()) 


{ 
var response = await client.GetAsync ("http:/ /www.bing.com"); 
} 
SampleEventSource.Log.ProcessingStop (x); 
} 


以 前 ， 使 用 PerfView 工具 打开 ETL 日 志文 件 。PerfView 还 可 以 分 析 运 行 着 的 应 用 程序 。 可 以 用 以 下 选项 
运行 PerfView: 


> PerfView /onlyproviders=*Wrox-SampleEventSource collect 


选项 collect 启动 数据 收集 。 使 用 限定 符 /onlyproviders 关闭 内 核 和 CLR 提供 程序 ， 仅 记录 提供 程序 列 出 的 
日 志 消 息 。 使 用 限定 符 -h 显示 可 能 的 选项 和 PerfView 的 限定 符 。 以 这 种 方式 启动 PerfView， 会 立即 开始 数 
据 收 集 ， 直 到 单 击 Stop Collection 按钮 才 停 止 ( 见 图 29-2)。 


2 Collecting data over a user specified interval 


This dialeg give displays options for collecting ETW profile data. The only required fiald the "Command’ field and this is only necessary when Using the ' Run 


图 29-2 


在 启动 跟踪 收集 之 后 运行 应 用 程序 ， 然 后 停止 收集 ， 就 可 以 看 到 生成 的 活动 ID 和 事件 类 型 
Wrox-SampleEventSource/ProcessineStart/Start。 了 ID 允许 有 层次 结构 ， 例 如 // 1/2 带 有 一 个 父 活动 和 一 个 子 活动 。 
每 次 循环 迁 代 , 都 会 看 到 一 个 不 同 的 活动 ID( 见 图 29-3)。 对 于 事件 类 型 Wrox-SampleEventSource/ProcessingStop/ 
Stop， 可 以 看 到 相同 的 活动 D， 因 为 它们 关联 到 同样 的 活动 上 。 

使 用 PerfView， 可 以 在 左边 选择 多 个 事件 类 型 ， 并 添加 一 个 过 滤器 ， 例 如 / /11/4 ， 这 样 就 会 看 到 属于 这 个 
活动 的 所 有 事件 ( 见 图 29-4)。 这 里 可 以 看 到 一 个 活动 DD 可 以 跨 多 个 线程 。 相同 活动 的 开始 和 停止 事件 使 用 不 同 
的 线程 。 


| 国 Events PerfviewData.etl.zip in ClientAhpp (Cprocshampsourcesdiagnostied Professionalt Sharnp DiagnosticesEventsourcesamples" clientApp" Perty ew Data,ed,zip) 


Fie Help Euent View Help [FJ 

Sit 0.000 “E764067 ~ Ia 00 -es 
Process Fiter: =| Text Filter: 

Systbem. Threading. Tasks. TplEventSource/ManiestData * | Evenkt Mame 

Wirwdenws Kermel/EventTrace 

Windows Kemnel/SysConfig/Buildinfo 

Windows Kemel/SysConfig/Opcodel37) Wrax-SampleEventSource/ProcessingStart/Start ThreadiD="11,596" w="5" ActivitylD= "1/1 PelatedActivitylD="/7 /7 

Windews Kemel/SysConfig/SystemPaths 

Windews Kemal/SysConfig/UnknownVolume Wrow-SampleEventSource/ProcessingStart/Start | 50.217.310| Process(34576) (34576) |ThreadID="20,652° x=°0- ActivityID= /71/1/5/ RelatedActivitylDeWt | 

Windows Kermel/SysContig/ volumelapping 


Tirme MMSec Process Mame 
Wrom-SampleEventsource/Processingdtart/ tart| S0217.102| Process(3d5 Te [34576)| Threadib="11,230 x="15" ActivibylD=° /1 /3 RelatedAetivitylD= ”AT 


Wraox-SampleEventsource/Processingdtart/ Sitar | SO223.123| Process(34576) (34576) | ThreediC="36.4767 w="11" ActivityiD=// /1/6 Relotedethityil=" 


WTON- Jam Eveniad CeEr Fioressl stanl .| 
Wraown-SarmpleEventlSource/ProcessingStop stop | 
WratcSsampleEventSourceyReaquestStarystart Wrem-SampleEventSource/ProcessingStart/Start| 50.223.124| Process{34576) (34576) 
Wirom=SampleEventSource/RequestStop/Stop 

， Wras-SampleEventsource/Processingstart/Start Process{3d576) (34578) 


Found a0 Records. 20 total events. 


图 29-3 
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9 Events PerfViewData.etl.zip in ClientApp (C:\procsharpsources\diagnestics\ ProfessionalCsharp7niDiagnestics\EventSourceSamples\Clientapp"PerfViewData.etlzip) I A 
Fle Help Event Views Help Fi Troubleshocting Tips 
[Update| sac: 0.000 -En 71 164067 = I leet 10000 “Eint 

Process Filter “ Ess /Nd ”| Columns To Display. 
Event Types Filter Histogram: 一 一 一 一 一 一 
System. Threading Tasks. TplEwventsourcerhAanitest Data Erent Name Time MSec Process Name Rest | 
id Kemel/EventTrace rar= sa rrple Ev TCR Processl ET 306 Process 二 ThreadID= = 了 3 ED: = ctiwi yD=" “J 起 天 RelatedA et de = 1 A _| | 
Windows hemel/systConfigBuildints W ror-SarrpleEveris ource Procesyir 二 3 | | URATIOR C= clivity ID=" /TT 


Wire KemelSysContig/Opeadel3n) 
Windowrs Kemel/SysConfigrsystembpaths 
Winmdows Kemel/SysConfig/ UnkEnmown Volurme 
Wirndowms Kemel/SyrsCaontia valumel Napping 
Wrow=SampleEventSourcerProcessing Start/ start 
Wrow-SampleE rentSource/Processingstop/ Stop 
Wrow-SampleEventSourcer egqueststart/ Start 
Wraw-SampleE ventSource/Reduet St op top 


CallConmtents: Wrox-SampleEventSource/Processingstart,/Start Ready 1 
Es 
29-4 


29.3 ”创建 自 定义 侦 听 器 


写 入 跟踪 消息 时 ， 我 们 了 解 了 如 何 使 用 工具 ， 如 logman、tracerpt 和 PerfView， 读 取 它 们 。 还 可 以 创建 一 
个 自 定义 的 进程 内 事件 侦 听 器 ， 把 事件 写 入 需要 的 位 置 。 

创建 自 定 义 事件 侦 听 器 时 , 需要 创建 一 个 派生 自 基 类 EventListener 的 类 。 为 此 , 只 需要 重 写 OnEventWritten 
方法 。 在 这 个 方法 中 ， 把 跟踪 消息 传递 给 类 型 EventWirittenEventArgs 的 参数 。 这 个 样 例 的 实现 代码 发 送 事件 的 
信息 ， 包 括 有 效 载 荷 ， 这 是 传递 给 EventSource 的 WriteEvent 方法 的 额外 数据 (代码 文件 ClientApp/ 
MyEventListener.cs): 


Public class MyEventListener : EventListener 
{ 
protected override void OnEventSourceCreated (EventSource eventSource) 
{ 
Console.WriteLine($"created {eventSource.Name} feventSource.Guld}"™).; 


} 


Protected override woid OnEventWritten (EventWrittenEventArgs eventData) 
{ 
Console.WriteLine($"event id: {eventData.EventId} source: 
s™" {feventData .EventSource.Name}"™); 
foreach (Var payload in eventData.Payload) 
{ 
Console .WriteLine($"™\t{payload}™}); 
} 
} 
} 


侦 听 器 在 Program 类 的 Main0 方 法 中 激活 。 通 过 调用 EventSource 类 的 静态 方法 GetSources, 可 以 访问 事件 源 。 

InitListener0 方 法 调用 自 定 义 侦 听 器 的 EnableEvents0 方 法 ， 并 传递 每 个 事件 源 。 示 例 代 码 注册 
EventLevelLogAlways 设置 ， 来 侦 听 写 入 的 每 个 日 志 消 上 足 。 还 可 以 指定 只 写 入 信息 性 消息 ， 其 中 还 包括 错误 ， 
或 只 写 入 错误 。 


private static void InitListener (IEnumerable<EventSource> sources) 


WR 十 


{ 
listener = new MyEventListener(); 
foreach (var SoOurce in sources) 
{ 
listener.EnableEvents (source, EventLevel .LogAlways); 
} 
} 


运行 应 用 程序 时 , 会 看 到 FrameworkEventSource 和 “WroxSampleEventSource 的 事件 写 入 控制 台 。 使 用 像 这 
样 的 自 定义 事件 侦 听 器 , 可 以 轻松 地 将 事件 写 入 Application Insights, 这 是 一 个 基于 云 的 遥测 服务 , 参见 下 一 节 。 


第 29 章 跟踪 、 日 志和 分 析 | 715 


29.4 使 用 ILogger 接口 编写 日 志 


多 年 来 ， NET 中 有 几 种 不 同 的 日 志 记 录 和 跟踪 工具 ， 还 有 许多 不 同 的 第 三 方 日 志 记 录 程 序 。 莹 试 将 一 个 应 
用 程序 从 一 种 日 志 记 录 技 术 更 改 为 另 一 种 日 志 记 录 技 术 不 是 一 件 容 易 的 事情 ， 因 为 日 志 记 录 API 的 使 用 分 布 在 
整个 源 代码 中 。 要 使 日 志 记 录 独 立 于 任何 日 志 记 录 技 术 ， 可 以 使 用 接口 。 

.NET Core 在 NuGet 包 Microsoft.Extensions.Logeging 中 般 入 了 泛 型 Iogger 接口 。 这 个 接口 定义 了 Log 方法。 
Log 方法 定义 了 参数 ， 来 指定 LogLevel( 枚 举 值 )、 事 件 ID( 使 用 结构 Eventd 趾 、 泛 型 状态 信息 、 记 录 异 篆 信 息 的 
Exception 类 型 ， 以 及 用 字符 串 确定 输出 格式 的 格式 化 程序 ， 


VOLIQ Log<TState> (LogLevel logLevel, EventId eventide, TState Satte ， 
Exception exception, Func<TState, Exception, string> formatter); 


除了 Log 方法 之 外 ，ILogger 接口 还 定义 了 IsEnabled 方法 ， 以 基于 LogLevel 检查 日 志 记 录 是 否 启用 ， 该 接 
口 也 定义 了 方法 BeginScope， 为 日 志 记 录 返 回 可 释放 的 作用 域 。ILogger 接口 中 的 成 员 实 际 上 是 日 志 记 录 所 需 
的 全 部 。Log 方法 有 许多 需要 填充 的 参数 。 为 了 简化 日 志 记 录 ， 在 LoggerExtensions 类 中 定义 了 ILogger 接口 的 
扩展 方法 ,扩展 方法 ,例如 LogDebug、LogTrace、LogInformation、LogWarning、LogError、LoegCritical 和 BeginScope 
都 有 几 个 重 载 版 本 和 易于 使 用 的 参数 。 

下 面 利用 依赖 注入 ， 并 使 用 包含 的 类 SampleController 作为 一 个 泛 型 参数 ， 注 入 ILogger 接口 。 泛 型 参数 定 
义 了 日 志 记 录 嚣 的 类 别 。 在 泛 型 参数 中 ， 类 别 是 由 类 名 组 成 的 ， 包 括 名 称 空 间 ( 代 码 文 件 
LoggingSample/SampleController.cs): 


class SampleController 

{ 
private readonly ILogger<SampleController> logger; 
Public SampleController(ILogger<SampleController> logger) 


_logger = logger; 
} 


a 
} 


在 29.4.3 节 “ 过 滤 ” 中 ， 说 明了 如 何 使 用 类 别名 来 过 滤 日 志 。 


注意 : 
依赖 注入 详 见 第 20 章 。 


日 志 示 例 使 用 了 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Microsott.Extensions.DependencyInjection 
Microsotft.Extensions.Logeing 
Microsott.Extensions.Logeing.Contieuration 
Microsott.Extensions.Logeing.Console 
Microsoft.Extensions.Logeing.Debug 
Microsotft.Extensions.Logeing.EventSource 
Microsoft.Extensions.Logeing.Filter 
名 称 空间 
Microsott.Extensions.DependencyInjection 
Microsotft.Extensions.Logeing 
Microsott.Extensions.Logeing.Console 
System 
System.Net.Http 
System.Threadine.Tasks 


716 | 第 中部 分 .NET Core 与 Windows Runtime 


ILogger 接口 可 以 简单 地 用 于 调用 扩展 方法 ， 如 LogInformation: 

logger.LogInformation ("NetworkRequestSample started"); 

扩展 方法 提供 重 载 版 本 ， 来 传递 额外 的 参数 、 异 党 信息 和 事件 ID。 为 了 使 用 事件 也， 应 用 程序 定义 了 一 
个 常量 值 列表 (代码 文件 LoggingSample/LoggingEvents.cs): 

class LoggingEvents 

De const int Injection = 2000; 


public const int Networking = 2002; 
} 


接 下 来 ， 使 用 LogInformation 和 LogError 扩展 方法 显示 NetworkRequestSampleAsync 方法 的 开头 、 结 束 时 
间 以 及 抛 出 异常 时 的 错误 信息 (代码 文件 LoggingSample/SampleController.cs): 


Public async Task NetworkRequestSampleAsync (string url) 
{ 
try 
{ 
_logger.Loglnformation(LoggingEvents .Networking, 
"NetworkRequestSampleAsync started with url {0}", url).; 
Var client = new HttpClient (1) ; 


string result = await client.GetSstringAsync (url); 
_logger.Loglnformation(LoggingEvents .Networking, 
"MetworkRequestSampleAsync completed, received {0} characters", 
result.Length)， 
} 
catch (Exception ex) 
{ 
_logger.LogError (LoggingEvents.Networking, ex, 
"Error in NetworkRequestSampleAsync, error message: {0}, HResult: {1}", 
ex.Message, ex.HResult).; 
} 
} 


注意 : 

ILogger 扩展 方法 的 一 个 重 载 版 本 需要 给 第 一 个 参数 使 用 EventId。 在 示例 代码 中 ,传递 一 个 int。 这 是 可 能 
的 ， 因 为 EventId 结构 实现 了 一 个 隐 式 运算 符 ， 来 将 int 转换 为 EventId。 操 作 符 重 载 在 第 6 章 中 讨论 。 

将 消息 传递 给 LogXX 方法 时 ， 可 以 提供 任何 数量 的 对 象 ， 并 将 其 放 入 格式 消息 字符 串 中 。 此 格式 字符 串 
使 用 位 置 参 数 传 入 以 下 对 象 。 不 能 使 用 可 格式 化 的 字符 串 ， 因 为 格式 字符 串通 常 来 自 允 许 这些 消 息 本 地 化 的 资 
源 。 本 地 化 在 第 27 章 中 讨论 。 


接 下 来 ， 需 要 配置 日 志 提 供 程序 ， 以 使 日 志 信 息 可 用 。 


29.4.1 配置 提供 程序 


需要 使 用 ILoggingBuilder 定义 配置 日 志 的 位 置 。 为 IServiceCollection 调用 AddLogging 扩展 方法 (这 个 方法 
的 一 个 重 载 版 本 接受 Action<ILoggingBuilder> 参 数 ) 时 ， 可 以 配置 ILoggingBuilder。 使 用 ILoggingBuilder 时 ， 可 
以 添加 提供 程序 。 示 例 代 码 为 控制 台 添 加 提供 程序 ， 调 试 (在 Visual Studio 的 Output 窗口 中 显示 )， 并 添加 事件 
源 代码 (代码 文件 LoggingSample/Program.cs): 


static void RegisterServices () 


{ 
VAI SEIVICeES = New ServiceCollection().; 
Services.AddLogging (buijlder 三 > 
{ 
builder.AddEventSourceLogger (1) ; 
builder.AddcCconsole():; 
#if DEBUG 
builder.AddDebug (); 
#endif 
zy 
}); 


Services.Addscoped<SampleController>(); 
AppServices = services.BuildSserviceProvider () ，; 
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} 

Public static IServiceProvider AppServices { get; private set; } 

示例 应 用 程序 的 Main0 方 法 调用 RegisterServices 方法 ， 在 依赖 注入 容器 中 注册 服务 ， 然 后 调用 
RunSampleAsync0 方 法 (代码 文件 LoggingSample/Program.cs): 


private static string s url = "https://csharp.christiannagel .com"; 
static async Task Main(string[] args) 
{ 
if (args.Length == 1) 
{ 
s url = args[0]; 
} 
RegisterServices(); 
await RunsampleAsvync(); 
Console.ReadLine{():; 


} 


static async Task RunSampleAsync{() 
{ 


var Controller = AppServices.GetService<SampleController> (); 
awalit controller.NetworkRequestSampleAsync(s url); 


| 
成 功 运行 应 用 程序 时 ， 可 以 在 控制 台 输 出 中 看 到 这 些 信息 日 志 : 


info: LoggingSample.sSampleController[2002] 

NetworkRequestSampleAsync started with url https://csharp.christiannagel .com 
info: LoggingSample.SsSampleController[2002] 

NetworkRequestSampleAsync completed, received 76318 characters 


传递 无 效 的 主机 名 ， 会 显示 如 下 错误 信息 : 


info: LoggingSample.SsSampleController[2002] 

NetworkRequestSampleAsync started with url https://csharp.christiannagell .com 
fail: LoggingSample.SampleController[2002] 

Error in NetworkRequestSampleAsync, error message: An error occurred 

while sending the regquest., HResult: -2147012889 


29.4.2 ”使 用 作用 域 


使 用 作用 域 ， 可 以 将 属于 输出 的 日 志 信 息 组 合 在 一 起 。 

调用 BeginScope 方法 ， 并 将 消息 传递 给 作用 域 ， 可 以 定义 作用 域 。 该 消息 显示 在 输出 中 ， 并 显示 作用 域内 
定义 的 每 个 日 志 消 息 。BeginScope 返回 一 个 IDisposable 对 象 。 调 用 Dispose 方法 (在 代码 示例 中 使 用 using 语句 
完成 ) 结 束 作 用 域 (代码 文件 LoggingScopeSample/SampleController.cs): 


Public async Task NetworkRequestSampleAsync (string url) 
{ 
using ( logger.BeginScope ("NetworkRequestSampleAsynce, url: {0}", url)) 
{ 
try 
{ 
logger.LogInformation (LoggingEvents .Networking, "Started"); 
var Client = new HttpClient (); 


string result = awalt client.GetStringAsync (url); 
logger.LogInformation (LoggingEvents .Networking., 
"Comleted with characters {0} received", result.Length); 
} 
catch (Exception ex) 
{ 
logger .LogError (LoggingEvents.Networking, ex, 
TEIror, error message: {10}, HResult: {1}", ex.Message, ex.HResult); 
} 
} 
} 


对 于 提供 程序 , 需要 启用 作用 域 来 显示 它 。 可 以 更 改 AddConsole 方法 的 配置 , 来 设置 IncludeScopes 属性 ( 代 
码 文 件 LoggingScopeSample/Program_.cs): 


static void RegisterServices!() 


| 
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Var SEIVIiCes = New ServiceCollection(); 
services.AddLogging (builder 三 > 
{ 


builder.AddEventSourceLogger (); 
builder.AddConsole (options 三 > optiocons.IncludeScopes = true).; 
builder.AddDebug () ; 


1); 

Services.Addscoped<SampleController>(); 

AppServices = services.BuilldSsServiceProvider (); 
} 


现在 运行 应 用 程序 时 ， 可 以 看 到 在 => 之 后 传递 给 作用 域 的 信息 ， 如 以 下 代码 片段 所 示 : 


info: LoggingScopeSample.SampleController[2002] 
=> NetworkRequestsampleAsync, url: https://csharp.christiannagel -Com 
started 

info: Logging3ScopesSample.SampleController[2002] 
=> NetworkRequestSampleAsync, url: https://csharp.christiannagel -com 
Completed with characters 76395 received 


29.4.3 过滤 


不 需要 在 任何 时 候 都 查看 所 有 日 志 消息 。 应 用 程序 在 生产 环境 中 运行 时 ， 需 要 注意 错误 和 关键 信息 。 调 试 
应 用 程序 时 ， 可 能 会 改变 配置 ， 为 特定 的 跟踪 源 显 示 跟 踪 消 息 ， 了 解 应 用 程序 中 的 所 有 事情 。 可 以 为 日 志 记 录 
需求 定义 过 滤器 。 

过 滤 可 以 基于 日 志 记 录 器 提供 程序 和 日 志 类 别 。 

下 面 的 代码 片段 为 ConsoleLoggerProvider 和 类 别名 LoggingSample 定义 了 一 个 过 滤器 ， 以 仅 过 滤 日 志 级 别 
为 Error 和 更 高 级 别 的 错误 (代码 文件 LoggingSample/Program cs): 


static void ReglistersServices!{() 
{ 
Var SEIVices = new ServiceCollection().; 
Services.AddLogging (builder => 
{ 
builder.AddEventSourceLogger (}); 
builder.AddCconsole (); 
#if DEBUG 
builder.AddDebug () ; 
#endif 
builder .AddFilter<ConsoleLoggerProvider2> ("LoggingSsample”", LogLewvel .Error); 
ee 


除了 指定 类 别 的 名 称 和 LogLevel 之 外 ， 还 可 以 传递 带 有 类 别 和 LogLevel 参数 的 委托 。 如 果 类 别名 称 包含 
SampleController， 并 且 所 接收 的 LogLevel 至 少 是 mformation， 那 么 下 面 的 代码 片段 将 返回 一 个 过 滤器 值 true。 
对 于 所 有 其 他 类 别 ， 如 果 LogLevel 的 值 至 少 是 Eror， 则 过 滤器 返回 true: 
builder.AddFijlter<ConsoleLoggerProvider>((category, logLevel) => 
{ 
if (category.Ccontains ("SampleController") &é& 
logLevel >= LogLevel.Information) return true; 
else if (logLevel >= LogLevel .Error) return true; 


Eelse return false; 


}) 5 


29.4.4 ”配置 日 忘记 录 


过 小 也 可 以 使 用 配置 文件 来 定义 。 

在 .NET Core 中 ， 可 以 给 配置 文件 使 用 提供 程序 ， 例 如 从 JSON 或 XML 文件 、 环境 变 量 或 命令 行 参数 中 读 
取 配 置 。 只 需要 从 NuGet 包 Microsoft.Extensions.Configuration 中 创建 一 个 ConfigurationBuilder， 并 加 此 构建 器 
添加 提供 程序 。 要 添加 JSON 提供 程序 ， 需 要 调用 扩展 方法 AddJsonFile。 构 建 器 的 Build 方法 返回 一 个 实现 
IConfiguration 的 对 象 。 可 以 使 用 此 接口 通过 任何 己 配 置 的 提供 程序 来 访问 己 配 置 值 。 下 面 的 示例 代码 从 配置 中 
检索 Logging 部 分 ， 并 将 其 传递 给 RegisterServices 方法 (代码 文件 LoggingeConfigurationSample/Proeram.cs): 


Var ConfigurationBuilder = new ConfigurationBuilder () ，; 
configurationBuilder.AddJsonFile ("appsettings.]j]son"); 
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IConfiguration configuration = Conflgurat1IionBulIlader-Bulla() : 
ReglsterServices (configuration); 


示例 应 用 程序 的 配置 文件 根据 提供 程序 和 类 别 配 置 不 同 的 配置 值 。 对 于 Debug 提供 程序 ，LogLevel 设置 为 
Information。 这 样 ， 对 于 所 有 类 别 ，Information 及 以 上 级 别 都 记录 到 Visual Studio 的 Output 窗口 。 对 于 Console 
提供 程序 ，LogLevel 根据 类 别 的 不 同 而 不 同 。 在 Console 提供 程序 的 配置 之 下 ， 所 有 其 他 提供 程序 的 默认 配置 
都 是 基于 类 别 用 特定 的 日 志 级 别 定 义 (配置 文件 LoggingConfigurationSample/appsettings.json): 


{ 
"Logging": { 
"Debug™": 1{ 
"LogLevel™": "Information™ 
} ， 
"Console™: 1 
"LogLevel™: 1{ 
"LoggingConfigurationSample.SampleController™".: “Information™, 
"Default™: "Warning™ 
} 
} ， 
"LogLevel™: 1{ 
"Default™": "Warning™., 
"System™": "Information™, 
"LoggingCconfigurationSample.SampleController™": "Warning™ 
} 
} 
} 


在 日 志 配 置 就 绪 后 , 现在 调用 AddConfiguration 方法 , 以 传递 对 IConfiguration 对 象 的 引用 .AddConfiguration 
方法 需要 配置 文件 中 Logging 部 分 的 内 容 (代码 文件 LoggingConfigurationSample/Program.cs): 


static void RegilsterServices(IConfiguration configuration) 


{ 
VAaAIL SEIVIices = Nnew ServiceCollection():; 
services.AddLogging (builder => 
{ 


builder.AddConfiguration(configuration.GetSection("Logging")) 
-LddConsole(); 


#if DEBUG 
builder.AddDebug (); 
#endif 
Hs 
Services.Addscoped<SampleController>(); 
AppServices = services.BuildServiceProvider(); 
} 


不 需要 更 改 任何 代码 ， 现 在 可 以 灵活 地 定义 日 志 配 置 。 


注意 : 
Microsoft.Extensions.Configuration 的 体系 结构 和 使 用 不 同 的 配置 提供 程序 详 见 第 30 章 。 


29.4.5 ”使 用 没有 依赖 注入 的 ILogger 


依赖 注入 有 很 大 的 优势 。 但 是 , 也 可 以 使 用 没有 依赖 注入 的 日 志 记 录 API。 为 此 , 只 需要 创建 一 个 LoggerFactory， 
并 使 用 CreateLogger 方法 创建 一 个 日 志 记录 器 。 配 置 提供 程序 可 以 添加 到 logger 工厂 一 一 类 似 于 为 ILoggingBuilder 
接口 提供 扩展 方法 ， 也 提供 了 ILoggerFactory 的 扩展 方法 (代码 文件 LoggingWithoutDLProgram.cs): 

Var loggerFactory = new 工 D 可 GeITECtOITYT) 7 

loggerFactory.AddConsole(}) .AddDebug (}; 


ILOGger<Program> logger = loggerFactory.CreateLogger<Program> (}; 
logger.LogInformation("Info Message"™").; 
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29.5 ”使 用 Visual Studio App Center 进行 分 析 


Visual Studio App Center (https://appcenter.ms) 是 微软 开发 Windows 和 移动 应 用 程序 、 回 beta 测试 人 员 分 发 
应 用 程序 、 测 试 应 用 程序 、 扩 展 珊 有 推送 通知 的 应 用 程序 以 及 获得 应 用 程序 的 用 户 分 析 的 人 入口。 

可 以 得 到 用 户 关 于 应 用 程序 问题 的 报告 ， 例 如 ， 可 以 找 出 异常 ， 也 可 以 找到 用 户 在 应 用 程序 中 正在 使 用 的 
特性 。 例 如 ， 假 设 给 应 用 程序 添加 一 个 新 特性 ， 用 户 会 找到 激活 该 特性 的 按钮 吗 ? 

使 用 Application Insights， 很 容易 识别 用 户 使 用 应 用 程序 时 遇 到 的 问题 。 所 以 ， 微 软 很 容易 集成 Application 


Insights 和 各 种 各 样 的 应 用 程序 。 
注意 : 


这 里 有 一 些 特性 示例 , 用 户 很 难 在 微软 自己 的 产品 中 找到 它们 。 Xbox 是 第 一 个 为 用 户 界 面 提供 大 磁 贴 的 设 
备 。 搜 索 特 性 放 在 磁 贴 的 下 面 。 虽 然 这 个 按钮 可 以 直接 显示 在 用 户 面 前 ， 但 用 户 看 不 到 它 。 微 软 把 搜索 功能 移 
动 到 磁 贴 内 ， 现 在 用 户 可 以 找到 它 。 

另 一 个 例子 是 Windows Phone 上 的 物理 搜索 按钮 。 这 个 按钮 用 于 应 用 程序 内 的 搜索 。 用 户 抱 奶 ， 没 有 在 电 
子 邮 件 内 搜索 的 选项 ， 因 为 他 们 不 认为 这 个 物理 按钮 可 以 搜索 电子 邮件 。 微 软 改变 了 功能 。 现 在 物理 搜索 按钮 
只 用 于 在 网 上 搜索 内 容 ， 邮 件 应 用 程序 有 自己 的 搜索 按钮 。 

Windows 8 有 一 个 相似 的 搜索 问题 用 户 不 使 用 功能 区 中 的 搜索 功能 ， 在 应 用 程序 内 搜索 。Windows 8.1 
改变 了 指南 ， 使 用 功能 区 中 的 搜索 功能 ， 现 在 应 用 程序 包含 自己 的 搜索 框 ; 在 Windows 10 中 还 有 一 个 自动 显 
示 框 。 看 起 来 有 一 些 共 性 ? 


要 启用 app 分 析 , 首先 需要 注册 Visual Studio App Center。 不 要 担心 成 本 过 高 一 一 月 溃 报告 和 分 析 是 免费 的 
(在 本 文 撰写 时 )。 接 下 来 ， 需 要 创建 一 个 应 用 程序 ， 并 从 Web 门户 中 复制 App Secret。 然 后 可 以 用 Visual Studio 
创建 一 个 新 的 Blank App (Universal Windows)。 要 局 用 分 析 , 给 项 目 添加 NuGet 包 Microsoft.AppCenter.Analytics。 

只 需要 使 用 几 个 API 调用 ， 就 可 以 发 现 用 户 的 问题 。 在 App 类 的 构造 函数 中 ， 添 加 AppCenter.Start， 并 添 
加 先前 复制 的 App Secret。 要 局 用 Analytics， 需 要 将 Analytics 对 象 的 类 型 作为 第 二 个 参数 传递 给 Start 方法 ( 代 
人 码 廊 件 WinAppAnalytics/App.Xam.cs): 


public App() 
{ 


this.InitializeComponent (); 
this.Suspending += Onsuspending; 


LAppCenter.Start("S84df09c4-d560-4c46-ad4f-asS24c3abbilf", typeof (Mnalytics)).; 
} 


注意 : 
请 记 住 在 Visual Studio App Center 的 应 用 程序 配置 中 ， 把 App Secret 添加 到 Application .Start 方法 中 。 


现在 运行 应 用 程序 ， 就 会 看 到 用 户 信息 ， 用 户 月 动 应 用 程序 的 时 间 、 位 置 以 及 来 目 用 户 的 设备 。 
要 从 用 户 获得 更 多 信息 ， 需 要 创建 对 Analytics.TrackEvent 的 调用 。 应 用 程序 中 所 有 可 能 的 事件 都 定义 在 类 
EventNames 中 (代码 文件 WinAppAnalytics/EventNames.cs): 
Public class EventNames 
public const string Buttonclicked = nameof (ButtonCclicked); 
public const string PageNavigation = nameof (PageNavigation); 


public const string CreateMenu = nameof (CreateMenu); 


} 

示例 应 用 程序 包含 一 些 控件 ， 用 于 局 用 / 蔡 用 分 析 、 输 入 一 些 文本 并 单 击 按钮 ( 见 图 29-5)。 激 活 MainPage 
时 ， 将 收集 事件 。TrackEvent 方法 需要 事件 名 的 字符 串 ， 该 字符 串 取 目 EventNames 类 。 这 个 事件 的 名 称 不 是 没 
有 把 类 名 作为 前 缀 ， 因 为 用 using static 声明 来 导入 该 类 的 成 员 。TrackEvent 方法 的 第 二 个 参数 是 可 选 的 。 在 这 
里 ， 可 以 传递 字符 串 的 一 个 字典 来 跟踪 其 他 信息 。 在 示例 代码 中 ， 当 寻 航 到 页 面 时 ，PageNavigation 事件 包含 
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关于 导航 到 的 页 面 类 型 的 信息 (代码 文件 WinAppAnalytics/MainPage.xaml.cs): 
protected override void OnNavigatedTo (NavigationEventArgs e) 
base .OnNavigatedTo (e}).; 
Analvytics.TrackEvent (PageNavigation, 
new Dictionary<string, string> { ["PFage"] = nameof (MainPage) }).; 
} 


WinAppAnalytics 


Allow Analytics 


| | 


Send Event 


图 29-5 


通过 单 击 按钮 ，TrackEvent 可 以 跟踪 ButtonClick 事件 ， 用 户 在 TextBox 控件 中 输入 的 信息 如 下 : 


private void OnButtoncClick (object sender, RoutedEventArgs e) 
{ 
Analvytics.TrackEvent (ButtonClicked, 
new Dictionary<string, string> { ["State"] = textState.Text }); 


} 
用 户 在 应 用 程序 中 漫游 时 ， 可 能 不 允许 收集 信息 ， 因 此 可 以 创建 一 个 用 户 可 以 用 来 己 用 和 禁用 该 功能 的 设 
置 。 如 果 设 置 了 Analyvtics.SetEnabledAsync(false)， 那 么 Analytics API 将 不 再 报告 数据 : 

private async void Onanalvticschanged (object sender, RoutedEventArgs e) 

if (sender is CheckBox checkbox) 

bool ischecked = checkbox?.IsChecked 2?? true; 

, await Analytics.SetEnabledAsync (isChecked) ; 
) 
Visual Studio App Center 在 分 析 方 面 有 一 些 限 制 ， 如 下 所 示 : 
e 只 能 有 200 个 或 更 少 的 事件 名 称 。 
es 事件 名 限制 在 256 个 字符 以 内 。 
e 字典 只 能 包含 5 个 或 更 少 的 属性 。 
e 事件 属性 名 称 和 事件 属性 值 限制 在 64 个 字符 内 。 


注意 : 
撰写 本 书 时 有 这 些 限 制 。 它 们 可 能 在 未 来 的 版 本 中 改变 。 


运行 应 用 程序 ， 并 监视 Visual Studio App Center 门户 时 ， 可 以 看 到 发 生 的 事件 和 受 影 啊 的 用 户 数 量 (参见 图 
29-6)。 单 击 事件 时 ， 可 以 看 到 事件 计数 、 每 个 会 话 的 事件 以 及 传递 的 字典 属性 的 详细 信息 。 还 可 以 看 到 实时 事 
件 日 志 流 ， 如 图 29-7 所 示 。 


722 | 第 中 部 分 .NET Core 与 Windows Runtime 


r= 出 Events . ProCSharp .AP 站 | 十 ~w 


一 OO 占 appcenter,ms/ Usersdl el-waqp Frocsharp : 次 = ££ 


TIME 


Events Last 30 days ™ 


EVENTS 


Buttent licked 


PageNavigation 


29-6 


加 坦 秽 Legflew:procsharp-£: 区 | 十 富 


: 名 站 ps-//appcentar.ms/Users 
Log flow 


88bs98 EVENT - ButtonClicked =- {" state™ :Hello, App!™} 
S508 EVENT - Buttontlicked - {"state”:"Hello, App!"} 
era38bsg8 EVENT = Buttonclicked =- {"state” :" Message From the Mpp” } 
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除了 这 些 信 息 之 外 ，Visual Studio App Center Analytics 还 提供 了 以 下 信息 : 
活跃 用 户 的 数量 

每 个 用 户 每 天 的 会 话 

会 话 持 续 时 间 

顶尖 设备 

使 用 的 OS 版 本 


“五 二 
TD 百 


29.6 小结 


本 章 介 绍 了 跟踪 和 日 志 功 能 ， 它 们 有 助 于 找 出 应 用 程序 中 的 问题 。 应 尽早 规划 ， 把 这 些 功能 内 置 于 应 用 程 
序 中 。 这 可 以 避免 以 后 的 许多 故障 排除 问题 。 

使 用 跟踪 功能 ， 可 以 把 调试 消息 写 入 应 用 程序 ， 也 可 以 用 于 最 终 发 布 的 产品 。 如 果 出 了 问题 ， 就 可 以 修改 
配置 值 ， 从 而 打开 跟踪 功能 ， 并 找 出 问题 。 


第 29 章 跟踪、 日 志和 分 析 | 723 


对 于 Visual Studio App Center Analytics， 使 用 这 个 云 服务 时 ， 有 很 多 开 箱 即 用 的 特性 可 用 。 只 用 几 行 代码 ， 
很 容易 获得 用 户 的 信息 。 如 果 添 加 更 多 代码 ， 可 以 找到 用 户 是 否 因为 找 不 到 使 用 应 用 程序 的 一 些 特性 而 没有 使 
用 它们 。 

这 是 本 书 第 工 部 分 的 最 后 一 章 。 下 一 部 分 基于 本 部 分 介绍 的 许多 功能 。 下 一 草 开 如 探讨 Web 应 用 程序 和 
服务 。 


II 部 分 
Web 应 用 程序 和 服务 


> 第 30 和 曹 ASPNET Core 
> 第 31 章 ASPNET Core MVC 


> 第 32 章 Web API 


.30. 


ASP.NET Core 


本 章 要 点 

了 解 ASPNET Core 和 Web 技术 
使 用 静态 内 容 

处 理 HITP 请 求 和 响应 

使 用 依赖 注入 和 ASPNET 
定义 简单 的 定制 路 由 
创建 中 间 件 组 件 

使 用 会 话 管理 状态 

读 取 配 置 设 置 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 aspnetcore 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 人 码 包 含 的 示例 文件 是 : 

® Simple Host 

® WebSampleApp 

® CustomConfieuration 


30.1 概述 


在 走 过 15 年 之 后 ，ASPNET Core 完全 重 写 了 ASPNET。 它 的 特色 在 于 采用 模块 化 编程 ， 完 全 开源 ， 是 轻 
量 级 的 ， 最 适合 用 在 云 上 ， 可 用 于 非 微软 平台 。 

完全 重 写 的 ASPNET 有 很 多 优势 ， 但 这 也 意味 着 重 写 基 于 老 版 本 ASPNET 的 现 有 Web 应 用 程序 。 有 必要 
把 现 有 的 Web 应 用 程序 重 写 为 ASPNET Core 版 本 吗 ? 下 面试 着 回答 这 个 问题 。 

ASPNET Web Forms 不 再 是 ASPNET Core 的 一 部 分 。 但 是 ， 在 Web 应 用 程序 中 包括 这 项 技术 并 不 意味 着 
必须 重 写 它们 。 仍 然 可 以 用 完整 框架 维护 用 ASPNET Web Forms 编写 的 旧 应 用 程序 。 在 最 新 版 本 的 NET 
Framework 中 ，ASPNET Web Forms 甚至 有 一 些 增强 ， 如 异步 的 模型 绑 定 。 
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ASPNET 的 变 体 ASPNET MVC 仍然 是 ASPNET Core 的 一 部 分 ， 但 它 不 同 于 .NET Framework 的 旧 框 架 。 
对 ASPNET MVC 和 ASPNET Core MVC 进行 高 级 比较 ， 会 发 现 这 两 个 技术 非常 类 似 。 但 幕后 的 所 有 内 容 都 不 
同 。 把 ASPNET MVC 应 用 程序 转换 为 ASPNET Core MVC， 需 要 对 源 代码 进行 一 些 修改 ， 把 它们 带 到 新 的 应 
用 程序 堆栈 中 。 对 于 一 些 应 用 程序 ， 这 可 能 意味 着 对 名 称 空间 、 类 型 和 一 些 方法 进行 很 小 的 修改 。 如 果 应 用 程 
序 使 用 了 ASPNET MVC 中 的 一 些 高 级 功能 ， 就 必须 进行 更 多 的 工作 ， 把 应 用 程序 迁移 到 新 技术 上 。 

将 ASPNET Web Forms 转换 为 ASPNET Core MVC 可 能 需要 做 很 多 工作 。ASPNET Web Forms 从 开发 人 
员 手 中 抽象 出 了 HTML 和 JavaScript。 使 用 ASPNET Web Forms， 就 没有 必要 了 解 HTML 和 JavaScript。 只 需要 
使 用 服务 器 端 控 件 和 C# 代 码 。 服 务 器 端 控件 返回 HTML 和 JavaScript。 此 编程 模型 类 似 于 旧 的 Windows Forms 
编程 模型 。 使 用 ASPNET MVC， 开 发 人 员 需 要 了 解 HTML 和 JavaScript。ASPNET MVC 基于 模型 -视图 -控制 
器 (MVC) 模 式 , 便于 进行 单元 测试 ,因为 ASPNET Web Forms 和 ASPNET MVC 基于 完全 不 同 的 体系 结构 模式 ， 
所 以 把 ASPNET Web Forms 应 用 程序 迁移 到 ASPNET MVC 是 一 个 艰巨 的 任务 。 承 担 这 个 任务 之 前 ， 应 该 创建 
一 个 清单 ， 列 出 解决 方案 仍 使 用 旧 技 术 的 优 缺 点 ， 并 与 新 技术 的 优 缺 点 进行 比较 。 未 来 很 多 年 仍 可 以 使 用 
ASPNET Web Forms.。 


注意 : 

网 站 http://www.cninnoation.com 最 初 用 ASP.NET Web Forms 创建 。 这 个 用 ASP.NET MVC 早期 版 本 创建 
的 网 站 被 转换 到 这 项 新 技术 堆栈 中 。 因 为 原来 的 网 站 使 用 了 很 多 独立 的 组 件 ， 抽 象 出 了 数据 库 和 服务 代码 ， 所 
以 工作 量 不 大 ， 很 快 就 完成 了 。 可 以 在 ASP.NET MVC 中 直接 使 用 数据 库 和 服务 。 另 一 方面 ， 如 果 使 用 Web 
Forms 控件 而 不 是 使 用 自己 的 控件 访问 数据 库 ， 工 作 量 就 很 大 。 目 前 ， 这 个 Web 应 用 程序 使 用 ASPNET Core 
实现 。 


注意 : 

本 书 不 介绍 旧 技 术 ASPNET Web Forms， 也 不 讨论 ASPNET MVC。 本 书 主要 论述 新 技术 ; 因此 对 于 Web 
应 用 程序 ， 这 些 内 容 基 于 ASPNET Core 和 ASPNET Core MVC。 这 些 技术 应 该 用 于 新 Web 应 用 程序 。 如 果 
需要 维护 旧 应 用 程序 ， 应 该 阅读 本 书 的 旧版 ， 如 《C# 高 级 编程 (第 9 版 ) 一 一 C#5.0 有 & .NET 4.5.1》， 其 中 介绍 了 
ASPNET 4.5、ASPNET Web Forms 4.5 和 ASP.NET MVC 5。 


本 章 介 绍 ASPNET Core 2.0 的 基础 知识 。 第 31 章 解 释 ASPNET Core MVC 的 用 法 ， 这 个 框架 建立 在 
ASPNET Core 的 基础 之 上 。 第 32 章 介 绍 如 何 用 ASPNET Core MVC 创建 Web API。 


30.2 Web 技术 


在 介绍 ASPNET Core 的 基础 知识 之 前 , 本 节 讨 论 创 建 Web 应 用 程序 时 必须 了 解 的 核心 Web 技术 : HTML、 
CSS、JavaScript 和 脚本 库 。 


30.2.1 HTML 


HTML 是 由 Web 浏览 器 解释 的 标记 语言 。 它 定义 的 元 素 显 示 各 种 标题 、 表 格 、 列 表 和 输入 元 素 ， 如 文本 框 
和 组 合 框 。 

2014 年 10 月 以 来 ,HTMILS5S 已 经 成 为 WwW3C 推荐 标准 (http://w3.org/TR/html5), 所 有 主流 浏览 器 都 提供 了 它 。 
在 http://w3.org/TR/html 上 有 一 个 工作 进度 的 列表 。 撰 写本 书 时 ，HTML5.2 上 自 2017 年 12 月 就 有 了 W3C 推荐 。 
有 了 HTMLS 的 特性 ， 束 不 再 需要 一 些 浏览 器 插件 (如 Flash 和 Silverlight) 了 ， 因 为 插件 可 以 执行 的 操作 现在 都 
可 以 直接 使 用 HIML 和 JavaScript 完成 。 当 然 ， 可 能 仍然 需要 Flash 和 Silverlight， 因 为 不 是 所 有 的 网 站 都 转 而 
使 用 新 技术 ， 或 用 户 可 能 仍然 使 用 不 文 持 HIMLS 的 旧 浏 览 器 版 本 。 
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HTMLS 添加 的 新 语义 元 素 可 以 由 搜索 引擎 使 用 ， 更 好 地 分 析 站 点 。canvas 元 率 可 以 动态 使 用 2D 图 形 和 图 
像 ，video 和 audio 元 素 使 object 元 素 过 时 了 。 由 于 最 近 添 加 的 媒体 源 (http://w3c.github.io/media-source)， 自 适应 
流 媒 体 也 由 HTML 提供 ;此 前 这 是 Silverlight 的 一 个 优势 。 

HTMLS 还 为 拖 放 操 作 、 存 储 器 、Web 套 接 字 等 定义 了 JavaScript API。 


30.2.2 CSS 


HTML 定义 了 Web 页 面 的 内 容 ，CSS 定义 了 其 外 观 。 例 如 ， 在 HTML 的 早期 ， 列表 项 标记 -<li> 定 义 列表 元 
素 在 显示 时 是 否 应 带 有 圆 、 圆 盘 或 方 框 。 目 前 ， 这 些 信息 已 从 HTML 中 完全 删除 ， 而 放 在 CSS 中 。 

在 CSS 样式 中 ，HTML 元 素 可 以 使 用 灵活 的 选择 器 来 选择 ， 还 可 以 为 这 些 元 素 定义 样式 。 元 素 可 以 通过 其 
ID 或 名 称 来 选择 ,也 可 以 定义 CSS 类 ， 从 HIML 代码 中 引用 。 在 CSS 的 新 版 本 中 , 可 以 定义 相当 复杂 的 规则 
来 选择 特定 的 HIML 元 素 。 

自 Visual Studio 2017 起 ， 一 些 Web 项 目 模板 使 用 Twitter Bootstrap， 这 是 CSS 和 HTML 约定 的 集合 。 这 就 
易于 采用 不 同 的 外 观 ， 下 载 易 用 的 模板 。 文 档 和 基本 模板 可 参阅 wwwgetbootstrap com。 


30.2.3 JavaScript 和 TypeScript 


并 不 是 所 有 的 平台 和 浏览 器 都 能 使 用 .NET 代码 ， 但 几乎 所 有 的 浏览 器 都 能 理解 JavaScript。 对 JavaScript 
的 一 个 彰 见 误解 是 它 与 Java 相关 。 实 际 上 ， 它 们 只 是 名 称 相 似 ， 因 为 Netscape(JavaScript 的 发 起 者 ) 与 Sun(Sun 
发 明了 Java) 达 成 了 协议 , 允许 在 名 称 中 使 用 Java。 如 今 , 这 两 个 公司 不 再 存在 。Sun 被 Oracle 收购 , 现在 Oracle 
持 有 Java 的 商标 。 

Java 和 JavaScript 有 相同 的 根 (C 编程 语言 )。JavaScript 是 一 种 函数 式 编程 语言 ， 不 是 面 问 对 象 的， 但 它 添 
加 了 面 回 对 象 功能 。 

JavaScript 允许 从 HIML 页 面 访 问 DOM(Document Object Model， 文 档 对 象 模 型 )， 因 此 可 以 在 客户 端 动态 
改 芝 元 素 。 

ECMAScript 是 一 个 标准 ， 它 定义 了 JavaScript 语言 的 当前 和 未 来 功能 。 因 为 其 他 公司 在 其 语言 实现 中 不 允 
许 使 用 Java 这 个 词 ， 所 以 该 标准 的 名 称 是 ECMAScript。Microsoft 的 JavaScript 实现 被 命名 为 JScript。 访 问 
https://tc39.github.io/ecma262/， 可 了 解 JavaScript 语言 的 当前 状态 和 未 来 的 变化 。 

尽管 许多 浏览 髓 不 文 持 最 新 的 ECMAScript 版 本 ， 但 仍然 可 以 编写 ECMAScript 2018 代码 。 不 是 编写 
JavaScript 代码 ， 而 是 可 以 使 用 TypeScript。TypeScript 语法 基于 ECMAScript， 但 是 它 有 一 些 改进 ， 如 强 类 型 
代码 和 注解 。C# 和 TypeScript 有 很 多 相似 的 地 方 。 因 为 TypeScript 编译 器 编译 成 JavaScript， 所 以 TypeScript 
可 以 用 在 需要 JavaScript 的 所 有 地 方 。 有 关 TypeScript 的 更 多 信息 可 访问 http://www.typescriptlang.org。 


30.2.4 脚本 库 


除了 JavaScript 编程 语言 之 外 ， 还 需要 脚本 库 简 化 编程 工作 。 脚 本 库 可 以 与 ASPNET Core 的 服务 器 庙 功能 

e jQuery(http://www.jquery.org) 是 一 个 库 ， 它 抽象 出 了 访问 DOM 元 素 和 响应 事件 时 的 浏览 器 的 差异 。 几 
年 前 ， 这 个 库 应 用 于 几乎 每 个 网 站 。 但 目前 ， 有 了 更 多 的 选项 ，jQuery 不 会 应 用 于 所 有 地 方 了 。 

e Aneular(https://angular.io) 是 Google 中 一 个 基于 MVC 模式 的 库 ， 用 单 页 面 的 Web 应 用 程序 简化 了 开发 
和 测试 (与 ASPNET MVC 不 同 ，Angular 提供 了 MVC 模式 与 客户 端 代码 )。 

e React (https://reactjs.org) 是 来 自 Facebook 的 一 个 库 , 提供 的 功能 便于 在 数据 改变 时 在 后 台 更 新 用 户 界 面 。 

用 于 Visual Studio 的 ASPNET Core 2.0 项 目 模板 包括 Angular 和 React。 Visual Studio 2017 支持 智能 感知 和 

对 JavaScript 代码 的 调试 。 
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注意 : 

本 书 未 涉及 指定 Web 应 用 程序 的 样式 和 编写 JavaScript 代码 。 关 于 HTML 和 样式 ， 可 以 参阅 John Duckett 
编著 的 《HTML & CSS 设计 与 构建 网 站 》(John Wiley & Sons, 2011); 进而 阅读 Jeremy McPeak 编著 的 Beginnine 
JavaScript, Fifih Edition(WIrox, 2015), 


30.3 ASP.NET Web 项 目 


首先 创建 一 个 空 的 ASPNET Core 2.0 Web 应 用 程序 。 第 一 个 应 用 程序 是 一 个 简单 的 主机 ， 它 只 响应 请 求 。 
从 一 个 新 的 ASPNET Core Web 应 用 程序 开始 ， 并 选择 空 模板 (参见 图 30-1)。 但 是 对 于 第 一 个 示例 ， 衬 模板 空 得 
还 不 够 。 从 模板 中 删除 Startup.cs 文件 和 wwwroot 目录 。 

Main() 方 法 简化 为 调用 WebHost 类 的 Start0 方 法 。 此 方法 具有 RequestDelegate 参数 。RequestDelegate 是 一 
个 委托 ， 把 HttpContext 接收 为 参数 并 返回 一 个 Task。 可 以 使 用 HttpContext 从 客户 端 读 取 请 求 并 发 送 返回 的 内 
容 。 使 用 示例 代码 ， 返 回 包含 HIML 字符 串 的 啊 应 (代码 文件 SimpleHost/Program.cs): 


UslIng Microsoft.AspNetCore; 
usSing Microsoft.AspNetCore .Hosting; 
uUSing Microsoft.AspNetCore.Http; 


namespace SimpleHost 
{ 
Public class Program 
{ 
Public static void Main{() 
{ 
WebHost .Start (asvync context =»> 
{ 
await context.Response.WriteAsyncec ("<hl>A Simple Host!</hl>").; 
}) .WaitForShutdown().:; 


New AsP.NET Core Web Application - WebsampleApP 


.NET Core “| ASP.NET Core 2.0 “| Learn more 


An empty project template for creating an ASP.NET 


四 SS SS IAJ Core application. This template does not have any 


content im it. 
Web API Web Web Angular 
Application Application 
(Model-View- 
Controller) 


Learn moare 


React.js 


Authenticatien Ne Authentication 


[| Enable Docker Support 


Os: Windows 


Reguires Docker tor Windows 


Docker support can also be enabled later Learn more 


30-1 
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运行 应 用 程序 时 ， 可 以 在 浏览 器 中 看 到 HIML 内 容 。 
使 用 ASPNET Core 创建 Web 主机 非常 简单 ， 但 是 现在 进入 一 个 更 复杂 的 场景 来 看 看 这 些 特 性 。 下 一 个 应 
用 程序 名 为 WebSampleApp， 使 用 相同 的 Empty 模板 创建 。 
创建 项 目 之 后 ， 会 得 到 一 个 名 为 WebSampleApp 的 解决 方案 和 一 个 项 目 文件 ， 其 中 包括 一 些 文件 和 文件 夹 
(参见 图 30-2)。 
Solution Explorer 
生 剖 - ©- 富 加 £| 一 | 
Search Solution Explorer (Ctrl+0) 


+ 的 ] Solution "WebSampleApp' (1 project) 
| 点 电 ] WebSsampleApp 
CP Connected Services 


bP Dependencies 


b aps Properties 
ly WwWwreet 


bb +cC# Program.cs 
bb +cC# Startup.cs 


solution Explorer Team Explorer 


图 30-2 


在 项 目 结构 中 , 有 一 个 Dependencies 文件 夹 。 其 中 的 NuGet 子 文件 夹 包含 NuGet 包 。 在 ASPNET Core 2.0， 
包 列 表 已 经 简化 ， 只 能 看 到 Microsoft.AspNetCore.All 引用 包 。 这 是 一 个 包含 大 量 ASPNET Core 包 的 引用 包 。 
在 Solution Explorer 中 打开 Microsoft.AspNetCore.All 时 引用 的 包 列 表 。 

在 项 目 文件 中 ， 还 可 以 看 到 对 这 个 包 的 引用 。 项 目 文 件 列 出 了 项 目 SDK( 软 件 开发 工具 包 ) 和 
MicrosoftNETSdk Web。 这 利用 了 安装 在 系统 上 的 SDK。 这 个 条 目 不 同 于 控制 台 应 用 程序 ， 其 中 SDK 是 
Microsoft.NET.Sdk。 在 Web SDK 中 ， 可 以 使 用 其 他 Web 开发 工具 (项 目 文件 WebSampleApp.cspoj): 

<Project Sdk="Microsoft.NET.Sdk .Web"> 

<PropertyGroup> 


<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<FOlder Include="wwwroot\™ /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.Al]l" Version="2.0.0" /> 
</ItemSroup> 

</Project> 

在 Project 设置 中 使 用 Debug 选项 , 可 以 配置 提供 Visual Studio 开发 时 使 用 的 Web 服务 器 (参见 图 30-3)。 在 
默认 情况 下 , IS Express 配置 为 使 用 Debug 设置 指定 的 端口 号 .IIS Express 源 目 Internet Information Server (IIS)， 
提供 了 IIS 的 所 有 核心 特性 。 所 以 非常 易于 在 与 稍 后 托管 应 用 程序 的 环境 (如 果 IIS 用 于 托管 ) 几 乎 相同 的 环境 中 
开发 Web 应 用 程序 。 

要 使 用 Kestrel 服务 器 运行 应 用 程序 ， 可 以 使 用 Debug Project 设置 选择 项 目 名 称 的 概要 文件 。 使 用 Visual 
Studio 项 目 设置 更 改 的 设置 将 影响 launchSettings.json 文件 的 配置 。 通 过 这 个 文件 ， 可 以 定义 一 些 附 加 的 配置 ， 
比如 命令 行 参 数 (代码 文件 WebSampleApp/Properties/launchsettings.json): 

"iisSsettings": 1 

"windowsAuthentication™": false, 
"anonymousAuthentication™"™: true, 


"iisExpress": 1 
"applicationUrl": "http://localhost:19879/"™, 
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"sslFPort™": 0 
} 
}, 
"Profiles™": { 
"IIS Express™"™: 1 
"CommandName™": "IISExpIress", 
"launchBrowser™": true, 
"environmentVariables": 1 
"Hosting:Environment": "Development™ 
} 
] ， 
"welb™": 1 
"commandName™": "web™, 
"launchBrowser™": true, 
"launchUrl™": "http://localhost:5000/™, 
"commandLineArgs": "Environment=Development™, 
"environmentVariables": 1 
"Hosting:Environment": "Development™ 


| WebsampleApp 


WebsampleApp 上 月 关 


Application 
Build 
Build Events 


Package Profile: IIS Express 


Debug 


2 和 Ming Launeh: lIS Express 
Typescript Build 


lisation arguments: 
Resources AP 9 


Wiorking directory: 


lw Launch browser: 


Envirenment vanables: Name Value 


ASPNETCORE_ENVIRONMENT Devalopment 


Vreb Servyer Settings 
App URL: http:ilocalhost so770 
llS Express Bitness: | Default 
| | Enable SSL 


Enabls Anonymous Authentication 


| | Enable Windows Authentication 


图 30-3 


注意 : 

Kestrel 服务 器 是 由 ASPNET Core 团队 开发 ， 通 过 ASP.NET Core 提供 简单 的 主机 。 当 使 用 IIS 托管 Web 应 
用 程序 时 ，IIS 将 请 求 转发 给 Kestrel 服务 器 。 这 就 像 Web 应 用 程序 在 Linux 上 由 Apache 服务 器 托管 一 样 一 一 将 
请 求 转 发 到 Kestrel 服务 器 。 首 先是 对 于 ASPNET Corer 2.0，Kestrel 服务 器 支持 面向 公众 的 使 用 ， 因 此 可 以 直 
接 在 Kestrel 服务 器 上 托管 Web 应 用 程序 ， 并 且 可 以 从 端口 80 上 访问 它 。 


Solution Explorer 的 项 目 结构 中 的 Dependencies 文件 夹 显示 了 对 JavaScript 库 的 依赖 。 创 建 空 项 目 时 ， 这 个 
文件 夹 是 空 的 。30.5 节 “ 添 加 静态 内 容 ” 会 添加 依赖 项 。 
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wwwroot 文件 夹 包 含 了 需要 发 布 到 服务 器 的 静态 文件 。 目前, 这 个 文件 夹 是 空 的 , 但 是 将 添加 HTML、 CSS 
文件 和 JavaScript 库 。 
C# 源 文件 Startup.cs 也 包含 在 一 个 空 项 目 中 。 接 下 来 将 讨论 这 个 文件 。 
在 项 目的 创建 过 程 中 ， 需 要 如 下 名 称 空 间 : 
Microsott.AspNetCore.Builder:; 
Microsoft.AspNetCore.Hosting: 
Microsoft.AspNetCore.Http: 
Microsoft.Extensions.Confieuration 
Microsott.Extensions.DependencyInjection 
Microsott.Extensions.Logeging 
Microsoft.Extensions.PlatformAbstractions 
Newtonsott.Json 
System 
System.Collections.Generic 
System.Globalization 
System.LInq 
System. [ext 
System.Text.Encodines. Web 
System.Threadine.Tasks 


3034 启动 


下 面 开始 建立 Web 应 用 程序 的 一 些 功能 。 为 了 获得 有 关 客 户 端的 信息 并 返回 一 个 啊 应 ， 需 要 编写 对 
HttpContext 的 啊 应 。 

使 用 空 的 ASPNET Web 应 用 程序 模板 在 Program 类 中 创建 一 个 Main0 方 法 ， 其 中 包含 以 下 代码 (代码 文件 
WebSampleApp/Program.cs): 

Es class Program 


public static void Main{string[] args) 


{ 
BuildWebHost (args) .Run(); 
} 


public static IWebHost BuildWebHost (string[] args) => 
WebHost.CreateDefaultBuilder (args) 
.UseSstartup<Sstartup> () 
.Build(}:; 
} 


CreateDefaultBuilder 返回 一 个 实现 IWebHostBuilder 的 对 象 ， 该 对 象 设 置 了 以 下 功能 : 
e 配置 Kestrel 作为 要 使 用 的 Web 服务 器 。 

e 内 容 的 根 路 径 设 置 为 当前 目录 。 

se 将 配置 定义 为 从 appsettings.json 文件 中 加 载 的 配置 。 

e 基于 环境 ， 用 不 同 的 名 称 添加 一 个 附加 的 JSON 配置 文件 
appsettings . {environmentname} .json 

环境 名 称 是 Development 时 ， 将 读 取 来 自 user secrets 的 配置 。 

将 配置 设置 提供 程序 配置 为 从 环境 变量 和 命令 行 中 加 载 设置 。 

将 记录 器 工厂 配置 为 记录 到 控制 台 和 调试 输出 窗口 上 。 

启用 IIS 集成 。 


734 | 第 由 部 分 Web 应 用 程序 和 服务 


注意 : 
用 户 机 密 和 参见 第 24 章 。 


使 用 从 CreateDefaultBuilder 返回 的 TWebHostBuilder 时 ， 将 调用 UseStartup 方法 。 该 方法 定义 要 实例 化 的 
Startup 类 和 运行 Web 主机 时 将 调用 的 方法 。 

UseStartup 方 法 实现 为 一 个 流利 API, 并 再 次 返回 ITWebHostBuilder。 可 以 在 Startup 类 之 前 使 用 ITWebHostBuilder 
来 配置 需要 的 其 他 服务 ， 并 定义 其 他 配置 提供 程序 。 

Build 方法 是 设置 Web 主机 的 链 中 的 最 后 一 个 方法 。 此 方法 构建 主机 来 运行 应 用 程序 ， 并 返回 ITWebHost 
接口 。 使 用 此 接口 时 ， 可 以 使 用 Services 属性 访问 依赖 注入 容器 ， 也 可 以 从 ServerFeatures 属性 中 访问 托管 服务 
器 特性 。IServerAddressesFeature 是 一 个 可 以 用 来 检索 主机 地 址 的 服务 器 特性 。 调 用 Start 方法 将 启动 对 已 配置 
端口 的 套 接 字 的 监听 。 


注意 : 
依赖 注入 和 .NET Core 依赖 注入 容器 MicrosoftExtensions.DependencyInjection 详 见 第 20 章 。 


空 的 ASPNET Web 应 用 程序 模板 创建 一 个 Startup 类 ， 它 包含 以 下 代码 : 
/1/... 


usSing Microsoft.AspNetCore.Builder; 

usSing Microsoft.AspNetCore.Hosting; 

usSing Microsoft.AspNetCore.Http; 

usSing Microsoft.Extensions.DependencyInjection; 


namespace WebSsampleApp 
{ 
public class Startup 
{ 
public void ConfigureServices (IServiceCollection services) 
{ 
} 
Public void Configure (IApplicationBuilder app, IHostingEnvironment env) 
{ 
if (env.IsDevelopment()) 
{ 
app.UseDeveloperExceptionpPage (1) ; 


} 


app .Run (asyne (context) => 
{ 
await context.Response.Writehsvynce("Hello World!™"). 
}); 
} 
} 
} 


由 于 使 用 泛 型 模板 参数 将 Startup 类 传递 给 UseStartup 方法 ， 因 此 将 调用 ConfigureServices 和 Configure 方法 。 

可 以 使 用 ConfigureServices 方法 在 依赖 注入 容器 中 配置 服务 。 此 方法 具有 IServiceCollection 属性 ， 该 属性 
包含 Main0 方 法 中 已 注册 的 所 有 服务 ， 并 人 允许 添加 其 他 服务 。IServiceCollection 派生 目 基 接口 IList<t>， 使 用 
ServiceDescriptor 作为 泛 型 参数 ， 因 此 不 仅 人 允许 读 取 服 务 ， 还 允许 添加 服务 。 

Configure0 方法 通过 依赖 注入 接收 参数 。 模 板 中 定义 的 参数 是 IApplicationBuilder 类 型 和 
IHostingEnvironment 类 型 。 

接口 IHostingEnvironment 人 允许 访问 环境 的 名 称 (EnvironmentName)、 内 容 的 根 路 径 ( 源 代 码 的 目录 ) 和 Web 
内 容 文件 的 根 路 径 ( 子 目录 wwwroob。 访 问 这 些 目录 的 默认 提供 程序 是 PhysicalFileProvider。 对 于 不 同 的 提供 程 
序 ， 可 以 从 其 他 数据 源 ( 例 如 数据 库 ) 中 提供 内 容 。 在 Configure 方法 的 实现 中 ， 使 用 IHostingEnvironment 通过 调 
用 扩展 方法 EDevelopment 来 检查 当前 环境 是 否 是 Development。 只 有 在 这 个 坏 境 中 才 显 示 异 弟 。 由 于 安全 问题 ， 
在 生产 环境 中 ， 用 户 看 不 到 异 妆 的 详细 信息 。 

IApplicationBuilder 接口 用 于 加 HITP 请 求 管 道 添加 中 间 件 。 调 用 这 个 接口 的 Use 方法 时 ， 可 以 构建 HITP 
请 求 管道 ， 来 定义 啊 应 请 求 时 应 该 做 什么 。Use 方法 是 使 用 流利 API 实现 的 ， 它 再 次 返回 IApplicationBuilder。 
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这 样 ， 可 以 很 容易 地 将 多 个 中 间 件 对 象 添 加 到 管道 中 。 有 几 种 扩展 方法 可 以 使 添加 中 间 件 更 加 容易 。 在 本 章 后 
面 可 以 创建 自 定 义 中 间 件 并 将 其 添加 到 管道 中 。 

Run 方法 是 接口 IApplicationBuilder 的 扩展 方法 ， 并 返回 void。 因 此 ， 它 在 请 求 管 道中 注册 最 后 一 个 中 间 
件 。Run 方法 的 参数 是 RequestDelegate 类 型 的 委托 。 该 类 型 日 ocahas ~ 
接收 HttpContext 作为 参数 ， 并 返回 一 个 Task。 使 用 Wy locatosta214 
HttpContext( 代 码 片 段 中 的 context 变量 )， 可 以 访问 来 自 浏 览 py 
器 的 请 求 信息 (HTTP 标题 、cookie 和 表单 数据 )， 并 可 以 发 送 
响应 。 生 成 的 代码 给 客户 端 返回 一 个 简单 的 字符 串 一 Hello 
World!， 如 图 30-4 所 示 。 


注意 : 

如 果 使 用 Microsoft Edge 测试 Web 应 用 程序 ， 就 需要 启用 localhost。 在 URL 框 中 输入 about:flags， 启 用 
Allow localhost loopback 选项 (参见 图 30-5)。 除 了 使 用 Microsoft Edge 内 置 的 用 户 界面 设置 此 选项 之 外 ， 还 可 以 
使 用 命令 行 选 项 : 实用 工具 CheckNetIsolation。 命 令 : 


CheckNetIsolation LoopbackExempt -a -n=Microsoft.MicrosoftEdge wekyb3d8bbwe 


可 以 启用 localhost， 类 似 于 使 用 Microsoft Edge 中 更 友好 的 用 户 界面 。 如 果 想 配置 其 他 Windows 应 用 程序 以 启 
用 localhost， 也 可 以 使 用 实用 程序 CheckNetIsolation 。 


号 喇 | 日 aboutflags 


| 
< () 【站 aboutflags 


Reset all flags to default 


I Developer settings 
车 show View source” and "Inspect elerment” in the 


context meny 

Use Microsoft Compatibility List 

|vw| Use Enterprse Mode Site List 

A Allow localhost loopback (this might put your device at 
risk). Some custom hosts file mappings might require 


additional configuration. See our FAQ for more 
information, 


| | Allow Adobe Flash Player localhost loopback (this might 
put your device at risk) 


| | Enable extension developer features (this might put 
your device at risk) 


| | Allow unrestricted memory consumption for web pages 
(this might impact the overall performance of your 
device) 


| | Hide my local IP address over WebRTC connections 


Standards Preview 


CAUTION! These features are volatile, meaning they might 
change, break, or disappear at ary time. Using them might 


图 30-5 


30.3.2 示例 应 用 程序 
示例 应 用 程序 包含 一 个 入 口 页 面 ， 在 该 页 面 中 ， 可 以 使 用 HTML 链接 轻松 访问 应 用 程序 显示 的 所 有 特性 : 
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app.Run (lasync (context) => 
{ 
string[] lines = mew[] 
{ 
提 walll>" 
"<1li><a href=""/hello.html"">Sstatic Files</a> — requires ™ 十 
@"UseStaticFiles</1i>"™, 
"<1i>Regquest and Response", 
反 Wel>" 
A"<1li><a href=""/RequestAndResponse"™">Request and Response</a></1i>™, 
a"<]li><a href=""/RequestAndResponse/header"">Header</a></1i>", 
"<1li><a href=""/RequestAndResponse/add?x=398&y=4"">Add</a></1i>", 


FF 


和 </ul>" a 
@"</1i>", 
外 we/ul> mm 
} 7 


Var sb = new StringBuilder(); 
foreach (var line in lines’ 
{ 
sb.Append (line); 
} 
string html = sb.ToString() .HtmlDocument ("Web Sample App"); 


await context.Response.WriteAsync (htm]l) ; 
}) i; 


定义 HTMLExtensions 类 是 为 了 创建 特定 的 HTML 并 减少 需要 编写 的 HTML 代码 。 这 个 类 定义 扩展 方法 来 
创建 div、span 和 1 元素 (代码 文件 WebSampleApp/HtmlExtensions.cs): 


Public static class HtmlExtensions 
{ 
public static string Div(this string value) => 
s"<div>{value}</div>"; 


public static string Spanl(this string value) => 
$s"<span>{value}</span>"™; 


public static string Div{this string key, string value) 三 > 
s"{key.Span()}:gtnbsp; {value.SsSpan(}}".Div(); 


Public static string Lil(this string value) => 
Ss@"<1i>{valuel}</1i>"; 


public static string Li(this string value, string url) => 
s@"<li><a href=""{url}j"™">{value}</ay</1liy>"; 


public static string Ul(this string value) 三 > 
Ss"<ul>{value}</ul>™; 


Public static string HtmlDocument (this string content, string title) 
{ 
Var sb = new StringBuilder(); 
sb.Append ("<!IDOCTYPE HTML>"™); 
sb.Append ("<head><meta charset=\"utf-8\"><title>{title}</title></head>"); 
sb.Append ("<bodvy>"}); 
sb.Append (content}).; 
sbh.Append ("</body>"); 
return sb.Tostring(); 


30.4 ”添加 客户 端 内 容 


通 和 不 希望 只 把 简单 的 字符 串 发 送 给 客户 疹 。 默 认 情况 下 ， 不 能 发 送 简单 的 HIML 文件 和 其 他 静态 内 容 。 
ASPNET Core 会 尽 可 能 减少 开销 。 如 果 没 有 局 用 ， 即 使 是 静态 文件 也 不 能 从 服务 器 返回 。 

要 在 Web 服务 器 上 处 理 静 态 文件 ， 可 以 添加 扩展 方法 UseStaticFiles， 以 添加 需要 的 中 间 件 (代码 文件 
WebSampleApp/Startup.cs): 
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public void Configure (IApplicationBuilder app, IHostingEnvironment env) 
{ 

| 

app.UseStaticFiles().; 

app.Run(asyne (context) =»> 

{ 

await context .Response .WriteAsvync("Hello World!l™).; 

}) 5 
} 
添加 静态 文件 的 文件 夹 是 项 目 内 的 wwwroot 文件 夹 。 下 面 将 一 个 简单 的 HTML 文件 添加 到 wwwroot 文件 

夹 中 ， 以 添加 静态 内 容 ( 代 码 文件 WebSampleApp/Wwwwroot/Hello.html))， 如 下 所 示 : 
lIDOCTYPE html> 
<html> 

<head> 
<meta charset="utf-8" /> 
<title>ASP.NET Core Sample</title> 
</head> 
<body> 
<hl>Hello, ASP.NET with Static Files</hil> 
</body> 
</html> 


现在 ， 局 动 服务 器 后 ， 从 浏览 器 中 辐 HIML 文件 发 出 请 求 ， 例 如 http://localhost:5000/Hello.html。 根 据 正在 
使 用 的 配置 ， 项 目的 端口 号 可 能 会 有 所 不 同 。 如 果 去 反 了 扩展 方法 UseStaticFiles 的 注释 符号 ，HTML 文件 就 不 
从 请 求 中 返回 。 


注意 : 

用 ASPNET Core 创建 Web 应 用 程序 时 ， 还 需要 了 解 HTML、CSS、JavaScript 和 一 些 JavaScript 库 。 本 书 
的 重点 是 C# 和 .NET Core， 所 以 这 些 主题 的 内 容 非 常 少 。 本 书 仅 讨论 使 用 ASP.NET Core 时 需要 知道 的 最 重要 
的 任务 。 


30.4.1 为 客户 端 内 容 使 用 工具 


要 为 客户 疾 创 建 内 容 ， 还 需要 一 些 工 具 。 使 用 老 版 本 的 ASP.NET, 一 切 都 集成 在 Visual Studio 中 。 可 以 使 
用 NuGet 包 下 载 并 安装 JavaScript 库 。 但 是 ， 由 于 关注 脚本 库 的 社区 通常 不 使 用 NuGet 服务 器 ， 所 以 社区 也 不 
为 JavaScript 库 创建 NuGet 包 。 关 注 JavaScript 库 的 社区 使 用 具有 NuGet 等 功能 的 服务 器 ， 而 不 是 使 用 NuGet。 

微软 和 NuGet 社区 为 JavaScript 库 构 建 NuGet 包 ， 以 便 在 Visual Studio 中 使 用 。 这 总 是 会 产生 一 些 延 返 ， 
通常 使 用 Visual Studio 的 体验 并 不 是 Web 世界 中 最 好 的 。 

许多 开发 Web 应 用 程序 的 工具 和 库 都 提供 了 命令 行 界面 。 对 于 .NET Core CLI， 现 在 也 是 如 此 。 前 面 介绍 
了 用 于 创建 应 用 程序 的 dotnet 命令 ， 还 使 用 了 一 些 扩展 ， 如 dotnet user-secrets( 第 24 章 ) 和 dotnet ef( 第 26 章 )。 
这 种 体验 现在 更 适合 用 于 创建 Web 应 用 程序 的 工具 。 男 一 方面 ，Visual Studio 提供 了 一 些 Web 工具 的 集成 。 

开发 Web 应 用 程序 的 客户 端 部 分 需要 如 下 工具 : 

e 下 载 包 的 工具 

e 处 理 编 译 或 转换 源 文 件 (例如 从 TypeScript 转换 为 JavaScripb 的 工具 

e 分 析 源 文件 的 工具 

e 捆绑 脚本 文件 的 工具 

e 单元 测试 的 工具 

根据 所 使 用 的 模板 ， 可 以 集成 不 同 的 工具 来 使 用 源 代码 。 例 如 ， 如 果 使 用 来 和 目 dotnet CLI 的 模板 创建 一 个 
ASPNET Core MVC Web 应 用 程序 ， 这 些 工具 就 集成 在 项 目 中 : 

e Bower 用 于 下 载 JavaScript 库 (https:/Wwww.bower.io)。 

e Bundler and Minifier 是 一 个 来 自 Mads Kristensen 的 Visual Studio 扩展 ， 用 于 捆绑 、 缩 小 JavaScript 和 CSS 

文件 ， 详 见 https://github.com/madskristensen/BundlerMinifier。 
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当 使 用 Visual Studio 或 dotnet CLI 创建 新 的 Angular 项 目 时 ， 要 使 用 的 工具 和 库 如 下 : 

下 载 JavaScript 包 的 npm (https://www.npmijs.com) 

把 TypeScript 文件 转换 为 JavaScript 文件 的 tsc(TypeScript 编译 器 ) (https://www.typescriptlang.ore) 
Jasmine， 一 个 JavaScript 测试 框架 (https://jasmine.github.io/) 

Karma， 测 试 运行 器 ， 用 于 测试 JavaScript 代码 (http://karma-runner.github.io/1.0/index.html) 

Chai， 这 是 一 个 用 于 单元 测试 的 断言 库 (http://chaijs.com/) 

webpack， 模 块 打 包机 ， 用 于 打包 、 捆 绑 和 加 载 JavaScript 库 (https://webpack.js.org/) 

不 仅 可 以 使 用 模板 中 的 工具 ， 还 可 以 自 定 义 代码 和 项 目 配置 ， 以 使 用 最 适合 目 己 工作 方式 的 工具 。 


30.4.2 ”通过 Bower 使 用 客户 端 库 


NET 包 可 以 从 NuGet 服务 器 中 获得 。 对 于 .NET Core, JavaScript 库 在 此 服务 器 上 不 再 可 用 。JavaScript 社区 
使 用 其 他 服务 器 ， 更 灵活 地 更 改 服务 器 。 当 Visual Studio 2015 发 布 时 ， 几 乎 所 有 的 客户 庙 JavaScript 库 都 可 以 
在 Bower 服务 器 上 使 用 。 这 就 是 为 什么 微软 在 Wisual Studio 中 集成 了 像 NuGet 这 样 的 Bower。 那 时 ， 服 务 器 上 
使 用 的 脚本 库 通 常 可 以 在 nppm( 节 点 包 管 理 器 ) 服 务 器 (https:/www.npmijs.com) 上 使 用 。 现 在 ， 服 务 器 上 使 用 的 肢 
本 库 和 客户 机 上 使 用 的 脚本 库 都 可 以 在 npm 服务 器 上 使 用 。 

对 于 .NET 项 目 ，NuGet 包 在 csproj 项 目 文件 中 管理 。 当 使 用 来 和 目 Bower 服务 器 的 包 时 ，Visual Studio 项 目 
模板 Bower Configuration File 将 文件 Bowerjson 添加 到 项 目 中 。 

在 Solution Explorer 中 选择 bower 配置 文件 时 ， 可 以 管理 bower 包 ， 并 打开 包 管 理 器 ， 例 如 NuGet 包 管 理 
器 (参见 图 30-6)。 可 以 像 使 用 NuGet 包 管 理 器 一 样 ， 浏 览 和 搜索 包 、 安 装 特 定 的 版 本 、 更 新 包 。 


中 上 WabSsampleApp 


Manage Bower Packages: WebsampleApp Project 


Browse lInstalled Update Available 


上 | 


marrvert The meost popular front-end framework for developing responsive, moebile first projects 
Parse, validate, manipulate, amd display dates in javascript. on the web. 

Autherls): twbs 

Lieense: MAIT 

Snare: 117484 

Projact Homaepage: httpy//getbootstrap.corm 


回 介 儿 


mormentjs 
Parse, validate, manipulate, and display dates in javascript, 


"ye 
@) Advanced HTMLS hybnd mobile app development framework. 


a i i 


30-6 


通过 Bower 包 管 理 器 安装 Bootstrap， 会 向 bower 配置 文件 添加 一 个 对 bootstrap 的 引用 (配置 文件 
WebSampleApp/Bower.json): 
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{ 
"name": "asp.net™, 
"private": true, 
"dependencies™: I 
"bootstrap™: "v3.3.1"™ 
} 
} 


在 Solution Explorer 的 Dependencies 列表 中 也 显示 了 Bower 依赖 项 。 该 包 会 自动 下 载 到 wwwroot/lib。 下 载 
包 的 位 置 由 .bowerrc 文件 指定 : 


{ 


"directory™: "wwwroot/1lib"™ 


使 用 命令 行 中 的 bower 时 ， 可 以 使 用 npm 安装 bower 命令 行 实 用 程序 : 


> npm install -9 bower 


还 可 以 安装 包 ， 它 将 包 写 入 bowerjson 文件 : 
> bower install jquery 
30.4.3 ”使 用 JavaScript 包 管 理 器 npm 


今天 ，Node Package Manager (opm) 的 主机 不 仅 服务 于 服务 器 问 JavaScript 库 ， 而 且 大 多 数 客 户 端 JavaScript 
库 也 可 以 从 npm 服务 器 中 获得 。 


注意 : 
使 用 Visual Studio 安装 程序 ,可 以 将 Node Package Manager 安装 为 可 选 组 件 . 也 可 以 直接 从 https://nodejs.org/ 
上 获得 它 。 


使 用 Visual Studio 2017， 可 以 通过 在 项 模板 中 添加 NPM Configuration File， 将 npm 添加 到 项 目 中 。 添 加 项 
模板 时 ， 将 下 面 的 package.json 文件 添加 到 项 目 中 : 

EE 2 "TO0.0™, 

ee 
"devDependencies": { 

devDependencies 是 用 来 描述 仅 在 开发 过 程 中 需要 的 库 的 部 分 。 dependencies 部 分 用 于 在 运行 期 间 所 需 的 库 ; 
这 些 需 要 部 署 到 生产 服务 器 上 。 

可 以 将 库 及 其 版 本 添加 到 package.json 中 相应 的 部 分 。Visual Studio 提供 智能 感知 ， 并 与 包 服 务 器 联系 ， 以 
获取 包 名 称 和 可 用 版 本 。 或 者 ， 可 以 使 用 npm 命令 行 来 添加 包 一 一 例如 ， 如 下 面 的 命令 行 语句 所 示 ， 其 中 的 选 
项 是 --save 将 依赖 项 写 入 package.json 文件 : 

> npm install fangular/core --save 

在 Visual Studio 编辑 器 中 选择 版 本 号 时 ， 可 以 选择 ^ 与 ~ 前 级。 如 果 没 有 前 级 ， 则 从 服务 器 中 检索 具有 用 户 
输入 的 确切 名 称 的 库 版 本 。 有 了 人 ^ 前 经， 就 检索 与 主 版 本 号 相同 的 最 新 库 有 了 ~ 前 级 ， 就 检索 与 次 版 本 号 相同 
的 最 新 库 。 

在 添加 包 之 后 ， 可 以 在 Solution Explorer 的 Dependencies 部 分 中 使 用 npm 节 点 轻松 地 更 新 或 凶 载 包 。 


30.4.4 捆绑 


加 浏览 器 返回 JavaScript 和 CSS 文件 在 生产 环境 中 应 该 与 在 开发 环境 中 不 同 。 注 释 和 空 日 可 以 删除 一 一 这 
称 为 “缩小 ”过 程 一 一 多 个 文件 可 以 合并 到 一 个 文件 中 一 一 这 就 是 所 谓 的 “捆绑 ”缩小 和 捆绑 都 提高 了 性 能 。 
缩小 会 减 小 文件 的 字 节 数 ， 绑 定 减 少 了 网 络 传输 的 数量 。 

捆绑 的 一 个 选项 是 Visual Studio 2017 集成 的 Bundler 和 Minifier。 只 需要 添加 bundleconfig.json 文件 ( 目 动 
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从 ASP NET Core MVC 项 目 模板 中 添加 )， 如 下 所 示 。 该 文件 包含 有 outputFileName 和 inputFiles 指令 的 部 分 。 
输入 文件 被 缩小 并 绑 定 , 以 创建 一 个 输出 文件 .可 以 将 所 有 CSS 文件 打包 到 一 个 CSS 文件 中 ,将 项 目的 JavaScript 
文件 打包 到 一 个 JavaSscript 文件 中 : 


[ 
| 
"outputFileName™"™: "wwwroot/css/site.min.css", 
// Mn array of relative input file paths. Globbing patterns supported 
"inputFiles": [ 
"wwwroot/css/site.css" 
] 
} ， 
{ 
"outputFileName™"™: "wwwroot/js/site.min.js", 
"inputFiles": [ 
"wwwroot/js/site.js" 
] ， 
/DOptional1lYy specify minification Options 
"minify": { 
"enabled™": true, 
"TrenameLocals™: true 
}, 
// Optionally generate .map file 
"sourceMap”": false 


30.4.5 用 webpack 打包 


如 前 所 述 ，webpack 是 一 种 打包 Web 项 目的 现代 方式 (撰写 本 文 时 )。 在 用 于 Angular 的 ASPNET Core 模板 
中 使 用 webpack， 创 建文 件 webpackconfigjs， 为 Web 应 用 程序 配置 webpack。 在 这 个 文件 中 ， 可 以 找到 绑 定 
JavaScript 和 CSS 文件 的 捆绑 配置 。 

要 启动 webpack， 还 要 检查 .NET 项 目 文 件 csproj。 对 于 Angular 项 目 AngularWithDotmnetCore， 这 个 文件 包 
会 了 在 构建 之 前 运行 的 DebugRunVWebpack 任务 ， 并 执行 JavaScript 文件 webpack: 


<Target Name="DebugRunWebpack" BeforeTargets="Build" 
Condition=" '$ {Configuration}" == "Debug"' and I!IExlsts('Wwwwroot\dist') "> 
<!l—— Ensure Node.]s is installed 一 一 > 
<Exec Command="node —-version™" ContinueOnError="true"> 
<Output TaskParameter="ExitCode™ PropertyName="ErrorCode™ /> 
</Exec> 
<ErrTor Condition="'s$ (ErrorCode}" = "0"" 
Text="Node.jJ]5s is required to build and run this project. To continue, 
please install Node.js from https://nodejs.corg/, and then restart your command 
prompt or IDE.™ /> 


<!I-—— In development, the dist files won't exist on the first run or When 
Cloning to a different machine, so rebuild them if not already present. 一 一 > 
<Message Importance="high"™" Text="Performing first-run Webpack build...™ /> 
<Exec Command="node node modules/webpack/bin/webpack .js 
--config webpack .config.vendor.js" /> 
<Exec Command="node node modules/webpack/bin/webpack.js" /> 
</Target> 


使 用 任务 PublishRunWebpack， 其 中 安装 了 npm 模块 ，webpack 从 缩小 和 捆绑 开始 : 


<Target Name="PUublishRunWebpack™" AfterTargets="ComputeFilesToPublish"> 
<!1l—— As part of publishing, ensure the JS resources are freshly buillt in 
production mode 一 一 > 
<Exec Command="npm install" /> 
<Exec Command="node node modules/webpack/bin/webpack.js --config 
Webpack .config.vendor.js --env.prod" /> 
<Exec Command="node node modules/webpack/bin/webpack.js --env.prod" /> 


<!l—— Include the newly-built files in the publish output 一 一 > 
<ItemGroup> 
<DistFiles Include="wwwroot\dist\**; ClientApp\dist\**" /> 
<ResolvedFileToPublish Include="f@ (DistFiles-»'$®$(FullPath)')" 
Exclude="@ (ResolvedFileToPublish)"»> 
<RelativePath>$ (DistFiles.Identity)</RelativePath> 
<CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory> 
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/ResolvedFileToPublish> 
</ItemSroup> 
</Target> 


30.5 ”请求 和 响应 


客户 疹 通 过 HTTP 协议 同 服 务 器 发 出 请 求 。 这 个 请 求 用 HITP 啊 应 来 回答 。 

请 求 包含 发 送 给 服务 器 的 标题 和 (在 许多 情况 下 ) 请 求 体 信息 。 服 务 器 使 用 标题 信息 了 解 客户 问 的 需求 ， 基 
于 这 个 信息 发 送 不 同 的 结果 。 下 面 看 看 可 以 从 客户 端 读 取 的 信息 。 

为 了 把 HIML 格式 的 输出 返回 到 客户 端 , span 和 Div 方法 会 创建 一 个 HTML div 元 素 , 其 中 包含 HTML span 
元 素 与 传递 的 参数 key 和 value( 代 码 文件 WebSampleApp/HtmlExtensions): 


public static string Span (this string value) => 
s"<span>{value}</span>™; 


Public static string Div{(this string key, string value) 三 > 
s"{key.Span()}:gtnbsp; {value.Span()}".Div(); 


GetRequestInformation 方法 使 用 HttpRequest 对 象 访问 Scheme、Host、 Path、QueryString、 Method 和 Protocol 
属性 (代码 文件 WebSampleApp/RequestAndResponseSamples.cs): 


Public static string GetRequestInformation (HttpRequest request) 
{ 
Var Sb = new StringBuilder (); 
sp -appena ("scheme" .DIVTIEeduest .Scheme) ) ; 
sp .appena ("host" .DIVTIEeduest .Host.HasValue ? reoquest.Host.Value : 
"no host™}))})s 
sb.Append ("path".Div lrequest.Path)).; 
sb.Append ("aquery string".Div(request.QueryString.HasValue ? 
request.QuerySstring.Value : "no query string™"™)); 
sb.Append ("method™".Div (request.Method) ); 
sb.Append ("protocol".Div (request .Protocol)).; 
return sb.ToSsString(); 


} 
把 路 径 及 equestAndResponse 传递 给 服务 器 ， 来 处 理 所 有 用 于 演示 本 节 示 例 代 码 的 请 求 。 因 此 Map 方法 在 
Startup 类 的 Configure 方法 中 定义 : 
app .Map("/RequestAndResponse", appl => 
| appl .Run(async context =» 
PF 2 
} 
} 


使 用 Map 方法 的 路 由 详 见 本 章 后 面 的 30.8 节 “ 简 单 的 路 由 ”. 
Run 方法 的 实现 代码 调用 GetRequestInformation 方法 , 并 通过 HttpContext 的 Request 属性 传递 HttpRequest。 
结果 写 入 Response 对 象 (代码 文件 WebSampleApp/Startup.cs): 


appl .Run (async context => 
{ 
await context.Response .WriteAsync! 
RequesthAndResponseSample.GetRequestInformation (context.Request)); 


上 
局 动 程序 ， 访 问 http://localhost:32146/RequestAndResponse/， 得 到 以 下 信息 : 


scheme: http 

host: localhost:32146 

path: / 

query string: no query string 
method: GET 

protocol: HTTP/1.1 
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给 请 求 添加 一 条 路 径 ， 例 如 http:Wlocalhost:32146/RequestAndResponse/Index， 得 到 路 径 值 集 : 


scheme :http 
host:localhost:32146 

path: /Index 

query String: no query string 
method: GET 

protocol: HTTP/1.1 


添加 一 个 查询 字符 串 ， 如 http://localhost:32146/RequestAndResponse/Sub?x=3&y=5， 就 会 显示 访问 
QueryString 属性 的 查询 字符 串 : 

query string: ?x=3g&y=5 

在 下 面 的 代码 片段 中 ， 使 用 HttpRequest 的 Path 属性 创建 一 个 轻 量 级 的 目 定 义 路 由 。 根 据 客 尸 端 设 定 的 路 
径 ， 调 用 不 同 的 方法 (代码 文件 WebSampleApp/Startup.cs): 


日 PP -RUTm (asvynec (context} => 
{ 
context .Response.ContentType = "text/html"™; 
string result = string.Fmpty; 
switch (context.Request.Path.Value.ToLoOwer'()) 
{ 
case "/header™: 
result = RequestAndResponseSamples.GetHeaderIinformation (context.Request); 
break; 
case "/add™: 
result = RequestAndResponseSamples.QuerySstring (context.Request),;} 
break; 
case mAcontentn : 
result = RequestAndResponseSsSamples.Content (context .Request).; 
break; 
case "/encoded™: 
result = RequestAndResponseSamples.ContentEncoded (context .Reaquest); 
break; 
case "™/form": 
result = RequestAndResponseSamples.GetForm(context.Request); 
break; 
case "/writecookie™: 
result = RequestAndResponseSamples .WriteCookie (context.Response); 
break; 
case "/readcookie"™: 
result = RequestAndResponseSamples.ReadCookie (context .Request); 
break; 
case "/json": 
result = RequestAndResponseSamples.GetJson (context.Response)s 
break; 
default: 
result = 
ReaquestAndResponseSamples.GetRequestInformation (context .Redquest); 
break; 
} 
awalit context.Response.WriteAsync (result).; 


})s 


以 下 各 节 实 现 了 不 同 的 方法 来 显示 请 求 标 题 、 查 询 字 符 串 等 。 


30.5.1 请 求 标题 


下 面 看 看 客户 端 在 HITP 标题 中 发 送 的 信息 。 为 了 访问 HITP 标题 信息 ，HttpRequest 对 象 定义 了 Headers 
属性 。 它 的 类 型 是 IHeaderDictionary， 包 含 带 有 标题 命名 的 字典 和 一 个 值 的 字符 串 数 组 。 使 用 这 个 信息 ， 先 前 
创建 的 GetDiv 方法 用 于 将 div 元 素 写 入 客户 咒 ( 代 码 文 件 WebSampleApp/RequestAndResponseSample.cs): 


public static string GetHeaderInformation (HttpRequest eduest) 
{ 
Var sb = new StringBuilder (); 
foreach (var header in request.Headers) 
{ 
sb.Append (header .Key.Div (string.Join("; ", header.Value))})}); 
} 


return sb.ToString(); 
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结果 取决 于 所 使 用 的 浏览 器 。 下 面 比较 一 下 其 中 的 一 些 结果 。 下 面 的 结果 来 自 Windows 10 触摸 设备 上 的 
Internet Explorer 11: 


Connection: Keep-Alive 

Accept: text/htm]l,application/xhtml+xml,image/jxr,*.* 

Accept—Encoding: gzip, deflate 

Accept—Language: en-Us,en;d=0.8.,de-AT;d=0.5,de;d=0.3 

Host: localhost:32146 

User—-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; Touch; rv:11.0) 
like Gecko 

MS—ASPNETCORE—TOFEN: f7fd3899-4436-40a2-b736-1118f43cbef3 

X-Original-Proto: http 

X-Original—For: 127.0.0.1:8639 


Google Chrome 61.0 版 本 显示 了 下 面 的 信息 ， 包 括 AppleWebKit、Chrome 和 Safari 的 版 本 号 : 


Connection: Keep-Alive 

Accept: text/htm]l,application/xhtml+xml,application/xml;q=0.9, image/webp, 
image/apng,*/*;q=0.8 

Accept—Encoding: gzip, deflate, br 

Accept—Language: en-US,en;dq=0.9 

Host: JlJocalhost:32146 

User—-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) 
AppleWebFRKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.62 Safari/537.36 

Upgrade—Insecure~Requests: 1 

MS—-ASPNETCORE—TOEEN: ffd3899-4436-40a2-bi136-1118f43cbef3 

X—-Original—-Proto: http 

X-Original—For: 1271.0.0.1:8693 

Microsoft Edge 显示 了 下 面 的 信息 ， 包 括 AppleWebKit、Chrome、Safari 和 Edge 的 版 本 号 : 

Connection: Keep-Alive 

Accept: text/html, application/xhtmli+xml, image/Jjxr, */* 

Accept-Encoding: gzip, deflate 

Accept—Language: en-US,en;d=0.8,de-AT;d=0.5,de;qdq=0 .3 

Cookie: color=red 

Host: localhost:32146 

Referer: http://localhost:32146/ 

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) 
AppleWebFKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 
Safari/537.36 Edge/16.16299 

MS-ASPNETCORE—TOEEN: fi7ifd3899-4436-40a2-bi136-1118f43cbef3 

X—-Original—-Proto: http 

X-Original—For: 1271.0.0.1:8639 


可 以 从 这 个 标题 信息 获得 什么 ? 

Connection 标题 是 HTTP 1.1 协议 的 一 个 增强 。 有 了 这 个 标题 ， 客 户 端 可 以 请 求 保持 打开 连接 。 客 户 端 通常 
使 用 HIML 发 出 多 个 请 求 ， 例 如 获得 图 像 、CSS 和 JavaScript 文件 。 服 务 器 可 能 会 处 理 请 求 ， 如 果 人 负载 过 高 ， 

Accept 标题 定义 了 浏览 器 接受 的 mime 格式 。 列 表 按 首选 格式 排序 。 根 据 这 些 信息 ， 可 能 基于 客户 端的 需 
求 以 不 同 的 格式 返回 数据 。 正 喜欢 HTML 格式 ， 其 次 是 XHTML 和 JXR。Google Chrome 有 不 同 的 列表 。 它 更 
喜欢 如 下 格式 : HTML、XHTML、XML 和 WEBP。 有 了 这 些 信 息 ， 也 可 以 定义 数量 。 用 于 输出 的 浏览 器 在 列 
表 的 最 后 都 有 *.*， 接 受 返 回 的 所 有 数据 。 

AcceptrLanguage 标题 信息 显示 用 户 配置 的 语言 。 使 用 这 个 信息 ， 可 以 返回 本 地 化 信息 。 本 地 化 参见 第 29 章 。 


注意 : 

以 前 ， 服 务 器 保存 着 浏览 器 功能 的 长 列表 。 这 些 列表 用 来 了 解 什么 功能 可 用 于 哪些 浏览 器 。 为 了 确定 浏览 
器 ， 浏 览 器 的 代理 字符 串 用 于 映射 功能 。 随 着 时 间 的 推移 ， 浏 览 器 会 给 出 错误 的 信息 ， 甚 至 允许 用 户 配 置 应 使 
用 的 浏览 器 名 称 ， 以 得 到 更 多 的 功能 (因为 浏览 器 列表 通常 不 在 服务 器 上 更 新 )。 在 过 去 ，IE 经 常 需 要 进行 与 其 
他 浏览 器 不 同 的 编程 。Microsoft Edge 非常 不 同 于 正 ， 与 其 他 供应 商 的 浏览 器 有 更 多 的 共同 点 。 这 就 是 为 什么 
Microsoft Edge 会 在 User-Agent 字符 串 中 显示 Mozilla、AppleWebKit、Chrome、Safari 和 Edge 的 原因 。 最 好 不 
要 用 这 个 User-Agent 字符 串 获 取 可 用 的 特性 列表 。 相 反 ， 应 以 编程 方式 检查 需要 的 特定 功能 。 
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前 面 介绍 的 用 浏览 器 发 送 的 标题 信息 是 给 非常 简单 的 网 站 发 送 的 。 通常 情况 下 会 有 更 多 的 细节 ， 如 cookie、 
号 份 验证 信息 和 目 定 义 信 息 。 为 了 查看 服务 器 收发 的 所 有 信息 ， 包 括 标 题 信 息 ， 可 以 使 用 浏览 器 的 开发 工具 ， 
局 动 一 个 网 络 会话 。 这 样 不 仅 会 看 到 发 送 到 服务 器 的 所 有 请 求 ， 还 会 看 到 标题 、 请 求 体 、 参 数 、cookie 和 时 间 
信息 ， 如 图 30-7 所 示 。 
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图 30-7 


30.5.2 ”查询 字符 串 


可 以 使 用 Add 方法 分 析 碍 询 字符 串 。 此 方法 需要 X 和 yy 参数 ， 如 果 这 些 参数 是 数字 ， 就 执行 相 加 操作 ， 并 
在 div 标记 中 返回 计算 结果 。 前 一 节 演 示 的 方法 GetRequestInformation 显示 了 如 何 使 用 HttpRequest 对 象 的 
QueryString 属性 访问 完整 的 查询 字符 串 。 为 了 访问 查询 字符 串 的 各 个 部 分 ， 可 以 使 用 Query 属性 。 下 面 的 代码 
片段 使 用 Get 方法 访问 x 和 y 的 值 。 如 果 在 盘 询 字符 串 中 没有 找到 相应 的 键 ， 这 个 方法 就 返回 null( 代 码 文件 
WebSampleApp/RequestAndResponseSample.cs): 

ee static string QuerySstring (HttpRequest request) 


string xtext 
string vtext 


= request .Query["x"]; 
= request.Query["y"]; 
if (xtext == null || ytext == null) 
f 
return "x and Y must be set" -DIVTI() :; 


} 


1if (!int.TryParse (xtext, out Int x)) 
| 
return $"Error parsing {xtext}".Div(); 


} 


if (!int.TryParse (ytext, out int Y)) 
{ 


return $"Error parsing {vytext}".Div(); 
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0 ?"{x} + {y} = {x + y}".Div(}; 
从 查询 字符 串 返 回 的 IQueryCollection 还 允许 使 用 Keys 属性 访问 所 有 的 键 ， 它 提供 了 一 个 ContainsKey 方 
法 来 检查 指定 的 键 是 否 可 用 。 
使 用 URL http://localhost:32146/RequestAndResponse/add?x=39&y=3 在 浏览 器 中 显示 这 个 结果 : 


39++ 3 = 42 


30.5.3 ”编码 


返回 用 户 输入 的 数据 可 能 很 危险 。 下 面 用 Content 方法 实现 这 个 任务 。 下 面 的 方法 直接 返回 用 查询 数据 字 
付 串 传递 的 数据 (代码 文件 WebSampleApp/RequestAndResponseSample.cs): 


Public static string Content (HttpRequest request) => 
request .Query["data™]:; 


使 用 URL http:Wlocalhost32146/RequestAndResponse/content?data=sample 调用 这 个 方法 ,只 返回 字符 串 示 例 。 
使 用 相同 的 方法 ,用 户 还 可 以 传递 HIML 内 容 , 如 http://localhost:32146/RequestAndResponse/content? data ==hl> 
Heading 1</h1>， 结 果 是 什么 ?如 图 30-8 显示 ，hl 元 素 由 浏览 器 解释 ， 文 本 用 标题 格式 显示 。 我 们 有 时 希望 这 
么 做 ， 例 如 用 户 ( 也 许 不 是 匿名 用 户 ) 为 一 个 网 站 写 文 章 。 

不 检查 用 户 输 入 ， 也 可 以 让 用 户 传 递 JavaScript， 如 http://localhost:32146/RequestAndResponse/content?data= 
<script>alert("hacker"):</script>。 可 以 使 用 JavaScript 的 alert 函数 弹出 一 个 消息 框 。 同 样 ， 很 容易 将 用 户 重 定向 
到 另 一 个 网 站 。 当 这 个 用 户 输 入 存储 在 网 站 中 时 ， 一 个 用 户 可 以 输入 这 样 的 脚本 ， 打 开 这 个 页 面 的 所 有 其 他 用 
户 就 会 被 重 定 问 。 

返回 用 户 输入 的 数据 应 总 是 进行 编码 。 下面 看 看 不 编码 的 结果 。 可 以 使 用 HtmlEncoder 类 进行 HIML 编码 ， 
如 下 面 的 代码 片段 所 示 ( 代 码 文件 WebSampleApp/RequestResponseSample.cs): 


Public static string ContentEncoded (HttpRequest regquest) 三 > 
HtmlEncoder.Default .Encode (request Query[l"data™.]}; 


当 应 用 程序 运行 时 ， 进 行 了 编码 的 JavaScript 代码 使 用 http://localhost:32146/RequestAndResponse/ 
encoded?data<script>alert("hacker");</scrip 全 传递 , 客 尸 就 会 在 浏览 器 中 看 到 JavaScript 代码 ;它们 没有 被 解释 ( 参 
见 图 30-9)。 

回 localhost X j++ 


< 一 CC) TY localhost 


回 localhost X Bt 


cc (0) ny localhost3214 


<script~alert( hacker ):=</script> 


Heading 1 


30-8 图 30-9 


发 送 的 编码 字符 串 如 下 面 的 例子 所 示 ， 有 字符 引用 小 于 号 (<)、 大 于 号 (>) 和 引号 ("): 


<script>alert ("hacker".™) ;</script> 


30.5.4 ”表单 数据 


除了 通过 查询 字符 串 把 数据 从 用 户 传 递 给 服务 器 之 外 ， 还 可 以 使 用 表单 HIML 元 素 。 下 面 这 个 例子 使 用 
HTTP POST 请 求 替代 GET。 对 于 POST 请 求 ， 用 户 数据 与 请 求 体 一 起 传递 ， 而 不 是 在 查询 字符 串 中 传递 。 

表单 数据 的 使 用 通过 两 个 请 求 定 义 。 首 先 , 表单 通过 GET 请 求 上 辰 送 到 客户 器 , 然后 用 户 填 写 表单 , 用 POST 
请 求 提交 数据 。 相 应 地 ， 通 过 /form 路 径 调 用 的 方法 根据 HTTP 方法 类 型 调用 GetForm 或 ShowForm 方法 (代码 
文件 WebSampleApp/RequestResponseSamples.cs): 


Public static string GetForm(HttpRequest request) 
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string result = string.Empty; 
switch (request.Method) 
{ 
Case GET™: 
result = GetFormi(}):; 
break:; 
Case "POST™: 
result = ShowForm(request)}); 
break; 
default: 
breaks; 
} 
return result; 


} 
创建 一 个 表单 ， 其 中 包含 输入 元 素 textl 和 一 个 Submit 按钮 。 单 击 Submit 按钮， 调用 表单 的 action 方法 以 
及 用 method 参数 定义 的 HTTP 方法 : 


private static string GetForm() 一 > 
“<form method=\"post\" action=\"form"™>" + 
"<input type=\"text\" name=\"text1l\"™ />™ + 
"<input type=\"submit\™" value=\"Submit\"™ />"™ + 
"</form>™; 


为 了 读 取 表单 数据 ，HttpRequest 类 定义 了 Form 属性 。 这 个 属性 返回 一 个 正 ormCollection 对 象 ， 其 中 包含 
发 送 到 服务 器 的 表单 中 的 所 有 数据 : 


private static string ShowForm(HttpRequest request) 
{ 
Var sb = new StringBuilder (}; 
if (request.HasFormCcontentType) 
{ 
IFormCollection coll = regquest .Form; 
foreach (Var key in coll.Keys) 
{ 
sb.Append (key .Div (HtmlEncoder.Default.Encode (coll [KeYy]) ) ) ， 
} 
return sb.ToSsString(); 
} 
else return "no form".Div'(}); 


} 
使 用 /form 链接 ， 通 过 GET 请 求 接收 表单 (参见 图 30-10)。 单 击 Submit 按钮 时 ， 表 单 用 POST 请 求 发 送 ， 可 
以 查看 表单 数据 的 textl 键 (参见 图 30-11)。 
= [i 一 mE 加 localh | 日 x | 十 SN 
.和 DD localhost321 六 ,…。 0 7) localhost32 人 六 


textl: hello 


图 30-10 图 30-11 
30.5.5 cookie 


为 了 在 多 个 请 求 之 间 记 住 用 户 数据 ， 可 以 使 用 cookie。 给 HttpResponse 对 象 添加 cookie 会 把 HTTP 标题 内 
的 cookie 从 服务 器 发 送 到 客户 端 。 默 认 情 况 下 ，cookie 是 暂时 的 (没有 存储 在 客户 端 )。 如 果 URL 和 cookie 在 同一 
个 域 中 ， 浏 览 器 就 将 其 发 送 回 服务 器 。 可 以 设置 Path 限制 浏览 器 何 时 返回 cookie。 在 这 种 情况 下 ， 只 有 cookie 来 目 同 
一 个 域 量 使 用 /cookies 路 径 , 才 返 回 cookie。 设置 Expires 属性 时 ，cookie 是 永久 性 的 ， 因此 存储 在 客户 端 。 时 间 到 了 后 ， 
就 删除 cookie。 然 而 ， 不 能 保证 cookie 在 之 前 不 被 删除 (代码 文件 WebSampleApp/Request ResponseSamples.cs): 

public static string WriteCookie (HttpResponse response) 

| response.Cookies.Append ("color", "red", new CookieOptions 

| Path = "/cookies", 


Expires = DateTime.Now.AddDays (1) 
}); 
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return "cookie written™.Divi{).: 


} 
通过 读 取 HttpRequest 对 象 ， 可 以 再 次 读 取 cookie。Cookies 属性 包含 浏览 器 返回 的 所 有 cookie: 


public static string ReadCookie (HttpRequest request) 
{ 

Var sb = new StringBuilder'(); 

IRequestCookieCollection cookies = request .Cookies; 

foreach (Var key in cookies.Keys) 

{ 

SDp -appena(key-DIVICookKklIes [key])); 
} 
return sb.ToSsString(); 


} 


为 了 测试 cookie， 还 可 以 使 用 浏览 器 的 开发 工具 。 这 些 工具 会 显示 收发 的 cookie 的 所 有 信息 。 
30.5.6 发 送 JSON 


服务 器 不 仅 返 回 HIML 代码 ， 还 返回 许多 不 同 的 数据 格式 ， 例 如 CSS 文件 、 图 像 和 视频 。 客 户 端 通过 啊 
应 标题 中 的 mime 类 型 ， 确 定 接收 什么 类 型 的 数据 。 

GetJson 方法 通过 一 个 匿名 对 象 创建 JSON 字符 串 ， 包 括 Title、Publisher 和 Author 属性 。 为 了 用 JSON 序 
列 化 该 对 象 ， 添 加 NuGet 包 NewtonSoft Json， 导 入 NewtonSoft Json 名 称 空 间 。JSON 格式 的 mime 类 型 是 
application/json。 这 通过 HttpResponse 的 ContentIype 属 性 来 设置 (代码 文件 WebSampleApp/RequestResponseSample.cs): 


Public static string GetJson (HttpResponse response) 
{ 

var b = new 

{ 
Title = "Professional C# 7", 
PuUublisher = "Wrox Press", 
Author = "Christian Nagel™ 
上 
string Json = JsonConvert.SerializeOQbject (PP) ; 
response.ContentType = "application/json"™; 
return jsons 


} 


注意 : 
JsonConvert 类 在 NuGet 包 Newtonsoft.Json 中 。 这 个 第 三 方 包 会 自动 从 Microsoft AspNetCore.All 引用 包 中 
引用 。 


下 面 是 返回 给 客户 判 的 数据 : 


{"Title™":"Professional C# 7","Publisher™.: "Wrox Press"™, 
"AUuthor™": "Christian Nagel"™"]} 


注意 : 
发 送 和 接收 JSON 的 内 容 参 见 第 32 章 。 


30.6 ”依赖 注入 


依赖 注入 深度 集成 在 ASPNET Core 中 。 这 种 设计 模式 提供 了 松散 耦合 ， 因 为 一 个 服务 只 用 一 个 接口 。 实 
现 接 口 的 具体 类 型 是 注入 的 。 在 ASPNET Core 内 置 的 依赖 注入 机 制 中 ， 注 入 通过 构造 函数 来 实现 ， 构 造 函 数 
的 参数 是 注入 的 接口 类 型 。 


注意 : 
依赖 注入 参见 第 20 章 。 
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依赖 注入 将 服务 协定 和 服务 实现 分 隔 开 。 使 用 该 服务 时 ， 不 需要 了 解 具 体 的 实现 ， 只 需要 一 个 协定 。 这 侈 
许 在 一 个 地 方 给 所 有 使 用 该 服务 的 代码 蔡 换 服务 (如 日 志 记 录 )。 
下 面 创建 一 个 定制 的 服务 ， 来 详细 论述 依赖 注入 。 


30.6.1 定义 服务 


首先 ， 为 示例 服务 声明 一 个 协定 。 通 过 接口 定义 协定 可 以 把 服务 实现 及 其 使 用 分 隔 开 ， 例 如 为 单元 测试 使 
用 不 同 的 实现 (代码 文件 WebSampleApp/Services/ISampleService.cs): 

Public interface ISampleService 

{ 


IEnumerable<string> GetSamplestrings(); 
} 


用 DefaultSampleService 类 实现 接口 [SampleService( 代 码 文件 WebSampleApp/Services/DefaultSampleService.cs): 


public class DefaultSampleService : ISampleService 

{ 
private List<string> strings = new List<string> { "one", "two", "three™ }; 
public IEnumerable<string> GetSamplestrings!() => strings; 

} 


30.6.2 ”注册 服务 


使 用 AddTransient 方法 (这 是 IServiceCollection 的 一 个 扩展 方法 ， 在 程序 集 Microsoft.Extensions. 
DependencyInjection.Abstractions 的 名称 空间 Microsoft.Extensions.DependencylInjection 中 定义 )， 
DefaultSampleService 类 型 被 映射 到 ISampleService。 使 用 ISampleService 接口 时 , 实例 化 DefaultSampleService 
类 型 (代码 文件 WebSampleApp/Startup.cs): 

public void ConfigureServices (IServiceCollection services) 

services.AddTransient<ISampleService, DefaultSampleService>(); 


ee 
} 


内 置 的 依赖 注入 服务 定义 了 几 个 生命 周期 选项 。 使 用 AddTransient 方法 ， 每 次 注入 服务 时 ， 都 会 实例 化 新 
的 服务 。 

使 用 AddSingleton 方法 ， 服 务 只 实例 化 一 次 。 每 次 注入 都 使 用 相同 的 实例 : 

services.Addsingleton<ISampleService, DefaultSampleService> (); 

AddiInstance 方法 需要 实例 化 一 个 服务 ， 并 将 实例 传递 给 该 方法 。 这 样 就 定义 了 服务 的 生命 周期 : 


Var SampleService = new DefaultSsampleService (); 
Services.AddInstance<ISampleService> (sampleService).,; 


在 第 4 个 选项 中 ， 服 务 的 生命 周期 基于 当前 上 下 文 。 在 ASPNET MVC 中 ， 当 前 上 下 文 基于 HTTP 请 求 。 只 
要 给 同样 的 请 求 调用 动作 ， 不 同 的 注入 就 使 用 相同 的 实例 。 对 于 新 的 请 求 ， 要 创建 一 个 新 实例 。 为 了 定义 基于 
上 下 文 的 生命 周期 ，AddScoped 方法 把 服务 协定 映射 到 服务 上 : 


services.AddSscoped<ISampleService> (); 


30.6.3 注入 服务 


注册 服务 之 后 ， 就 可 以 注入 它 。 在 Controllers 目录 中 创建 一 个 控制 器 类 型 HomeController。 内 置 的 依赖 注 
入 框架 利用 构造 函数 注入 功能 ;因此 定义 一 个 构造 函数 来 接收 ISampleService 接口 。Index 方法 接收 一 个 
HttpContext， 可 以 使 用 它 读 取 请 求 信 息 。 在 实现 代码 中 ， 从 服务 中 使 用 ISampleService 获得 字符 串 。 控 制 器 添 
加 了 一 些 HIML 元 素 , 把 字符 串 放 在 列表 中 , 设置 状态 代码 (代码 文件 WebSampleApp/Controllers/HomeControllercs): 


public class HomeController 
{ 
Private readonly ISampleService service; 
Public HomeController (ISampleService service) => 
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_ Service = service; 
Public async Task Index(HttpContext context) 
{ 


Var sb = new StringBuilder(); 

sb.Append ("<ul>").; 

sb.Append (string.Join (string .Empty, 
Service.GetSamplestrings() .Select(s => s.L1{(}) -TORATITaY() )) 7 
sb.Append ("</ul>"); 
context .Response.StatusCode = 200; 
awalt context.Response.WriteAsync(sb.ToString()); 

} 
} 


注意 : 
这 个 示例 控制 器 直接 返回 HIML 代码 。 最 好 把 用 户 界 面 和 功能 分 开 , 通过 另 一 个 类 (视图 ) 创 建 HTML 代码 。 
对 于 这 种 分 离 最 好 使 用 ASPNET MVC 框架 。 这 个 框架 参见 第 31 章 。 


30.6.4 贡 用 控制 怖 


为 了 通过 依赖 注入 实例 化 控制 器 , 可 使 用 IServiceCollection 服务 注册 HomeController 类 。 这 次 不 使 用 接口 ， 
只 需要 服务 类 型 的 具体 实现 和 AddTransient 方法 调用 (代码 文件 WebSampleApp/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 

{ 
Services.AddTransient<ISampleService, DefaultSampleService> (); 
Services.DLddTransient<HometCtontroller>({().; 
FF pe 

} 


包含 路 由 信息 的 Configure 方法 现在 改 为 检查 /Home 路 径 。 如 果 这 个 表达 式 返 回 tue， 就 在 注册 的 应 用 程序 
服务 上 调用 GetService 方法 ， 通 过 依赖 注入 实例 化 HomeController 。IApplicationBuilder 接口 定义 了 
ApplicationServices 属性 ， 它 返回 一 个 实现 了 IServiceProvider 的 对 象 。 这 里 ， 可 以 访问 所 有 已 注册 的 服务 。 使 
用 这 个 控制 器 ， 通 过 传递 HttpContext 来 调用 Index 方法 : 
Public void Confijgure (IAppPlicationBuilder app, ILoggerFactory loggerFactory) 
A 
app.Map ("/Home™", homeApp => 


{ 
homeApp.Run (lasync (context) 三 > 


HomeCcontroller controller = 


homeApp .ApplicationServices.GetService Hlocalh X | 二 a 
<HomeController> () 7 
awalit controller.Index(context):; < C) (i) localhost:3214 
} 
-a =。 One 
} . tiwo 


sa three 


图 30-12 显示 用 主页 地 址 的 URL 运行 应 用 程序 时 的 无 序列 


30.7 ”简单 的 路 由 


在 前 面 的 代码 示例 中 使 用 了 Map 方法 ， 它 是 IApplicationBuilder 接口 中 创建 简单 路 由 的 扩展 方法 。Map 方 
法 通过 ASPNET Core 提供 了 一 个 简单 的 路 由 工具 。 对 于 每 个 定义 的 映射 ，ASPNET Core 提供 了 一 个 新 的 中 间 
件 管道 ， 它 以 基于 URL 路 径 的 Run 方法 结束 。 

如 果 收 到 请 求 ， 并 且 Map 的 路 径 成 功 ， 那 么 分 配给 Action 参数 的 方法 将 定义 与 请 求 一 起 活动 的 其 余 管道 。 
实现 代码 块 中 的 Run 方法 指定 管道 的 最 后 一 步 。 

下 面 的 代码 段 在 收 到 请 求 时 定义 了 一 个 到 /Home 路 径 的 映射 ， 运 行 HomeController 的 Invoke 方法 (代码 文 
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件 WebSampleApp/Startup.cs): 


Public void Configure (IApplicationBuilder app, ILoggerFactory loggerFactory) 
{ 

ed 

apP .Map("/Home", homeApp => 

{ 


homeApp .Run (asvyne context =»> 
{ 
HomeCcontroller controller = 
app.-.ApplicationSsServices.GetService<HomeController> (); 
awalit controller.Index (context).: 


}}s 


了 使 用 Map 方法 之 外 ,还 可 以 使 用 MapWhen。 在 下 面 的 代码 片段 中 , 当 路 径 包 含 字 符 串 hello 时 ,应 用 MapWhen 
管理 的 映射 。hello 在 开头 还 是 结尾 ， 或 者 是 前 缀 还 是 后 缀 ， 并 不 重要 (代码 文件 WebSampleApp/Startup.cs): 


public void Configure (IApplicationBuilder app, IHostingEnvironment env) 
{ 
f 7 .。 
app .MapWhen (context => context.Request.Path.Value.Contains ("hello"™"), 
helloaApp => 
{ 
了 ELLoapP -Run (async context => 
{ 
awalt context.Response.WriteAsync ("hello in the Path" -DIV() ) ; 
}); 
})s; 
a 。。 
} 


除了 使 用 路 径 之 外 , 还 可 以 访问 HttpContext 的 任何 其 他 信息 , 例如 客户 端的 主机 信息 (context.RequestHost) 
或 通过 身份 验证 的 用 户 (context.User.Identity.IsAuthenticated) 。 


30.8 创建 目 定 义 的 中 间 件 


ASPNET Core 很 容易 创建 在 调用 Run 方法 之 前 调用 的 模 抉 。 这 可 以 用 于 添加 标题 信息 、 验 证 令 牌 、 构 建 
缓存 、 创 建 日 志 跟 踊 等 。 一 个 中 间 件 模块 链接 男 一 个 中 间 件 模块 ， 直 到 调用 所 有 连接 的 中 间 件 类 型 为 止 。 

使 用 Visual Studio 项 模板 Middleware Class 可 以 创建 中 间 件 类 。 有 了 这 个 中 间 件 类 型 ， 就 可 以 创建 构造 函 
数 ， 接 收 对 下 一 个 中 间 件 类 型 的 引用 。RequestDelegate 是 一 个 委托 ， 它 接收 HttpContext 作为 参数 ， 并 返回 一 个 
Task。 这 就 是 Invoke 方法 的 签名 。 在 这 个 方法 中 ,可 以 访问 请 求 和 啊 应 信息 .HeaderMiddleware 类 型 给 HttpContext 
的 啊 应 添加 一 个 示例 标题 。 在 最 后 的 动作 中 ，Invoke 方法 调用 下 一 个 中 间 件 模块 (代码 文件 
WebSampleApp/Middleware/HeaderMiddleware.cs): 


Public class HeaderMiddleware 
{ 


private readonly RequestDelegate next; 


public HeaderMiddleware (RegquestDelegate next) 一 > 
next = nexts 


public Task Invoke (HttpContext httpContext) 
{ 
httpcCcontext .Response.Headers.Add ("sampleheader™, 
new[] { "addheadermiddleware™});: 
return next (httpContext); 


} 
} 
为 便于 配置 中 间 件 类 型 ,UseHeaderMiddleware 扩展 方法 扩展 接口 IApplicationBuilder 来 调用 UseMiddleware 
方法 : 
i static class HeaderMiddlewareExtensions 


Public static IApplicationBuilder UseHeaderMiddlewarel 
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this IApplicationBuilder builder) => 
builder.UseMiddleware<HeaderMiddleware> () 7; 
} 


现在 ，Startup 类 和 Configure 方法 负责 配置 所 有 的 中 间 件 类 型 。 扩 展 方 法 已 经 准备 好 调用 了 (代码 文件 
WebSampleApp/Startup.cs): 


Public void Configure (IAppPlicationBuilder app, ILoggerFactory loggerFactory) 
{ 

Eg 

app.UseHeaderMiddleware().; 

天 


} 
运行 应 用 程序 时 ， 可 以 看 到 返回 给 客户 端的 标题 (使 用 浏览 器 的 开发 人 员工 具 )。 无 论 使 用 之 前 创建 的 哪个 
链接 ， 每 个 页 面 都 显示 了 标题 (参见 图 30-13)。 


Headers | Body Parameters Cookies Timings 

Request URL: http://localhost32146/ 

Request Method: GET 

status Code: 国 200 / Ok 

a Request Headers 

Accept: text/html, application/xhtml+xml, image/jxr, “A 

Accept-Encoding: gzip, deflate 

Accept-Language: en-US, en; 9=0.8, de-AT:; q=0,5, de; 9q=0.3 

Connection: Keep-Alive 

Cookie: .AspMNetCore.Session=CfDJBITAkEv VrgRAnkEKCIYSHIRpuLynu WaROAgB2oGUV ee 
Host: localhost:321#46 

User-Agent: Mozilla/5.0 Windeows NT 10.0; WinB6A: weAd) AppleVWebkit/s37.38 [KHTML, lik 
1 Response Headers 

Date: Sat OQ4 Nov 2017 17:34:07 GMT 

一 amipPpIeHeader addheadermiddleware 

Server: Kestrel 

Transfer-Encoding: chunked 

-Powered-By: ASP.NET 

xX-SourceFiles: =?UTF-8?B?QzpccHIyY3Now wc291cmNIclxhc3BuZxRjb3JXFByb22c3N 
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30.9 ”会话 状态 


使 用 中 间 件 实现 的 服务 是 会 话 状态 。 会 话 状态 允许 在 服务 器 上 暂时 记忆 客户 端的 数据 。 会 话 状态 本 身 实 现 
为 中 间 件 。 

用 户 第 一 次 从 服务 器 请 求 页 面 时 ， 会 月 动 会 话 状态 。 用 户 在 服务 器 上 使 页 面 保持 打开 时 ， 会 话 会 继续 到 超 
时 (通常 是 10 分 钟 ) 为 止 。 用 户 导 航 到 新 页 面 时 ， 为 了 仍 在 服务 器 上 保持 状态 ， 可 以 把 状态 写 入 一 个 会 话 。 超 时 
后 ， 会 话 数据 会 被 删除 。 

为 了 识别 会 话 ， 可 在 第 一 个 请 求 上 创建 一 个 带 会 话 标识 从 的 临时 cookie。 这 个 cookie 与 每 个 请 求 一 起 从 客 
户 闪 返回 到 服务 器 ， 在 浏览 器 关闭 后 ， 就 删除 cookie。 会 话 标识 符 也 可 以 在 URL 字符 串 中 发 送 ， 以 苦 代 使 用 
cookne。 

在 服务 器 端 ， 会 话 信 息 可 以 存储 在 内 存 中 。 在 Web 场 中 ， 存 储 在 内 存 中 的 会 话 状态 不 会 在 不 同 的 系统 之 间 
传播 。 采 用 粘性 的 会 话 配 置 ， 用 户 总 是 返回 到 相同 的 物理 服务 器 上 。 使 用 粘性 会 话 ， 同 样 的 状态 在 其 他 系统 上 
不 可 用 并 不 重要 (除了 一 个 服务 器 失败 时 )。 不 使 用 粘性 会 话 ， 为 了 处 理 失 败 的 服务 器 ， 应 选择 把 会 话 状态 存储 
在 SQL Server 数据 库 的 分 布 式 内 存 内 。 将 会 话 状态 存储 在 分 布 式 内 存 中 也 有 助 于 服务 器 进程 的 回收 ; 如 果 只 使 
用 一 个 服务 器 进程 ， 则 回收 处 理会 删除 会 话 状态 。 

为 了 与 ASPNET 一 起 使 用 会 话 状态 , 需要 添加 NuGet 包 IMicrosoft.AspNet.Session。 这 个 包 提 供 了 AddSession 
扩展 方法 , 它 可 以 在 Startup 类 的 ConfigureServices 方法 中 调用 。 该 参数 允许 配置 闲置 超时 和 cookie 选项 .cookie 
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用 来 识别 会 话 。 会 话 也 使 用 实现 了 IDistributedCache 接口 的 服务 。 一 个 简单 的 实现 是 进程 内 会 话 状态 的 缓存 。 
方法 AddCaching 添加 以 下 缓存 服务 (代码 文件 WebSampleApp/Startup.cs): 


Public Vvoid ConfigureServices (IServiceCollection services) 
{ 
services.AddTransient<ISampleService, DefaultSsampleService> (); 
Services.AddTransient<HomeController> ()}; 
services.AddDistributedMemoryCache (). 
Services.AddSession(options => 
options.IdleTimeout = TimeSpan.FromMinutes (10) ) 

} 

为 了 使 用 会 话 ， 需 要 调用 UseSession 扩展 方法 在 管道 中 配置 中 间 件 。 在 写 入 任何 响应 之 前 ， 需 要 调用 这 个 
方法 ， 例 如 用 UseHeaderMiddleware 完成 ， 因 此 UseSession 在 其 他 方法 之 前 调用 。 使 用 会 话 信 息 的 代码 映射 到 
/Session 路径 (代码 文件 WebSampleApp/Startup.cs): 

public void Configure (IApplicationBuilder app, ILoggerFactory loggerFactory) 

{ 

fa 
app .UseSession().; 


app.UseHeaderMiddleware (); 
app.Map("/Session", sessionApp => 


{ 
sessionApp.Run (async context 三 > 
{ 

awalt SessionSample.SessionAsync (context),; 

1); 

}) 7 

FE 。 

} 


使 用 Setxxx 方法 可 以 编写 会 话 状态 ， 如 SetString 和 SetInt32。 这 些 方法 用 ISession 接口 定义 ，ISession 接口 从 
HttpContext 的 Session 属性 返回 。 使 用 Getxxx 方法 检索 会 话 数据 (代码 文件 WebSampleApp/Session Sample.cs): 


public static class SessionSample 
{ 
private const string SessionVisits = nameof (SessionVisits).,; 
private const string SessionTimeCreated = nameof (SessionTimeCreated); 
public static async Task SesslonAsync (HttpContext context) 
{ 
int visits = context.Session.GetInt32 (SessionVisits) ?2? 0; 
string timeCreated = context.Session.GetSstring (SessionTimeCreated) 2? 
string.Empty; 
if (string.IsNullOorEmpty (timeCreated)) 
{ 
timeCreated = DateTime.Now.ToString("t", CultureInfo.InvariantCulture)}); 
context .Session.SetSstring (SessionTimeCreated, timeCreated),; 
} 
DateTime timeCreated2 = DateTime.Parse (timeCreated)-; 
Context .Session.SetInt32 (SessionVisits, ++tvisits); 
await context.Response.WriteAsyncl 
STNUumber of visits within this session: {visits} ™ + 
s"that was created at {timeCreated2:T}; "+ 
s"ourrent time: {DateTime .Now:T}"); 


注意 : 
示例 代码 使 用 不 变 的 区 域 .性 来 存储 创建 会 话 的 时 间 。 向 用 户 显示 的 时 间 使 用 了 特定 的 区 域 性 。 最 好 使 用 不 
变 的 区 域 性 把 特定 区 域 性 的 数据 存储 在 服务 器 上 。 不 变 的 区 域 性 和 如 何 设置 区 域 性 参见 第 26 章 。 


30.10 用 ASP.NET Core 本 和 站 


在 Web 应 用 程序 中 ， 需 要 存储 可 以 由 系统 管理 员 改 变 的 配置 信息 ， 例 如 连接 字符 串 。 下 一 章 会 创建 一 个 数 
据 驱 动 的 应 用 程序 ， 其 中 需要 连接 字符 串 。 

ASPNET Core 的 配置 不 再 像 以 前 版 本 的 ASPNET 那样 基于 XML 配置 文件 web.config 和 machine.config。 
在 旧 的 配置 文件 中 ， 程 序 集 引 用 和 程序 集 重 定 同 是 与 数据 库 连 接 字符 串 和 应 用 程序 设置 混合 在 一 起 的 。 现 在 不 
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再 是 这 样 。 应 用 程序 设置 通 币 存储 在 appsettings.json 中 ， 但 是 配置 更 灵活 ， 可 以 选择 使 用 几 个 JSON 或 XML 
文件 和 环境 变量 进行 配置 。 

使 用 WebHost 与 用 默认 模板 创建 的 默认 构建 器 时 ， 配 置 了 几 个 配置 提供 程序 (代码 文件 WebSampleApp/ 
Program.cs): 


public static IWebHost BulladWebHost(sStrling[] args) 三 > 
WebHost.CreateDefaultBullder (args) 
.Usestartup<3Startup> () 
.Builgd(); 


具体 来 说 ， 这 5 个 提供 程序 是 默认 配置 的 : 
MemoryConfieurationProvider 
JsonConfieurationProvider (appsetttings.]son) 
JsonConfieurationProvider (appsettings. {environment}.Json) 
EnvironmentVariablesConfieurationProvider 
es CommandLineConfieurationProvider 
从 Startup 类 中 访问 配置 值 的 一 种 方法 是 在 构造 函数 中 注入 IConfiguration 接口 ， 并 将 一 个 属性 分 配给 所 接 
收 的 配置 (代码 文件 WebSampleApp/Startup.cs): 


Public Startup (IConfiguration configuration) 
{ 
Configuration = configuration.; 


} 


public IConfiguration Configuration { get; } 
使 用 此 内 容 创建 应 用 程序 配置 文件 (配置 文件 WebSampleApp/appsettings.json): 


{ 
"SampleSettings": { 
"Settingl™": "Valuel"™ 
js 
"AppSettings": 1{ 
"setting2": "Value2", 
"Setting3": "Value3", 
"SubSectionl™: 1{ 
"Setting4": "Valuedn" 
} 
}， 
"Connectionstrings™": { 
"DefaultConnection™: 
"Server={({localdb) \\MSSQLLoOCcalDB; Database= CHANGE ME; 
Trusted Connection=True;MultipleActiveResultSsSets=true"™ 
} 
} 


下 一 节 将 访 问 此 设置 o 
30.10.1 ” 读 取 配 置 


要 读 取 配置 ， 可 以 使 用 IConfiguration 接口 并 访问 各 个 部 分 。ConfigurationSample 类 通过 依赖 注入 来 访问 这 
个 接口 (代码 文件 WebSampleApp/ConfieurationSample.cs): 

public class ConfigurationSample 
{ 

private readonly lICconfiguration configuration; 

Public Configurationsample (IConfiguration configuration) => 

configuration = configuration; 

| - 

} 


可 以 使 用 索引 器 检索 设置 ， 可 以 使 用 GetSection 访问 配置 文件 中 的 部 分 。GetSection("SampleSettings") 检 索 
SampleSettings 部 分 ， 然 后 访问 传递 字符 串 Setting1 的 索引 器 。 这 样 ， 就 可 以 检索 值 Valuel: 
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Public async Task ShowApplicationSettingsAsync (HttpContext context) 

{ 
string settings = configuration.GetSection("SampleSettings") ["Settingl"]; 
await context.Response.WriteAsync (settings.Div ()); 


} 


与 使 用 GetSection 方法 访问 层次 结构 配置 不 同 ， 可 以 使 用 冒号 语法 与 索引 器 分 隔 所 有 层次 结构 。 下 面 的 代 
码 片 段 从 配置 文件 中 检索 与 前 一 个 相同 的 值 ; 


Public async Task ShowApplicationSsettingsUsingColonsAsync (HttpContext context) 
{ 

string settings = configuration["SampleSettings:Settingl"]; 

await context.Response.WriteAsync (settings.Div()); 


} 


对 于 名 为 ConnectionStrings 的 部 分 ， 存 在 一 个 扩展 方法 来 方便 地 访问 连接 字符 串 。 不 使 用 GetSection 和 索 
引 器 ， 而 可 以 使 用 GetConnectionString 方法 ， 检 索 这 个 部 分 中 的 设置 : 


Public async Task ShowCconnectionstringSettingAsync (HttpContext context) 
{ 
string connectionstring = configuration 
.GetConnectionstring("DefaultConnection").; 
awalt context.Response.WriteAsync (connectionstring.Div()); 


} 
还 可 以 为 对 配置 值 的 强 类 型 访问 创建 一 个 类 。 要 使 用 这 个 特性 ， 可 以 创建 类 AppSettings 和 SubSection1， 
并 将 属性 名 直接 映射 到 配置 文件 中 的 键 (代码 文件 WebSampleApp/ConfigurationSample.cs): 


PUublic class SubSectionl 
{ 

public string Setting4 { get; set; } 
} 


public class AppSettings 
{ 

Public string Setting2 { get; set， } 

public string Setting3 { get; set; } 

public SubSectionl SubSectionl { get; set; } 
} 


要 填充 映射 自 定义 配置 类 型 的 自 定 义 类 ， 应 调用 泛 型 Get 方法 ， 并 将 AppSettings 类 作为 泛 型 参数 传递 。 


public async Task ShowApplicationSsettingsstronglyTyped (HttpContext context) 
{ 
AppSettings settings = configuration.GetSsection'("AppSettings") 
.Get<AppSettings2> (); 
await context.Response.WriteAsync($"setting 2: {settings.Setting2}, "+ 
s"setting3: {settings.Setting3}, "+ 
$s"setting4: {settings.SsSubSectionl .Setting4}".Div()); 
} 


对 于 运行 应 用 程序 并 调用 ConfigurationSample 类 的 不 同方 法 ，MapWhen 定义 一 个 到 /Configuration 链接 的 
映射 ， 并 将 剩 下 的 路 径 传 递 给 remainingPath 变量 。 根 据 剩 下 的 部 分 ， 将 调用 来 目 ConfigurationSample 类 的 不 同 
方法 (代码 文件 WebSampleApp/Startup.cs): 


Pathstring TemalniIngPathi 
// out war not possible with lambda following in next parameter 
app.MapWhen (context => 
context .Request.Path.startsWithSsegments("/Configuration", out remainingPath), 
configurationApp => 
{ 
confijgurationApp.Run (async context 一 > 
{ 
var configSample = app.ApplicationServices 
.GetService<ConfigurationSample> (); 
if (remainingPath.startsWithsegqments ("/appsettings")) 
{ 
await configSample.ShowApplicationsSettingsAsync (context)}); 
} 
else if (remainingPath.startsWithsSegments ("/colons")) 


第 30 章 ASP.NET Core | 755 


{ 
awalt configsample.ShowApplicationSettingsUsingColonsAsync (context).,; 


} 
else if (remainingPath.startsWithSegments("/database"™)) 
{ 


awalt configsSample.ShowConnectionstringSettingAsync (context).; 


} 
else IE (remainingPath.startsWithsegments{("/stronglytyped")) 


{ 
awalt configSample.ShowApplicationSettingsSstronglyTyped (context); 
} 
})5 
}})s; 


30.10.2 ”修改 配置 提供 程序 


如 前 所 述 ， 有 5 个 配置 提供 程序 配置 了 默认 的 主机 构建 嚣 。 这 些 提供 程序 的 顺序 很 重要 。 如 条 多 次 指定 了 
同一 键 的 不 同 值 ， 则 返回 最 后 配置 的 值 。 例 如 ， 从 命令 行 中 传递 值 时 ， 这 些 值 是 检索 出 来 的 ， 而 不 是 在 JSON 
文件 中 配置 的 。 使 用 .NET Core 控制 台 应 用 程序 进行 完整 的 目 定义 配置 ， 并 同 该 应 用 程序 添加 以 下 NuGet 包 : 

Microsott.Extensions.Confieuration 

Microsott.Extensions.Contieuration.CommandLime 

Nicrosott.Extensions.Confieuration.EnvironmentVariables 

Microsott.Extensions.Confieuration.Json 

控制 台 应 用 程序 的 配置 是 使 用 ConfigurationBuilder 进行 的 。 ConfigurationBuilder 类 实现 了 接口 
IConfieurationBuilder。 对 于 这 个 接口 ， 在 NuGet 包 Microsoft Extensions.Configuration.* 中 定义 了 各 种 扩展 方法 。 
SetupConfiguration 方法 为 JSON、 坏 境 变量 和 命令 行 添加 提供 程序 (代码 文件 CustomConfiguration/Program.cs): 


static void SetupConfiguration(string[] args) 
{ 
var builder = new ConfigurationBuilder () 
.SetBasePath (Directory.GetCurrentDirectory()) 
.AddJsonFile ("appsettings.json") 
.AddEnvironmentVariables') 
.AddCommandLine (args); 
Configuration = builder.Buildl({(); 


} 
public static IConfigurationRoot Configuration { get; private set; } 
使 用 GetSection 方法 和 IConfiguration 接口 的 索引 器 读 取 配置 ， 如 前 面 几 节 所 述 : 


private static void ReadConfiguration{({) 

{ 
string vall = Configuration.GetSection("sectionl"™) ["keyl1"]; 
Console .WriteLine (vall)}).; 
string val2 = Configuration.GetSection("sectionl"}) ["key2"]; 
Console .WriteLine (val2).-: 


} 
JSON 配置 文件 定义 了 这 些 设 置 (配置 文件 CustomConfiguration/appsettings.jsom): 
{ 


"sectionl™: 1 
"keyvyil™": "value 1™, 
"key2": "Value 了 之 ” 

} 

} 


因为 环境 变量 和 命令 行 提供 程序 是 在 JSON 提供 程序 之 后 添加 的 ， 所 以 这 些 提 供 程序 定义 的 设置 会 覆盖 其 
他 设置 。 使 用 带 有 dotnet 命令 的 命令 行 时 ， 应 用 程序 的 参数 将 在 -- 之 后 分 配 ， 以 将 应 用 程序 的 参数 与 domet 命 
令 的 参数 分 离开 来 。 分 层 配 置 部 分 用 冒号 分 隔 : 

> dotnet run -- sectionl:keyl="settings from command line" 


在 Debusg 设置 中 ， 可 以 配置 Visual Studio 中 的 命令 行 参 数 和 环境 变量 ， 如 图 30-14 所 示 。 
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中 | WebSsampleApp 


tomConfiguration 

Application 

Build 

Build Events 

Package : 。 CustomConfiguration 
Ew 

Signing Project 


Resources 


Application argurments: section|:key2="app anrgument" 


Wreorking directory: 


: Environment variables: Name Value 


sectionl-key1 env vanable 


图 30-14 


将 调试 设置 写 入 文件 LaunchSettings. json: 
{ 
"Profiles": 1{ 
"CustomConfiguration™: { 
"commandName": "Project", 
"commandLineArgs": "sectionl:key2=\"app argument\™", 
"environmentVvarjables"™: 1 
"sectionl]: keyl"™: 
} 
} 
} 
} 


venv variable™ 


在 ASPNET Core Web 应 用 程序 中 ， 可 以 定义 配置 提供 程序 ， 如 以 前 在 控制 合 应 用 程序 中 那样 。 然 而 ， 
ASPNET Core 2 提供 了 一 种 更 简单 的 方法 : 使 用 IWebHostBuilder 的 扩展 方法 (如 ConfigureAppConfiguration 方 
法 ) 添 加 额外 的 配置 。 下 面 的 代码 片段 使 用 AddXmlFile 扩展 方法 添加 了 XML 文件 appsettings.xml。 当 文件 不 存 
在 时 ， 不 应 该 出 现 运 行 时 异常 ， 因 此 该 文件 标记 为 可 选 (代码 文件 WebSampleApp/Program.cs): 

public static IWebHost BuildWebHost (string[] args) => 

WebHost .CreateDefaultBuilder (args) 
.Usestartup<Sstartup> () 
-ConfigureAppConfiguration (configure 三 > 
| configure.AddxmlFile ("appsettings.xml", optional: true); 
SR 


30.10.3 ”基于 环境 的 不 同 配置 


使 用 不 同 的 环境 变量 运行 Web 应 用 程序 (例如 在 开发 、 测 试 和 生产 过 程 中 ) 时 ， 也 可 能 要 使 用 分 阶段 的 服务 
器 ， 因 为 可 能 要 使 用 不 同 的 配置 。 测 试 数据 不 应 添加 到 生产 数据 库 中 。 对 于 不 同 的 配置 值 ， 可 以 使 用 不 同 的 配 
置 文件 。 

WebHost 的 默认 构建 器 添加 了 两 个 JSON 配置 文件 , appsettings.json 和 appsettings.{ env.EnvironmentName }. 
json。 第 二 个 文件 配置 为 可 选 的 ， 就 像 前 一 节 中 的 XML 文件 配置 一 样 。 根 据 调试 和 发 布 构建 环境 名 称 的 配 


是 不 同 的 。 
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可 以 在 Visual Studio 项 目 属性 中 设置 名 为 ASPNETCORE ENVIRONMENT 的 环境 变量 , 就 可 以 配置 环境 ， 


加 图 30-15 所 示 。 


Applicatien 


Build 

Build Events 
Package 

Debug 

Signing 
Typescript Build 


Resources 


为 了 i 


Profile: 


Launeh: 


Bpplication arguments: 


Working directory; 


Launch browser: 


Enaronment variables: 


Web Server Settings 


if (env.IsDevelopment () ) 


| 
Ff 
} 


30.11 ”小结 


IIB Express 


IIS Express 


Valus 


ASPNETCORE_ENVIRONMENT Development 


App URL: httpirlocalhost,32146/ 


llS Express Bitness: | Default 
[ ] Enabls SSL 
Enable Anenymous Authentication 


[ Enable Windews Authenticetien 


30-15 


前 过 编程 验证 托管 环境 ， 可 为 接口 [HostingEnvironment 定义 扩展 方法 ， 例 如 IsDevelopment、 IsStaging 
和 IsProduction。 为 了 测试 任何 环境 名 ， 可 以 给 ISEnvironment 传递 验证 字符 串 : 


本 章 探讨 了 ASPNET Core 和 Web 应 用 程序 的 基础 ， 讨 论 了 如 何 处 理 来 自 浏 览 器 的 请 求 ， 并 通过 啊 应 来 应 
答 。 我 们 学 习 了 ASPNET Core 依赖 注射 和 服务 的 基础 知识 ， 以 及 使 用 依赖 注入 的 具体 实现 ， 如 会 话 状 态 。 此 
外 还 了 解 了 如 何 用 不 同 的 方式 存储 配置 信息 ， 例 如 用 于 不 同 环境 (如 开发 和 生产 环境 ) 的 JSON 配置 。 

第 31 章 展示 了 ASPNET Core MVC 如 何 使 用 本 章 讨论 的 基础 知识 创建 Web 应 用 程序 。 


ASP.NET Core MVC 


本 章 要 点 

ASPNET Core MVC 的 特性 

路 由 

创建 控制 器 

创建 视图 

验证 用 户 输入 

使 用 HIML 和 Tag Helpers 

创建 数据 驱动 的 Web 应 用 程序 
实现 身份 验证 和 授权 

使 用 Razor 页 面 


本 章 源 代码 下 载 地 址 (wrox.com): 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 MVC 目录 的 
https://github.comyProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

® MVC Sample App 

® Menu Planner 

® AzureB2C Sample 

® Razor Pages Sample 


31.1 为 ASP.NET Core MVC 建立 服务 


第 30 章 展 示 了 ASPNET Core 的 基础 ， 介 绍 中 间 件 以 及 依赖 注入 如 何 与 ASPNET Core 一 起 使 用 。 本 章 通 
过 注入 ASPNET Core MVC 服务 使 用 依赖 注入 。 

ASPNET Core MVC 基于 MVC( 模 型 -视图 -控制 器 ) 模 式 。 如 图 31-1 所 示 ， 这 个 标准 模式 [Design Patterns: 
Elements of Reusable Object-Oriented Sofiware(Addison-Wesley Professional, 1994) 中 记录 的 模式 | 定 到 了 一 个 实现 
了 数据 实体 和 数据 访问 的 模型 、 一 个 表示 显示 给 用 户 的 信息 的 视图 和 一 个 利用 模型 并 将 数据 发 送 给 视图 的 控制 
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器 。 控 制 器 接收 来 自 浏览 器 的 请 求 并 返回 一 个 响应 。 为 了 建立 响应 ， 控 制 器 可 以 利用 模型 提供 一 些 数 据 ， 用 视 
图 定义 返回 的 HIML。 


图 31-1 


在 ASPNET Core MVC 中 ,控制 器 和 模型 通常 用 服务 器 端 运 行 的 C# 和 .NET 代码 创建 。 视 图 是 带 有 JavaScript 
的 HTML 代码 ， 另 外 还 有 一 些 C# 代 码 用 来 访问 服务 器 端 信息 。 

这 种 分 离 在 MVC 模式 中 的 最 大 好 处 是 ， 可 以 使 用 单元 测试 方便 地 测试 功能 。 控 制 器 只 包含 方法 ， 其 参数 
和 返回 值 可 以 轻松 地 在 单元 测试 中 覆盖 。 

下 面 开 始 建立 ASPNET Core MVC 服务 。 在 ASPNET Core 中 , 如 第 30 章 所 述 , 已 经 深度 集成 了 依赖 注入 。 
选择 ASPNET Core 模板 Web Application (Model-View-Controller) 可 以 创建 一 个 ASPNET Core MVC 项 目 。 这 个 
模板 包括 ASPNET Core MVC 所 需 的 NuGet 包 , 以 及 有 助 于 组 织 应 用 程序 的 目录 结构 。 然 而 , 这 里 从 使 用 Empty 
模板 开始 (类 似 于 第 30 章 )， 所 以 可 以 看 到 建立 ASPNET Core MVC 项 目 都 需要 什么 , 没有 项 目 不 需 要 的 多 余 
东西 。 

创建 的 第 一 个 项 目 命 名 为 MVCSampleApp。Empty 模板 已 经 包含 对 NuGet 包 Microsoft.AspNetCore.All 的 
引用 , 所 以 已 经 包含 了 用 于 ASPNET Core MVC 的 包 。 有 了 这 个 包 , 就 可 在 ConfigureServices 方法 中 调用 AddMvc 
扩展 方法 ， 添 加 MVC 服务 (代码 文件 MVCSampleApp/Startup.cs): 

ee ee 


USing Microsoft.AspNetCore.Http; 
USing Microsoft.Extensions.DependencyInjection; 


namespace MVCSampleApp 
{ 
public class Startup 


{ 
了 
Public void ConfijgureServices (IServiceCollection services) 
{ 

Services.AddMvyve().; 

} 

} 

} 


AddMvc 扩展 方法 添加 和 配置 几 个 ASPNET Core MVC 核心 服务 ， 如 配置 特性 ( 带 有 MvcOptions 和 
RouteOptions 的 IConfigureOptions); 控制 器 工 三 和 控制 器 激活 程序 (IControllerFactory、IControllerActivator); 动 
作 方 法 选择 器 、 调 用 器 和 约束 提供 程序 (LActionSelector、ILActionInvokerFactory、 IActionConstraintProvider); 参数 
绑 定 器 和 模型 验证 器 (ControllerActionAreumentBinder 、 IObjectModelValidaton 以 及 过 滤器 提供 程序 
(IFilterProvider)。 

除了 添加 的 核心 服务 之 外 ，AddMvc 方法 还 增加 了 ASPNET Core MVC 服务 来 支持 授权 、CORS、 数 据 注 
解 、 视 图 、Razor 视图 引擎 等 。 
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31.2 ”定义 路 由 


第 30 章 提 到 ，IApplicationBuilder 的 Map 扩展 方法 定义 了 一 个 简单 的 路 由 。 本 章 将 说 明 ASPNET Core 
MVC 路 由 基于 该 映射 提供 了 一 个 灵活 的 路 由 机 制 ， 把 URL 映射 到 控制 器 和 动作 方法 上 。 
控制 器 根据 路 由 来 选择 。 创 建 默认 路 由 的 一 个 简单 方式 是 调用 Startup 类 中 的 方法 UseMvcWith- 
DefaultRoute( 代 码 文件 MVCSampleApp/Startup.cs): 
Public void Configure (IApplicationBuilder app) 
{ 
En 
app .UseStaticFiles(); 
app .UseMvcocWithDefaultRoute(); 
ff--. 
} 


注意 : 
扩展 方法 UseStaticFiles 参见 第 30 章 。 


在 这 个 默认 路 由 中 ， 控 制 器 类 型 的 名 称 (没有 Controller 后 级) 和 方法 名 构成 了 路 由 ， 如 http://server 
[:portl/controlleraction。 也 可 以 使 用 一 个 可 选 参数 id， 例 如 http://server[:port]/controller/action/id。 控 制 器 的 默认 
名 称 是 Home; 动作 方法 的 默认 名 称 是 mdex。 

下 面 的 代码 段 显 示 了 用 另 一 种 方法 指定 相同 的 默认 路 由 .UseMvc 方法 可 以 接收 一 个 Action <IRouteBuilder> 
类 型 的 参数 。 这 个 有 下 outeBuilder 接口 包含 一 个 映射 的 路 由 列表 。 使 用 MapRoute 扩展 方法 定义 路 由 : 

app.UseMvc (routes => routes.MapRoute! 

name: "default™, 
template: "{controller}/{action}/{iq?}", 


defaults: new {controller = "Home™", action = "Index"} 


让 

这 个 路 由 定义 与 默认 路 由 是 一 样 的 .template 参数 定义 了 URL; ?与 id 一 起 指定 这 个 参数 是 可 选 的 ; defaults 
参数 定义 URL 中 controller 和 action 部 分 的 默认 值 。 

看 看 下 面 的 这 个 网 址 : 

http://localhost: [port] /UseAService/GetSampleStrings 

在 这 个 URL 中 ，UseAService 映射 到 控制 器 的 名 称 ， 因 为 Controller 后 级 是 目 动 添加 的 ; 类 型 名 是 
UseAServiceController; GetSampleStrings 是 动作 ， 代 表 UseAServiceController 类 型 的 一 个 方法 。 


31.2.1 添加 路 由 


添加 或 修改 路 由 的 原因 有 几 种 。 例 如 ， 修 改 路 由 以 便 使 用 带 链 接 的 动作 、 将 Home 定义 为 默认 控制 器 、 同 
链接 添加 额外 的 项 或 者 使 用 多 个 参数 。 

如 果 要 定义 一 个 路 由 ， 让 用 户 通 过 类 似 于 http://<server>/About 的 链接 来 使 用 Home 控制 器 中 的 About 动作 
方法 ， 而 不 传递 控制 嚣 名称， 那么 可 以 使 用 如 下 所 示 的 代码 。URL 中 省 略 了 控制 器 。 路 由 中 的 controller 关键 
字 是 必须 有 的 ， 但 是 可 以 定义 为 默认 值 : 

app.UseMvc (routes => routes.MapRoutel 

name: "default™, 
template: "{action}/{id?}", 


defaults: new {controller = "Home”", action = "Index"} 


让 
下 面 显示 了 修改 路 由 的 另 一 种 场景 。 这 段 代 码 在 路 由 中 添加 了 一 个 变量 language。 该 变量 放 在 URL 中 的 服 
务 器 名 之 后 、 控 制 器 之 前 ， 如 http://server/en/Home/About。 可 以 使 用 这 种 方法 指定 语言 : 


app-.UseMvc (routes => TOUtES -MapPRoute 
name: "default™, 
template: "{controller}/{action}/{id?}", 
defaults: new {controller = "Home™", action = "Index"} 
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) .MapRoute ( 

name: "language"™, 

template: "{language}/{controller}/{action}/{id?}", 
defaults: new {controller = "Home", action = "Index"]} 


下 
如 果 一 个 路 由 匹配 并 找到 控制 器 和 动作 方法 ， 就 使 用 该 路 由 ， 否 则 选择 下 一 个 路 由 ， 直 到 找到 匹配 的 路 由 
为 止 。 


31.2.2 ”使 用 路 由 约束 


在 映射 路 由 时 ， 可 以 指定 约束 。 这 样 一 来 ， 就 只 能 使 用 约束 定义 的 URL。 下 面 的 约束 通过 使 用 正则 表达 式 
(en)l(de), 定义 了 1language 参数 只 能 是 en 或 de。 类似 于 http://<server>/en/Home/About 或 http://<server>/de/Home/ 
About 的 URL 是 合法 的 : 

app.UseMvc (routes => routes .MapRoute ( 


name: "language™", 
template: "{language}/{controller}/{action}/{id?}", 


defaults: new {controller = "Home", action = "Index"™"}, 
constraints: new {language = "(en) | (de)"} 
))}s; 


约束 可 以 在 模板 定义 中 指定 ， 或 者 通过 约束 定义 来 指定 。 在 前 面 示 例 的 id 参数 中 ，? 后 跟 参 数 名 指定 ， 这 
个 参数 是 可 选 的 。 还 可 以 在 模板 中 指定 特定 的 数据 类 型 ， 例 如 给 产品 DD 使 用 int 参数 类 型 
routes.MapRoute( 
name: "products™, 


template: "{controller}/{action}/ {productId:int}", 
defaults: new {controller = "Home", action = "Index™}); 


除了 数据 类 型 之 外 ， 还 可 以 给 最 小 值 、 最 大 值 、 范 围 、 带 有 最 小 和 最 大 长 度 的 字符 串 指定 约束 。 如 果 某 个 
链接 只 允许 使 用 数字 (例如 , 通过 产品 编号 访问 产品 ), 那么 可 以 使 用 正则 表达 式 \d+ 来 匹配 多 个 数位 构成 的 数字 ， 
但 是 至 少 要 有 一 个 数字 : 

app.UseMvc (routes => routes.MapRoute ( 


name: "products"™, 
template: "“{controller}/{action}/{productId?}", 


defaults: new {controller = "Home", action = "Index™}, 
constraints: new {productId = @"\d+"} 
) 


所 有 这 些 约束 都 可 用 ， 但 不 应 给 输入 的 验证 使 用 约束 。 的 东 可 以 用 于 选择 路 由 ， 它 们 本 来 就 应 该 用 于 这 种 
场合 。 如 果 约 束 不 匹配 ， 就 检查 下 一 个 路 由 是 否 匹 配 。 如 果 没 有 匹配 的 路 由 ,就 返回 HTTP 状态 码 404( 未 找到 )。 


路 由 指定 了 使 用 的 控制 器 和 控制 器 的 动作 。 因 此 ， 接 下 来 就 讨论 控制 器 。 


31.3 ”创建 控制 器 


控制 器 对 用 户 请 求 做 出 反应 ， 然 后 发 回 一 个 啊 应 。 如 本 节 所 述 ， 视 图 并 不 是 必要 的 。 

ASPNET Core MVC 中 存在 一 些 约定 ， 优 先 使 用 约定 而 不 是 配置 。 对 于 控制 器 ， 也 有 一 些 约定 。 控 制 器 位 
于 目录 Controllers 中 ， 控 制 器 类 的 名 称 必 须 带 有 Controller 后 级 。 

创建 第 一 个 控制 器 之 前 ， 先 创建 Controllers 目录 。 然 后 创建 一 个 控制 器 ， 为 此 要 在 Solution Explorer 中 选 
择 该 目录 , 在 上 下 文 沫 单 中 选择 Add | New Item 命令 , 再 选择 MVC Controller Class 项 模板 。 对 于 所 指定 的 路 由 ， 
创建 HomeController。 

生成 的 代码 中 包含 了 派生 目 基 类 Controller 的 HomeController 类 。 该 类 中 包含 对 应 于 Index 动作 的 Index 
方法 。 请 求 路 由 定义 的 动作 时 ， 会 调用 控制 器 中 的 一 个 方法 (代码 文件 MVCSampleApp/Controllers/ 
HomeController.cs): 


Public class HomeController : Controller 
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{ 
public IActionResult Index() => VIewl() ， 
} 


31.3.1 理解 动作 方法 


控制 器 中 包含 动作 方法 。 下 面 代码 段 中 的 Hello 方法 就 是 一 个 简单 的 动作 方法 (代码 文件 
MVCSampleApp/Controllers/HomeController.cs): 

public string Hello() => "Hello, ASP.NET Core MYVC"; 

使 用 链接 http://localhost:4994/Home/Hello 可 调用 Home 控制 器 中 的 Hello 动作 。 当 然 ， 端 口号 取 诀 于 目 己 
的 设置 ， 可 以 通过 项 目 设置 中 的 Web 属性 进行 配置 。 在 浏览 器 中 打开 此 链接 后 ， 控 制 器 仅 返 回 字符 串 Hello. 
ASPNET Core MVC。 没 有 HIML， 而 只 是 一 个 字符 串 。 浏 览 器 显示 出 了 该 字符 串 。 

动作 可 以 返回 任何 内 容 , 例如 图 像 的 字 节 、 视 频 、XML 或 JSON 数据 ， 当 然 也 可 以 返回 HTML。 视图 对 于 
返回 HTML 很 有 帮助 。 


31.3.2 ”使 用 参数 


如 下 面 的 代码 段 所 示 ， 动 作 方 法 可 以 声明 为 带 有 参数 (代码 文件 MVCSampleApp/Controllers 
/HomeController.cs): 


Public string Greeting (string name) 三 > 
HtmlEncoder.Default.Encode ($"Hello, {name}"™); 


有 了 此 声明 ， 就 可 以 通过 请 求 下 面 的 URL 来 调用 Greeting 动作 方法 ， 并 在 URL http://localhost:4994/Home/ 
Greetine?name 一 Stephanie 中 为 name 参数 传递 一 个 值 。 
为 了 使 用 更 易于 记忆 的 链接 ， 可 以 使 用 路 由 信息 来 指定 参数 。Greeting2 动作 方法 指定 了 参数 id: 


Public string Greeting2 {string id) => 
HtmlEncoder.Default.Encode ($"Hello, {id}"); 


这 匹配 默认 路 由 {controller}/{action}/{id?}， 其 中 id 指定 为 可 选 参数 。 现 在 可 以 使 用 此 链接 ，id 参数 包含 字 
符 串 Matthias:http:/localhost:4944/Home/Greeting2/Matthias。 
动作 方法 也 可 以 声明 为 带 任意 数量 的 参数 。 例如, 可 以 在 Home 控制 器 中 添加 带 两 个 参数 的 Add 动作 方法 : 
Public int add(In x, int Y) => XxX + ys 
可 以 使 用 URL http://localhost:4944/Home/Add?x= 4&y=5 来 调用 此 动作 ， 以 填充 x 和 y 参数 的 值 。 
使 用 多 个 参数 时 ， 还 可 以 定义 一 个 路 由 ， 以 在 不 同 的 链接 中 传递 值 。 下 面 的 代码 段 显 示 了 路 由 表 中 定义 的 
男 一 个 路 由 , 它 指定 了 填充 变量 x 和 y 的 多 个 参数 ,日 最 多 不 超过 3 位 数字 (代码 文件 MVCSampleApp/Startup.cs): 
app.UseMvc (routes => routes.MapRoutel 
name: "default™, 
template: "{controller}/{action}/{id?}", 
defaults: new {controller = "Home™", action = "Index"]} 
) .MapRoute ( 
name: "multipleparameters"., 
template: "{controller}/{action}/{x:int}/{y:int}", 


defaults: new {controller = "Home", action = "Add"}, 
constraints: new {x = @"\d{l1,3}", YY = &@"\d{l1,3}"} 


)}); 
现在 可 以 使 用 URL http://localhost:4994/Home/Add/7/2 调用 与 之 前 相同 的 动作 。 
注意 : 


本 章 后 面 的 31.4.1 节 “向 视图 传递 数据 ”会 介绍 自 定义 类 型 的 参数 如 何 使 用 以 及 客户 端的 数据 如 何 映射 到 
属性 上 。 


31.3.3 ”返回 数据 
到 目前 为 止 ， 只 从 控制 器 返回 了 字符 串 值 。 通 常 ， 会 返回 一 个 实现 IActionResult 接口 的 对 象 。 
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下 面 是 ResultController 类 的 几 个 例子 。 第 一 段 代码 使 用 ContentResult 类 来 返回 简单 的 文本 内 容 。 不 需要 创 
建 ContentResult 类 的 实例 并 返回 该 实例 , 而 可 以 使 用 基 类 Controller 的 方法 来 返回 ActionResult。 这 里 使 用 Content 
方法 来 返回 文本 内 容 。Content 方法 允许 指定 内 容 、MIME 类 型 和 编码 (代码 文件 MVCSampleApp/Controllers/ 
ResultController.cs): 


Public IActionResult ContentDemo() 三 > 
Content ("Hello World", "text/plain™); 


为 了 返回 JSON 格式 的 数据 ， 可 以 使 用 Json 方法 。 下 面 的 示例 代码 创建 了 一 个 Menu 对 象 : 


public IActionResult JsonDemo () 


{ 
var m = new Menu 
{ 
Id = 3, 
Text = "Grilled sausage with sauerkraut and potatoes"™, 


Price = 12.90, 
Date = new DateTime (2018, 3, 31), 
Category = "Main™ 

}s 


return Json({m).; 


Menu 类 定义 在 Models 目录 中 ， 它 定义 了 一 个 包含 一 些 属性 的 简单 POCO 类 (代码 文件 MVCSampleApp/ 
Models/Menu.cs): 


Public class Menu 
{ 
Public int Id {get; set;} 
Public string Text {get; set;]} 
public double Price {get; set;} 
public DateTime Date {get; set;} 
Public string Category {get; set;} 
} 


客户 判 可 在 啊 应 体内 看 到 这 些 JSON 数据 ， 现 在 它们 可 轻松 地 用 作 JavaScript 对 象 : 


{"id":3, "text": "Grilled sausage with sauerkraut and potatoes™, 
"Drice™:12.9, "date™:"2018-03-31T00:00:00"™, "category":"Main™} 


通过 使 用 Controller 类 的 Redirect 方法 , 客户 新 接收 HTTP 重 定 同 请 求 。 之 后 , 浏览 器 会 请 求 它 收 到 的 链接 。 
Redirect 方法 返回 一 个 RedirectResult( 代 码 文 件 MVCSampleApp/Controllers/Result Controller.cs): 


Public IActionResult RedirectDemo{() 三 > 
Redirect ("https://www.cninnovation.com"™); 


通过 指定 到 另 一 个 控制 器 和 动作 的 重 定 辣 ， 也 可 以 构建 对 客户 端的 重 定 同 请 求 。RedirectToRoute 返回 一 个 
RedirectToORouteResult， 它 允许 指定 路 由 名 称 、 控 制 器 、 动 作 和 参数 。 这 会 构建 一 个 在 收 到 HTTP 重 定 同 请 求 时 
返回 客户 端的 链接 : 


Public IActionResult RedirectRouteDemo() 三 > 
RedirectToRoute (new {controller = "Home™", action="Hello™}); 


Controller 基 类 的 File 方法 定义 了 不 同 的 重 载 版 本 ， 返 回 不 同 的 类 型 。 这 个 方法 可 以 返回 
FileContentResult、FileStreamResult 和 VirtualFileResult。 不 同 的 返回 类 型 取决 于 使 用 的 参数 , 例如 使 用 字符 串 返 
回 VirtualFileResult， 使 用 流 返回 FileStteamResult， 使 用 字 节 数组 返回 FileContentResult。 

下 一 个 代码 段 返 回 一 幅 图 像 。 创 建 一 个 Images 文件 来， 添加 一 个 JPG 文件 。 为 了 让 接 下 来 的 代码 段 执行 ， 
在 wwwroot 目录 中 创建 一 个 Images 文件 夹 并 添加 文件 Matthias.jpg。 样 例 代 码 返 回 一 个 VirtualFileResult， 用 第 
一 个 参数 指定 文件 名 。 第 二 个 参数 用 MIME 类 型 image/jpeg 指定 contentType 参数 : 

public IActionResult FileDemo() => 

File("~/images/Matthias.jpg", "image/jpeg™); 


31.4 节 “ 创 建 视图 ”演示 了 如 何 返 回 不 同 的 ViewResult 变 体 。 


31.3.4 使 用 Controller 基 类 和 POCO 控制 器 
到 目前 为 止 , 创建 的 所 有 控制 器 都 派生 自 基 类 Controller。 ASPNET Core MVC 也 支持 POCO(Plain Old CLR 
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Objects) 控 制 器 ， 它 们 不 派生 上 自 这 个 基 类 。 因 此 ， 可 以 使 用 目 己 的 基 类 来 定义 控制 器 的 类 型 层次 结构 。 
从 Controller 基 类 可 以 得 到 什么 ? 有 了 这 个 基 类 ， 控 制 器 可 以 直接 访问 基 类 的 属性 。 表 31-1 描述 了 这 些 属 


性 和 它们 的 功能 。 


属 性 
ControllerContext 


HttpContext 


ModelBinderFactory 


MetadataProvider 


ModelSstate 


Request 


Response 
RouteData 
ViewBag 
ViewData 


TempData 


User 


表 31-1 
说 了 明 

这 个 属性 包装 其 他 属性 。 在 这 里 可 以 得 到 动作 描述 符 的 信息 ， 其 中 包含 动作 的 名 称 、 控 制 器 、 过 滤器 和 方 
法 信息 ; 直接 在 HttpContext 属性 中 访问 的 HttpContext; 直接 在 Modelstate 属性 中 访问 的 模型 状态 ， 以 及 直 
接 在 RouteData 属性 中 访问 的 路 由 信息 
这 个 属性 返回 HttpContext。 在 这 个 上 下 文中 ， 可 以 访问 ServiceProvider 来 访问 依赖 注入 注册 的 服务 
(ApplicationServices 属性 )、 身 份 验证 和 用 户 信息 、 直 接 在 Request 和 Response 属性 中 访问 的 请 求 和 啊 应 信 
恩 以 及 Web 套 接 字 ( 如 果 使 用 它们 的 话 ) 
使 用 这 个 属性 可 以 创建 将 接收 到 的 数据 绑 定 到 动作 方法 的 参数 上 的 绑 定 器 。 把 请 求 信息 绑 定 到 定制 类 型 上 
的 内 容 将 在 31.5 节 “ 从 客户 端 提交 数据 ”讨论 
使 用 绑 定 器 来 绑 定 参 数 。 绑 定 器 可 以 利用 与 模型 相关 的 元 数据 。 使 用 MetadataProvider 属性 可 以 访问 配置 为 
处 理 元 数据 信息 的 提供 程序 的 信息 
ModelState 属性 允许 确定 模型 绑 定 是 成 功 还 是 有 错误 。 如 果 有 和 错误， 则 可 以 读 取 导致 错 误 的 属性 的 信息 
使 用 这 个 属性 可 以 访问 HTTP 请 求 的 所 有 信息 : 标题 和 请 求 体 信 息 、 查 询 字 符 串 、 表 单数 据 和 cookie。 标 
题 信息 包 含 User-Agent 字符 串 ， 它 提供 浏览 器 和 客户 端 平 台 信 息 
这 个 属性 保存 返回 给 客户 端的 信息 。 在 这 里 ， 可 以 发 送 cookie， 改 变 标 题 信息 ， 直 接 写 入 响应 体 
RouteData 属性 提供 了 在 启动 代码 中 注册 的 完整 路 由 表 的 信息 


使 用 这 些 属性 把 信息 发 送 到 视图 ， 参 见 31.4.1 节 “ 向 视图 传递 数据 ” 


这 个 属性 写 入 在 多 个 请 求 之 则 共享 的 用 户 状 态 ( 而 可 以 写 入 ViewBag 和 ViewData 的 数据 会 在 一 个 请 求 内 的 
视图 和 控制 器 之 则 共享 信息 )。 默 认 情 况 下 ，TempData 把 信息 写 入 会 话 状态 
User 属性 返回 经 过 身份 验证 的 用 户 的 信息 ， 包 括 身 份 和 声明 


POCO 控制 器 没有 Controller 基 类 ， 但 要 访问 这 些 信息 ， 它 仍然 很 重要 。 下 面 的 代码 段 定义 了 一 个 派生 上 自 
object 基 类 的 POCO 控制 器 (可 以 使 用 自己 的 目 定义 类 型 作为 基 类 )。 为 了 用 POCO 类 创建 ActionContext， 可 以 
创建 一 个 该 类 型 的 属性 。POCOController 类 使 用 ActionContext 作为 这 个 属性 的 名 称 ， 类 似 于 Controller 类 所 采用 的 方式 。 
然而 , 只 拥有 一 个 属性 并 不 能 自动 设置 它 。 需要 应 用 ActionContext 特性 。 使 用 这 个 特性 注入 实际 的 ActionContext。Context 
属性 直接 访问 ActionContext 中 的 HttpContext 属性 。 在 UserAgentInfo 动作 方法 中 ， 使 用 HttpContext 属性 访问 
和 返回 请 求 中 的 User-Agent 标题 信息 (代码 文件 MVCSampleApp/Controllers/POCOController.cs): 


Public class POCOConNntroller 


{ 


public string Index() => 
"this 15 a POCO controller™; 


[Actioncontext] 
public ActionContext ActlionContext {get; set;]} 


public HttpContext HttpContext => ActionContext.HttpContext; 


public ModelstateDictionary ModelSstate => ActionContext .Modelstate; 


public string UserAgentIinfo() 


{ 


if (HttpContext.Request.Headers.ContainsKRey ("User—-Agent"™)) 


{ 


return HttpContext.Request .Headers["User-Agent™]; 


} 
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return "No user-agent information™s 
} 
} 


31.4 创建 视图 


返回 给 客户 端的 HTML 代码 最 好 通过 视图 指定 。 对 于 本 节 的 示例 ， 创 建 了 ViewsDemoController。 视 图 都 
在 Views 文件 夹 中 定义 。ViewsDemo 控制 器 的 视图 需要 一 个 ViewsDemo 子 目 录 ， 这 是 视图 的 约定 (代码 文件 
MVCSampleApp/Controllers/ViewDemoController.cs): 


public ActionResult Index() => View(); 


注意 : 
另 一 个 可 以 搜索 视图 的 地 方 是 Shared 目录 。 可 以 把 多 个 控制 器 使 用 的 视图 (以 及 多 个 视图 使 用 的 特殊 部 分 
视图 ) 放 在 Shared 目录 中 。 


在 Views 目录 中 创建 ViewsDemo 目录 后 ， 可 以 使 用 Add | New Item 并 选择 MVC View Page 项 模板 来 创建 
视图 。 因 为 动作 方法 的 名 称 是 mdex， 所 以 将 视图 文件 命名 为 mdex.cshtml。 
动作 方法 Index 使 用 没有 参数 的 View 方法 ， 因 此 视图 引擎 会 在 ViewsDemo 目录 中 寻找 与 动作 同名 的 视图 
文件 。 控 制 器 中 使 用 的 View 方法 有 重 载 版 本 ， 人 允许 传递 不 同 的 视图 名 称 。 此 时 ， 视 图 引擎 会 寻找 与 在 View 方 
法 中 传递 的 名 称 对 应 的 视图 。 
视图 包含 HIML 代码 ， 其 中 混合 了 一 些 服务 器 端 代 码 。 下 面 的 代码 段 包 含 默认 生成 的 HIML 代码 (代码 文 
件 MVCSampleApp/Views/ViewsDemo/Index.cshtml): 
0 = null: 
} 
lIDOCTYPE html> 
<html]l> 
<head> 
<meta charset="utf-8" /> 
<meta name="viewport" content="width=device-width" /> 
<title>Index</title> 
</head> 
<body> 
</body> 
</html> 


服务 器 端 代码 使 用 Razor 语法 ( 即 有 @ 符 号 ) 编 写 。31.4.2 节 “Razor 语法 ”将 讨论 这 种 语法 。 在 那 之 前 ， 先 
看 看 如 何 从 控制 器 同 视 图 传递 数据 。 


31.4.1 向 视图 传递 数据 


控制 器 和 视图 运行 在 同一 个 进程 中 。 视 图 直接 在 控制 器 内 创建 ， 这 便于 从 控制 器 同 视 图 传递 数据 。 为 传递 
数据 ， 可 使 用 ViewDataDictionary。 该 字典 以 字符 串 的 形式 存储 键 ， 并 允许 使 用 对 象 值 。ViewDataDictionary 可 
以 与 Controller 类 的 ViewData 属性 一 起 使 用 ， 例 如 回 键 值 为 MyData 的 字典 传递 一 个 字符 串 : 
ViewData["MyData"] = "Hello"。 更 简单 的 语法 是 使 用 ViewBag 属性 。ViewBasg 是 动态 类 型 ， 人 允许 指定 任何 属 
性 名 称 ， 以 同 视图 传递 数据 (代码 文件 MVCSampleApp/Controllers/SubmitDataController.cs): 
public IActionResult PassingData{) 
ViewBag .MyData = "Hello from the controller"; 


return View(}); 


} 


注意 : 
使 用 动态 类 型 的 优势 在 于 ， 视 图 不 会 直接 依赖 于 控制 器 。 第 16 章 详 细 介绍 了 动态 类 型 。 
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在 视图 中 , 可 以 用 与 控制 器 类 似 的 方式 访问 从 控制 器 传递 的 数据 。 视 图 的 基 类 WebViewPage 定 义 了 了 ViewBag 
属性 (代码 文件 MVCSampleApp/Views/ViewsDemo/PassineData.cshtml): 

”> 

</div> 


31.4.2” Razor 语法 


前 面 提 到 ， 视 图 包含 HIML 和 服务 器 端 代 码 。 在 ASPNET Core MVC 中 ， 可 以 使 用 Razor 语法 在 视图 中 编 
写 C# 人 代码 。Razor 使 用 @ 字 符 作 为 转换 字符 。@ 字 符 之 后 的 代码 是 C# 代 码 。 

使 用 Razor 语法 时 ， 需 要 区 分 返回 值 的 语句 和 不 返回 值 的 方法 。 返 回 的 值 可 以 直接 使 用 。 例 如 ， 
ViewBag.MyData 返回 一 个 字符 串 。 该 字符 串 直 接 放 到 HIML 的 div 标记 内 : 

<div>Q@ViewBag.MyData</div> 

如 果 要 调用 没有 返回 值 的 方法 或 者 指定 其 他 不 返回 值 的 语句 ， 则 需要 使 用 Razor 代码 块 。 下 面 的 代码 块 定 
义 了 一 个 字符 串 变 量 : 


| 


string name = "Angela"™; 


现在 ， 使 用 转换 字符 @， 即 可 通过 简单 的 语法 使 用 变量 : 

<div>@name</div> 

使 用 Razor 语法 时 ， 引 擎 在 找到 HTML 元 素 时 ， 会 自动 认为 C# 代 码 结束 。 在 有 些 情况 中 ， 这 是 无 法 上 自动 
看 出 来 的 。 此 时 ， 可 以 使 用 圆 括 号 来 标记 变量 。 其 后 是 正常 的 代码 : 

<div>@ (name), Stephanie</div> 

foreach 语句 也 可 以 定义 Razor 代码 块 : 

@foreach (var item in list) 


<li>The item name is fitem.</l1i> 


} 


注意 : 
通常 ， 使 用 Razor 可 自动 检测 到 文本 内 容 ， 例 如 它们 以 角 括 号 开头 或 者 使 用 圆 括 号 包围 变量 。 但 在 有 些 情 
况 下 是 无 法 自动 检测 的 ， 此 时 需要 使 用 @: 来 显 式 定义 文本 的 开始 位 置 。 


31.4.3 ”创建 强 类 型 视图 


使 用 ViewBag 回 视 图 传递 数据 只 是 一 种 方式 。 男 一 种 方式 是 回 视 图 传递 模型 ， 这 样 可 以 创建 强 类 型 视图 。 
现在 用 动作 方法 PassingAModel 扩展 ViewsDemoController。 这 里 创建 了 Menu 项 的 一 个 新 列表 ， 并 把 该 列 
表 传 递 给 基 类 Controller 的 View 方法 (代码 文件 MVCSampleApp/Controllers/ViewsDemoController.cs): 


private IEnumerable<Menu> GetSampleData() 三 > 
new List<Menu> 
{ 
new Menu 
{ 
Id=1., 
Text="Schweinsbraten mit Kn6del und Sauerkraut"™, 
Price=6.9, 
Category="Main™" 
}, 
new Menu 
{ 
Id—2. 
Text="Erdapfelgulasch mit Tofu und Geback", 
Price=6.9, 
Category="Vegetarian™ 


}, 
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new Menu 
{ 
Id=3， 
Text="Tiroler Bauerngrest'l1 mit Spiegelei und Krautsalat™, 
Price=6.9, 
Category="Main" 


}s 


Public IActionResult PassingAModel() 三 > 
View (GetSsampleData()). 


当 模 型 信息 从 动作 方法 传递 到 视图 时 ， 可 以 创建 一 个 强 类 型 视图 。 强 类 型 视图 使 用 model 关键 字 声 明 。 传 
递 到 视图 的 模型 类 型 必须 匹配 model 指令 的 声明 。 在 下 面 的 代码 段 中 ， 强 类 型 的 视图 声明 了 类 型 
IEnumerable<Menu>， 它 匹配 模型 类 型 。 因 为 Menu 类 在 名 称 空间 MVCSampleApp.Models 中 定义 ， 所 以 这 个 名 
称 空间 用 using 关键 字 打 开 。 

通过 .cshtml 文件 创建 的 视图 的 基 类 派生 目 基 类 RazorPage。 有 了 模型 ， 基 类 的 类 型 就 是 RazorPage <TModel>; 
在 下 面 的 代码 段 中 ， 基 类 是 RazorPage<IEnumerable<Menu>>。 这 个 泛 型 参数 又 定义 了 类 型 IEnumerable<Menu> 
的 Model 属性 。 代 码 段 使 用 基 类 的 Model 属性 ， 在 (@foreach 中 遍历 Menu 项 ， 为 每 个 菜单 显示 一 个 列表 项 ( 代 
码 文 件 MVCSampleApp/ViewsDemo/PassingAModelcshtm]): 

Qusing MVCSampleApp .Models 

cp IEnumerable<Menu> 


Layout = null; 
} 


<IDOCTYPE html> 
<html»> 
<head> 

<meta name="viewport"™ content="width=device-width" /> 

<title>PassingAModel</title> 
</head> 
<body> 

<dlv> 

<Ul> 
Bforeach (var item in Model) 


> 
</ul> 

</div> 
</body> 
</html> 
根据 视图 需要 ， 可 以 传递 任意 对 象 作 为 模型 。 例如， 编辑 单个 Menu 对 象 时 ， 模 型 的 类 型 将 是 Menu。 在 显 

示 或 编辑 列表 时 ， 模 型 的 类 型 可 以 是 IEnumerable<Menu>。 

运行 应 用 程序 并 显示 定义 的 视图 时 ， 浏 览 器 中 将 显示 一 个 染 单列 表 ， 如 图 31-2 所 示 。 


可 | 回 passingAModel X 十 ww 


< 一 一 一 (a (iy localhost4944/ViewsDemo/Passil 


* Schwemsbraten mit EnGdel und Sauerkraut 
" Frdapfeleulasch mt Tofu und Geback 
= Tiroler Bauerngrist] mit Spiegelel und Krautsalat 


图 31-2 


31.4.4 ”定义 布局 


通常 ，Web 应 用 程序 的 许多 页 面 会 显示 部 分 相同 的 内 容 ， 如 版 权 信 息 、 微 标 和 主导 航 结构 。 到 目前 为 止 ， 
所 有 的 视图 都 包含 完整 的 HTML 内 容 ， 但 有 一 种 更 简单 的 方式 管理 共享 的 内 容 ， 即 使 用 布局 页 面 。 
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为 了 定义 布局 ， 应 设置 视图 的 Layonut 属性 。 为 了 定义 所 有 视图 的 默认 属性 ， 可 以 创建 一 个 视图 启动 页 面 。 
需要 把 这 个 文件 放 在 Views 文件 夹 中 ， 使 用 MVC View Start Page 项 模板 创建 它 。 这 将 创建 ViewStart.cshtml 文 
件 ( 代 码 文 件 MVCSampleApp/Views/ ViewStart.cshtml): 


@1 
Layout = ™" Layout™; 
} 
如 果 所 有 视图 都 不 需要 使 用 布局 ， 则 可 以 将 Layout 属性 设置 为 null 
0 = nulls 
} 


1. 使 用 默认 布局 页 
使 用 MVC View Layout Page 项 模板 可 以 创建 默认 的 布局 页 面 。 可 以 在 Shared 文件 夹 中 创建 这 个 页 面 ， 这 
样 它 就 可 用 于 不 同 控制 器 的 所 有 视图 。Visual Studio 项 模板 MVC View Layout Page 创建 下 面 的 代码 : 


<IDOCTYPE html> 
<html»> 
<head> 
<meta name="viewport" content="width=device-width"™" /> 
<title>Q@VviewBadg.Title</title> 
</head> 
<body> 
<div> 
RRenderBody () 
</div> 
</pody> 
</html> 


布局 页 包含 了 所 有 使 用 该 布局 页 的 页 面 所 共有 的 HIML 内 容 ， 例 如 页 眉 、 页 脚 和 导航 。 前 面 介 绍 了 视图 和 
控制 器 如 何 通过 ViewBag 通信 。 页 面 布局 也 可 以 使 用 相同 的 机 制 。ViewBag.Title 的 值 可 以 在 内 容 页 中 定义 ; 在 
布局 页 面 中 ， 在 HIML 的 title 元 素 中 显示 它 ， 如 前 面 的 代码 段 所 示 。 基 类 RazorPage 的 RenderBody 方法 呈现 
内 容 页 的 内 容 ， 因 此 定义 了 内 容 应 该 放置 的 位 置 。 

在 下 面 的 代码 段 中 ， 更 新 生成 的 布局 页 面 来 引用 样式 表 ， 给 每 个 页 面 添加 页 眉 、 页 脚 和 导航 分 区 。environment、 
asp-controller 和 asp-action 是 创建 HIML 元 素 的 Tag Helper。( 代 码 文件 MVCSampleApp/Views/Shared/ LayoutcshtmD): 


lIDOCTYPE html> 

<html> 

<head> 

<head> 
<meta charset="™utf-8" /> 
<meta name="viewport"™" content="width=device-width, initial-scale=1.0" /> 
<title>QVviewBag.Title</title> 


<environment include="Development"™"»> 
<link rel="stylesheet™" href="~/1lib/bootstrap/dist/css/bootstrap.css"™" /> 
<link rel="stylesheet"™ href="~/css/site.css"™" /> 
</environment> 
<environment exclude="Development"> 
<link rel="stylesheet" 
href="https://ajax.aspnetcdn.com/ajax/bootstrap/3.3.7/css/bootstrap.min.css" 
asp-fallback-href="~/1ib/bootstrap/dist/css/bootstrap-.min.css"™" 
asp-fallback-test-class="sr-only" asp-fallback-test-property="position™ 
asp-fallback-test-value="absolute™" /> 
<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true™ /> 
</environment> 


<title>@ViewBag.Title - My ASP.NET Application</title> 
</head> 
<body> 
<divVv class="container body-content"> 
<header> 
<hl>ASP.NET Core MVC Sample App</hl> 
</header> 
nav 
<ul> 
<1]i><a asp-controller="ViewsDemo" asp-action="LayoutSsample"»> 
Layout Sample</a></li> 
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li><a asp-controller="ViewsDemo" asp-action="LayoutUsingSections"> 
Layout Using Sections</a></li> 
</ul> 
</nav> 
<div> 
RenderBody () 
</div> 
<hr /> 
<footer> 
<D> 
<div>Sample Code for Professional C#</div> 
&COPY QDateTime .Now.Year — My ASP.NET Application 
</p> 
</footer> 
</div> 
</body> 
</html> 


为 动作 LayoutSample 创建 视图 (代码 文件 MVCSampleApp/Views/ViewsDemo/LayoutSample.cshtml)。 该 
视图 未 设置 Layout 属性 ， 所 以 会 使 用 默认 布局 。 下 面 的 代码 设置 了 ViewBag.Title， 并 在 布局 的 HTML title 元 素 
中 使 用 它 : 


Qf{ 
ViewBag.Title = "Layout Sample"™; 
} 
<h2>Layout Sample</h2> 
<D> 
This content is merged with 七 he layout page 
</p> 
现在 运行 应 用 程序 ， 布 局 与 视图 的 内 容 会 合并 到 一 起 ， 如 图 31-3 所 示 。 
岂 二 | 加 Layoutsample x Es 一 
一 CC) (0) localhost:a Tr se 
ASP.NET Core MVC Sample App 
= Layout Sample 
" Layout Using Sections 
Layout Sample 
This Content s merged with the layout page 
Sample Code for Professional C# 
® 2017 - My ASP.NET Application 
图 31-3 
2. 使 用 分 区 


除了 呈现 页 面 主体 以 及 使 用 ViewBag 在 布局 和 视图 之 间 交 换 数据 ,还 可 以 使 用 分 区 定义 把 视图 内 定义 的 内 
容 放 在 什么 位 置 。 下 面 的 代码 段 使 用 了 一 个 名 为 PageNavigation 的 分 区 。 默 认 情况 下 ， 必 须 有 这 类 分 区 ， 如 果 
没有 , 加 载 视图 的 操作 会 失败 。 如 果 把 required 参数 设置 为 false, 该 分 区 就 变 为 可 选 (代码 文件 MVCSampleApp/ 
Views/Shared/! Layout.cshtm)l): 


i 
<dliv> 
RenderSectiont("PageNMNavigation", required: false) 
</div> 
<dliv> 
RRenderBody () 
</div> 
ee 


在 视图 页 面 内 , 分 区 由 关键 字 section 定义 。 分 区 的 位 置 与 其 他 内 容 完 全 独立 。 视图 没有 在 页 面 中 定义 位 置 ， 
这 是 由 布局 定义 的 (代码 文件 MVCSampleApp/Views/ViewsDemo/LayoutUsingSections.cshtml): 


770 | 第 由 部 分 Web 应 用 程序 和 服务 


@{ 
ViewBag.Title = "Layout Using SectIons"; 
} 
<h2>Layout Using Sections</h2> 
<div>Main content here</div> 
section PageNavigation 
{ 
<div>Navigation defined from the view</div> 
Ul1> 
<1li>Navl</1li> 
<1li>Nav2</1i> 
</ul> 
} 


现在 运行 应 用 程序 ， 视 图 与 布局 的 内 容 将 根据 布局 定义 的 位 置 合 并 到 一 起 ， 如 图 31-4 所 示 。 
BB Layout Using Sections Xx i ee 一 口 2 


人 () (Li localhost o/Layo 窒 T= 入 已， 


ASP.NET Core MVC Sample App 


s Layout Sample 

" Layout Lsing Sections 
Navigation defined from the view 

" Maw1 

" Navz 


Layout Using Sections 


Main content here 


Sample Code for Professional C# 
B2017 - My ASP.NET Application 


图 31-4 


注意 : 
分 区 不 只 用 于 在 HTML 页 面 主体 内 放置 一 些 内 容 , 还 可 用 于 使 视图 在 页 面 头 部 放置 一 些 内 容 ， 如 页 面 的 元 
数据 。 


31.4.5 用 部 分 视图 定义 内 容 


布局 为 Web 应 用 程序 内 的 多 个 页 面 提供 了 整体 性 定义 ， 而 部 分 视图 可 用 于 定义 视图 内 的 内 容 。 部 分 视图 没 
有 布局 。 

此 外 ， 部 分 视图 与 标准 视图 类 似 。 部 分 视图 使 用 与 标准 视图 相同 的 基 类 。 

下 面 是 部 分 视图 的 示例 。 首 先是 一 个 模型 ， 它 包含 EventsAndMenusContext 类 定义 的 独立 集合 、 事 件 和 沫 
单 的 属性 (代码 文件 MVCSampleApp/Models/EventsAndMenusContext.cs): 


public class EventsAndMenusContext 
{ 
private IEnumerable<Event> GetEvents() 三 > 
new List<Event> 
{ 
new Event(l1, "Formula 
new Event (2, "Formula 
new Event (3, "Formula 
new Event (4, "Formula 


}s 
fi 


. Australia, Melbourne™", new DateTime (2018, 3, 25)), 
. Bahrain, Sakhir™", new DateTime (2018, 4, 8)),， 

. China, Shanghai™", new DateTime (2018, 4, 15)), 

- Aserbaidschan, Baku", new DateTime (2018, 4, 29)) 


忆 上 
Www 
rd md 中 四 


private IEnumerable<Event> events = null; 
public IEnumerable<Event> Events 
| 
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get => events ?2 ( events = GetEVentsS ()) : 
} 
private IEnumerable<Menu> menus = null; 
Public IEnumerable<Menu> Menus 
{ 
get => menus 2: ( menus = GetMenus () ) : 
} 
} 


上 下 文 类 用 依赖 注入 局 动 代码 注册 ， 通 过 控制 器 构造 函数 注入 类 型 (代码 文件 MVCSampleApp/Startup.cs): 


public void ConfigqureServices (IServiceCollection services) 
{ 
Services.AddMve (); 
services.AMddSsScoped<EventsAndMenusContext>()., 
} 


下 面 使 用 这 个 模型 介绍 从 服务 器 端 代码 加 载 的 部 分 视图 ， 然 后 介绍 客户 端的 JavaScript 代码 请 求 的 部 分 
视图 。 


1. 使 用 服务 器 端 代码 中 的 部 分 视图 


在 ViewsDemoController 类 中 , 构造 图 数 改 为 注入 EventsAndMenusContext 类 型 (代码 文件 MVCSampleApp/ 
Controllsers/ViewsDemoController.cs): 
Public class ViewsDemoController : Controller 
| Private EventsAndMenusContext context.; 
Public ViewsDemoController (EventsAndMenusContext context) 


{ 
Context = context.; 


} 
FF 

动作 方法 UseAPartialView1l 将 EventsAndMenus 的 一 个 实例 传递 给 视图 (代码 文件 MVCSampleApp/ 
Controllers/ViewsDemoController.cs): 

public IActionResult UseAPartialViewl() => View( context); 

这 个 视图 被 定义 为 使 用 EventsAndMenusContext 类 型 的 模型 。 使 用 HTML Helper Html.Par tialAsync 可 以 显 
示 部 分 视图 。 该 方法 返回 一 个 Task<HtmlString>。 在 下 面 的 示例 代码 中 ， 使 用 Razor 语法 把 该 字符 串 写 为 div 
元 素 的 内 容 。PatrtialAsync 方法 的 第 一 个 参数 接受 部 分 视图 的 名 称 。 使 用 第 二 个 参数 ，PartialAsyne 方法 允许 传 
递 模型 。 如 果 没 有 传递 模型 ， 那 么 部 分 视图 可 以 访问 与 视图 相同 的 模型 。 这 里 ， 视 图 使 用 了 
EventsAndMenusContext 类 型 的 模型 ， 部 分 视图 只 使 用 了 该 模型 的 一 部 分 ， 所 用 模型 的 类 型 为 IEnumerable 
<Event>( 代 码 文 件 MVCSampleApp/Views/ViewsDemo/UseAPartialView1.cshtml): 

eusing MVCSampleApp .Models 

Emodel EventsAndMenusContext 

0 -Title = "Use a Partial View"; 

ViewBag.EventsTitle = "Live Events"; 

2 a Partial View</h2> 

<div>this is the main view</div> 

ee Html .PartialAsync ("ShowEvents", Model .Events) 

</div> 

不 使 用 异步 方法 的 话 , 还 可 以 使 用 同步 变 体 Html.Partial。 这 是 一 个 扩展 方法 , 返回 实现 了 接口 IHtmlContent 
的 对 象 。 

另外 一 种 在 视图 内 呈现 部 分 视图 的 方法 是 使 用 HIML Helper HtmlRenderPartialAsync， 该 方法 定义 为 返回 
Task。 该 方法 将 部 分 视图 的 内 容 直 接 写 入 啊 应 流 。 这 样 ， 就 可 以 在 Razor 代码 块 中 使 用 RenderPartialAsync。 

部 分 视图 的 创建 方式 类 似 于 标准 视图 。 可 以 访问 模型 ， 还 可 以 使 用 ViewBag 属性 访问 字典 。 部 分 视图 会 收 到 字 
典 的 一 个 副本 ， 以 接收 可 以 使 用 的 相同 字典 数据 (代码 文件 MVCSampleApp/Views/ViewsDemo/ShowEvents.cshtml): 

Rusing MVvCSampleApp.Models 


Qmodel IEnumerable<Event> 
<h2> 
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QViewBag .EventsTitle 
</h2> 
<table> 
Qforeach (var item in Model) 
{ 
<tr> 
<td>@item.Day.ToShortDatestring (})} </td> 
<td>@item. Text</td> 


</tr> 
</table> 
运行 应 用 程序 ， 视 图 、 部 分 视图 和 布局 都 将 呈现 出 来 ， 如 图 31-5 所 示 。 
而 司 | 日 usea Partial View x | 十 ~ 
和 合意 | © pcalhost4o44 partialview 妇 在 人 器 


ASP.NET Core MVC Sample App 


= Layout sample 
= Layoul Using Sections 


Use a Partial View 


this is the main view 


Live Events 


dna018 Formula 1 GP, Australia, Melbourne 
dB2018 Formula 1 G.P. Bahrain, Sakhir 
dari5/2018 Formula 1 G.P. China, Shanghai 
429/2018 Formula 1 G.P. Aserbaidschan, Baku 


sample Code for Professional C# 
号 2017 - My ASP.NET Application 


图 31-5 


2. 从 控制 器 中 返回 部 分 视图 


到 目前 为 止 ， 都 是 直接 加 载 部 分 视图 ， 而 没有 与 控制 器 交互 。 也 可 以 使 用 控制 器 来 返回 部 分 视图 。 

在 下 面 的 代码 段 中 ， 类 ViewsDemoController 内 定义 了 两 个 动作 方法 。 第 一 个 动作 方法 UsePartialView2 返 
回 一 个 标准 视图 ， 第 二 个 动作 方法 ShowEvents 使 用 基 类 方法 PartialView 返回 一 个 部 分 视图 。 前 面 已 经 创建 并 
使 用 过 部 分 视图 ShowEvents， 这 里 再 次 使 用 它 。PartialView 方法 把 包含 事件 列表 的 模型 传递 给 部 分 视图 ( 代 
人 码 文件 MVCSampleApp/Controllers/ViewDemoController.cs): 


Public ActionResult UseAPartialView2() => View!(); 
Public ActionResult ShowEvents () 
{ 

ViewBag.EventsTitle = "Live Events"; 

return PartialView( context.Events); 


} 

当 部 分 视图 在 控制 器 中 提供 时 ， 可 以 在 客户 器 代码 中 直接 调用 它 。 下 面 的 代码 段 使 用 了 fetch API 从 服务 
器 上 下 载 jQuery: 事件 处 理 程序 链接 到 按钮 的 click 事件 。 在 单 击 事件 处 理 程序 内 ， 利 用 jQuery 的 load 函 
数 向 服务 器 发 出 了 请 求 /ViewsDemo/ShowEvents 的 一 个 GET 请 求 。 该 请 求 返回 一 个 部 分 视图 ， 部 分 视图 的 
结果 放 到 了 名 为 events 的 div 元 素 内 (代码 文件 MVCSampleApp/Views/ViewsDemo/UseAPartial View2.cshtml): 


auslIng MVC3SamplLeapp .Mode1s 
Bmodel EventsaAndMenusContext 


@{ 
ViewBag.Title = "Use a Partial View"; 
} 
<script src="~/lib/jquery/dist/jquery.j]s"></script> 
<SCript> 


{function (}) 1 
window.onload = function (}) 1 
var buttonEvents = document .getElementById ("getEvents"); 
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buttonEvents.onclick = function ({}) 
if (window.fetch == nully 1 
output.innerHTML = 
"<div>window.fetch not supported. Use another browser</div>"; 
TEtUurn; 
} 
var result = fetcoh("/ViewsDemo/ShowEvents"). 
result.thenlfunction (response) 1{ 
return response.text().; 
}) .then(function (text) 1{ 
var output = document .getElementById("output").; 
output.innerHIML = text.; 
}); 
}; 
}; 
1) (5 
</script> 
<h2>Use a Partial View</h2> 
<div>this is the main view</div> 
<button id="getEvents">Get Events</button> 
<dly lid="output"> 
</div> 


注意 : 
fetch API 是 XmlHttpRequest API 的 一 个 现代 替代 品 。IE11 不 支持 这 个 API， 但 Microsoft Edge、Firefox、 
Safari、Chrome 和 Opera 等 现代 浏览 器 都 支持 它 。 这 个 新 API 详 见 https://fetch.spec.whatwg.org/。 


31.4.6 ”使 用 视图 组 件 


ASPNET Core MVC 提供 了 部 分 视图 的 新 痊 代 品 : 视图 组 件 。 视 图 组 件 非常 类 似 于 部 分 视图 ; 主要 的 区 别 
在 于 视图 组 件 与 控制 器 并 不 相关 。 这 使 得 它 很 容易 用 于 多 个 控制 器 。 视 图 组 件 非常 有 用 的 例子 有 菜单 的 动态 时 
航 、 登 录 面 板 或 博客 的 侧 栏 内 容 。 这 些 场景 都 独立 于 单个 控制 器 。 

与 控制 器 和 视图 一 样 ， 视 图 组 件 也 有 两 个 部 分 。 在 视图 组 件 中 ， 控 制 器 的 功能 由 派生 目 ViewComponent 
的 类 (或 带 有 属性 ViewComponent 的 POCO 类 ) 接 管 。 用 户 界 面 的 定义 类 似 于 视图 ， 但 是 调用 视图 组 件 的 方法 是 
不 同 的 。 

下 面 的 代码 段 定 义 了 一 个 派生 自 基 类 ViewComponent 的 视图 组 件 。 这 个 类 利用 前 面 在 Startup 类 中 注册 的 
EventsAndMenusContext 类 型 ， 可 用 于 依赖 注入 。 其 工作 原理 类 似 于 市 有 构造 图 数 注 入 的 控制 器 。InvokeAsync 
方法 定义 为 从 显示 视图 组 件 的 视图 中 调用 。 这 个 方法 可 以 拥有 任意 数量 和 类 型 的 参数 ， 因 为 
IViewComponentHelper 接口 定义 的 方法 使 用 params 关键 字 指 定 了 数量 灵活 的 参数 。 除 了 使 用 异步 方法 实现 之 
外 ， 还 可 以 以 同步 方式 实现 该 方法 ， 返 回 IViewComponentResult 而 不 是 Task<IViewComponentResult>。 然 而 ， 
通常 最 好 使 用 异步 变 体 ， 例 如 用 于 访问 数据 库 。 视 图 组 件 需要 存储 在 ViewComponents 目录 中 。 这 个 目录 本 身 
可 以 放 在 项 目 中 的 任何 地 方 (代码 文件 MVCSampleApp/ViewComponents/EventListViewComponent.cs): 


Public class EventListViewComponent : ViewComponent 
{ 


private readonly EventsAndMenusContext context; 
Public EventListViewComponent (EventsAndMenusContext context) 三 > 
_Context = Context; 


Public Task<IViewComponentResult> InvokeAsync (DateTime from, DateTime to) 三 > 
Task.FromResult<IViewComponentResult>!{ 
View (EventsByDateRange (from, to))); 


private IEnumerable<Event> EventsByDateRange (DateTime from, DateTime to) 三 > 
Context.Events.Where(e => e.Day > 一 from g&& e.Day < 一 to}; 
} 


视图 组 件 的 用 户 界面 在 下 面 的 代码 段 内 定义 。 视 图 组 件 的 视图 可 以 用 项 模板 MVC View Page 创建 ; 它 使 用 
相同 的 Razor 语法 。 具 体 地 说 ， 它 必须 放 入 Components/[viewcomponent| 文 件 夹 ， 例 如 Components/EventList。 
为 了 使 视图 组 件 可 用 于 所 有 的 控件 ， 需 要 在 Shared 文件 夹 中 为 视图 创建 Components 文件 夹 。 只 使 用 特定 控制 
器 中 的 视图 组 件 时 ， 可 以 把 它 放 到 视图 控制 器 文件 夹 中 。 这 与 视图 的 区 别 是 ， 它 需要 命名 为 defaultcshtml。 也 
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可 以 创建 其 他 视图 名 称 ; 但 需要 在 mvokeAsynec 方法 中 使 用 一 个 参数 为 返回 的 View 方法 指定 这 些 视图 (代码 文 
件 MVCSampleApp/Views/Shared/Components/EventList/default.cshtm]l): 

Qusing MyCSampleApp.Models; 

Gmodel IEnumerable<Event> 

<h3>Formula 1 Calendar</h3> 

<uUl> 

Qforeach (var ev in Model) 
<li><div>@ev.Day.ToSsString ("D")</div><div>flev. Text</div></1i> 

ee 

现在 完成 了 视图 组 件 后 ， 可 以 调用 InvokeAsync 方法 显示 它 。Component 是 视图 的 一 个 动态 创建 的 属性 ， 返回 一 个 
实现 了 IViewComponentHelper 的 对 象 。IViewComponentHelper 允许 调用 同步 或 异步 方法 ， 例 如 Invoke、InvokeAsync、 
RenderInvoke 和 了 RenderinvokeAsync。 当然 , 只 能 调用 由 视图 组 件 实现 的 这 些 方 法 , 参数 需要 用 Dictionary<string, object> 
传递 ， 其 中 键 匹 配 参数 名 (代码 文件 MVCSampleApp/Views/ViewsDemo/UseViewComponentl.cshtml): 


@{ 
ViewBag.Title = "View Components Sample"™; 
} 
<h2>Q@VYiewBag .Title</h2> 
<D> 
Qawait Component.InvokeAsync ("EventList", new Dictionary<string, object>() 
{ 
["from"] = new DateTime (2018, 4, 1}), 
["to"] = new DateTime (2018, 4, 20) 
}) 
</p> 


自从 ASPNET Core 1.1 以 来 ， 就 可 以 使 用 Tag Helper 调用 视图 组 件 。Tag Helper 是 用 HTML 编写 的 一 一 类 
似 于 简化 视图 的 代码 。 创 建 男 一 个 视图 ， 来 调用 与 以 前 相同 的 视图 组 件 ， 要 为 视图 组 件 使 用 Tag Helper， 需 要 
添加 @addTagHelper 指令 和 视图 组 件 所 在 程序 集 的 名 称 一 一 在 这 个 示例 中 是 Web 应 用 程序 的 名 称 。 为 视图 组 件 
添加 Tag Helper 之 后 , 可 以 使 用 vc 标记 引用 视图 组 件 。 在 vc 标记 的 冒号 之 后 , 是 视图 组 件 的 名 称 。 当 类 用 Pascal 
命名 约定 定义 时 ，Tag Helper 通过 切换 到 小 写字 母 来 更 改名 称 ; 不 使 用 大 写字 母 ， 而 是 添加 了 连 字符 ， 因 此 
EventList 变 成 event-list( 代 码 文 件 MVCSampleApp/Views/ViewsDemo/UseViewComponent2.cshtm]l): 

QaddTagHelper *, MyCSamplenApp 

| 人 = "View Components Samplen"; 

} 


<h2>@viewBag .Title</h2> 
<ve:event-list from="@new DateTime (2018, 4, 1)" to="@new DateTime (2018, 4, 20})" /> 


注意 : 
带 小 写字 母 和 连 字 符 的 Tag Helper 的 命名 规则 称 为 lower kebab casing。 


注意 : 
Tag Helper 详 见 31.7 节 “Tag Helper” 。 


运行 应 用 程序 ， 呈 现 的 视图 组 件 如 图 31-6 所 示 。 


31.4.7 ”在 视图 中 使 用 依赖 注入 


如 果 服 务 需要 直接 出 现在 视图 中 ,可 以 使 用 inject 关键 字 注 入 (代码 文件 MVCSampleApp/Views/ViewsDemo/ 
InjectServicelnView.cshtml): 


using MyCSampleApp .Services 
Binject ISampleService sampleService 
<D> 
Qstring.Join(". * ", sampleService.GetSampleStrings()) 
</p> 
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图 31-6 


此 时 ， 最 好 使 用 AddScoped 方法 注册 服务 。 如 前 所 述 ， 以 这 种 方式 注册 服务 意味 着 只 为 一 个 HTTP 请 求实 
例 化 一 次 。 使 用 AddScoped 在 控制 器 和 视图 中 注入 相同 的 服务 ， 也 只 为 一 个 请 求实 例 化 一 次 。 


31.4.8 为 多 个 视图 导入 名 称 空间 


所 有 之 前 关于 视图 的 示例 都 使 用 using 关键 字 打 开 了 所 需要 的 所 有 名 称 空间 。 除 了 为 每 个 视图 打开 名 称 空 
间 之 外 ， 还 可 以 使 用 Visual Studio 项 模板 MVC View Imports Page 创建 一 个 文件 ( ViewImports.cshml)， 它 定义 
了 所 有 的 using 声明 (代码 文件 MVCSampleApp/Views/ ViewImports.cshtml): 


Qusing MvCSampleApp.Models 
Qusing MyvCSampleApp.Services 


有 了 这 个 文件 ， 就 不 需要 在 所 有 视图 中 添加 所 有 的 using 关键 字 。 


31.5 ”从 客户 端 提交 数据 


到 现在 为 止 ， 在 客户 闯 只 是 使 用 HTTP GET 请 求 来 获取 服务 器 端的 HTML 人 代码。 那么 ， 如 何 从 客户 端 肥 
送 表 单数 据 ? 

为 提交 表单 数据 ， 可 为 控制 器 SubmitData 创建 视图 CreateMenu。 该 视图 包含 一 个 HTML 表单 元 素 ， 它 定 
义 了 应 把 什么 数据 发 送 给 服务 器 。 表 单方 法 声明 为 HTTP POST 请 求 。 定 义 输入 字段 的 input 元 素 的 名 称 全 部 与 
Menu 头 型 的 属性 对 应 。 对 于 输入 元 紊 ， 使 用 与 属性 类 型 相对 应 的 类 型 。 这 人 允许 在 客户 机 上 进行 输入 验证 ， 而 
不 需要 编写 JavaScript 代码 (代码 文件 MVCSampleApp/Views/SubmitData/CreateMenu.cshtml): 

| 


ViewBag.Title = "Create Menu™; 


} 
<h2>Create Menu</h2> 
<form action="/SubmitData/CreateMenu" method="post"> 
区 主 il dset> 
<legend>Menu</1legend> 
<label for="id">Id</label><pbr /> 
<input name="id" id="id" type="number" /><br /> 


<label for="text">Text</label><br /> 
<input name="text" id="text" type="text" /><br /> 
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<label for="price">Price</label><br /> 
<input name="price" id="price" type="number" step="0.01" /><br /> 


<label for="date">Date</label><br /> 
<input name="date" id="date" type="date" /><br /> 


<label for="category">Category</label><br /> 
<input name="category" id="category" type="text" /><br /> 


<button type="submit">Submit</button> 


</fieldset> 
</form> 
图 31-7 显示 了 在 浏览 器 中 打开 的 页 面 。 
局 二 | 加 create Menu 半 上 wer 一 口 Xe | 
< 一 一 () fi localhost:4944/5 Data/Createle 广 二 A Ey 


ASP.NET Core MVC Sample App 


= Layout Sample 
= Layout Lsing Sections 


Create Menu 


Menmu 


| mm dd yyyy 
Category 


Submit 


Sample Code for Professional C¥# 
S2017 - My ASP.NET Application 


图 31-7 


在 SubmitData 控制 器 内 , 创建 了 两 个 CreateMenu 动作 方法 : 一 个 用 于 HTTP GET 请 求 , 男 一 个 用 于 HTTP 
POST 请 求 。 因 为 C# 中 存在 同名 的 不 同方 法 ， 所 以 这 些 方 法 的 参数 数量 或 参数 类 型 必须 不 同 。 动 作 方法 也 存在 
这 种 要 求 。 另外 , 动作 方法 还 需要 与 HTTP 请 求 方 法 区 分 开 。 默认 情况 下 , HITP 请 求 方法 是 GET, 应 用 HttpPost 
特性 后 ， 请 求 方法 是 POST。 为 读 取 HTTP POST 数据 ， 可 以 使 用 Request 对 象 中 的 信息 。 但 是 ， 定 义 带 参数 的 
CreateMenu 方法 要 简单 多 了 。 参 数 的 名 称 与 表单 字段 的 名 称 匹 配 (代码 文件 MVCSampleApp/Controllers/ 
submitDataController.cs): 


public IActionResult Index() => View!(); 
public IActionResult CreateMenu!() => View(); 


[HttpPost] 
public IActionResult CreateMenul(int id, string text, double price, 
DateTime date, string category) 
{ 
Var m = new Menu 
{ 
Id = 1id, 
Text = text, 
Price = price., 
Date = date, 
CategoryY = Category 
}; 


ViewBadg.Info = $"menu created: {m.Text}, Price: {m.Price}, ™ + 
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s"date: {m.Date}, category: {m.Category}"; 
return View{("Index™):; 


} 
为 了 显示 结果 ， 仪 显示 ViewBag.Info 的 值 (代码 文件 MVCSampleApp/Views/SubmitData/Index.cshtm)l): 


RViewBag. Info 


31.5.1 模型 绑 定 器 


除了 在 动作 方法 中 使 用 多 个 参数 ， 还 可 以 使 用 类 型 ， 类 型 的 属性 与 输入 的 字段 名 称 匹 配 ( 代 码 文件 
MVCSampleApp/Controllers/SubnmitDataController.cs): 


[HttpPost] 
public IActionResult CreateMenu2 (Menu menu) 
{ 
ViewBag.Info = $"menu created: {menu.Text}, Price: {menu.Price}, ™ + 


s"date: {menu.Date}, category: {menu.Category}"™; 
return View("Index™); 


} 

提交 表单 数据 时 ， 会 调用 CreateMenu 方法 ， 它 在 Index 视图 中 显示 了 提交 的 菜单 数据 ， 如 图 31-8 所 示 。 
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图 31-8 


模型 绑 定 器 负责 传输 HITP POST 请 求 中 的 数据 。 模 型 绑 定 器 实现 IModelBinder 接口 。 默 认 情 况 下 ， 使 用 
FormCollectionModelBinder 类 将 输入 字段 绑 定 到 模型 。 这 个 绑 定 器 支持 基本 类 型 、 模 型 类 (如 Menu 类 型 ) 以 及 实 
现 了 ICollection<T>、IList<T> 和 IDictionary<TKEey TValue> 的 集合 。 

如 果 并 不 是 所 有 参数 类 型 的 属性 都 应 从 模型 绑 定 器 中 填充 ， 此 时 可 以 使 用 Bind 特性 。 通 过 这 个 特性 ， 可 以 
指定 一 个 属性 名 列表 ， 这 些 属 性 被 应 用 于 绑 定 。 

还 可 以 使 用 不 带 参数 的 动作 方法 将 输入 数据 传递 给 模型 ， 如 下 面 的 代码 段 所 示 。 这 段 代 码 创 建 了 Menu 类 
的 一 个 新 实例 ， 并 把 这 个 实例 传递 给 Controller 基 类 的 TryUpdateModelAsync 方法 。 如 果 在 更 新 后 ， 被 更 新 的 模 
型 处 于 无 效 状态 ，TryUpdateModelAsync 就 返回 false: 


[HttpPost] 
Public async Task<IActionResult> CreateMenu3Result{() 
{ 
var m = new Menul().: 
bool updated = await TryUpdateModelAsync<Menu> (m); 
if (updated) 
{ 
ViewBag.Info = $"menu created: {m.Text}, Price: {m.Price}, ™ + 
s"date: {m.Date}, category: {m.Category}"; 
return View("Index"™); 
} 
else 
{ 
return View ("Error™); 
} 
} 
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可 以 癌 模 型 类 型 添加 一 些 注 解 ， 当 更 新 数据 时 ， 会 将 这 些 注 解 用 于 验证 。 名 称 空 间 System. 
ComponentModel.DataAnnotations 中 包含 的 特性 可 用 来 为 客户 问 数 据 指定 一 些 信 息 ， 或 者 用 来 进行 验证 。 
使 用 其 中 的 一 些 特性 来 修改 Menu 类 型 : 


Public class Menu 
{ 
public int Id { get; set; } 
[Required, StringLength (50)] 
public string Text { get; set; } 
[Display (Name="Price"), DisplavyFormat (DataFormatString="{0:C}")] 
public double Price { get; set; } 
[DataType (DataType .Date) ] 
public DateTime Date { get; set; } 
[StringLength (10)] 
Public string Category { get; set; } 
} 


可 用 于 验证 的 特性 包括 : 用 于 比较 不 同属 性 的 CompareAttribute 、 用 于 验证 有 效 信用 卡号 的 
CreditCardAttribute 、 用 来 验证 电子 邮件 地 址 的 EmailAddressAttribute 、 用 来 比较 输入 与 枚 举 值 的 
EnumDataTypeAttribute 以 及 用 来 验证 电话 号 码 的 PhoneAttribute。 

还 可 以 使 用 其 他 特性 来 获得 要 显示 的 值 或 者 用 在 错误 消息 中 的 值 ， 如 DataTypeAttribute 和 
DisplayFormatAttribute。 

为 了 使 用 验证 特性 ， 可 以 在 动作 方法 内 使 用 ModelState.IsValid 来 验证 模型 的 状态 ， 如 下 所 示 ( 代 码 文 件 
MVCSampleApp/Controllers/SumitDataController.cs): 


[HttpPost] 
public IActionResult CreateMenud (Menu menu) 
{ 
if (ModelSsState.IsValid) 
{ 
ViewBag.Info = $"menu created: {menu.Text}, Price: {menu.Price}, "+ 
s"date: {menu.Date}, category: {menu.Category}"; 
} 
全] Se 
{ 
ViewBag.Info = "not valid"™; 
} 
return View{("Index"™).; 


} 


如 果 使 用 工具 生成 的 模型 类 ， 则 很 难 给 属性 添加 特性 。 工 具 生 成 的 类 被 定义 为 部 分 类 ， 可 以 通过 为 其 添加 
属性 和 方法 、 实 现 额外 的 接口 或 者 实现 它们 使 用 的 部 分 方法 来 扩展 这 些 类 。 对 于 已 有 的 属性 和 方法 ， 如 果 不 能 
修改 类 型 的 源 代 码 ， 则 是 不 能 添加 特性 的 。 但 是 在 这 种 情况 下 ， 还 是 可 以 利用 一 些 帮 助 。 现 在 假定 Menu 类 是 
一 个 工具 生成 的 部 分 类 。 可 以 用 一 个 不 同名 的 新 类 (如 MenuMetadata) 定 义 与 实体 类 相同 的 属性 并 添加 注解 ， 如 
下 所 示 ( 代 码 文 件 MVCSampleApp/Models/MenuMetadata.cs): 


Public class MenuMetadata 
{ 
public int Id { get; set; } 
[Required, StringLength (25)] 
public string Text { get; set; 1} 
[Display (Name="Price"), DisplayFormat (DataFormatstring="{0:C}")] 
public double Price { get; set; } 
[DataType (DataType .Date)}] 
public DateTime Date { get; set; } 
[StringLength (10)] 
public string Category 1{ get; set; } 
} 


MenuMetadata 类 必须 链接 到 Menu 类 。 对 于 工具 生成 的 部 分 类 ， 可 以 在 同一 个 名 称 空 间 中 创建 男 一 个 部 分 
类 型 ， 将 ModelMetadataType 特性 添加 到 创建 该 连接 的 类 型 定义 中 : 
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[ModelMetadataType (typeof (MenuMetadata) ) ] 
Public partial class Menu 

{ 

} 


HTML 辅助 方法 也 可 以 使 用 注解 来 同 客 尸 端 添加 信息 。 


31.6 ”使 用 HTML Helper 


HTML Helper 是 创建 HTML 代码 的 Helper。 可 以 在 视图 中 通过 Razor 语法 直接 使 用 它们 。 

Html 是 视图 基 类 RazorPage 的 一 个 属性 ， 它 的 类 型 是 IHtmlHelper。HTML Helper 被 实现 为 扩展 方法 ， 用 
于 扩展 IHtmlHelper 接口 。 

类 InputExtensions 定义 了 用 于 创建 复 选 框 、 密 码 控件 . 单 选 按钮 和 文本 框 控件 的 HIML Helper。Helper Action 
和 RenderAction 由 类 ChildActionExtensions 定义 。 用 于 显示 的 Helper 由 类 DisplayExtensions 定义 。 用 于 HIML 
表单 的 Helper 由 类 FormExtensions 定义 。 

接 下 来 就 看 一 些 使 用 HTML Helper 的 例子 。 


31.6.1 简单 的 Helper 


下 面 的 代码 段 使 用 了 HTML Helper BeginForm、Label 和 CheckBox 。BeginForm 开始 一 个 表单 元 素 。 还 有 
一 个 用 于 结束 表单 元 素 的 EndForm。 示 例 使 用 了 BeginForm 方法 返回 的 MvcForm 所 实现 的 IDisposable 接口 。 
在 释放 MvcForm 时 ， 会 调用 EndForm。 因 此 ， 可 以 将 BeginForm 方法 放 在 一 条 using 语句 中 ， 在 闭 花 括号 处 结 
束 表 单 。-DisplayName 方法 直接 返回 参数 的 内 容 , CheckBox 是 一 个 input 元 素 , 其 type 特性 被 设置 为 checkbox( 代 
人 码 文 件 MVCSampleApp/Views/HtmlHelpers/SimpleHelper.cshtml): 


Qusing (Html .BeginForm()) 1 
@Html .DisplayName ("Check this (or not)"™) 
QHtml .CheckBox ("checkl"™) 

} 


得 到 的 HTML 代码 如 下 所 示 。CheckBox 方法 创建 了 两 个 同名 的 input 元 素 ， 其 中 一 个 设置 为 隐藏 。 其 原因 
是 ， 如 果 一 个 复 选 框 的 值 为 包 lse， 那 么 浏览 器 不 会 把 与 之 对 应 的 信息 放 到 表单 内 容 中 传递 给 服务 器 。 只 有 选中 
的 复 选 框 的 值 才 会 传递 给 服务 器 。 这 种 HTML 特征 在 自动 绑 定 到 动作 方法 的 参数 时 会 产生 问题 。 简 单 的 解决 办 
法 是 使 用 Helper CheckBox。 该 方法 会 创建 一 个 同名 但 被 隐藏 的 mput 元 素 ， 并 将 其 设 为 false。 如 果 没 有 选中 该 
复 选 框 ， 则 会 把 隐藏 的 input 元 素 传递 给 服务 器 ， 绑 定 false 值 。 如 果 选 中 了 复 选 框 ， 则 同名 的 两 个 input 元 素 都 
会 传递 给 服务 器 。 第 一 个 input 元 素 设 为 tue， 第 二 个 设 为 外 lse。 在 目 动 绑 定 时 ， 只 选择 第 一 个 input 元 素 进 行 
绑 定 : 


<form action="/HtmlHelpers/SimpleHelper™" method="post"> 
Check this (or not) 
<input id="checkl™" name="checkl™ type="checkbox"™ value="true™ /> 
<input name="checkl"™" type="hidden™" value="false™ /> 

</form> 


31.6.2 ”使 用 模型 数据 


Helper 可 以 使 用 模型 数据 。 下 例 创 建 了 一 个 Menu 对 象 。 本 章 前 面 在 Models 目录 中 声明 了 此 类 型 。 然 后 ， 
将 该 Menu 对 象 作 为 模型 传递 给 视图 (代码 文件 MVCSampleApp/Controllers/HIML HelpersController.cs): 


Public IActionResult HelperWithMenu() => View (GetSampleMenu () ) : 
private Menu GetSampleMenul() 三 > 
new Menu 


{ 
Id = 1, 
Text = "Schweinsbraten mit FKnedel und Sauerkraut™, 
Price = 6.9, 


Date = new DateTime (2017, 11, 14), 
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Category = "Malmnn" 
ts 


视图 有 一 个 模型 定义 为 Menu 类 型 。 与 前 例 一 样 ， HTML Helper DisplayName 只 是 返回 参数 的 文本 。Display 
方法 使 用 一 个 表达 式 作 为 参数 ， 其 中 以 字符 串 格 式 传递 一 个 属性 名 。 该 方法 试图 找 出 具有 这 个 名 称 的 属性 ， 然 
后 使 用 属性 存 取 器 来 返回 该 属性 的 值 (代码 文件 MVCSampleApp/Views /HTMLHelpers/HelperWithMenu.cshtml): 


model MvyCSampleApp .Models .Menu 
@{ 
ViewBag.Title = "HelperWithMenu™; 
} 
<h2>Helper with Menu</h2> 
Html .DisplayName ("Text:") 
QHtml .Display ("Text") 
<br /> 
aHtml .DisplayName ("Category:") 
&@Html .Display ("Category") 


在 得 到 的 HIML 代码 中 ， 可 以 从 调用 DisplayName 和 Display 方法 的 输出 中 看 到 这 一 扣 : 


Text: 

schweinsbraten mit Fng#246;del und Sauerkraut 
<br /> 

Category: 

Main 


注意 : 
Helper 也 提供 强 类 型 化 方法 来 访问 模型 成 员 ， 如 31.6.5 节 “ 强 类 型 化 的 Helper” 所 示 。 


31.6.3 定义 HTML 特性 


大 多 数 HIML Helper 都 有 一 些 可 传递 任何 HIML 特性 的 重 载 版 本 。 例 如 ， 下 面 的 TextBox 方法 创建 一 个 
文本 类 型 的 input 元 素 。 其 第 一 个 参数 定义 了 文本 框 的 名 称 ， 第 二 个 参数 定义 了 文本 框 设 置 的 值 。TextBox 方法 
的 第 三 个 参数 是 object 类 型 ,允许 传递 一 个 匿名 类 型 , 在 其 中 将 每 个 属性 改 为 HIML 元 素 的 一 个 特性 。 在 这 里 ， 
input 元 素 的 结果 是 将 required 特性 设 为 required， 将 maxlength 特性 设 为 5， 将 class 特性 设 为 CSSDemo。 因 
为 class 是 C# 的 一 个 关键 字 , 所 以 不 能 直接 设 为 一 个 属性 , 而 是 要 加 上 @ 作 为 前 缀 , 以 生成 用 于 CSS 样式 的 class 
特性 : 


QHtml .TextBox ("textl"™", "Input text here", 
new { required="required", maxlength=15, @class="CSSDemo™ }); 


得 到 的 HTML 输出 如 下 所 示 : 


<input name="textl1l" class="CSSDemo™" id="textl1l" maxlength="15" 
required="required™" type="text" value="input text here"™ /> 


31.6.4 创建 列表 


为 显示 列表 ， 需 要 使 用 DropDownList 和 ListBox 等 Helper。 这 些 Helper 会 创建 HIML select 元 素 。 

在 控制 器 内 ， 首先 创建 一 个 包含 键 和 值 的 字典 。 然 后 使 用 上 自 定义 扩展 方法 ToSelectListItems， 将 该 字典 转换 
为 SelectListItem 的 列表 。DropDownList 和 ListBox 方法 使 用 了 SelectListItem 集合 (代码 文件 MVCSampleApp/ 
Controllers/HTMLHelpersController.cs): 


public IActionResult HelperList () 

{ 
Var Cars = new Dictionary<int, string> (}); 
cars.Add(l1, "Red Bull Racing"™); 
cars.Add (2, "McLaren™}); 
cars.Add(3, "Mercedes™}); 
cars.Add (4, "Ferrari™); 
return View (cars.ToSelectListItems (4)). 
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自 定 义 扩 展 方法 ToSelectListItems 在 扩展 了 IDictionary<int，string> 的 SelectListItemsExtensions 类 中 定义 ， 
IDictionary<int，string> 是 cars 集合 中 的 类 型 。 在 其 实现 中 ， 只 是 为 字典 中 的 每 一 项 返回 一 个 新 的 SelectListItem 
对 象 (代码 文件 MVCSampleApp/Extensions/SelectListItemsExtensions.cs): 


public static class SelectListItemsExtensions 
{ 
public static IEnumerable<SelectListItem> ToSelectListItems'! 
this IDictionary<int, string> dict, int selectedId) 三 > 
dict.Select (item 一 > 
new SelectListItem 


Selected = item.Key == selectedId, 
Text = item.Value, 
Value = item.RKey.ToStringl() 
上 
} 


在 视图 中 ，Helper DropDownList 直接 访问 从 控制 器 返回 的 模型 (代码 文件 MVCSampleApp/Views/ 
HTMLHelpers/HelperList.cshtm!l): 


人 @{ 
ViewBag.Title = "Helper List™"; 
} 
model IEnumerable<SelectListItem> 
<h2>Helper2</h2> 
QHtml .DropDownList("carslist", Model) 


得 到 的 HIML 创建 了 一 个 select 元 素 , 该 元 素 包 含 通 过 SelectListItem 创建 的 一 些 option 子 元 素 。 这 些 HIML 
还 定义 了 从 控制 器 中 返回 的 选中 项 : 


<Sselect id="carslist" name="carslist"> 

<option value="1l">Red Bull Racing</option> 

<option value="2">McLaren</option> 

<option value="3">Mercedes</option> 

<option selected="selected™" walue="4">Ferrari</option> 
</select> 


31.6.5” 强 类 型 化 的 Helper 


HIML Helper 提供 了 强 类 型 化 的 方法 来 访问 从 控制 器 传递 的 模型 。 这 些 方法 都 带 有 后 缀 For。 例 如 ， 可 以 
使 用 TextBoxFor 代 蔡 TextBox 方法 。 

下 面 的 示例 再 次 使 用 返回 单个 实体 的 控制 器 (代码 文件 MVCSampleApp/Controllers/HTIML- 
HelpersController.cs): 

public IActionResult stronglyTypedMenu() => View(GetsampleMenu1() ) ; 

视图 使 用 Menu 类 型 作为 模型 ， 所 以 可 以 使 用 DisplayNameFor 和 DisplayFor 方法 直接 访问 Menu 属性 。 
DisplayNameFor 默认 返回 属性 名 (在 这 里 是 Text 属性 )，DisplayFor 返回 属性 值 (代码 文件 MVCSampleApp/ 
Views/HTMLHelpers/StronelyTypedMenu.cshtml): 


Rusing MVvCSampleApp.Models 
Rmodel Menu 

QHtml .DisplayNameFor (m => m.Text) 
<DI /> 

QHtml .DisplayFor (m => m.Text) 


类 似 地 ， 可 以 使 用 Html.TextBoxFor(m => m.Text)， 它 返回 一 个 允许 设置 模型 的 Text 属性 的 input 元 时。 该 
方法 还 使 用 了 添加 到 Menu 类 型 的 Text 属性 的 注解 。Text 属性 添加 了 Required 和 MaxStringLength 特性 ， 所 以 
TextBoxFor 方法 会 返回 data-val-length、data-val-length-max 和 data-val-required 特性 : 


<input data-—val="true"™ 
data-val-length="The field Text must be a string with a maximum length of S50." 
data—val—-length—max="50"™ 
data—val-required="The Text field is required.™" 
id="FileName TeXt” name="Text™" 
type="text™ 
value="Schweinsbraten mit Kn6del und Sauerkraut™ /> 
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31.6.6 ”编辑 器 扩展 


除了 为 每 个 属性 使 用 至 少 一 个 Helper 外 ，EditorExtensions 类 中 的 Helper 还 给 一 个 类 型 的 所 有 属性 提供 了 
一 个 编辑 器 。 
使 用 与 前 面相 同 的 Menu 模型 ， 通 过 方法 HtmlEditorForm => m) 构 建 一 个 用 于 编辑 菜单 的 完整 UI。 该 方法 
调用 的 结果 如 图 31-9 所 示 。 
后 器 | 加 EditorExtensions x | 十 


《一 EL (站 localhost4944/HtmlHelpers/EditorExtensions Tr j= 


ASP.NET Core MVC Sample App 


* Layout Sample 
* Layout Using Sections 


Editor Extensions 


1 
Text 


schweinsbraten mit Kned 
Price 


69 

Date 

11714/2017 
Category 


hain 


Sample Code for Professional C# 
© 2017 - My ASP.NET Application 


图 31-9 


除了 使 用 Html.EditorFor(m => m)， 还 可 以 使 用 Html.EditorForModel。EditorForModel 方法 会 使 用 视图 的 模 
型 ， 不 需要 显 式 指定 模型 。EditorFor 在 使 用 其 他 数据 源 (例如 模型 提供 的 属性 ) 方 面 更 加 灵活 ，EditorForModel 
需要 添加 的 参数 更 少 。 


31.6.7 “实现 模板 


使 用 模板 是 扩展 HIML Helper 的 结果 的 一 种 好 方法 。 模 板 是 HTML 辅助 方法 被 隐 式 或 显 式 使 用 的 一 个 简 
单 视图 ， 它 们 存储 在 特殊 的 文件 夹 中 。 显 示 模板 存储 在 视图 文件 夹 下 的 DisplayTemplates 文件 夹 中 (如 
Views/HtmlHelpers/DisplayTemplates)， 或 者 存储 在 共享 文件 光 中 (如 Shared/DisplayTemplates)。 共 至 文件 夹 由 全 
部 视图 使 用 ， 特 定 的 视图 文件 夹 则 只 有 该 文件 夹 中 的 视图 可 以 使 用 。 编 辑 器 模板 存储 在 EditorTemplates 文件 
夹 中 。 

现在 看 一 个 示例 。 在 Menu 类 型 中 , Date 属性 有 一 个 注解 DataType， 其 值 为 DataType.Date。 指 定 该 特性 时 ， 
DateTime 类 型 默认 并 不 会 显示 为 日 期 加 时 间 的 形式 ， 而 是 显示 为 短 日 期 格式 (代码 文件 
MVCSampleApp/Models/Menu.cs): 

public class Menu 

0 int Id { get; set; } 


[Required, StringLength (50)] 
public string Text { get; set; } 
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[Display (Name="Price"), DisplayFormat (DataFormatstring="{0:c}")] 
public double Price { get; set; } 


[DataType (DataType .Date)] 
Public DateTime Date 1{ get; set; } 


[stringLength (10)] 


public string Category { get; set; } 
} 


现在 为 日 期 创建 了 模板 。 这 里 使 用 了 长 日 期 字符 串 格 式 D 来 返回 Model， 将 这 个 日 期 字符 串 格式 D 和 藤 入 在 
CSS 类 为 markRed 的 div 标记 内 (代码 文件 MVCSampleApp/Views/HTMLHelpers/DisplayTemplates/Date.cshtml): 
<div class="markRed"> 
string.Format ("{0:D}", Model) 
/div> 
CSS 类 markRed 在 样式 表 中 定义 ， 用 于 设置 红色 (代码 文件 MVCSampleApp/wwwroot/css/Site.css): 
.markRed 1{ 
color: #f00; 
} 
现在 像 DisplayForModel 这 样 用 于 显示 的 HIML Helper 可 以 使 用 已 定义 的 模板 。 模 型 的 类 型 是 Menu， 所 以 
DisplayForModel 方法 会 显示 Menu 类 型 的 所 有 属性 。 对 于 Date， 它 找到 模板 Date.cshtml， 所 以 会 使 用 该 模板 以 
CSS 样式 显示 长 日 期 格式 的 日 期 (代码 文件 MVCSampleApp/Views/HTML Helpers/Display.cshtm)): 
Rmodel MVCSampleApp.Models .Menu 
"> = "Display"; 


} 
<h2>@ViewBag.Title</h2> 
QHtml .DisplayForModel () 


如 果 在 同一 个 视图 内 ， 茶 个 类 型 应 该 有 不 同 的 表示 ， 则 可 以 为 模板 文件 使 用 其 他 名 称 。 之 后 就 可 以 使 用 
UIHint 特性 来 指定 这 个 模板 的 名 称 ， 或 者 使 用 辅助 方法 的 模板 参数 指定 模板 。 


31.7 Tag Helper 


ASPNET Core MVC 提供 了 一 种 新 技术 ， 可 以 用 来 代替 HIML Helper: Tag Helper。 对 于 Tag Helper， 不 要 
编写 混合 了 HTML 的 C# 代 码 ， 而 是 使 用 在 服务 器 上 解析 的 HIML 特性 和 元 素 。 如 今 许 多 JavaScript 库 用 目 己 
的 特性 (如 Angulan 扩 展 了 HIML, 所 以 可 以 很 方便 地 把 自 定义 的 HIML 特性 用 于 服务 器 端 技 术 。 许 多 ASPNET 
Core MVC Tag Helper 都 有 前 缀 asp-， 所 以 很 容易 看 出 在 服务 器 上 解析 了 什么 。 这 些 特性 不 发 送 给 客户 端 ， 而 是 
在 服务 器 上 人 解析， 生成 HIML 代码 。 


31.7.1 激活 Tag Helper 


要 使 用 ASPNET Core MVC Tag Helper， 需 要 调用 addTagHelper 来 激活 标记 。 它 的 第 一 个 参数 定义 了 要 使 
用 的 类 型 (* 会 打开 程序 集 的 所 有 Tag Helper); 第 二 个 参数 定义 了 Tag Helper 的 程序 集 。 使 用 removeTagHelper， 
会 再 次 取消 激活 Tag Helper。 取 消 激 活 Tag Helper 可 能 很 重要 ， 例 如 不 与 脚本 库 发 生命 名 冲突 。 给 内 置 的 Tag 
Helper 使 用 asp- 前 缀 ， 发 生 剖 突 的 可 能 性 最 小 ， 但 如果 内 置 的 Tag Helper 与 其 他 的 Tag Helper 同名 ， 其 他 的 Tag 
Helper 有 用 于 脚本 库 的 HIML 特性 ， 就 很 容易 发 生 冲突 。 

为 了 使 Tag Helper 可 用 于 所 有 的 视图 , 应 把 addTagHelper 语句 添加 到 共享 文件 ViewImports.cshtml 中 (代码 
文件 MVCSampleApp/Views/ ViewImports.cshtml): 


QaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


31.7.2 使 用 锁定 Tag Helper 
下 面 从 扩展 锚 元 素 a 的 Tag Helper 开始 。Tag Helper 的 示例 控制 器 是 TagHelpersController。Index 动作 方法 
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返回 一 个 视图 ， 用 来 显示 销 Tag Helper (代码 文件 MVCSampleApp/Controllers/TagHelpersController cs): 


public class TagHelpersController : Controller 
{ 

public IActionResult Index() => View!(); 

1 _---。 
} 


锚 Tag Helper 定义 了 asp-controller 和 asp-action 特性 。 之 后 ， 控 制 器 和 动作 方法 用 来 建立 销 元 素 的 URL。 
在 第 二 个 和 第 三 个 例子 中 ， 不 需要 控制 器 ， 因 为 视图 来 自 相 同 的 控制 器 (代码 文件 MVCSampleApp/Views/ 
TaegHelpers/Index.cshtml ): 


<a asp-controller="Home" asp-action="Index">Home</a> 

<br /> 

<a asp-action="LabelHelper">Label Tag Helper</a> 

<br /> 

<a asp-action="InputTypeHelper">Input Type Tag Helper</a> 


以 下 代码 段 显 示 了 生成 的 HTML 代码 。asp-controller 和 asp-action 特性 为 a 元 素 生 成 了 href 特性 。 在 第 一 个 
示例 中 ， 为 了 访问 Home 控制 器 中 的 Index 动作 方法 ， 因 为 它们 都 是 路 由 定义 的 默认 值 ， 所 以 结果 中 只 需要 指 
同 “/” 的 href。 指 定 asp-action LabelHelper 时 ，href 指 辣 /TagHelpers/LabelHelper， 即 当前 控制 器 中 的 动作 方法 


LabelHelper: 
<a href="/">Home</a> 
<br /> 
<a href="/TagHelpers/LabelHelper">Label Tag Helper</a> 
<br /> 


<a href="/TagHelpers/InputTypeHelper">Input Type Tag Helper</a> 


31.7.3 使 用 Label Tag Helper 


下 面 的 代码 段 展示 了 Label Tag Helper 的 功能 ， 其 中 动作 方法 LabelHelper 把 Menu 对 象 传递 到 视图 (代码 文 
件 MVCSampleApp/Controllers/TagHelpersController.cs): 


public IActionResult LabelHelper() => View (GetSampleMenu()); 
private Menu GetSampleMenu!() 三 > 
new Menu 


{ 


Text = "Schweinsbraten mit Knedel und Sauerkraut™, 
Price = 6.9, 

Date = new DateTime (2018, 10, 5), 

Category = "Main™ 

} 7 

} 


Menu 类 应 用 了 一 些 数据 注解 , 用 来 影响 Tag Helper 的 结果 。 看 一 看 Text 属性 的 Display 特性 。 它 将 Display 
特性 的 Name 属性 设置 为 “Menu”( 代 码 文件 MVCSampleApp/Models/Menu.cs): 


Public class Menu 


{ 
public int Id { get; set; } 


[Required, StringLength (50) ] 
[Display (Name = "Menu") ] 
public string Text { get; set; } 


[Display (Name = "Price"), DisplayFormat (DataFormatSstring = "{0:cC}")] 
Public double Price 1{ get; set; } 


[DataTYype (DataTYype .Date})l] 
public DateTime Date { get; set; } 


[StringLength (10)] 
public string Category { get; set; } 
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视图 利用 了 应 用 于 标签 控件 的 asp-for 特 性 。 用 于 此 特性 的 值 是 视图 模型 的 一 个 属性 。 在 Visual Studio 2017 
中 ， 可 以 使 用 智能 感知 来 访问 Text、Price 和 Date 属 性 (代码 文件 MVCSampleApp/Views/TagHelpers/LabelHelper. 
cshtml): 


model MvCSampleApp.Models .Menu 
人 @{ 
ViewBag.Title = "Label Tag Helper"™; 
} 
<h2>@ViewBag.Title</h2> 
<label asp-for="Text"></label> 
<br/> 
<label asp-for="Price"></label> 
<pbr /> 
<]label asp-for="Date"></]label> 


在 生成 的 HTML 代码 中 ， 可 以 看 到 for 特性 ， 它 引用 的 元 素 与 属性 同名 ， 内 容 是 属性 名 或 Display 特性 的 
值 。 还 可 以 使 用 此 特性 本 地 化 值 


<]label for="Text">Menu</label> 
<br/> 

<label for="Price">Price</label> 
<br /> 

<label for="Date">Date</label> 


31.7.4 使 用 Input Tag Helper 


HTML 标签 通常 与 input 元 素 相 关 。 下 面 的 代码 段 说 明了 使 用 input 元 素 和 Tag Helper 会 生成 什么 (代码 文件 
MVCSampleApp/Views/TagHelpers/InputHelper.cshtml): 


<dliv> 
<label asp-for="Text"></label> 
<input asp-for="Text"/> 
</div> 
<dlv> 
<label asp-for="Price"></label> 
<input asp-for="Price" /> 
</div> 
<dliv> 
<label asp-for="Date"></label> 
<input asp-for="Date" /> 
</div> 


检查 生成 的 HIML 代码 的 结果 ， 会 发 现 input 类 型 的 Tag Helper 根据 属性 的 类 型 创建 一 个 type 特性 ， 它 们 
也 应 用 了 DateType 特性 。 属 性 Price 的 类 型 是 double， 得 到 一 个 数字 输入 类 型 。 因 为 Date 属性 的 DataType 应 
用 了 DataType.Date 值 ， 所 以 输入 类 型 是 日 期 。 此 外 ， 还 创建 了 data-val-length 、data-val-length-max 和 
data-val-required 特性 ， 用 于 注解 : 


<dliv> 
<label for="Text">Text</label> 
<input type="text" data-val="true"™ 
data-val-length="The field Text must be a string with a maximum length of 50."™ 
data—val-length-max="50" data—val-required="The Text field js required." 
id="Text™" name="Text" 
value="Schweinsbraten mit Kng#xFé;del und Sauerkraut™ /> 
</div> 
<dly> 
<label for="Price">Price</label> 
<input type="text" data—val="true" 
data—val—-number="The field Price must be a number.™" 
data-val-regquired="The Price field 1s regquired.™" id="Price"™ 
name="Price"™" value="6.9" /> 
</div> 
<dlyv> 
<label] for="Date">Date</label> 
<input type="date™" data—val="true" 
data—val-required="The Date field is required.™" id="Date™" name="Date"™ 
value="2018-10-05"™ /> 
</div> 


现代 浏览 器 给 HIML 5 输入 控件 (如 日 期 控件 ) 提 供 了 特别 的 外 观 .Microsoft Edge 的 输入 日 期 控件 如 图 31-10 
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所 示 ， 它 不 同 于 其 他 浏览 器 。 
四 呈 | 品 Input Tag Helper 


“一 > | (DD) localhost4944/TagHelpers Yr = 


ASP.NET Core MYC Sample App 


* Lavout Sample 
Lavout Using Sections 


Input Iag Helper 


Text 上 as so ee 


Price 


June 
Date| 


July 
Samp : August 


全 20] 
September 


November ; 
December 
January 


February 


31.7.5 ”使 用 表单 进行 验证 


为 了 把 数据 发 送 到 服务 器 , 输入 字段 需要 用 表单 包围 起 来 .表单 的 Tag Helper 使 用 asp-method 和 asp-controller 
定义 了 action 特性 。 对 于 input 控件 ， 验 证 信息 是 由 这 些 控件 定义 的 。 需 要 显示 验证 错误 。 为 了 显示 ， 验 证 消息 
Tag Helper 用 asp-validation-for 扩展 了 span 元 系 ( 代 码 文 件 MVCSampleApp/Views/TagHelpers/FormHelper.cshtm)): 


<form method="post" asp-method="FormHelper"> 
<input asp-for="Id" hidden="hidden™ /> 
<hr /> 
<label asp-for="Text"></label> 
<dliv> 
<input asp-—for="Text" /> 
<span asp-validation-for="Text"></span> 
</div> 
<bT /> 
<label asp-for="Price"></label> 
<dliv> 
<input asp-for="Price™ /> 
<span asp-validation-for="Price"></span> 
</div> 
<br /> 
<label asp-for="Date"></label> 
<AdlvV> 
<input asp-for="Date™" /> 
<span asp-validation-for="Date"></span> 
</div> 
<label asp-for="Category"></label> 
<AdlvV> 
<input asp-for="Category™ /> 
<span asp-validation-for="Category"></span> 
</div> 
<input type="submit"™" value="Submit"™" /> 
/form> 
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控制 器 检查 ModelState， 验 证 接收 数据 是 否 正确 。 如 果 不 正确 ， 就 再 次 显示 同样 的 视图 (代码 文件 
MVCSampleApp/Controllers/TaeHelpersController.cs): 


Public IActionResult FormHelper() => View (GetSampleMenu()); 


[HttpPost] 
Public IActionResult FormHelper (Menu m) 
{ 
1if (IModelSstate.IsValid) 
{ 
return View (m); 
] 
return View("ValidationHelperResult", m); 


} 
运行 应 用 程序 时 ， 错 误 信息 如 图 31-11 所 示 。 
时 本 | 日 Formhalper x Be a 口 x 


《一 Ee) (iD localhost:494 | ye 六 | J 


ASP.NET Core MVC Sample App 


s Lavout Sarmple 
* Lavout [sins Sections 


Form Helper 


Text |Schweinsbraten mit Knac 
Price |6.9 

Date |18/5/2818 
Category |This category is too long | | The field Category must be a string with a maximum length of 10. 
| Submit 


Sample Code for Professional C# 
CC 2017 - My ASPNET Application 


图 31-11 


31.71.6 environment lag Helper 

environment Tag Helper 允许 用 户 界 面 的 特定 部 分 仅 在 特定 的 环境 中 可 用 。 第 30 章 展 示 了 如 何 使 用 具有 
EnvironmentalName 属性 、 扩 展 方法 IDevelopment、IsStasging 和 IsProduction 的 IHostingEnvironment 接口 区 分 
不 同 的 环境 。environment Tag Helper 支持 类 似 的 功能 。 

在 下 面 的 代码 片段 中 ， 只 有 在 使 用 include 特性 在 Development 和 Staging 环境 中 运行 时 ， 才 使 用 第 一 个 环 
境 标 记 来 显示 包含 的 内 容 。 第 二 个 环境 标记 不 包括 Production 环境 ; 因此 , 包含 的 内 容 在 Development、Staging 
和 其 他 可 以 配置 的 环境 中 显示 (代码 文件 MVCSampleApp/Views/TagHelpers/EnvironmentHelper.cshtm)): 


<environment include="Development, Staging™"> 
<div>This shows up for the <strong>Development</strong> 
and <strong>3staging</strong> environments</div> 
</environment> 
<environment exclude="Production"> 
<div>Not visible in the <strong>Production</strong> environment</div> 
</environment> 


可 以 通过 设置 环境 变量 ASPNETCORE ENVIRONMENT 来 配置 活动 环境 ， 这 可 以 通过 Visual Studio 中 的 
项 目 设置 完成 (参见 图 31-12)， 也 可 以 通过 配置 launchsettings.json 文件 来 完成 。 
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| MVCSampleApp - MVCSampleApp 
| 看 3 


MIVCsampleApp 
| Application 
| Build 

Build Events 
Package 一 川 号 Express 
Signing Li - lIS Express 
Typescript 日 wild 


Resources 


Werking directory. 
Iw) Launch browser 


Envwironment vanalbles: Narrme Value 


ASPNETCORE_ENVIRONMENT Development 


App URL: http -iocalhestdedd 
IIS Express Biness: | Default 

|_| Enasls SSL 

| Enable Anonymous Authentication 


[| Enable Windows Authantication 


图 31-12 


31.7.7 创建 自 定 义 Tag Helper 


除了 使 用 预定 义 的 Tag Helper 之 外 ， 也 可 以 创建 自 定义 的 Tag Helper。 第 一 个 自 定义 Tag Helper 在 NuGet 
包 Markdig 的 帮助 下 将 Markdown 代码 转换 为 HIML。 


注意 : 

Markdown 是 一 种 可 以 通过 文本 编辑 器 轻松 创建 的 标记 语言 。Markdown 很 容易 转换 成 HIML。 请 登录 
https://csharp.christiannagel.com/2016/07/03/markdown/ 阅 读 博 客 文 章 “Usine Markdown”， 了 解 使 用 .NET 和 
Markdown 的 信息 。 


Tag Helper MarkdownTagHelper 在 一 个 名 为 TagHelperSamples 的 .NET _ Core 库 中 实现 ， 该 库 引 用 了 NuGet 
包 Microsoft.AspNetCore.all 和 Markdig。 

下 面 的 代码 片段 显示 了 MarkdownTagHelper 的 类 声明 。Tag Helper 派生 目 基 类 TagHelper。 特 性 
HtmlTargetElement 定义 了 用 于 指定 Tag Helper 的 元 素 或 特性 名 称 。 这 个 Tag Helper 可 以 与 markdown 元 素 一 起 
使 用 ， 也 可 以 与 在 div 元 系 中 使 用 的 markdownfile 特性 一 起 使 用 。 如 果 元 素 需 要 目 闭 ( 枚 举 值 WithoutEndTag， 
或 者 使 用 NormalOrSelfClosing 允许 结束 标记 或 目 闭 )， 那 么 TagStucture 特性 允许 进行 配置 (代码 文件 
TaeHelperSamples/MarkdownTaeHelper.cs.cs): 


[HtmlTargetElement ("markdown™, 

TagSstructure = Tagstructure.NormalOrselfclosing)] 
[HtmlTargetElement (Attributes = "markdownfile")] 
public class MarkdownTagHelper : TagHelper 
{ 
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站 
} 


Tag Helper 可 以 使 用 依赖 注入 。 因 为 MarkdownTagHelper 需要 wwwroot 文件 的 目录 ， 这 个 目录 是 从 
IHostingEnvironment 接口 中 返回 的 ， 所 以 这 个 接口 被 注入 到 构造 函数 中 : 


private readonly IHostingEnvironment env; 
Public MarkdownTagHelper (IHostingEnvironment env) => env = enVr 


Tag Helper 的 属性 在 用 HtmlAttributeName 特性 注释 时 自动 应 用 于 基础 结构 。 在 这 里 ， 属 性 MarkdownFile 
从 markdownfile 特性 中 获取 其 值 : 


[HtmlAttributeName ("markdownfile")] 
Public string MarkdownFile { get; set; } 


接 下 来 了 解 这 个 Tag Helper 的 主要 功能 。Tag Helper 需要 重 写 其 中 一 个 方法 Process 或 ProcessAsync。 当 需 
要 异步 功能 时 ， 将 使 用 ProcessAsync 方法 ， 而 如 果 只 调用 同步 方法 ， 则 可 以 使 用 Process 方法 。 下 面 的 代码 片 
段 重 写 了 ProcessAsync 方法 ， 因 为 在 实现 中 使 用 了 异步 方法 GetChildContentAsync。 通 过 实现 ， 可 以 考虑 
MarkdownTagHelper 的 两 个 不 同 用 法 。 一 种 用 法 是 指定 markdown 元 素 ， 其 内 容 作为 元 素 的 子 元 率 ， 另 一 种 用 
法 是 引用 Markdown 文件 的 Markdownfile 特性 。 

如 果 使 用 了 特性 markdownfile， 就 设置 MarkdownFile 属性 ， 从 而 读 取 此 属性 指定 的 文件 ， 并 将 内 容 写 入 
markdown 变量 。 文 件 的 目录 通过 类 型 为 [HostingEnvironment 的 env 变量 检索 。 这 个 接口 定义 了 WebRootPath 
属性 ， 该 属性 返回 Web 文件 的 根 路 径 。 

如 果 没 有 设置 MarkdownFile 属性 ， 而 是 使 用 markdown 元 素 ， 则 读 取 该 元 素 的 内 容 。 使 用 TagHelperOutput 
可 以 访问 markdown 中 指定 的 元 素 内 容 。 要 检索 内 容 ， 需 要 调用 GetChildContentAsync 方法 ， 在 这 个 方法 返回 
后 , 需要 调用 GetContent 方 法 ,最 终 返 回 HIML 页 面 中 指定 的 内 容 。 使 用 Markdig 库 的 Markdown 类 ,将 Markdown 
内 容 转换 为 HIML。 然 后 将 调用 SetHtmlContent 方法 ， 此 HTML 代码 放 入 TagHelperOutput 的 内 容 中 (代码 文件 
TagHelperSamples/MarkdownTagHelper.cs): 

public override async Task ProcessAsyne (TagHelperContext context, 

TagHelperoutput output) 

{ 


if (context == null) throw new ArgumentNullException (nameof (context)); 
if (output == null) throw new ArgumentNullException (nameof (output)); 


string markdown = string.Empty; 

if (MarkdownFile != null) 

{ 
string filename = Path-ComblIne ( env.WebRootPath, MarkdownF1ile); 
markdown = Flile.ReadAllText (filename); 


} 
全 号 忌 
{ 
markdown = (await cutput.GetChildcContentAsync(})) .GetContent(); 
} 
output .Content .SetHtmlContent (Markdown .ToHtml (markdown) )，; 
} 


在 创建 MarkdownTagHelper 之 后 ， 可 以 在 CSHTML 文件 中 使 用 它 。 首 先 ，(@addTagHelper 添加 来 自 库 
TagHelperSamples 的 所 有 Tag Helper。 在 HTML 代码 中 ,使 用 markdown 元 素 。 这 个 元 素 包含 一 小 段 Markdown 
语法 ， 包 括 标题 2、 一 个 链接 和 一 个 列表 (代码 文件 MVCSampleApp/Views/TagHelpers/Markdown.cshtm]): 

QaddTagHelper *, TagHelperSamples 

<h2>Markdown Sample</h2> 


markdown> 
## This is simple Markdown 


[C# Blog] (https://csharp.christiannagel .com) 


* one 

去 七 林口 

让 three 
</markdown> 
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运行 应 用 程序 时 ，markdown 语法 被 转换 为 HIML， 如 图 31-13 所 示 。 
嘎 酌 ' 量 lecalhost x [ken 


(1) localhostiA4944/TagHelpers/Ma Tr vs 


ASP.NET Core MVC Sample App 


* Lavyout Sample 
* Lavout Usimne Sections 


Markdown Sample 


This is simple Markdown 


Sample Code for Professional C# 
© 2017 - MY ASP NET Application 


图 31-13 


现在 , 通过 创建 文件 Sample.md( 包 含 与 前 面 所 示 相 同 的 Markdown 内 容 ), 并 引用 markdownfile 特性 中 的 文 
件 可 以 实现 相同 的 功能 (代码 文件 MVCSampleApp/Views/TagHelpers/MarkdownAttribute.cshtm]): 
<div markdownfile="Sample.md"></div> 


这 样 ，MarkdownTagHelper 的 属性 MarkdownFile 就 设置 好 了 ， 因 此 会 读 取 markdown 文件 。 
31.7.8 用 Tag Helper 创建 元 素 


本 节 建 立 的 示例 自 定 义 Tag Helper 扩展 了 HTML 元 素 table, 为 列表 中 的 每 项 显示 一 行 , 为 每 个 属性 显示 一 
列 。 把 数据 信息 的 模型 传递 给 Tag Helper，Tag Helper 就 会 动态 创建 tble、tr、 也 和 td 元 素 。 应 创建 的 信息 使 用 
反射 来 完成 。 类 似 这 样 的 功能 也 可 以 在 视图 组 件 中 实现 ， 视 图 Helper 可 以 与 Tag Helper 一 起 使 用 。 本 节 详 细 介 
绍 如 何 创建 更 复杂 的 Tag Helper， 使 用 TagBuilder 类 动态 创建 HIML 元 素 。 


注意 : 
反射 参见 第 16 章 。 


对 于 本 例 , 控制 器 实现 了 方法 CustomHelper, 以 返回 包含 Menu 对 象 列表 的 视图 (代码 文件 MVCSampleApp/ 
Controllers/TagHelpersController.cs): 
Public IActionResult CustomTable() => View(lGetSampleMenus ()); 


private IList<Menu> GetSampleMenus{() => 
new List<Menu> {() 
{ 
new Menu 
{ 
1d = 1, 
Text = "Schweinsbraten mit Kn6del und Sauerkraut™, 
Price = 8.5, 
Date = new DateTime (2018, 10, 5), 
Category = "Main™ 
] 
new Menu 
{ 
Id = 2, 
Text = "Erdipfelgulasch mit Tofu und Geback"™", 
Price = 8.5, 
Date = new DateTime (2018, 10, 6),， 
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Category = "Vegetarian™ 
}, 
new Menu 
{ 
Id = 3, 
Text = "Tiroler Bauerngr6st'"l1 mit Spiegeleli und Krautsalat™, 
Price = 8.5, 
Date = new DateTime (2018, 10, 7),， 
Category = "Vegetarian"™ 
} 


}; 

Tag Helper 类 TableTagHelper 用 HTML table 元 对 激活 。 与 前 面 使 用 markup 元 素 的 辅助 程序 相反 ， 这 个 辅 
助 程序 与 有 效 的 HTML 元 素 一 起 使 用 。HtmlTargetElement 指定 table 和 items 特性 来 应 用 这 个 辅助 程序 ， 这 个 
items 特性 用 于 设置 Items 属性 ， 与 HtmlAttributeName 特性 指定 Items 属性 一 样 (代码 文件 TagHelperSamples/ 
TableTaeHelper.cs): 

[HtmlTargetElement ("table™", Attributes = ItemsAttributeName)] 

i class TableTagHelper : TagHelper 


private const string ItemsAttributeName = "items"™"; 


[HtmlAttributeName (ItemsAttributeName)] 
Public IEnumerable<object> Items { get; set; ]} 
ee 

} 


Tag Helper 的 核心 是 方法 Process。 这 次 可 以 使 用 这 个 方法 的 同步 变 体 ， 因为 实现 代码 中 没有 使 用 异步 方法 。 
通过 方法 Process 的 参数 ， 接 收 一 个 TagHelperContext。 这 个 上 下 文 包含 应 用 了 Tag Helper 的 HIML 元 素 和 所 
有 子 元 系 的 特性 。 对 于 使 用 Tag Helper 时 指定 的 表 元 素 ， 行 和 列 可 能 已 经 定义 ， 可 以 合并 该 结果 与 现 有 的 内 容 。 
在 示例 中 ， 这 被 忽略 了 ， 只 是 把 特性 放 在 结果 中 。 结 果 需 要 写 入 第 二 个 参数 : TagHelperOutput 对 象 。 为 了 创建 
HTML 代码 ， 使 用 TagBuilder 类 型 。TagBuilder 帮助 通过 特性 创建 HTML 元 素 ， 它 还 处 理 元 率 的 关闭 。 为 了 给 
TagBuilder 添加 特性 ， 使 用 MergeAttributes 方法 。 这 个 方法 需要 一 个 包含 所 有 特性 名 称 和 值 的 字典 。 这 个 字典 
使 用 LINQ 扩展 方法 ToDictionary 创建 ,在 Where 方法 中 , 提取 表 元 素 所 有 已 有 的 特性 , 但 items 特性 除外 ,items 
特性 用 于 通过 Tag Helper 定义 项 ， 但 以 后 在 客户 端 不 需要 它 : 


public override void Process (TagHelperContext context, TagHelperoQutput output) 
{ 

1if (context == null) throw new ArgumentNullException (nameof (context))}),; 

if (output == null}) throw new ArgumentNullException (nameof (output)).; 


var table = new TagBuilder("table"™).,; 
table.GenerateId (context .UniqueId, "id"™); 
var attributes = context .AllAttributes 
.Wherela => a.Name != ItemsAttributeName) 
.ToDictionaryl(a => a.Name); 
table.Mergenttributes (attributes); 


PropertyInfo[] properties = CreateHeading (table); 
i... 


注意 : 
LINQ 参见 第 12 章 。 


接 下 来 ， 使 用 CreateHeading 方法 创建 表 中 的 第 一 行 。 这 一 行 包含 一 个 tf 元 素 ， 作 为 table 元 素 的 子 元 素 ， 
它 还 为 每 个 属性 包 合 td 元 素 。 为 了 获得 所 有 的 属性 名 ， 调 用 First 方法 ， 检 索 集合 的 第 一 个 对 象 。 使 用 反射 访 
问 该 实例 的 属性 ， 调 用 Type 对 象 上 的 GetProperties 方法 ， 把 属性 的 名 称 写 入 HTML 元 素 也 的 内 部 文本 : 


private PropeIrtyInfto[] CreateHeading (TagBuilder table) 
{ 
Var tr = new TagBuilder ("tr").; 
var heading = Items.First(); 
PropertyInfo[] properties = heading.GetType(}) .GetProperties (}); 
foreach (var prop in properties) 
{ 
Var th = new TagBuilder ("th"); 


792 | 第 由 部 分 Web 应 用 程序 和 服务 


th.InnerHtml .Append (PFCOP -Namelh 
tr.InnerHtml .AppendHtml (th}); 
} 
table.InnerHtml .AppendHtml (tr); 
return properties; 


} 
Process 方法 的 最 后 一 部 分 所 历 集合 的 所 有 项 ， 为 每 一 项 创建 更 多 的 行 (t)。 对 于 每 个 属性 ， 添 加 td 元 素 ， 
将 属性 的 值 写 入 为 内 部 文本 。 最 后 ， 将 所 建 table 元 素 的 内 部 HIML 代码 写 到 输出 : 


foreach (var item in Items) 
{ 
tr = new TagBuilder ("tr"); 
foreach (var prop in properties) 
| 
Var td = new TagBuilder ("td"}); 
td.InnerHtml .Append (prop.GetValue (Item) .ToString(})); 
tr.InnerHtml .AppendHtml (td}.; 
} 
table.InnerHtml .AppendHtml 七 工 ) 
} 
CUtEPUE .Content.Append'ltable.InnerHtml}); 
} 


在 创建 Tag Helper 之 后 , 创建 视图 就 变 得 非常 简单 。 定义 了 模型 后 , 传递 程序 集 的 名 称 , 通过 addTagHelper 
引用 Tag Helper。 使 用 特性 items 定义 一 个 HIML 表 时 , 实例 化 Tag Helper 本 喘 (代码 文件 MVCSampleApp/Views/ 
TagHelpers/CustomHelper.cshtml ): 

model IEnumerable<Menu> 


AaaddTagHelper *, MVCSampleApp 
<table items="Model" class="sample"></table> 


运行 应 用 程序 时 ， 表 应 该 如 图 31-14 所 示 。 创 建 了 Tag Helper 后 ， 使 用 起 来 很 简单 。 使 用 CSS 定义 的 所 有 
格式 仍 适 用 ， 因 为 定义 的 HIML 表 的 所 有 特性 仍 在 生成 的 HTML 输出 中 。 
中 局 custom fable Helper Xx 二 到 


和 Ed CO) (Ci) localhost494: 


ASP.NET Core MVC Sample App 


sa Lavout Sample 
" Lavout Usme Sectons 


Custom Table Helper 


Id Text Price Date Category 
] Schweinsbraten mt 有 madel und Sauerkraut 853 103/2018 12:00-00 AM Main 

2 Erdapfelogulasch mit Tofu und Geback 853 1062018 12:00:00 AM Wegetarian 
3 Tiroler BauernerSst] mit Spiegelel und Krautsalat 8 3 C10/7/2018 12:00:00 AM Vegetarian 


Sample Code for Professional C# 
尼 2017 - My ASP.NET Application 


图 31-14 


31.8 ”实现 动作 过 滤器 


ASPNET Core MVC 在 很 多 方面 都 可 以 扩展 。 可 以 实现 控制 器 工厂 ， 以 搜索 和 实例 化 控制 器 (接口 
IControllerFactory)。 控 制 器 实现 了 IController 接口 。 使 用 IActionInvoker 接口 可 以 找 出 控制 器 中 的 动作 方法 。 使 
用 派生 目 ActionMethodSelectorAttribute 的 特性 类 可 以 定义 允许 的 HITP 方法 。 通 过 实现 IModelBinder 接口 ， 可 
以 定制 将 HITP 请 求 映 射 到 参数 的 模型 绑 定 器 。 在 31.5.1 节 " 模型 绑 定 器 "中 , 使 用 过 FormCollectionModelBinder 
类 型 。 有 实现 了 IViewEngine 接口 的 不 同 视 图 引擎 可 供 使 用 。 在 本 章 中 ， 使 用 了 Razor 视图 引擎 。 使 用 HTML 
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Helper、Tag Helper 和 动作 过 滤器 也 可 以 实现 目 定 义 。 大 多 数 可 以 扩展 的 地 方 都 不 在 本 书 讨 论 范 围 内 ， 但 是 由 于 
很 可 能 需要 实现 或 使 用 动作 过 滤器 ， 所 以 下 面 就 加 以 讨论 。 

在 动作 执行 之 前 和 之 后 ， 都 会 调用 动作 过 滤器 。 使 用 特性 可 把 它们 分 配给 控制 器 或 控制 器 的 动作 方法 。 通 
过 创建 派生 目 基 类 ActionFilterAttribute 的 类 ， 可 以 实现 动作 过 滤器 。 在 这 个 类 中 ， 可 以 重 写 基 类 成 员 
OnActionExecuting、OnActionExecuted、OnResultExecuting 和 OnResultExecuted。OnActionExecuting 在 动作 方 
法 调用 之 前 调用 ，OnActionExecuted 在 动作 方法 完成 之 后 调用 。 之 后 ， 在 返回 结果 前 ， 调 用 OnResultExecuting 
方法 ， 最 后 调用 OnResultExecuted 方法 。 

在 这 些 方 法 内 ， 可 以 访问 Request 对 和 象 来 检索 调用 者 信息 。 然 后 根据 浏览 器 决定 执行 菏 些 操作 、 访 问 路 由 
信息 、 动 态 修改 视图 结果 等 。 下 面 的 代码 段 访 问 路 由 信息 中 的 变量 language。 为 把 此 变量 添加 到 路 由 中 ， 可 以 
把 路 由 修改 为 如 31.2 节 “ 定 义 路 由 ”所 示 。 用 路 由 信息 添加 language 变量 后 ， 可 以 使 用 RouteData Values 访问 
URL 中 提供 的 值 ， 如 下 面 的 代码 段 所 示 。 可 以 根据 得 到 的 值 ， 为 用 户 修 改 区 域 性 : 


Public class LanguageaAttribute : ActionFilterAttribute 


{ 
private string language = null; 
Public override void OnActlionExecuting (ActionExecutingContext filterContext) 
{ 
language = filterContext.RouteData.Values["language"] == null 3? 
null : filtercontext.RouteData.Values["language"] .ToString(); 
Ee 
} 
Public override Vold OnResultExecuting (ResultExecutingContext filterContext) 
{ 
} 
} 
注意 : 


第 27 章 讨 论 了 全 球 化 和 本 地 化 、 区 域 性 设置 及 其 他 区 域 信息 。 


使 用 创建 的 动作 过 滤器 特性 类 ， 可 以 把 该 特性 应 用 到 一 个 控制 器 ， 如 下 面 的 代码 段 所 示 。 对 类 应 用 特性 后 ， 
在 调用 每 个 动作 方法 时 ， 都 会 调用 特性 类 的 成 员 。 另 外 ， 也 可 以 把 特性 应 用 到 一 个 动作 方法 ， 此 时 只 有 调用 该 
动作 方法 时 才 会 调用 特性 类 的 成 员 。 

[Language] 

public class HomeController : Controller 

{ 

ActionFilterAttribute 实现 了 几 个 接口 : IActionFilter、IAsyncActionFilter、JResultFilter、IAsyncResultFilter、 
IFilter 和 IOrderedFilter。 

ASPNET Core MVC 包含 一 些 预定 义 的 动作 过 滤器 ， 例 如 需要 HITPS、 授 权 调用 程序 、 处 理 错 误 或 缓存 数 
据 的 过 滤器 。 

使 用 特性 Authorize 的 内 容 参 见 本 章 后 面 的 31.10 节 “ 实 现 吴 份 验证 和 授权 ”。 


31.9 创建 数据 驱动 的 应 用 程序 

在 讨论 完 ASPNET Core MVC 的 基础 知识 后 ,创建 一 个 使 用 Entity Framework Core 的 数据 驱动 的 应 用 程序 。 
该 应 用 程序 使 用 了 ASPNET Core MVC 提供 的 功能 和 数据 访问 功能 。 

注意 : 

第 26 章 详细 讨论 了 Entity Framework Core。 


示例 应 用 程序 MenuPlanner 用 于 维护 数据 库 中 存储 的 饭店 菜单 条 目 。 数 据 库 条 目的 维护 只 应 该 由 经 过 映 份 
验证 的 账 尸 完成。 但 是 ， 未 经 映 份 验证 的 用 户 应 该 能 够 浏览 菜单 。 
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这 个 项 目 首先 选择 ASPNET Core Web Application 模板 。 对 于 身份 验证 ， 选 择 默认 选项 Individual User 
Accounts 和 Store User Accounts mm-App。 这 个 项 目 模板 给 ASPNET Core MVC 和 控制 器 添加 了 几 个 文件 夹 ， 包 
括 HomeController 和 AccountController。 另 外 还 添加 了 几 个 脚本 库 。 


31.9.1 定义 模型 


首先 在 Models 目录 中 定义 一 个 模型 。 该 模型 使 用 Entity Framework Core(EF Core) 创 建 。MenuCard 类 型 定 
义 了 一 些 属性 和 与 一 组 菜单 的 关系 (代码 文件 MenuPlanner/Models/MenuCard.cs): 


public class MenuCard 


{ 


} 


public int Id { get; set; } 


[MaxLength (S50)] 
Public string Name { get; set; } 
public bool Active { get; set; } 


public int Order { get; Set } 
public virtual List<Menu> Menus { get; set; } 


在 MenuCard 中 引用 的 菜单 类 型 由 Menu 类 定义 (代码 文件 MenuPlanner/Models/Menu.cs): 


Public class Menu 


{ 


} 


public int Ia { get; set; } 

public string Text { get; set; } 
Public decimal Price { get; set; } 
Public bool Active { get; set; } 


public int Order { get; set; } 


public string TYPe { get; set; } 
public DateTime Day { get; set; } 


public int MenuCardId { get; set; } 


public virtual MenuCard MenuCard 1{ get; set; } 


数据 库 连 接 以 及 Menu 和 MenuCard 类 型 的 设置 由 MenuCardsContext 管理 。 上 下文 使 用 ModelBuilder 指定 
Menu 类 型 的 Text 属性 不 能 是 null， 其 最 大 长 度 是 50( 代 码 文 件 MenuPlanner/Models/MenuCardsContext.cs): 


public class MenuCardsContext : DbContext 


{ 


} 


Public MenuCardsContext (DbContextOptions<MenuCardsContext> options) 
: base (options) 

{ 

} 


public DbSet<Menu> Menus { get; set; } 


public Dbhbset<MenuCard> MenuCards { get; set; } 


protected override void OnModelcCcreating (ModelBuilder modelBuilder) 
{ 
modelBuilder.Entity<Menu> (}) .Property(p => p.Text) 
.HasMaxLength (50) .IsRequired(); 
base.OonModelCreating (modelBuilder); 
} 


Web 应 用 程序 的 启动 代码 定义 了 MenuCardsContext, 用 作 数 据 上 下 文 , 从 配置 文件 中 读 取 连 接 字符 串 (代码 
文件 MenuPlanner/Startup.cs): 


Public Vvoid ConfigureServices (IServiceCollection services) 


{ 


Services.AddDbContext<ApplicationDbContext> (options 三 > 
options.UseSqlServer( 
Confijguration.GetConnectionstring ("DefaultConnection™))).; 


services.AddDbContext<MenuCardsContext» (options => 
options.UseSdqlServerl 
Configuration.GetConnectionstring("DefaultConnection™))})); 


en 
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在 配置 文件 中 ， 添 加 DefaultConnection 连接 字符 串 。 这 个 连接 字符 串 引 用 Visual Studio 2017 附带 的 SQL 
实例 。 当 然 ， 也 可 以 改变 它 ， 把 这 个 连接 字符 串 添 加 到 SQL Azure 中 (代码 文件 MenuPlanner/appsettings.json): 


{ 
"Connectionstrings": { 
"DefaultConnection™": "Server=(localdb) \\mssgqllocaldb;Database=~MenuPlanner; 
Trusted Connection=True;MultipleActiveResultSsets=true" 
}, 
Fae 
} 


31.9.2 创建 数据 库 


可 以 使 用 EF Core 命令 创建 代码 来 创建 数据 库 。 在 命令 行 提 示 符 中 ， 使 用 NET Core Command Line (CLD 
和 ef 命令 创建 代码 ， 来 目 动 创建 数据 库 。 使 用 命令 提示 符 时 ， 必 须 把 当前 文件 夹 设置 为 project 文件 所 在 的 
目录 : 


>dotnet ef migrations add InitMenuCards 一 -ConteXt MenuCardsContext 


注意 : 
dotnet ef 工具 扩展 参见 第 26 章 。 


因为 这 个 项 目 定义 了 多 个 数据 上 下 文 (MenuCardsContext 和 ApplicationDbContext)， 所 以 需要 用 --context 选 
项 指定 数据 上 下 文 。ef 命令 在 项 目 结构 中 创建 一 个 Migrations 文件 夹 ，InitMenuCards 类 使 用 Up 方法 来 创建 数 
据 库 表 ， 使 用 Down 方法 再 次 删除 更 改 (代码 文件 MenuPlanner/Migrations/[date]InitMenuCards.cs): 


public partial class InitMenuCards : Migration 
{ 
Public override void Up{(MigrationBuilder migrationBuilder) 
{ 
migrationBuilder.cCcreateTable'l( 
name: "MenuCards™, 
columms: table 三 > new 
{ 
Id = table.Ccolumn<int> (nullable: false) 
-Annotation ("SqlServer:ValueGenerationstrategy", 
SqlServerValueGeneratlionstrategy.IdentityColumn), 
Active = table.column<bool> (nullable: false), 
Name = table.Column<string> (maxLength: 50, nullable: truel) ， 
Order = table.columm<inty (nullable: false) 
}, 
constraints: table => 
{ 
table.PrimaryEey ("PK MenuCards", 总 一 > 区 .Id) :> 
})5; 


migqrationBuilder.cCcreateTablel 


name: "Menus"™, 
columms: table = new 
{ 


IQ = table.column<int> (nullable: false) 
-Annotation ("SqlServer:ValueGenerationstrategy"™, 
SqlServerValueGenerationSstrategy.IdentityColumn), 
Active = table.column<bool> (nullable: false), 
Day = table.column<DateTime> (nullable: false), 
MenuCardId = table.column<int> (nullable: false), 
order = table.column<int> (nullable: false), 


Price table.column<decimal> (nullable: false), 
Text = table.Ccolumn<string> (maxLength: 50, nullable: false), 
Type = table.Ccolumn<string> (nullable: true) 

] 。 

constraints: table => 

{ 


table.PrimaryKey ("PK Menus", X => Xx.1Id); 
table.ForelignKey 
name: "FEK Menus MenuCards MenuCardId", 
Column: XxX => XxX.MenuCardId, 
principalTable: "MenuCards"™, 
principalColumn: "Id"™, 
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onDelete: RefeerentialAction.Cascade); 


})s 


} 


public override void Down (MigrationBuilder migration) 


{ 


} 


migration.DropTable ("Menus™); 
migration.DropTable ("MenuCards"™"); 


现在 只 需要 一 些 代码 来 局 动迁 移 过 程 ， 用 最 初 的 样本 数据 填充 数据 库 。MenuCardDatabaseInitializer 在 
Database 属性 返回 的 DatabaseFacade 对 象 上 调用 扩展 方法 MigrateAsync， 应 用 迁移 过 程 。 这 又 反 过 来 检查 与 连 
接 字符 串 关 联 的 数据 库 版 本 是 否 与 迁移 指定 的 数据 库 相 同 。 如 果 版 本 不 同 ， 就 需要 调用 Up 方法 得 到 相同 的 版 
本 ,此 外 ,创建 一 些 MenuCard 对 象 ,存储 在 数据 库 中 (代码 文件 MenuPlanner/Models/MenuCardDatabaseInitializer.cs): 


USing Microsoft.EntityFrameworkCore; 
usSing System.Threading.Tasks; 


namespace MenuPlanner.Models 
{ 
public class MenuCardDatabaseInitializer 
{ 
private static bool s databaseChecked = false; 
private readonly MenuCardsContext context; 


Public MenuCardDatabaseInitializer (MenuCardsContext context) => 
_Context = context,; 


Public async Task CreateanadSeeadDatabaseasync () 


{ 
if {({!s databaseChecked)} 
{ 
s databaseChecked = true; 
await context .Database.MigrateAsync(); 
if (awalit context.MenuCards.CcountAsync() == 0) 
{ 
_ Context -MenuCards .Add ( 
new MenuCard { Name = "Breakfast"™", Active = true, Order = 1 1}); 
_ Context .MenuCards .Add ( 
new MenuCard { Name = "Vegetarian™", Active = true, Order = 2 }); 
context -MenuCards .Add { 
new MenuCard { Name = "Steaks", Active = true, Order = 3 1}); 
} 
忌 厢 已 1 七 context.SaveChangesAsync () 7 
} 
} 


} 
} 


有 了 数据 库 和 模型 ， 就 可 以 创建 服务 了 了。 
31.9.3 创建 服务 


在 创建 服务 之 前 ， 创 建 了 接口 IMenuCardsService， 它 定义 了 服务 所 需 的 所 有 方法 (代码 文件 MenuPlanner/ 


Services/IMenuCardsService.cs): 


usSing MenuPlanner.Models; 
usSing System.Collections.Generic; 
using System.Threading.Tasks; 


namespace MenuPlanner.Services 
{ 
public interface IMenuCardsService 
{ 
Task AddMenuAsvync (Menu menu); 
Task DeleteMenuAsync (Int id); 
Task<Menu> GetMenuByIdAsync (int id); 
Task<IEnumerable<Menu>> GetMenusAsvync (}); 
Task<IEnumerable<MenuCard>> GetMenuCardsAsync ();} 
Task UpdateMenuBAsync (Menu menu); 
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服务 类 MenuCardsService 实现 了 返回 某 单 和 某 单 卡 的 方法 ， 并 创建 、 更 新 和 删除 们 单 (代码 文件 
MenuPlanner/Services/MenuCardsService.cs): 


using MenuPlanner.Models; 

USIing Microsoft.EntityFrameworkCore; 
USing SySstem.Collections.Generic; 
USing SYySsStem.Ling; 

usSing System.Threading.Tasks; 


namespace MenuPlanner.Services 
{ 
Public class MenuCardsService : IMenuCardsService 
{ 
private readonly MenuCardsContext menuCardsContext; 
public MenucardsSservice (MenuCardsContext menuCardsContext) => 
menuCardsContext = menuCardsContextr 


Public async Task<IEnumerable<Menu>> GetMenusAsync() 

{ 
awalt EnsureDatabaseCreatedNAsync(); 
Var menus = menuCardsContext.Menus.Include (m => m.MenuCard).:; 
Ieturn await menus Toarrayasync () ; 


} 


Public async Task<IEnumerable<MenuCard>> GetMenuCardsAsync() 
{ 

awalt EnsureDatabaseCreatedNAsync(); 

Var menuCards = menuCardsContext.MenuCards; 

return awalt menuCards .ToArrayAsync (); 


} 


Public async Task<Menu> GetMenuByIdAsyncl(int id) 三 > 
awalt menuCcardsContext.Menus.SingleOrDefaultAsync(m => m.1d == 1d); 


Public async Task AddMenuAsync (Menu menu) 

{ 
awalt menuCcardsContext -Menus .AddAasYynec (menu); 
awalt menuCardsContext .SaveChangesAsync(); 


} 


Public async Task UpdateMenuAsync (Menu menu) 
{ 
menuCcardsContext .Menus .Update (menu)j : 
awalt menuCcardsContext.SaveChangesAsync!(); 


} 


Public async Task DeleteMenuAsync(int 1id) 

{ 
Menu menu = awalt menuCardsContext .Menus.SingleAsync(m => m.1d == 1d); 
menuCcardscCcontext .Menus .Remove (menu); 
await menuCardsContext -SaVvechangesasyYnec (1) 7 


} 


Private async Task EnsureDatabaseCreatedAsync () 

{ 
Var init = new MenuCardDatabaseInitializer{( menuCardsContext); 
awalit init.cCcreateAndseedDatabaseAsync(); 

} 


} 

为 了 使 服务 可 用 于 依赖 注入 ， 使 用 AddScoped 方法 在 服务 集合 中 注册 服务 (代码 文件 MenuPlanner/ 
Startup.cs): 

Public void ConfigureServices (IServiceCollection services) 


{ 
| 
Services.AddsScoped<IMenuCardsService, MenuCardsService> (); 
Ff 

} 
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31.9.4 创建 控制 尼 


ASPNET Core MVC 提供 搭建 功能 来 创建 控制 器 ， 以 直接 访问 数据 库 。 为 此 ， 可 以 在 Solution Explorer 中 选 
择 Controllers 文件 夹 ， 并 从 上 下 文 菜 单 中 选择 Add | Controller。 打 开 Add Scaffold 对 话 框 。 在 该 对 话 框 中 ， 可 
以 使 用 Entity Framework 选择 MVC Controller 视图 . 单 击 Add 按钮 ,打开 Add MVC Controller 对 话 框 , 如 图 31-15 
所 示 。 使 用 此 对 话 框 ， 可 以 选择 Menu 模型 类 和 Entity Framework 数据 上 下 文 MenuCardsContext， 配 置 为 生成 
视图 ， 给 控制 器 指定 一 个 名 称 。 用 视图 创建 控制 器 ， 碍 看 生成 的 代码 ， 包 括 视 图 。 


Edd MYC Controller with wews, USImg Ermtrty Framework 


Niodel class: Mienu [henuPlanner.NModels) 

Data context class: enuCardsCentext (MenuPlanner. hodels) 
Views: 

|w| Generate views 


|w| Reference script libraries 


[Y| Use a layout page: 


(Leave empty if it is set in a Razor viewstart file) 


Controller nanve: 


图 31-15 


图 书 示例 不 直接 在 控制 器 中 使 用 数据 上 和 下文， 而 是 把 一 个 服务 放 在 其 中 。 这 样 做 提供 了 更 多 的 灵活 性 。 可 
以 在 不 同 的 控制 器 中 使 用 服务 ， 还 可 以 在 服务 中 使 用 服务 ， 如 ASPNET Core Web API。 


注意 : 
ASPNET Core Web API 参见 第 32 章 。 


在 下 面 的 示例 代码 中 ，ASPNET Core MVC 控制 器 通过 构造 函数 注入 来 注入 沫 单 卡 服务 (代码 文件 
MenuPlanner/Controllers/MenusAdminController.cs): 


public class MenusAdminController : Controller 
{ 
Private readonly IMenuCardsService service; 
Public MenusAdminController(IMenuCardsService service) 三 > 
_ Service = Service; 
ff... 
} 


只 有 当 控 制 器 通过 URL 来 引用 而 没有 传递 动作 方法 时 ， 才 默认 调用 Index 方法 。 这 里 ， 会 创建 数据 库 中 所 
有 的 Menu 项 ， 并 传递 到 Index 视图 。Details 方法 传递 在 服务 中 找到 的 染 单 ， 返回 Details 视图 。 注 意 错 误 处 理 。 
在 没有 把 ID 传递 给 Details 方法 时 ， 如 果 在 数据 库 中 没有 找到 沫 单 ， 使 用 NotFound 方法 返回 HITP Not Found 
错误 (404 错误 啊 应 )。 这 个 方法 在 控制 器 的 一 个 基 类 ControllerBase 中 和 定义 (代码 文件 MenuPlanner/ 
Controllers/MenusAdminController.cs): 


public async Task<IActionResult> Index() => 
Viewlawalt service.GetMenusAsync () ) ; 


public async Task<IActionResult> Details (int? 1d = 0) 
{ 
if (id == null) 
{ 
return NotFound(}s; 


} 
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Menu menu = awalt service.GetMenuByIdAsync (id.vVvalue); 


if (menu == null} 
{ 

return NotFound().; 
} 


return View (menu).; 


} 

用 户 创 建新 业 单 时 ， 在 收 到 客户 端的 HITP GET 请 求 后 ， 会 调用 第 一 个 Create 方法 。 在 这 个 方法 中 ， 把 
ViewBasg 信息 传递 给 视图 。 这 个 ViewBag 包含 SelectList 中 华 单 卡 的 信息 。SelectList 允许 用 户 选 择 一 项 。 因 为 
MenuCard 集合 被 传递 给 SelectList， 所 以 用 户 可 以 选择 一 个 市 有 新 建 沫 单 的 菜单 卡 (代码 文件 MenuPlanner/ 
Controllers/MenusAdminController.cs): 


Public async Task<IActionResult> Create{() 
{ 


IEnumerable<MenuCard> cards = awalit service.GetMenuCardsAsync (); 
ViewBag.MenuCardId = new SelectList (cards, "Id", "Name™); 
return Viewt(}).: 


} 

在 用 户 填 写 表单 并 把 带 有 新 沫 单 的 表单 提交 到 服务 器 时 ， 在 HITP POST 请 求 中 调用 第 二 个 Create 方法 。 
这 个 方法 使 用 模型 绑 定 ， 把 表单 数据 传递 给 Menu 对 象 ， 并 将 Menu 对 象 添加 到 数据 上 下 文中 ， 同 数据 库 写 入 
新 创建 的 祭 单 (代码 文件 MenuPlanner/Controllers/MenusAdminController.cs): 


[HttpPost] 
[ValidateAntiForgeryToken] 
Public async Task<ActionResult> Createl 
[Bind ("Id™", "MenuCardId™", "Text"”", "Price™, "Active™", "Order™., "Type"™", "Day™)] 
Menu menu) 


1if (ModelSstate.IsValid) 
{ 

awalt service.AddMenuAsync (menu); 

return RedirectToAction ("Index™):; 
} 
IEnumerable<MenuCard> cards = awalit service.GetMenuCardsAsync (); 
ViewBag.MenuCards = new SelectList (cards, "Id", "Name", menu.MenuCardId); 
return View (menu); 


注意 : 
第 24 章 解 释 了 特性 ValidateAntiForgeryToken 的 防伪 令 牌 。 


为 了 编辑 菜单 卡 ， 定 义 了 两 种 动作 方法 Edit， 一 个 用 于 GET 请 求 ， 另 一 个 用 于 POST 请 求 。 第 一 个 Edit 
方法 返回 一 个 表单 项 ， 第 二 个 Edit 方法 在 模型 绑 定 成 功 后 调用 服务 的 UpdateMenuAsynec 方法 : 


Public async Task<IActionResult> Edit(int? 1id) 
{ 
if {iqd = null) 


{ 
return NotFound().:; 
} 
Menu menu = awalt service.GetMenuByIdAsync (id.value); 
1if (menu == null)}) 
{ 
return NotFound():; 
} 
IEnumerable<MenuCard> cards = awalit service.GetMenuCardsAsync (); 


ViewBag.MenuCardId = new SelectList (cards, "Id", "Name", menu.MenuCardId); 
return View (menu); 


} 


[HttpPost] 
[ValidateAntiForgeryToken] 
public async Task<IActionResult> Edit(int id, 
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[Bind (“Id™", “MenuCardId™, "Text", "Price™", "Order™, "Type", "Day"™)] 
Menu menu) 


if (ia != menu.Id) 
{ 
return NotFoundl(}:; 


} 


if (Modelstate.IsValid) 
{ 

awalt service.UpdateMenuAsync (menu); 

return RedirectToABction ("Index™").: 
} 
IEnumerable<MenuCard> cards = awalt service.GetMenuCardsAsync(); 
ViewBag.MenuCardId = new SelectList (cards, "Id", "Name", menu.MenuCardId); 
return View (menu); 


控制 器 的 实现 的 最 后 一 部 分 包括 Delete 方法 。 因 为 这 两 个 方法 有 相同 的 参数 (这 在 C# 中 是 不 可 能 的 )， 所 以 
第 二 个 方法 的 名 称 是 DeleteConfirmed。 第 二 个 方法 可 以 在 第 一 个 Delete 方法 所 在 的 URL 链接 中 访问 ， 但 是 它 用 
HTTP POST 访问 ， 而 不 是 用 ActionName 特性 的 GET 访问 。 该 方法 调用 服务 的 DeleteMenuAsync 方法 : 


Public async Task<IActionResult> Delete (int? id) 


{ 


} 


IE (id == null) 


{ 
return NotFound(); 
} 
Menu menu = awalt service.GetMenuByIdAsync(id.Vvalue); 
if (menu == null) 
{ 
return NotFound(); 
} 


return View (menu); 


[HttpPost, ActionName ("Delete"™")] 
[ValidateAntiForgeryToken] 
Public async Task<IActionResult> DeleteConfirmed{(int id) 


{ 


} 


Menu menu = awalt service.GetMenuByIdAsync (1d); 
awalt service.DeleteMenuAsync (menu.Id)}); 
return RedirectToAction ("Index™).; 


注意 : 

使 用 Web API 时 ， 删 除 资源 通常 是 使 用 HITP DELETE 谓词 完成 的 。 有 关 Web API 的 信息 参见 第 32 章 。 
对 于 访问 页 面 的 浏览 器 来 说 ， 情 况 并 非 如 此 。DeleteConfirmed 方法 是 使 用 HTTP POST 谓词 请 求 的 (由 HttpPost 
特性 定义 )。 


31.9.5 ”创建 视图 


现在 该 创建 视图 了 。 视 图 在 文件 夹 Views/MenuAdmin 中 创建 。 要 创建 视图 ， 可 以 在 Solution Explorer 中 选 
择 MenuAdmin 文件 夹 ， 并 从 上 下 文 菜 单 中 选择 Add | View。 这 将 打开 Add MVC View 对 话 框 ， 如 图 31-16 所 
示 。 使 用 此 对 话 框 可 以 选择 List、Details、Create、Edit、Delete 模板 ， 安 排 相 应 的 HTML 元 素 。 在 这 个 对 话 框 
中 选择 的 Model 类 定义 了 视图 基于 的 模型 。 


Add MNC Vievw 


View name: 
Template: 


Model class: 
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Create 
Create 


hienu tenuPlanner.\odels) 
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Data context class: henuCardsContext (MenuPlanner.hodels) 


Options: 


| | Create as a partial view 


|w| Reference script libraries 
Use a layout page: 


(Leave empty if it is set in a Razor viewstart file) 
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Index 视图 定义 了 一 个 HTML 表 ， 它 把 Menu 集合 作为 模型 。 对 于 表 头 元 素 ， 使 用 带 有 HTML Helper 
DisplayNameFor 的 HTML 元 素 标签 来 访问 用 于 显示 的 属性 名 称 。 为 了 显示 项 ， 菜 单 集合 使 用 @foreach 和 办 代 ， 
每 个 属性 值 用 输入 元 素 的 HIML Helper 来 访问 。 锚 元 素 的 Tag Helper 为 Edit、 Details 和 Delete 页 面 创建 链接 ( 代 
码 文 件 MenuPlanner/Views/MenuAdmin/Index.cshtml): 


Qmoaqel IEnumerable<MenuPlanner.Models.Menu> 
af 
ViewDatal["Title™"] = "Index"™; 
} 
<h2>Index</h2> 
D> 
<a asp-action="Create">Create New</a> 
</p> 
<table class="table™> 
<thead> 
芯 七 工 产 
<th> 
aHtml .DisplayNameFor (model => model .Text) 
</th> 
<th»> 
aHtml .DisplayNameFor (model => model .Price) 
</th> 
<th» 
AHtml .DisplayNameFor (model => model .Active) 
</th> 
<th> 
QHtml .DisplayNameFor (model => model .Order) 
</th> 
所 七 是 六 
aHtml .DisplayNameFor (model => model .Type) 
</th> 
<th» 
aHtml .DisplayNameFor (model => model .Day) 
</th> 
<th> 
QHtml .DisplayNameFor (model => model .MenuCard) 
</th> 
<th></th> 
</tr> 
</thead> 
<tbody> 
Bforeach (var item in Model) I 
所 七 工 > 
<td> 
aHtml .DisplayFor (modelItem => item.Text) 
</td> 
<td> 
QHtml .DisplayFor (modelItem => item.Price) 
</td> 
<td> 
QHtml .DisplayFor (modelItem => item.Active) 
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</td> 
<td> 
8&8Htm]l .DisplayFor (modelItem => item.Order) 
</td> 
< 七 dd> 
@Htm]l .DisplayFor (modelItem => item.Type) 
</td> 
<td> 
@Htm]l .DisplayFor (modelItem => item.Day) 
</td> 
<td> 
@Htm]l .DisplayFor (modelItem => item.MenuCard.Id) 
</td> 
< 七 dd> 
<a asp-action="Edit" asp-route-id="@item.Id">Edit</a> | 
<a asp-action="Details" asp-route-id="@item.Id">Details</a> | 
<a asp-action="Delete" asp-route-id="Q@item.Id">Delete</a> 
</td> 
</tr> 
} 
</tbody> 
</table> 


在 MenuPlanner 项 目 中 ，MenuAdmin 控制 器 的 第 二 个 视图 是 Create 视图 。HTML 表单 使 用 asp-action Tag 
Helper 来 引用 控制 器 的 Create 动作 方法 。 用 asp-controller Helper 引用 控制 器 不 是 必要 的 ， 因 为 动作 方法 与 视图 
位 于 相同 的 控制 器 中 。 表单 内 容 使 用 标签 和 输入 元 素 的 Tag Helper 建立 。 标签 的 asp-for Helper 返回 属性 的 名 称 ; 
输入 元 素 的 asp-for Helper 返回 其 值 ( 代 码 文 件 MenuPlanner/Views/MenuAdmin/Create.cshtm)): 


amoadel MenuPlanner.Models.Menu 
1 
ViewDatal["Title"] = "Create™; 
} 
<h2>Create</h2> 
<h4>Menu</h4> 
<hr /> 
<div Class="row"> 
<div Class="col-md—4"> 
<form asp-action="Create"> 
<div asp—-validation—-summary="ModelOnly" class="text-—-danger"™></div> 
<div class="form-group"> 
<label asp-for="Text" class="control-label"></label> 
<input asp-for="Text" class="form-control" /> 
<span asp-validation-for="Text" class="text-danger"></span> 
</div> 
<div class="form-group"> 
<label asp-for="Price" class="control-label"></label> 
<input asp-for="Price" class="form-control" /> 
<span asp-validation-for="Price" class="text-danger"></span> 
</div> 
<div class="form-group"> 
<div class="checkbox"> 
<label> 
<input asp-for="Active™ /> 
QHtml .DisplayNameFor (model => model .Active) 
</label> 
</div> 
</div> 
<div class="form-group"> 
<label asp-for="Order" class="control-label"></label> 
<input asp-for="Order" class="form-control" /> 
<span asp-validation-for="Order" class="text-danger"></span> 
</div> 
<div class="form-group"> 
<label asp-for="Type" class="control-label"></label> 
<input asp-for="Type" class="form-control" /> 
<span asp-validation-for="Type" class="text-danger"></span> 
</div> 
<div class="form-group™"> 
<label asp-for="Day" class="control-label"></label> 
<input asp-for="Day" class="form-control" /> 
<span asp-validation-for="Day" class="text-danger"></span> 
</div> 
<div class="form-group"> 
<label asp-for="MenuCardId" class="control-label"></label> 
Select asp-for="MenuCardlId" class ="form-control" 
asp-items="ViewBag .MenuCardId"></select> 
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</div> 
<dliv class="form-group"> 
<input type="submit" value="Create" class="btn btn-default" /> 
</div> 
</ form> 
</div> 
</div> 
<dliv> 
<a asp-action="Index">Back to List</a> 
</div> 


Qsection Scripts I 
efawalit Html .RenderPartialAsync(" ValidationscriptsPartial");} 

} 

其 他 视图 的 创建 与 前 面 所 示 的 视图 类 似 ， 因 此 这 里 不 作 介绍 。 

现在 可 以 使 用 应 用 程序 在 现 有 的 业 单 卡 中 添加 和 编辑 亲 单 。 


31.10 ”实现 身份 验证 和 授权 


身份 验证 和 授权 是 Web 应 用 程序 的 重要 方面 。 如果 网 站 或 其 中 的 一 部 分 不 应 公开 ， 那么 用 户 就 必须 获得 授 
权 。 对 于 用 户 的 身份 验证 ， 在 创建 ASPNET Core Web 应 用 程序 时 可 以 使 用 不 同 的 选项 (参见 图 31-17): No 
Authentication、Individual User Accounts、Work or School Accounts 和 Windows Authentication 。 
Change Authentication 
Store User accounts in-app “| Learn more 
下 Select this option to create a project that includes a local user accounts store. 
®) Individual User Accounts 


[7 Work or School Accounts 


Dn Windows Authentication 


Learn more about third-party open source authentication options | Cancel ] 


图 31-17 


对 于 Work or School Accounts， 可 以 从 云 中 选择 Active Directory， 进 行 身份 验证 。 

使 用 Individual User Accounts 时 ， 可 以 在 SQL Server 数据 库 中 存储 用 户 ， 或 者 使 用 Azure Active Directory 
B2C。 本 章 会 讨论 这 两 个 选项 。 用 户 可 以 注册 和 登录 ， 也 可 以 使 用 Facebook、Twitter、Google 和 Microsoft 中 现 
有 的 账户 。 


31.10.1 存储 和 检索 用 户 信 息 


为 了 管理 用 户 ， 需 要 把 用 户 信 息 添 加 到 库 中 。IdentityUser 类 型 (名 称 空 间 Microsoft.AspNet.Identity. 
EntityFrameworg) 定 义 了 一 个 名 称 ， 列 出 了 和 角色、 登录 名 和 声明 。 用 来 创建 MenuPlanner 应 用 程序 的 Visual 
studio 模板 创建 了 一 些 明 显 的 代码 来 保存 用 户 : 类 ApplicationUser 是 项 目的 一 部 分 ， 派 生 目 基 类 
IdentityUser( 名 称 空间 Microsoft.AspNet.Identity.EntityFrameWwork)。ApplicationUser 默认 为 空 , 但 是 可 以 添加 需 
要 的 用 户 信息 ， 这 些 信息 存储 在 数据 库 中 (代码 文件 MenuPlanner/Models/IdentityModels.cs): 

public class ApplicationUser : IdentityUser 


| 
} 


数据 库 的 连接 通过 IdentityDbContext<TUser> 类 型 建立 。 这 是 一 个 泛 型 类 ， 派 生 于 DbContext， 因 此 使 用 了 
Entity Framework Core。IdentityDbContext<TUser> 类 型 定义 了 IDbSet<TEntity> 类 型 的 Roles 和 Users 属性 。 
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IDbSet<TEntity> 类 型 定义 了 到 数据 库 表 的 映射 。 为 了 方便 起 见 ， 创 建 ApplicationDbContext， 把 ApplicationUser 类 
型 定义 为 IdentityDbContext 类 的 泛 型 类 型 (代码 文件 MenuPlanner/Data/ApplicationDbContext.cs): 


public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 
{ 
protected override volid OnModelCreating (ModelBuilder builder) 
| 
base.onModelCreating (builder).; 
} 
} 


31.10.2 ”启动 身份 系统 


数据 库 的 连接 通过 局 动 代 码 中 的 依赖 注入 服务 集合 来 注册 。 类 似 于 前 面 创建 的 MenuCardsContext， 

ApplicationDbContext 被 配置 为 使 用 SQL Server 和 config 文件 中 的 连接 字符 串 。 身 份 服务 本 身 使 用 扩展 方法 
AddIdentity 注册 。AddIdentity 方法 映射 身份 服务 所 使 用 的 用 户 和 角色 类 的 类 型 。 类 ApplicationUser 是 前 面 提 到 
的 源 自 IdentityUser 的 类 ; IdentityRole 是 基于 字符 串 的 角色 类 ， 派 生 目 IdentityRole<string>。AddIdentity 方法 的 
重 载 版 本 允许 的 配置 身份 系统 的 方式 有 双 因 京 身 份 验证 ; 电子 邮件 令 牌 提供 程序 ， 用 户 选 项 ， 如 需要 唯一 的 电 
子 邮件 ; 或 者 正则 表达 式 ， 要 求 用 户 名 匹配 。AddIdentity 返回 一 个 IdentityBuilder， 人 允许 对 身份 系统 进行 额外 的 
配置 ， 如 使 用 的 实体 框架 上 下 文 (AddEntityFrameworkStores) 和 令 牌 提供 程序 (AddDefaultTokenProviders)。 可 以 添 
加 的 其 他 提供 程序 用 于 错误 、 密 码 验 证 器 、 角 色 管理 器 、 用 户 管 理 器 和 用 户 验证 器 (代码 文件 
MenuPlanner/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 
{ 
Services.AddDbContext<ApplicationDbContext> (options 三 > 
options.UseSqlServer( 
Confijguration.GetConnectionstring ("DefaultcConnection™))).; 


services.AddDbContext<MenuCardsContext> (options 一 > 
options.UseSqlServerl 
Confijguration.GetConnectionstring ("DefaultConnection™))).; 
Services.Addscoped<IMenuCardsService, MenuCardsService> (); 


services.AddIdentity<ApplicationUser, IdentityRole>() 
-DddEntityFrameworkSstores<ApplicationDbContext> () 
-AddDefaultTokenProviders(); 


services.AddTranslient<IFEmailSender, EmailSsSender> (); 


Services.AddMvec T) : 


31.10.3 ”执行 用 户 注册 


现在 进入 为 注册 用 户 而 生成 的 代码 ,功能 的 核心 在 AccountController 类 中 ,控制 器 类 应 用 了 Authorize 特性 ， 
它 将 所 有 的 动作 方法 限制 为 通过 身份 验证 的 用 户 。 构 造 函 数 接收 一 个 用 户 管理 器 、 登 录 管 理 嚣 和 通过 依赖 注入 
的 数据 库 上 和 下文。 电子 邮件 和 SMS 发 送 方 用 于 双 因 素 身 份 验证 。 如 果 没 有 实现 生成 代码 中 的 衬 
AuthMessageSender 类 , 就 可 以 删除 IEmailSender 的 注入 (代码 文件 MenuPlanner/Controllers/AccountController.cs): 


[Authorizel] 

[Route ("[controller]/ [action]")] 

PUublic class AccountController : Controller 

{ 
private readonly UserManager<ApplicationUser> userManager; 
private readonly SignInManager<ApplicationUser> signInManager; 
private readonly IEmailSender emailSender; 
private readonly ILogger logger; 


public AccountControllerl 
UserManager<ApplicationUser> userManager, 
SignInManager<ApplicationUser> signInManager., 
IFEmailSender emailSender, 
ILOgger<AccountControl]ler> loogger) 
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_USeTManageI = userManagers 
_ signInManager = signIinManager; 
emallSender = emailSender; 
_logger = logger; 

} 


要 注册 用 性， 应 定义 RegisterViewModel。 这 个 模型 定义 了 用 户 在 注册 时 需要 输入 什么 数据 。 在 生成 的 代码 
中 ， 这 个 模型 只 需要 电子 邮件 、 密 码 和 确认 密码 (必须 与 密码 相同 )。 如 果 想 获得 更 多 的 用 户 信 息 ， 可 以 根据 需 
要 添加 属性 (代码 文件 MenuPlanner/Models/AccountViewModels.cs): 


Public class ReglsterViewModel 
{ 
[Required] 
[EmailAddress] 
[Display (Name = "Emal1l1") ] 
public string Emall { get; set; } 


[Required] 
[StringLength (100, ErrorMessage = 
"The {0} must be at least {2} characters long.", MinimumLength = 6)] 
[DataType (DataTYype. Password)] 
[Display (Name = "Password")] 
Public string Password { get; set; } 


[DataType (DataType. Password})] 
[Display (Name = "Confirm password"})] 
[Compare ("Password™", ErrorMessage = 
"The password and confirmation password do not match.")] 
Public string ConfjrmPassword 1{ get; set; } 


} 

用 户 注 册 对 于 未 经 过 身份 验证 的 用 户 也 必须 可 用 。 这 就 是 为 什么 AllowAnonymous 特性 应 用 于 
AccountController 的 Register 方法 的 原因 。 这 会 否决 这 些 方法 的 Authorize 特性 。Register 方法 的 HTTP POST 变 
体 接收 RegisterViewModel 对 象 ， 通 过 调用 方法 userManager.CreateAsync 把 ApplicationUser 写 入 数据 库 。 用 
户 成 功 创建 后 ， 使 用 电子 邮件 提供 程序 向 用 户 发 送 电子 邮件 ， 通 过 signInManager.SignInAsync 登录 ( 代 
码 文 件 MenuPlannerControllers/AccountController cs): 


[HttpGetl 
[AllowAnonvymous] 
Public IActionResult Reglister{(string returnUrl = null) 
{ 
ViewData[l"ReturnUrl"] = returnUrl:; 
return Viewt(}).: 


} 


[HttpPost] 
[AllowAnonymous] 
[ValidatenAntiForgeryToKen] 
Public async Task<IActionResult> Register (RegisterViewModel model., 
string returnUrl = null) 
{ 
ViewDatal[" ReturnUrl"] = returnUrl:; 
if (Modelstate.IsValid) 
{ 
Var user = new ApplicationUser 
{ 
UserName = model .Emall， 
Emall = model .Email 
}s 
Var result = await userManager.CreateAsync (user, model .Password)., 
if (result.SsSucceeded) 
{ 


_1ogge -LogInftOTmat1Ion ("USeT created a new account with password.™); 


Var code = awalt userManager.GenerateEmailConfirmationTokenAsync (user); 
var CallbackUrl = Url.EmailConfirmationLink (user.Id, code., 

ReGuest -Scheme : 
await emailSender.SendEmailConfirmationAsync (model .Email, callbackUr]l).; 


await signInManager .SignlnAsync (user, isPersistent: false); 
logger.LogInformation("User created a new account with password."™); 
return RedirectToLocal (returnUrl); 

} 

AddErrors{({result).; 
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} 
i:/ If we got this far, something failed, redisplay form 
return View (model); 


} 
现在 视图 (代码 文件 MenuPlanner/Views/Account/Register.cshtm) 只 需要 用 户 的 信息 。 图 31-18 显示 要 求 用 户 
提供 信息 的 对 话 框 。 
园 Register - MenuPlanner 又 上 竹 


-一 一 六 lecalhaost 44 


Reglster 


Create a new account. 
Email 
christian@mchristiannagel.com 


Passiweord 


大 大 恒 王 恒 本 


Confirm passWord 


各 生硬 王 量 汪 必 硬 


Register 


B2017 - MenuPlanner 


图 31-18 


31.10.4 ”设置 用 户 登录 


当 用 户 注 册 时 ， 在 注册 成 功 后 ， 会 直接 开始 登录 。LoginViewModel 模型 定义 了 UserName、Password 和 
RememberMe 属性 一 一 用 户 登 录 时 要 求 提供 的 信息 。 这 个 模型 有 一 些 注解 与 HTML Helper 一 起 使 用 (代码 文件 
MenuPlanner/Models/AccountViewModels.cs): 


Public class LoginViewModel 
{ 
[Requiredl 
[EmailAddress] 
public string Emall { getr set; } 


[Required] 
[DataTYype (DataTYype .Password)l] 
public string Password { get; set; } 


[Display (Name = "Remember me?")] 
public bool RememberMe { get; set; } 
} 


为 了 登录 已 注册 的 用 户 ， 需 要 调用 AccountController 的 Login 方法 。 用 户 输入 登录 信息 后 ， 就 使 用 登录 管 
理 器 通过 PasswordSienInAsync 验证 登录 信息 。 如 果 登 录 成 功 ， 用 户 就 重 定 同 到 最 初 请 求 的 页 面 。 如 果 登 录 失 
败 了 ， 会 返回 同样 的 视图 ， 再 给 用 户 提 供 一 个 选项 ， 以 正确 输入 用 户 名 和 密码 (代码 文件 
MenuPlanner/Controllers/AccountController.cs): 

> 


Public IActionResult Login(string returnUrl = null) 


{ 
Await HttpContext.SiagnOutAsync(IdentityConstants.ExternalSscheme); 
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ViewData[l"ReturnUrl"] = returnUrl:; 
return Viewt(}).: 


} 


[HttpPost] 

[Al1l]owAnonymous] 

[ValidatenntiForgeryTokKken] 

Public async Task<IActionResult> Login (LoginViewModel model, 
string returnUrl = null) 


ViewDatal[" ReturnUrl"] = returnUrl:; 
1if (Modelstate.IsValid) 
{ 
Var result = await signlnManager.PasswordSignInAsynce( 
model .Email, model .Password, model .RememberMe, lockoutOnFailure: false).; 
if (result.SsSucceeded) 
{ 
logger.LogInformation("User logged in."™); 
return RedirectToLocal (returnUrl):; 
} 
if (result.RequiresTwoFactor) 
{ 
return RedirectToAction (nameof (LoginWith2fa), 
new { returnUrl, model .RememberMe }); 
} 
if (result.IsLockedout) 


_logger.LogWarning ("User account locked out."™); 
return RedirectToAction (nameof (Lockout))}).:; 
} 
忆 ] Se€© 
{ 
ModelSstate.AddModelError (string.Empty, "Invalid login attempt."); 
return Viewimodel).:; 
} 
} 
return View (model).:; 


} 


31.10.5 “验证 用 户 的 身份 


有 了 身份 验证 的 基础 设施 ， 就 很 容易 使 用 Authorize 特性 注解 控制 器 或 动作 方法 ， 要 求 用 户 进行 身份 验证 。 
把 这 个 特性 应 用 到 类 上 需要 为 类 的 每 一 个 动作 方法 指定 角色 。 如 果 不 同 的 动作 方法 有 不 同 的 授权 要 求 , Authorize 
特性 也 可 以 应 用 于 动作 方法 。 使 用 这 个 特性 ， 会 验证 调用 者 是 否 已 经 获得 授权 (检查 授权 cookie)。 如 果 调 用 者 
还 没有 获得 授权 ， 就 返回 一 个 401 HTTP 状态 代码 ， 并 重 定向 到 登录 动作 。 

应 用 特性 Authorize 时 如 果 没 有 设置 参数 ， 那 么 区 需要 用 户 通过 身份 验证 。 为 了 拥有 更 多 的 控制 ， 可 以 把 角 
色 赋 予 Roles 属性 ， 指 定 只 有 特定 的 用 户 角 色 才 可 以 访问 动作 方法 ， 如 下 面 的 代码 段 所 示 : 

[Authorize (Roles="Menu Admins")] 


Public class MenuAdminController : Controller 
{ 


还 可 以 使 用 Controller 基 类 的 User 属性 访问 用 户 信息 ， 允 许 更 动态 地 批准 或 拒绝 用 户 。 例 如 ， 根 据 传递 的 
参数 值 ， 要 求 不 同 的 角色 。 


用 户 身份 验证 和 其 他 安全 信息 参见 第 24 章 。 


31.10.6 ”使 用 Azure Active Directory 对 用 户 进行 身份 验证 


现在 最 好 不 要 在 自己 的 数据 库 中 保存 用 户 名 和 密码 。 用 户 不 喜欢 记 住 另 一 个 密码 。 用 户 可 能 在 使 用 密码 管 
理工 具 ， 因 为 用 户 不 可 能 处 理 很 多 密码 。 这 不 是 唯一 的 问题 。 使 用 本 章 前 几 节 中 使 用 过 的 ASPNET Core 标识 
系统 来 满足 安全 需求 。 密 码 是 散 列 的 ， 因 此 无 法 从 数据 库 中 读 取 。 这 只 是 一 个 从 密码 到 散 列 的 单 向 进程 。 仍 然 
需要 确保 用 户 信息 的 安全 性 。 


808 | 第 由 部 分 Web 应 用 程序 和 服务 


注意 : 
最 好 将 用 户 管理 与 应 用 程序 放 在 单独 的 服务 中 。 


对 于 用 户 名 和 密码 ， 可 以 使 用 用 户 已 有 的 账户 ， 如 微软 、 谷 歌 、Facebook 和 Twitter 账户 ， 并 使 用 这 些 提供 
程序 的 令 脾 。 这 样 用 户 就 不 需要 处 理 额 外 的 密码 ， 而 且 所 有 的 密码 管理 都 不 是 应 用 程序 的 一 部 分 。 要 实现 这 一 
点 ， 需 要 使 用 所 选择 的 提供 程序 创建 应 用 程序 ， 并 相应 地 配置 ASPNET Core 身份 。 使 用 这 些 提供 程序 中 的 一 
个 或 多 个 ， 只 需要 添加 关于 用 户 的 附加 信息 ， 以 及 来 自 数 据 库 中 提供 程序 的 用 户 标 识 符 。 

为 了 管理 这 个 附加 的 用 户 信息 , 最 佳 实践 是 将 其 与 应 用 程序 分 开 。 可 以 为 这 个 功能 编写 一 个 服务 应 用 程序 ， 
并 在 几 个 Web 应 用 程序 中 使 用 它 。 可 以 使 用 开 箱 即 用 的 服务 ， 例 如 身份 服务 器 (https:Widentityserverio/)， 并 将 其 
托管 在 自己 的 Web 应 用 程序 中 , 或 者 可 以 使 用 Paas 服务 , 如 Azure Active Directory。 本 节 演 示 了 Azure AD B2C 
(Active Directory Business to Consumer) 和 ASPNET Core MVC 的 用 法 。 与 Azure AD 相反 ，Azure AD B2C 人 允许 
用 户 注 册 ， 并 人 允许 添加 微软 、 人 和 谷歌 、Facebook、Twitter 等 其 他 提供 程序 。 


1. 创建 Azure Active Directory B2C 租户 


在 ASPNET Core 中 使 用 Azure Active Directory B2C 时 ， 首 先 需 要 创建 Azure Active Directory。 这 可 以 通过 
门户 网 站 https://portal.azure.com 来 实现 。 我 用 域名 procsharp.onmicrosoft.com 创建 了 一 个 。 需 要 创建 一 个 不 同 的 
域名 ， 因 为 这 个 域名 已 经 不 可 用 了 。 

要 让 Web 应 用 程序 访问 这 个 Azure AD B2C， 需 要 创建 一 个 应 用 程序 ， 如 图 31-19 所 示 。 除 了 输入 应 用 程 
序 的 名 称 之 外 ， 还 需要 选择 Web App 选项 ， 并 配置 Reply URI。 在 创建 ASPNET Core Web 应 用 程序 时 ， 将 得 到 
Reply URI。 例 如 https://localhost:44359/signin-oidc。 端 口 在 用 户 的 系统 上 是 不 同 的 。 仅 为 了 测试 目的 ， 可 以 使 用 
localhost。 对 于 产品 ， 需 要 将 其 更 改 为 产品 服务 器 的 URL。 


RW | | LanN 


BArureADBrCSample 


Web App / Web APl 
Include web app / web API@ 


Allow implicnt flow @ 
| Yes | Ne 
Oh Redirect URIs must all belong to the seme domain 


Reply URL® 


httpsi/Mocalhostdd4359signin-oide 


App ID WRI (optianal) @ 


httpsi// procsharp.onmicrosoft.com/ 


Native client 


Include natme cliant @ 


图 31-19 
要 使 用 户 能 够 从 男 一 个 提供 程序 中 输入 新 的 用 户 名 和 和 密码， 可 以 添加 标识 提供 程序 ， 如 图 31-20 所 示 。 对 
于 所 选择 的 每 个 映 份 提供 程序 ， 都 需要 配置 客户 端 ID 和 客户 端 密 钥 。 对 于 使 用 微软 账户 ， 可 以 在 
https://apps.dev.microsoft.com/ 中 注册 一 个 应 用 程序 来 检索 ID 和 密 钥 。 


第 31 章 ASP.NET Core MVC | 809 


ES | pi i rr 有 | Fs 产 十 二 普 。 王 到 | rd pd 
Add identity provide Select social identity providel 


* Mame@ 


Enter am identity provder name 


后 . Gocgle 
* ldentity provider type > 
EE, 
Facebook 
Set up this Wentity provider > 
Required 
Linkedin 
Amazon 


Weilbo (Previewn) 
QQ (Prevrew) 
WeChat [Preview) 


Twiitter (Preview) 


图 31-20 


接 下 来 需要 一 些 策略 。 通 过 策略 ， 可 以 指定 注册 用 户 需 要 什么 信息 ， 以 及 可 以 使 用 哪些 提供 程序 。 对 于 
ASPNET Core Web 应 用 程序 ， 至 少 需 要 注册 或 登录 和 密码 重 置 策 略 。 自 定义 注册 或 登录 策略 (参见 图 31-21) 时 ， 
要 定义 里 份 提供 程序 ， 以 使 用 电子 邮件 、 城 市 和 国家 等 注册 属性 。 用 户 需 要 在 注册 时 提供 这 些 信息 。 还 可 以 指 
定 应 该 将 哪些 信息 放 入 应 用 程序 声明 中 一 一 在 访问 令 牌 中 发 送 给 应 用 程序 的 信息 。 在 使 用 Azure AD B2C 定义 


用 户 属性 时 ， 可 以 定义 出 现在 这 里 的 自 定义 字段 。 


* Name 


Procsharp-Sg nupandgnin 
二 entity prowiders 性 

2 elected 

Sign-up attributes $ 

3 Selected 


Bpplicatben cpms 性 
6 Selected 
Rulbiactor sutiherrcatncn 忆 


CF 


Page Ul customization 和 


Default 


并 Select sgn-up attributes 


GESCRIFTEON 

-city in which ve wmer is located, 
可 CountwRegion The county/ragion in which he wsar ie locntacd 
Display Name Display Marme of the User 
”Ernail Mddress 
Grren Narme The user's gven name lalso known ss first name) 
et: Trtle The vser's jab tle. 

Postal Code The posial code of the user's sddness. 
he ate wr Prariee In umer 3 Bodrear. 


Ster pre 


Gtrest ddress Te street addlress where te user Is hocated 


Th Uber s turnerie lalso Enonmn Be my Mb OF | 于 各 MimielL. 


i name 


图 31-21 
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配置 Azure AD B2C 租户 后 ， 可 以 构建 ASPNET Core Web 应 用 程序 。 

2. 用 Azure AD B2C 创建 ASP.NET Core Web 应 用 程序 

当 创 建 ASPNET Core Web 应 用 程序 (Model-View-Controller) 时 ， 需 要 使 用 Connect to an existing user store in 
the cloud 选项 ， 将 身份 验证 设置 更 改 为 Individual User Accounts( 参 见 图 31-22)。 在 这 个 对 话 杠 中， 还 需要 指定 
域名 、 应 用 程序 ID、 回 调 路 径 和 使 用 Azure AD B2C 配置 指定 的 策略 。 所 有 这 些 设置 都 保存 到 配置 文件 
appsettings.json 中 ， 可 以 在 以 后 修改 它们 。 


Change Authentication 


Connect to an existing User store in the cloud “| Leam more 


| select this option to connect to an existing Azrure AD B2C application. 
人 No Authentication 


®) Individual User Accounts Domain Name 

procsharp.onmicrosoftLcom 

Work er Scheol Accounts 
Application ID 

OO) Windows Authentication fgcc9d-2d14-4b69-gdie-ci8a66fb777a 
Callback Path 
lsignin-oide 
Reply URI: https://localhost44383/signin-oide 
sign-up or sign-in poliey 
B2cC 1_procsharp-signupandsignin 


Reset password policy 


Edit profile Policy 


Learn more about third-party open seurce authentication options 


图 31-22 


生成 的 启动 代码 为 Startup 类 中 的 身份 验证 注册 所 需 的 服务 。 调 用 AddAuthentication 扩展 方法 来 配置 cookie 
和 OpenID 标准 .对 于 Azure AD B2C, 扩展 方法 AddAzureAdB2C 在 AzureAdB2CAuthenticationBuilderExtensions 
类 的 项 目 Extensions 文件 夹 中 定义 。 这 个 方法 采用 设置 中 的 AzureAdB2C 部 分 来 配置 身份 验证 (代码 文件 
AzureADB2CSample/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 
{ 
Services.LAddAiuthentication (sharedOptions => 
{ 
sharedoOpticons.DefaultSscheme = 
CookieAuthenticationDefaults.AuthenticationScheme.: 
sharedOptions .DefaultChallengeScheme = 
OpenlIdConnectDefaults.AuthenticationScheme; 
}) 
-addazureadB2c (options => Configuration.Bind("AzureAdB2C", options)) 
.LAddCcookie () 


Services.AddMvyc (); 


} 

有 了 这 个 配置 ， 就 可 以 启动 应 用 程序 ， 然 后 单 击 Sign-In 按钮 ， 通 过 已 配置 的 社交 账户 身份 提供 程序 或 使 用 
用 户 名 和 密码 登录 ， 如 图 31-23 所 示 。 如 果 用 户 还 没有 注册 ， 就 可 以 通过 单 击 Sign Up Now 链接 进行 注册 。 此 
对 话 框 根据 绩 略 请 求 用 户 的 信息 (参见 图 31-24)。 
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二 到 口 


a ; 和 a EE 
FE i on Koes Sa Ng A 4 i= ti 


白 https://login.microsoftonline.com/te/procsharp.onmicrosoft.com/bac_1_procsharp-signupane | 家 二 及 [他 


Sign in with your social account 


Microsoft ProGsh 
; En 


OR 


sign in with your existing acecount 
Emaill Address 


Email Addresa 


Password Forgot your password? 
Password 


SIgn In 


Cont have an account? Sign up now 


31-23 


大 二 | 加 User details X | 二 YY 


Pa -i eT We RP OY VN VE WR SNS ET SY J TS 


| hitps://Mogin.microsoftonline.com/procsharp.onmicrosoft.com/B2C_1_procsharp-signt 


Email Address 


31-24 


使 用 Azure AD B2C, 主要 需要 进行 配置 ， 并 编写 较 少 的 代码 来 集成 应 用 程序 。 这 样 可 以 更 好 地 关注 业务 
代码 。 
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31.11 Razor 岁 面 


ASPNET Core 2.0 提供 了 一 种 创建 Web 应 用 程序 的 新 技术 : Razor 页 面 。 与 MVC 模式 相 比 ， 这 种 技术 更 
容易 理解 ， 有 了 时， 控制 器 只 是 将 请 求 转发 到 视图 。 在 前 面 的 示例 中 ， 己 经 使 用 了 一 些 操 作 方 法 ， 它 们 仅仅 调用 
View 方法 。 如 果 创 建 一 个 带 有 脚本 库 的 Single Page Application (SPA)， 比 如 Angular， 只 要 使 用 Razor 页 面 就 可 
以 启动 Angular 页 面 。 

使 用 Razor 页 面 ， 就 不 需要 分 离 模型 -视图 -控制 器 。 仍 然 像 使 用 MVC 和 视图 一 样 编写 CSHIML 页 面 。 使 
用 Razor 页 面 ， 可 以 直接 在 CSHTML 页 面 中 添加 C# 代 码 一 一 不 仅仅 是 对 视图 使 用 的 Razor 语法 。 还 可 以 使 用 
与 CSHTML 文件 直接 相关 的 代码 隐藏 文件 ， 并 且 可 以 与 C# 代 码 进行 一 些 分 离 。 代 码 隐藏 文件 类 似 于 其 他 技术 
(如 WPF、UWP 和 ASPNET Web Forms)。 

Razor 页 面 是 基于 ASPNET Core MVC 的 。NuGet 包 MicrosoftAspNetCore.All 包括 对 Razor 页 面 的 支持 。 
可 以 使 用 与 视图 相同 的 功能 ， 如 Razor 语法 、HTML Helper、Tag Helper、 视 图 中 的 依赖 注入 等 。 不 需要 控制 器 。 
CSHTML 文件 有 一 个 @Page 指令 ， 可 以 将 C# 代 码 添加 到 页 面 的 代码 隐藏 文件 中 。 

因为 Razor 页 面 使 用 的 特性 与 ASPNET Core MVC 中 的 视图 相同 ,本 节 只 讨论 ASPNET Core MVC 和 Razor 
页 面 之 间 的 差异 。 


31.11.1 创建 一 个 Razor 页 面 项 目 


使 用 Visual Studio 时 ， 可 以 使 用 项 目 模板 Web Application with ASPNET Core 2.0 创建 一 个 Razor Page 应 用 
程序 。 示 例 项 目 RazorPagesSample 就 使 用 这 个 项 目 模板 (参见 图 31-25)。 还 可 以 从 Web Application 
(Model-View-Controller) 模 板 开 始 ， 并 向 这 个 项 目 添 加 Razor 页 面 。 只 需要 将 Razor 页 面 文件 添加 到 Pages 文件 
夹 中 。 将 Razor 页 面 与 MVC 混合 起 来 很 容易 。 

如 果 使 用 命令 行 ， 则 使 用 如 下 命令 创建 Razor 页 面 项 目 : 


>dotnet new IrIazor 
New ASP.NET Core Web Application - RazorPagessample 


.NET Core 


A project template for creating an ASP.NET Core 
application with example ASP.NET Core Razor Pages 
content 
Web Anqular 
Application 
[Model-Vievs 
Contreller) 


Learn mare 


Reactjs and 
Redux 


Change Authentication 


Authentication Ne Authenticeatien 


|] Enable Docker Support 


Requires Docker for Windows 
Docker support can also be enabled later Learn more 


图 31-25 


Startup 类 的 ConfigureServices 方法 与 在 ASPNET Core MVC 项 目 中 的 类 似 ,， 包 舍 对 AddMvc 的 调用 ， 以 注 
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册 ASPNET Core MVC 需要 的 所 有 服务 (代码 文件 RazorPagesSample/Startup.cs): 
PUublic void ConfigureServices (IServiceCollection services) 
{ 
services.AddMyvec (}); 


} 

AddMvc 的 调用 包括 Razor 页 面 所 需 的 服务 。Razor 也 可 以 通过 使 用 AddRazorOptions 和 
AddRazorPageOptions 方法 来 配置 。 默认 情况 下 ， 在 Pages 文件 夹 和 子 文件 夹 中 搜索 Razor 页 面 。 例 如 ， 如 果 访 
问 URL /Hello， 就 搜索 页 面 Pages/Hello.cshtml。 使 用 URL /Admin/User， 会 得 到 页 面 Pages/Admin/User.cshtml。 

如 果 没 有 找到 这 些 页 面 ， 则 在 views/Shared 文件 夹 中 继续 搜索 。 用 AddRazorOptions 方法 设置 属性 
PageViewLocationFormats 时 ， 可 以 改变 这 种 行为 。 只 需要 将 文件 来 Pages 更 改 为 男 一 个 文件 来， 就 可 以 使 用 
AddRazorPagesOptions 方法 设置 RazorPagesOptions 的 RootDirectory 属性 。 


31.11.2 ”实现 数据 访问 


示例 应 用 程序 将 使 用 EF Core 从 数据 库 中 读 写 。 这 与 之 前 的 内 容 类 似 ， 因 此 不 需要 专门 解释 。Book 和 
BooksContext 类 是 在 Model 目录 中 创建 的 ， 以 说 明 可 以 使 用 来 自 ASPNET Core MVC 和 Razor 页 面 中 基于 服务 
的 代码 。 

下 面 代码 片段 中 的 Book 类 定义 了 要 读 写 的 数据 的 模型 (代码 文件 RazorPagesSample/Models/Book.cs): 

public class Book 


{ 
public int BookId { get; set; |} 


[StringLength (50)] 
Public string Title { get; set; } 


[StringLength (20) ] 
public string Publisher { get set; } 
} 


BooksContext 类 将 Book 类 型 映射 到 Books 表 , 并 实现 为 与 依赖 注入 一 起 使 用 (代码 文件 RazorPagesSample/ 
Models/BooksContext.cs): 


Public class BooksContext : DbhContext 
{ 
Public BooksContext (DhbContextOptions<BooksContext> options) 
: base (options) { } 


public DbSet<Book> Books { get; set; } 
} 


BooksContext 类 现在 使 用 AddDbContext 扩展 方法 在 依赖 注入 容器 中 注册 (代码 文件 RazorPagesSample/ 
Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 
{ 
Services.AddMyvec (); 
Services.AMddDbContext<BooksContext»> (options =»> 
opticons.UseSgqlServerl 
Configuration.GetConnectionSstring("BooksConnection™}))}))}); 


} 
对 于 数据 库 管理 ， 剩 下 的 就 是 定义 连接 字符 串 ( 配 置 文件 RazorPagesSample/appsettingsjson): 
{ 

"Connectionstrings™": 1 

"BooksConnection™: "server=(localdb})\‘\mssqllocaldb;database=RazorBooks; 
trusted connection=true™ 

} 

} 


到 目前 为 止 , Razor 页 面 的 代码 与 使 用 ASPNET Core MVC 中 的 控制 器 没有 什么 不 同 。Razor 页 面 最 有 趣 的 
部 分 将 在 下 一 节 中 介绍 。 
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31.11.3 ”使 用 内 联 代 码 


在 创建 项 目 并 添加 代码 以 访问 数据 库 之 后 ， 可 以 使 用 Visual Studio Item Template Razor Pages 来 添加 Razor 
页 面 。 使 用 这 个 模板 ， 可 以 在 简单 的 Razor 页 面 、 使 用 Entity Framework 的 Razor 页 面 和 使 用 Entity Framework 
的 多 个 Razor 页 面 之 间 选 择 ( 参 见 图 31-26)。 当 对 话 框 列 出 Entity Framework 时 ， 可 以 使 用 EF Core 来 创建 这 些 


页 面 。 下 面 从 一 个 简单 的 Razor 页 面 开 始 。 


在 选择 Razor 页 面 之 后 ， 可 以 选择 Generate a PageModel class、Create as a Partial View 和 Use a Layout Page 
选项 (参见 图 31-26)。 虽 然 本 章 已 经 介绍 了 ASPNET Core MVC 中 的 部 分 视图 和 布局 页 面 , 但 PageModel 的 选项 
是 Razor 页 面 新 增 的 。 选 择 Generate a PageModel class 选项 时 ， 将 生成 代码 隐藏 文件 ， 没 有 PageModel， 所 有 
C# 代 码 都 需要 放 在 CSHTML 文件 中 。 使 用 示例 代码 ， 第 一 个 创建 的 页 面 将 是 内 联 的， 没有 代码 隐藏 文件 。 

从 浏览 器 中 请 求 页 面 时 , 数据 库 中 的 所 有 图 书 都 应 该 显示 在 一 个 表 中 。 在 CSHTML 文件 的 顶部 有 一 个 Page 
指令 。 此 指令 将 文件 标记 为 Razor 页 面 。 因 为 BooksContext 类 是 在 依赖 注入 容器 中 注册 的 ,所 以 可 以 使 用 @inject 
直接 注入 页 面 中 。( 代 码 文 件 RazorPagesSample/Pages/Inline.cshtml): 


page 

dusing RazorPagesSample.Models 
Rinject BooksContext context 
@{ 


ViewDatal["™Title™"™] = "Inline™; 


} 


Add Razor Page 


Razor Page name: InlineCode 

Options: 

[| Generate PagelModel class 

[| Create as a partial view 
Reference seript libraries 


Use a layout page: 


(Leave empity if it is set in a Razor _viewstart file) 


图 31-26 


在 Razor 页 面 中 编写 内 联 C# 人 代码， 可 以 使 用 @functions 指令 。OnGet 方法 在 页 面 的 每 个 GET 请 求 上 调用 。 
在 实现 代码 中 ， 如 果 数 据 库 还 不 存在 ， 就 创建 数据 库 ， 并 调用 SeedBooks 方法 同 数据 库 写 入 两 个 Book 对 象 。 
在 成 功 创建 数据 库 之 后 ， 将 检索 图 书 并 将 其 写 入 Books 属性 (代码 文件 RazorPagesSample/Pages/Inline.cshtml): 


functions 

{ 
Public void Oncet() 
{ 


bool created = context.Database .EnsureCreated(}); 


if (created) SeedBooks () ; 


Books = _ Context .Books.ToList (}; 


} 
Public IEnumerable<Book> Books { get; set,; } 
private Vol SeedBooks ( ) 


{ 
Context.Books.Add (new Book 


{ Title = "Professional C# 6 and .NET Core 1™, 


_ Context .Books .Add (new Book 


{ Title = "Professional C# 了 angd .NET Core 2™, 


Context.SaveChanges (}; 


} 
Ee 


Eublisher 


Eublisher 


"WIox Press™ }); 


"Wrox Press™ 1}).， 
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注意 : 
在 Razor 页 面 中 , On... 方 法 是 根据 请 求 的 HTTP 方法 调用 的 .GET 请 求 调用 OnGet 方法 , POST 请 求 OnPost 
方法 ，PUT 请 求 OnPut 方法 等 。 还 可 以 向 方法 名 添加 后 级 ， 并 实现 返回 Task 的 异步 变 体 。 


要 显示 这 些 书 ， 请 在 (@function 声明 之 后 的 同一 页 面 中 ， 添 加 HIML 代码 和 Razor 代码 ， 如 下 所 示 。 使 用 
@foreach， 可 以 迭代 并 显示 Books 属性 中 的 图 书 (代码 文件 RazorPagesSample/Pages/Inline.cshtml): 

Q@* --- 六 昌 

<h2>Inline Razor Page Sample</h2> 


@if (Books != null) 
{ 
<table> 
<thead> 
区 七 工 祖 
<th>Title</th> 
<th>Publisher</th> 
</tr> 
</thead> 
<tbody> 
foreach (var book in Books) 
{ 
所 七 工 
<td>book .Title</td> 
<td>ibook .Publisher</td> 
</tr> 
} 
</tbody> 
</table> 
} 


下 面 通 过 创建 表单 ， 发 送 POST 请 求 来 扩展 这 个 功能 。 在 同一 个 页 面 中 ， 定 义 一 个 表单 元 素 ， 人 允许 用 户 输 
入 图 书 标题 和 出 版 商 。 单 击 Submit 按钮 时 ， 把 一 个 POST 请 求 发 送 到 同一 个 页 面 (代码 文件 RazorPagesSample/ 
Inline.cshtm)l): 

<div>@Message</div> 


<form method="post"»> 
Enter a new book 
<br /> 
<input type="tezxt" name="Title”" id="Title"™" /> 
<br /> 
<input type="text" name="Publisher™ id="Publisher™ /> 
<br /> 
<button type="submit">Submit</button> 
</form> 


在 (@functions 声明 中 ，OnPost 方法 定义 为 啊 应 POST 请 求 。 在 这 里 ， 把 Book 属性 引用 的 书写 入 数据 库 ， 
并 再 次 检索 这 些 书 。Book 属性 具有 BindProperty 注释 。 此 属性 从 POST 请 求 ( 即 表单 中 输入 字段 的 值 ) 中 获取 
请 求 体 来 创建 Book 对 象 ; 因此 ， 这 是 一 种 新 的 模型 绑 定 方式 (代码 文件 RazorPagesSample/Pages/Inline.cshtml): 


Qfunctions 


{ 


Eublic void OnPost() 
{ 
_ConteXt -BOOKS -Add (BOoOK) ;7 
Context.SaveCchanges ()/ 
Message = "Book saved"™; 
Books = context.Books.ToList(); 


} 


[BindProperty () ] 
public Book Book { get; set; } 


Public string Message |{ get; set; } = string.Empty; 
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默认 情况 下 , 使 用 BindProperty 特性 标记 属性 不 会 使 属性 可 用 于 GET 请 求 , 这 在 大 多 数 情况 下 都 是 有 用 的 ， 
因为 绑 定 应 该 只 发 生 在 表单 的 POST 请 求 上 。 但 是 ， 还 可 以 将 属性 SupportGet 设置 为 true, 该 属性 也 与 GET 请 

运行 应 用 程序 并 在 浏览 器 中 输入 /Tnline 链接 ， 将 打开 Razor 页 面 ， 创 建 一 个 数据 库 ， 列 出 数据 库 中 的 图 书 ， 
并 允许 用 户 输 入 一 本 新 书 ， 如 图 31-27 所 示 一 一 所 有 这 些 都 定义 在 一 个 代码 文件 中 。 当 然 ， 也 可 以 在 同一 个 
CSHTML 文件 中 定义 Book 和 BooksContext， 这 样 就 可 以 将 所 有 内 容 都 放 在 一 个 文件 中 。 


居 | 品 Inline - RazorPagesSam | 二 Ww a 口 x 
-一 人 站 localhost:240' Tr T= 


Inline Razor Page Sample 


Title Publisher 
Professional C# 6 and .NET Core 1 Wrox Press 
Professional C# 7 and .NET Core 2 Wrox Press 
Enter a new Dook 


SUbrmit 


B2017 - RazorPagessample 


图 31-27 


只 要 没有 太 多 的 代码 行 ， 把 读 写 图 书 的 所 有 代码 放 在 一 个 文件 中 就 是 有 用 的 。 在 NET Core 中 ， 把 所 有 内 
容 放 在 一 个 文件 中 有 益 于 初学 者 ， 但 是 对 于 大 文件 来 说 ， 这 样 会 变 得 很 混乱 ， 因 为 很 难 找到 要 更 新 的 行 。 


31.11.4 ”使 用 内 联 代码 和 页 面 模型 


使 用 内 联 代 码 创 建 Razor 页 面 后 的 第 一 个 更 改 是 将 内 联 C# 代 码 更 改 为 一 个 模型 类 。 现在， 在 (@functions 声 
明 中 ， 定 义 了 派生 自 类 PageModel 的 InlinePageModel 类 。 基 类 PageModel 在 名 称 空 间 
Microsoft.AspNetCore.Mvc.RazorPages 中 定义 。 这 个 类 用 (@model 指令 分 配给 页 面 一 一 这 与 把 控制 器 中 的 信息 传 
递 给 视图 时 使 用 的 指令 相同 。 在 这 个 场景 中 ， 可 以 从 页 面 中 删除 @inject， 通 过 InlinePageModel 类 的 构造 函数 
注入 BooksContext 。 除 了 构造 函数 之 外 ， 前 面 示例 的 @fonction 中 的 代码 现在 在 类 中 定义 (代码 文件 
RazorPagesSample/Pages/Inline WithClasses.cshtml): 


@page 

Bmodel InlinePageModel 

Busing Microsoft.AspNetCore.Myve .RazorPages 
Busing RazorPagesSample.Models 


a 
ViewDataf[™" Title™] = "Inline™; 


@functions 
{ 
Public class InlinePageModel : PageModel 
{ 
Private readonly BooksContext context.,; 
Public InlinePageModel (BooksContext context) => context = context., 


public void OnGet() 

{ 
bool created = context.Database.EnsureCreated(). 
if (created})} SeedPBooks (); 
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Books = context.Books.ToL1ist(); 


} 
public IEnumerable<Book> Books |{ get; set; } 


i... 
} 
} 
@* --- 克己 
需要 用 Razor 代码 对 HTML 部 分 进行 小 的 修改 。 由 于 不 能 直接 访问 Books 和 Message 属性 ， 因 此 需要 使 用 
Model 属性 (从 @model 指令 中 创建 )( 代 码 文 件 RazorPagesSample/Pages/InlineWithClasses.cshtml): 
Rforaeach {var book in Model .Books) 
{ 
< 七 工 > 
<td>@book.Title</td> 
<td>@book.Publisher</td> 
</tr> 
} 


通过 此 更 改 ， 在 CSHTML 文件 中 定义 InlinePageModel，C# 代 码 与 前 一 个 示例 相 比 有 所 增长 。 但 是 ， 现 在 
有 了 一 个 小 步骤 ， 可 以 将 该 代码 移动 到 代码 隐藏 文件 中 ， 如 下 一 节 所 示 。 


31.11.5 ”使 用 代码 隐藏 文件 


创建 Razor 页 面 时 ,可 以 选择 Generate PageModel class 选项 。 这 将 创建 CodeBehind.cshtml.cs 和 代码 隐藏 文 
件 CodeBehind.cshtml。 CSHTML 文件 使 用 @model 指令 引用 代码 隐藏 文件 中 的 类 型 ,这 个 文件 中 没有 @functions 
声明 (代码 文件 RazorPagesSample/Pages/CodeBehind.cshtm]l): 

page 

model RazorPadgesSsample. Pages.CodeBehindModel 

CR = "Code Behind™.; 


<h2>Code Behind Razor Page Sample</h2> 
Bt 


代码 隐藏 文件 包含 与 内 联 类 相同 的 代码 ;不 需要 除了 类 名 之 外 的 代码 更 改 (代码 文件 RazorPagesSample/ 
Pages/CodeBehind.cshtml.cs): 

Public class CodeBehindModel : PageModel 

{ 


private readonly BooksContext context; 
Public CodeBehindModel (BooksContext context) => context = context; 
Public void OnGet () 
{ 
bool created = context.Database.EnsureCreated (). 
if (created) SeedBooks () ; 
Books = Context .Books.ToList (}; 
} 
f/--- 
} 


C# 代 码 和 HIML 代码 分 成 两 个 文件 。 现 在 就 拥有 了 附近 页 面 的 功能 ， 而 不 是 调用 多 个 视图 的 控制 器 。 
31.11.6 ”页 面 参 数 

使 用 Razor 页 面 的 简单 路 由 功能 ， 需 要 一 种 传递 参数 的 方式 。 这 就 是 @page 指令 所 提供 的 功能 : 可 以 在 以 
下 代码 片段 中 添加 参数 作为 int 类 型 的 可 选 id 参数 (代码 文件 RazorPagesSample/Pages/PageWithParameter.cshtm]l): 

GPage "{id:int?}" 

要 检索 参数 ,可 以 修改 OnGet 方法 , 来 接收 这 个 数值 (代码 文件 RazorPagesSample/Pages/PageWithParameter 
cshtml.cs): 


Public class PageWithParameterModel : PageModel 


{ 
Public void OnGet (int id = 0) 
{ 
Id = idqs: 
} 
public int Id { get; set; } 
} 


使 用 page 指令 中 定义 的 路 由 ， 可 以 通过 在 路 由 中 直接 传递 值 来 访问 页 面 : 

http://localhost:24095/PageWithPrarameter/42 

或 作为 URL 参数 传递 : 

http://localhost:24095/PageWithParameter/?id=42 

除了 更 改 OnGet 方法 来 接收 参数 之 外 ， 也 可 以 将 其 直接 绑 定 到 应 用 BindProperty 特性 的 属性 上 。 请 记 住 设 
置 此 特性 的 SupportsGet 属性 (代码 文件 RazorPagesSample /Pages/PageWithParameterAndBinding.cshtml.cs): 

Public class PageWithPrarameterAndBindingModel : PageModel 

ee VOId OnGet() 


{ 
} 


[BindProperty (SupportsGet = true)})] 


Public int Id 1{ get; Set 上 } 
} 


在 学 习 了 Razor 页 面 的 基础 知识 之 后 ， 就 很 容易 使 用 Visual Studio 中 的 Razor 页 面 项 模板 来 创建 页 面 ， 以 
便 列 出 、 创 建 、 编 辑 或 删除 对 象 ， 包 括 使 用 前 面 创建 的 BooksContext 类 的 代码 隐藏 文件 。 检 查 文 件 夹 
RazorPagesSample/Pages/Books 内 可 下 载 的 源 代 码 ， 坦 看 生成 的 源 文件 ， 其 中 包括 HIML 辅助 程序 、Tag Helper 
以 及 访问 EF Core 的 代码 。 


31.12 小结 


本 章 介 绍 了 一 种 使 用 ASPNET Core MVC 框架 的 最 新 Web 技术 。 这 提供 了 一 个 健壮 的 结构 , 非常 适合 需要 
恰当 地 进行 单元 测试 的 大 型 应 用 程序 。 通 过 本 章 可 以 看 到 ， 使 用 ASPNET Core MVC 时 ， 提 供 高 级 功能 十 分 简 
单 ， 其 逻辑 结构 和 功能 的 分 离 使 代码 很 容易 理解 和 维护 。 

我 们 还 了 解 了 Razor 页 面 (这 是 ASPNET Core 2.0 中 的 新 技术 )， 及 其 与 ASPNET Core MVC 的 区 别 。Razor 
页 面 不 仅 提 供 了 开始 使 用 ASPNET Core 的 简单 方法 ， 它 也 可 能 是 创建 以 HIML 和 JavaScript 为 主 的 Web 页 面 

在 这 里 ，Razor 页 面 很 容易 与 ASPNET Core MVC 混合 是 很 重要 的 ， 因 为 它 用 于 开发 Web API 一 一 该 API 
用 于 客户 端 和 服务 端 之 间 的 通信 ， 而 客户 端 可 以 是 Web 页 面 或 WPF、UWP 和 Xamarin 客户 端 。 创 建 Web API 
是 下 一 章 的 主题 。 


入 


Web AP 


本 章 要 点 

ASPNET Web API 概述 

创建 Web API 控制 器 

使 用 存储 库 和 依赖 注入 

调用 REST API 创建 NET 客户 端 

在 服务 中 使 用 Entity Framework Core 
使 用 Swagger 创建 元 数据 

使 用 OData 

实现 Azure Function 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 API 目录 的 
https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® BooksService Sample 
Book Service Async Sample 
Book Service Client App 
Book Service OData 


Book Service Azure Functions 


32.1 概述 


.NET 3.0 发 布 WCF(Windows Communication Foundatiom 时 ，WCF 是 一 种 通信 技术 ， 蔡 代 了 .NET 栈 中 的 其 
他 几 个 技术 (其 中 的 两 个 是 NET Remoting 和 ASPNET Web 服务 )。 其 目标 是 只 用 一 种 非常 灵活 的 通信 技术 来 满 
足 所 有 需求 。 但 是 ，WCF 最 初 基 于 SOAP。 现 在 有 许多 情形 都 不 需要 强大 的 SOAP 改进 功能 。 对 于 返回 JSON 
的 HITP 请 求 这 样 的 简单 情形 ，WCF 过 于 复杂 。 因 此 在 2012 年 引入 了 另 一 种 技术 ， ASPNET Web API。 随 着 
ASPNET Core 的 发 布 ， 发 布 了 使 用 ASPNET 技术 的 Web API 的 第 三 个 重要 版 本 。 

ASPNET MVC 和 ASPNET Web API 以 前 有 不 同 的 类 型 和 配置 (以 前 的 版 本 是 ASPNET MVC 5 和 ASPNET 
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Web API2)， 但 ASPNET Core 中 的 Web API 与 ASPNET Core MVC 中 的 Web API 相同 。 

ASPNET Web API 提供 了 一 种 基于 REST(Representational State Transfer) 的 简单 通信 技术 。REST 是 基于 一 
些 限制 的 体系 结构 样式 。 下 面 比 较 基 于 REST 体系 结构 样式 的 服务 和 使 用 SOAP 的 服务 ， 以 了 解 这 些 限制 。 

REST 服务 和 使 用 SOAP 协议 的 服务 都 利用 了 客户 端 -服务 器 技术 。SOAP 服务 可 以 是 有 状态 的 ， 也 可 以 是 
无 状态 的 ;REST 服务 总 是 无 状态 的 。SOAP 定义 了 它 自己 的 消息 格式 ， 该 格式 有 标题 和 正文 ， 可 以 选择 服务 
的 方法 。 而 在 REST 中 ， 使 用 HTTP 动词 GET、POST、PUT 和 DELETE。GET 用 于 检索 资源 ，POST 用 于 添 
加 新 资源 ，PUT 用 于 更 新 资源 ，DELETE 用 于 删除 资源 。 

本 章 使 用 ASPNET Core MVC 介绍 Web API 的 各 个 重要 方面 一 一 创建 服务 、 使 用 不 同 的 路 由 方法 、 创 建 客 
户 端 、 使 用 OData、 保 护 服务 以 及 使 用 目 定义 的 人 宿主。 本 章 还 讨论 如 何 通过 ASPNET Core 使 用 已 创建 的 相同 服 
务 ， 在 Microsoft Azure Functions 中 使 用 它们 ， 这 是 使 用 C# 和 .NET 创建 Web API 的 另 一 个 选项 。 


32.2 ”创建 服务 


首先 创建 服务 。 使 用 .NET Core 时 ， 需 要 从 ASPNET Core Web Application 开始 ， 并 在 如 图 32-1 所 示 的 
对 话 框 中 选择 Web API。 这 个 模板 添加 了 Web API 需要 的 文件 夹 和 引用 。 如 果 需 要 Web 页 面 和 服务 ， 还 可 以 
使 用 模板 Web Application(Model-View-Controller)。 使 用 示例 代码 ， 这 个 项 目 在 解决 方案 BooksServiceSample 中 
命名 为 BooksServiceSampleHost。 


,NET Core “| ASPNET Core 2.0 | | rm reare 


A project template for creating an ASP,NET Core 
加 | A application with an example Conitroller for a RESTful 
HTTP service. This template can also be used for 
‘Web Angular ASPNET Core MVC Views and Controllers. 
Application Application 
(hodel-View 
Controller 


Learm more 


Change Authentication 
Authenticzation Ne Authenticatien 


L_ | Enable Docker Support 


Requires Docker tor Windoaws 
Docker support can also be enabled later Learn mere 


| OK Carnecel | 


图 32-1 


注意 : 
ASPNET Core MVC 参见 第 31 章 。ASP.NET Core MVC 的 基础 核心 技术 参见 第 30 章 。 


用 这 个 模板 创建 的 目录 结构 包含 创建 服务 所 需要 的 文件 夹 。Controllers 目录 包含 Web API 控制 器 。 第 31 章 
介绍 过 这 样 的 控制 器 ， 事 实 上 Web API 和 ASPNET Core MVC 使 用 相同 的 基础 设施 。ASPNET 的 .NET 
Framework 版 本 不 是 这 样 。 使 用 默认 模板 ，ValuesController 是 通过 一 个 简单 的 示例 实现 创建 的 。 在 较 大 的 应 
用 程序 中 ， 最 好 将 其 分 离 为 多 个 库 。 如 果 创 建 一 个 包含 服务 和 模型 的 库 ， 那 么 使 用 来 目 不 同 技术 (例如 ,来自 
Web API 项 目 和 Azure Functions) 的 相同 类 型 是 很 容易 的 。Web API( 控 制 器 ) 的 实现 也 可 以 位 于 与 托管 应 用 程序 
分 离 的 库 中 。 在 Web 应 用 程序 中 , 可 以 使 用 在 应 用 程序 自己 的 库 中 实现 的 控制 器 。 服 务 (BookServices) 和 Web 
API (APIBookServices) 的 库 都 实现 为 NET 标准 2.0 库 。 有 了 库 APIBookServices， 需 要 添加 NuGet 包 
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Microsoft.AspNetCore.Mvc.Core 和 Microsoft.AspNetCore.Mvc.ViewFeatures 来 实现 控制 器 。 在 NET 标准 2.0 库 中 
不 可 能 使 用 前 几 章 中 用 过 的 元 数据 包 Microsoft.AspNetCore.All， 而 需要 一 个 NET Core 2.0 库 。 

现在 ， 从 模型 开始 。 在 项 目 BooksService 中 ，Models 目录 用 于 数据 模型 。 可 以 将 实体 类 型 添加 到 此 目录 ， 
以 及 返回 模型 类 型 的 存储 库 。 

所 创建 的 服务 返回 图 书 的 章节 列表 ， 并 允许 动态 添加 和 删除 章节 。 


32.2.1 定义 模型 


首先 需要 一 个 类 型 来 表示 要 返回 和 修改 的 数据 。 在 Models 目录 中 定义 的 类 的 名 称 是 BookChapter， 它 包含 
表示 一 章 的 简单 属性 (代码 文件 Sync/BookServices/Models/BookChapter.cs): 


public class BookChapter 

{ 
Public Guid Id { get; set; } 
Public int Number { get; set; } 
Public string Title { get; set; } 
public int Pages { get; set; } 


32.2.2 创建 服务 


接 下 来 ， 创 建 一 个 服务 。 服 务 提供 的 方法 由 接口 IJBookChaptersService 定义 ， 用 于 检索 、 添 加 和 更 新 图 书 
章节 (代码 文件 Sync/BookServices/Services/IBookChaptersService.cs): 


Public interface IBookChaptersService 
{ 
VOI1Id Add (BookChapter bookChapter); 
Vol1ad AddRange (IEnumerable<BookChapter> chapters); 
IEnumerable<BookChapter> GetAll(); 
BookChapter Find({(Guid id); 
BookChapter Remove (Guid 19) ; 
volid Update (BookChapter bookChapter); 
} 


服务 的 实现 由 类 BookChaptersService 定义 。 书 的 章节 保存 在 一 个 集合 类 中 。 由 于 不 同 客户 机 请 求 的 多 个 任 
务 可 以 并 发 访问 该 集合 , 因此 在 图 书 章节 中 使 用 类 型 ConcurrentDictionary。 这 个 类 是 线程 安全 的 。Add、Remove 
和 Update 方法 使 用 集合 来 添加 、 删除 和 更 新 图 书 章节 (代码 文件 BookServices /Services/BookChaptersService.cs): 


Public class BookChaptersService : IBookChaptersService 
{ 
private readonly ConcurrentDictionary<Guid, BookChapter> chapters = 
new ConcurrentDictionary<Guid, BookChaptery> (); 


public void Add (BookChapter chapter) 
{ 
chapter.Id = Guid.NewGuid({(); 
chapters[lchapter.1d] = chapter; 
} 


Public void AddRange (IEnumerable<BookChapter> chapters) 
{ 
foreach (var chapter in chapters) 
{ 
chapter.Id = Guid.NewGuid(); 
chapters[chapter.Id|] = chapter; 
} 
} 


Public BookChapter Find(Guid 1d) 

{ 
_Chapters -TIYGetValue (id, out BookChapter chapter); 
return chapter; 


} 
Public IEnumerable<BookChapter> GetAll{() => chapters.Values; 


public BookChapter Remove (Guid 1d) 
{ 
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} 
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BookcCchapter removed; 
_ Chapters .TryRemove (id, out removed); 
return removed; 


} 


public void Update (BookChapter chapter) => 
chapters[chapter.Id|] = chapter; 


注意 : 

通过 示例 代码 ，Remove 方法 确保 id 参数 传递 的 BookChapter 不 在 字典 中 。 如 果 字 典 已 经 不 包含 书 的 章节 ， 
那 没关系 。 

如 果 找 不 到 所 传递 的 图 书 章 节 ，Remove 方法 的 另 一 种 实现 可 以 抛 出 异常 。 控 制 器 可 以 更 改 此 错误 ， 以 返 
回 HITP 未 找到 的 状态 码 (404)。 

Microsoft REST API 指南 (https://github.com/microsoft/apieuidelines/blob/master/Guidelines.md) 指 定 DELETE 
请 求 为 锋 等 性 的 ， 因 此 它 应 该 在 多 个 请 求 中 返回 相同 的 结果 。 


注意 : 
并 发 集合 详 见 第 11 章 。 


因此 ， 第 一 次 访问 服务 时 ， 可 以 使 用 一 些 示例 章节 ， 类 SampleChapters 用 章节 信息 填充 图 书 章节 服务 (代码 
文件 Sync/BookServices/Services/SampleChaptercs): 


public class SampleChapters 


{ 


} 


private readonly IBookChaptersService bookChaptersService; 
public SampleChapters (IBookChaptersService bookCchapterService) 
{ 

bookChaptersService = bookChapterService; 


} 


private string[] sampleTitles = mew[] 
{ 
.NET Application Architectures™, 
"Core C#", 
"Objects and Types™, 
"Object-Oriented Programming with C#™, 
"Gaenerics™, 
"Operators and Casts™, 
"Arravs™", 
"Delegates, Lambdas, and Events™, 
"Windows Communication Foundation"™ 


}s 


private int[] chapterNumbers = { 1, 2, 3, 4, 5, 6, 7, 8, 44 }; 


private int[] numberPages = { 35, 42, 33, 20, 24, 38, 20, 32, 44 }; 


public void CreateSampleChapters () 

{ 
Var chapters = new List<BookChapter> (); 
for {int i = 0; 1 < 838; i++) 


{ 
chapters.Add (new Bookchapter 
{ 
Number = chapterNumbers[i], 
Title = sampleTitles[1i], 
Fages = numberPages[i] 
}); 
} 


bookChaptersService.AddRange (chapters}); 
} 


在 托管 应 用 程序 中 ， 引 用 了 库 。 要 使 服务 可 用 ， 需 要 用 依赖 注入 (DD 容 器 注册 。 这 是 在 Startup 类 中 完成 的 。 
在 启动 之 后 ，BookChaptersService 和 SampleChapters 服务 通过 DI 容器 的 AddSingleton 方法 注册 ， 为 请 求 
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服务 的 所 有 客户 端 创建 一 个 实例 。 由 于 BookChaptersService 注册 为 单 例 ， 因 此 可 以 同时 从 多 个 线程 中 访问 它 ; 这 
就 是 为 什么 在 其 实现 代码 中 需要 ConcurrentDictionary 的 原因 (代码 文件 Sync/BookServiceSampleHost/Startup.cs): 
public void ConfigureServices (IServiceCollection services) 
{ 
services.AddMvec (});} 
i 
SeErvices.Addsingleton<IBookChaptersService, BookChaptersService>(); 


services.AddSsingleton<SampleChapters> (); 
} 


创建 示例 章节 的 调用 在 Configure 方法 中 完成 。 在 这 里 ， 将 注入 SampleChapters 对 象 ， 在 方法 的 实现 中 ， 
将 调用 CreateSampleChapters 创建 示例 章节 (代码 文件 Sync/BookServiceSampleHost/Startup.cs): 
PUublic void Configure (IApplicationBuilder app, IHostingEnvironment env, 
SampleChapters sampleChapters) 
| (env .IsDevelopment () ) 


app-.UseDeveloperExceptionPpage ()，; 
} 


app.UseMvc (); 
sampleChapters.CreateSampleChapters (); 
} 


32.2.3 ”创建 控制 疾 


Web API 控制 器 使 用 图 书 章节 服务 。 控制 器 可 以 通过 Solution Explorer 上 下 文 菜单 Add New Item | Web API 
Controller Class 创建 。 管理 图 书 章节 的 控制 器 类 被 命名 为 BookChaptersController。 这 个 类 派生 自 基 类 Controller。 
到 控制 器 的 路 由 使 用 Route 特性 定义 。 该 路 由 以 api 开头 ， 其 后 是 控制 器 的 名 称 ， 这 是 没有 Controller 后 组 的 
控制 器 类 名 。BooksChapterController 的 构造 函数 需要 一 个 实现 IBookChapterRepository 接口 的 对 象 。 这 个 
对 象 是 通过 依赖 注入 功能 注入 的 (代码 文件 Sync/API BookServices/Controllers/BookChaptersController.cs): 

[Produces ("application/json", "application/zxml")] 

[Route ("api/ [controller]")] 

Public class BookChaptersController : Controller 


| 


private readonly IBookChaptersService bookCchaptersService;s 


Public BookChaptersController (IBookChaptersService bookChaptersService) 


bookChaptersService = bookChaptersService; 


} 
模板 中 创建 的 Get 方法 被 重 命 名 , 并 被 修改 为 返回 类 型 为 IEnumerable<BookChapter> 的 完整 集合 (代码 文件 
Sync/APIBookServices/Controllers/BookChaptersController.cs): 


// GET api/bookchapters 

[HttpGet] 

public IEnumerable<BookChapter> GetBookChapters() => 
bookChaptersService.GetaAll (}; 


带 一 个 参数 的 Get 方法 被 重 命名 为 GetBookChapterById， 用 Find 方法 过 滤 存 储 库 的 字典 。 过 滤器 的 参数 
id 从 URL 中 检索 .如果 没有 找到 章节 , 存储 库 的 Find 方法 就 返回 null。 在 这 种 情况 下 , 返回 NotFound。NotFound 
返回 一 个 404( 未 找到 ) 啊 应 。 找 到 对 象 时 ， 创 建 一 个 新 的 ObjectResult 并 返回 它 ; ObjectResult 返回 一 个 状态 码 
200， 其 中 包含 图 书 的 章节 (代码 文件 Sync/APIBookServices/Controllers/BookChaptersController.cs): 

// GET api/bookchapters/guid 

[HttpGet ("{id}", Name = nameof (GetBookChapterBYId) ) ] 


Public IActionResult GetBookCchapterById (Guid id) 
{ 


BookChapter chapter = bookCchaptersService.Find(1id); 
if (chapter == null) 
{ 
return NotFound():; 
} 
全 ] Se 
{ 


return new ObjectResult (chapter); 
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注意 : 

路 由 的 定义 参见 第 31 章 。 

要 添加 图 书 的 新 章节 ， 应 添加 PostBookChapter。 该 方法 接收 一 个 BookChapter 作为 HITP 体 的 一 部 分 ， 反 
序列 化 后 分 配给 方法 的 参数 。 如 果 参 数 chapter 为 null， 就 返回 一 个 BadRequest(HTTP 400 错误 )。 如 果 添 加 
BookChapter, 这 个 方法 就 返回 CreatedAtRoute。CreatedAtRoute 返回 HTTP 状态 码 201( 已 创建 ) 及 序列 化 的 对 象 。 
返回 的 标题 信息 包含 到 资源 的 链接 ， 即 到 GetBookChapterById 的 链接 ， 其 id 设置 为 新 建 对 象 的 标识 符 (代码 文 
件 Sync/APIBookServices/Controllers/BookChaptersController.cs): 


// POST api/bookchapters 


[HttpPost] 
Public IActionResult PostBookChapter([FromBody]BookChapter chapter) 
{ 

if (chapter == null) 


{ 
return BadReaquest () ， 
} 
bookChapterssService.Add (chapter); 
return CreatedAtRoute (nameof (GetBookChapterById), new { id = chapter.Id }, 
chapter}); 
} 


更 新 条 目 需要 基于 HTTP PUT 请 求 。PutBookChapter 方法 在 集合 中 更 新 已 有 的 条 目 。 如 果 对 象 还 不 在 集合 
中 ,就 返回 NotFound。 如 果 找 到 了 对 象 ， 就 更 新 它 并 返回 一 个 成 功 的 结果 状态 码 204， 其 中 没有 内 容 (代码 文件 
Sync/APIBookServices/Controllers/BookChaptersController.cs): 

// PUT api/bookchapters/guid 


[HttpPut (" {id}")] 
public IActionResult PutBookChapter (Guid id, [FromBody] BookChapter chapter) 


{ 
1f (chapter == null || id != chapter.Id) 
{ 
return BadRequest () ; 
} 
if ( bookchaptersService.Find(1id) == null) 


{ 
return NotFoundl(}):; 
} 
bookChaptersService.Update (chapter); 
return new NoContentResult().; 


} 
对 于 HITP DELETE 请 求 ， 从 字典 中 删除 图 书 的 章节 (代码 文件 Sync/APIBookServices/Controllers/ 
BookChaptersController.cs): 


/DELETE api/bookchapters/5 
[HttpDelete ("{1d}")] 
Public Vold Delete(Guid 1d) => bookChaptersSsService.Remove (id); 


有 了 这 个 控制 器 ， 就 可 以 在 浏览 器 上 进行 第 一 组 测试 了 。 打 开 和 链接 http://localhost:1079/api/BookChapters( 新 
口号 可 能 不 同 )， 人 返回 JSON， 如 下 所 示 : 


[{"id":"015b0Ofb6-la0f-44ac-ba0d-3d6d743bf4df", "number™".:2,"title":"Objects and Types", "pages":33}, 
{"id":"33ccl22a-6be2-48b6-83bl-e913fcl0da77™", "number™"™:0,"title™":".NET Application Architectures™, 
"pages™:35},{"id":"47bcfale—-085e-4d1l1-9a63-ed2421]1cad912", "number™.:6,"title™":"Arrays", "Pages":20}, 
{"id":"069al755-05da-40d7-96d4-al422eddfcdli", "number™:3,"title"™": "Object-Oriented Programming with 
C#", "pages™:20},{"id":"allcdcé6b-087b-4c69-a4dc7-cc48f472c1b0O™"™, "number™":5, "title™": "Operators and 
Casts" "pages™:38},{"id":"1b638e90-f£f553-4635-8b54-b6é6c5a938ad5d"™, "number™"™:1,"title™":"Core 
C#", "pages™":42},{"id":"387lal0e-cala-4d63-944e-984d869b9416", "number"m:7,"title":"Delegates, Lambdas, 
and Events", "pages™.:32},1{"id":"311dlic72-844c-4b0Ob-a674—6af7Tb24d7530™, "number™"™:4, "title™":"Generics", 
"Dages" :241}1] 


32.2.4 ”修改 响应 格式 


ASPNET Web API 的 .NET Framework 版 本 返回 JSON 或 XML, 这 取决 于 由 客户 端 请 求 的 格式 ,在 ASPNET 
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Core MVC 中 , 当 返 回 ObjectResult 时 , 默认 情况 下 返回 JSON。 如 果 也 需要 返回 XML, 可 以 添加 一 个 对 Startup 
类 的 AddXmlSerializerFormatters 的 调用 。AddXmlSerializerFormatters 是 IMvcBuilder 接口 的 一 个 扩展 方法 ， 可 
以 使 用 流利 API 添加 到 AddMvc 方法 中 (代码 文件 Sync/BooksServiceSampleHost/Startup.cs): 
Public void ConfigureServices(IServiceCollection services) 
services.AddMvc () .AddXmlSerializerFormatters () ; 
services.Addsingleton<IBookChaptersService, BookChaptersSservice> (); 


services.AddSsSingleton<SampleChapters> (); 
} 


在 控制 器 中 ， 使 用 Produces 特性 可 以 指定 允许 的 内 容 类 型 和 可 选 的 结果 (代码 文件 Sync/APIBookServices/ 
Controllers/BookChaptersController.cs): 

[Produces ("application/json"™, "application/xml")})] 

[Route ("api/ [controller]")] 


Public class BookChaptersController: Controller 


| 
Fees 
} 


注意 : 
本 章 后 面 的 32.4.2 节 “从 服务 中 接收 XML” 将 介绍 如 何 接收 XML 格式 的 响应 。 


32.2.5 REST 结果 和 状态 码 
表 32-1 总 结 了 服务 基于 HTTP 方法 返回 的 结果 : 
表 32-1 


FE | 次 束 休 册 应 
到 ET 天 


POST 添加 资 要 添加 的 资源 资源 
PUT 更 新 资源 要 更 新 的 资源 无 


DELETE 出 除 资源 EE 


表 32-2 显示 了 重要 的 HTTP 状态 码 、Controller 方法 和 返回 状态 码 的 实例 化 对 象 。 要 返回 任何 HITP 状态 
码 ， 可 以 返回 一 个 HttpStatusCodeResult 对 象 ， 用 所 需 的 状态 码 初始 化 : 


表 32-2 


TT a 
201 已 创建 CreatedAtRoute CreatedAtRouteResult 
204 无 内 容 NoContentResult 
400 错误 请 求 BadRequestResult 


401 未 授权 Unauthorized UnauthorizedResult 
404 未 找到 NotFound NotFoundResult 


ET EE 


所 有 成 功 状态 码 都 以 2 开头 ， 错 误 状 态 码 以 4 开头 。 状 态 码 列表 在 RFC 7231 中 可 以 找到 : 
https://tools.1etf.org/html/rfc7231#section-6.3。 
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32.3 ”创建 异步 服务 


前 面 的 示例 代码 使 用 了 一 个 同步 服务 。 如 果 使 用 Entity Framework Core (EF Core) 和 存储 库 ， 可 以 使 用 同步 
或 异步 的 方法 。EF Core 文 持 两 者 。 然 而 ,许多 技术 (例如 使 用 HttpClient 类 调用 其 他 服务 ) 只 提供 了 异步 的 方法 。 
这 可 能 会 导致 一 个 异步 服务 ， 如 Async 文件 夹 中 的 项 目 BooksServiceSample 所 示 。 

在 异步 项 目 中 ，IBookChaptersService 已 经 改 为 异步 的 版 本 。 这 个 接口 定义 为 通过 服务 访问 异步 方法 ， 如 网 络 
或 数据 库 客户 端 。 所 有 的 方法 都 返回 Task (代码 文件 Async/BooksServiceSample/Services/TBookChaptersService.cs): 


Public interface IBookChaptersRepository 

{ 
Task AddAsync (BookChapter chapter}; 
Task BAddRangeAsync (IEnumerable<BookChapter> chapters); 
Task<BookChapter> RemoveAsync (Gulid 19) ; 
Task<IEnumerable<BookCchapter>> GetAllAsvync (}; 
Task<BookChapter> FindAsync (Guid 1id}); 
Task UpdateAsync (Bookchapter chapter).; 

} 


类 BookChaptersService 实现 了 异步 方法 。 读 写字 典 时 , 不 需要 异步 功能 ， 所 以 返回 的 Task 使 用 FromResult 
方法 创建 (代码 文件 Async/BooksServiceSample/Services/BookChaptersService.cs): 


Public class BookCchaptersService: IBookChaptersService 
{ 
private readonly ConcurrentDictionary<string, BookChapter> chapters = 
new ConcurrentDictionary<string, BookChapter> (); 


public Task AddAsync (BookChapter chapter) 
{ 
chapter.Id = Guid.NewGuid(); 
Chapters[lchapter.Id] = chapter; 
return Task.CcompletedTask; 
} 


public Task AddRangeAsync (IEnumerable<BookChapter> chapters) 
| foreach {var chapter in chapters) 
chapter.Id = Guid.NewGuid(); 
chapters[chapter.1Id] = chapter; 
Task.completedTask; 


} 


public Task<BookChapter> RemoveAsvync (Guid id) 
{ 
BookcCchapter removed; 
Chapters .TryRemove (1id, out removed).; 
return Task.FromResult (removed}y.:; 


} 


Public Task<IEnumerable<BookChapter>> GetAllAsync() => 
Task.FromResult<IENnumerable<BookChapter>>( chapters.Values); 


public Task<BookChapter> FindAsync (Guid id) 

{ 
Chapters .TryGetValue (lild, out BookChapter chapter); 
return Task.FromResult (chapter); 

} 


public Task UpdateAsync (BookChapter chapter) 
{ 
chapters[chapter.1Id] = chapter; 
return Task.completedTasks; 
} 
} 


API 控制 器 BookChaptersController 只 需要 一 些 变 化 ， 以 实现 为 异步 版 本 。 控 制 器 方法 也 返回 一 个 
Task。 这 样 ， 就 很 容易 调用 存储 库 的 异步 方法 (代码 文件 Async/BooksServiceAsyncSample/Controllers/ 
BookChaptersController.cs): 


[Produces ("application/json", "application/zxml")] 
[Route ("api/ [controller]")] 
Public class BookChaptersController: Controller 
{ 
private readonly IBookChaptersService bookChaptersService; 
Public BookChaptersController (IBookChaptersService bookChaptersService) 
{ 
bookChaptersService = bookChaptersService; 


} 


// GET: api/bookchapters 

[HttpGet ()] 

public Task<IEnumerable<BookChapter>> GetBookChaptersAsync() => 
_bookChaptersService.GetAllAsync (); 


/GET api/bookchapters/guid 
[HttpGet ("{id}", Name = nameof (GetBookChapterByIdAsync))] 
Public async Task<IActionResult> GetBookChapterByIdAsync (Guid 1id) 
{ 
BookChapter chapter = awalt bookChaptersSservice.FindAsync (1d); 
IE (chapter == null) 
{ 
return NotFound().; 
} 
1] se 
{ 
return new ObjectResult (chapter); 
} 
} 


// POST api/bookchapters 
[HttpPost] 
public async Task<IActionResult> PostBookChapterAsync'l! 
[FromBody]BookcCchapter chapter) 
{ 
1if (人 (chapter == null) 
{ 
return BadRequest (}; 
} 
awalt bookChaptersService.AddAsync (chapter); 
return CreatedAtRoute (nameof (GetBookChapterByIdAsync)., 
new { id = chapter.Id }, chapter); 
} 


// PUT api/bookchapters/guid 
[HttpPut ("{iqd}")] 
Public asvync Task<IActionResult> PutBookChapterAsyncl! 
Guid id, [FromBody] BookChapter chapter) 
{ 
if (人 (chapter == null || id != chapter.Id) 
{ 
return BadRequest (}); 
} 
if (await bookChaptersservice.FindAsync(1id) — null) 
{ 
return NotFound()}); 
} 
awalt bookChaptersService.UpdateAsync (chapter); 
return new NoContentResult(}). 


} 


// DELETE api/bookchapters/guid 

[HttpDelete ("{1d}")] 

Public asvync Task DeleteAsync (Guid id) => 
awalt bookChaptersService.RemoveAsync (1d).，} 


} 
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对 于 客户 回来 说 ， 控 制 器 实现 为 同步 还 是 异步 并 不 重要 ，API 调用 是 相同 的 。 客 户 亲 会 为 这 两 种 情形 创建 


相同 的 HTTP 请 求 。 


32.4 创建 .NET 客户 端 


使 用 浏览 器 调用 服务 是 处 理 测 试 的 一 种 简单 方法 。 客户 端 弟弟 使 用 JavaScript( 这 是 JSON 的 优点 ) 和 .NET 客 
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户 端 。 本 书 创建 一 个 Console APP(.NET Core) 项 目 来 调用 服务 。 
BookServiceClientApp 的 示例 代码 使 用 了 以 下 依赖 项 和 名 称 空间 : 
依赖 项 
Mlcrosoft.Extenslons.DependencyInjection 
Microsoft.Extensions.Logeging.Console 
Newtonsott.Json 
名 称 空间 
Microsott.Extensions.Logeme 
Newtonsott.Json 
System 
System.Collections.Generic 
System.Ling 
System.Net.Http 
System.Net.Http.Headers 
System.Runtime.CompllerServices 
System. [ext 
System.Threading.Tasks 
System.Xml.Ling 


32.4.1 发 送 GET 请 求 


要 发 送 HTTP 请 求 ， 应 使 用 HttpClient 类 。 在 本 章 中 ，HttpClient 类 用 来 发 送 不 同 的 HITP 请 求 。 要 使 用 
HttpClient 类 , 需要 添加 NuGet 包 System.Net.Http, 打开 名 称 空间 System.Net.Http。 要 将 JSON 数据 转换 为 .NET 
类 型 ， 应 添加 NuGet 包 Newtonsoft.Json。 


注意 : 
JSON 序列 化 和 使 用 JsonNET 的 内 容 参 见 网 上 附加 第 2 章 。 


为 了 把 需要 的 所 有 URL 放 在 一 个 地 方 ，UrlService 类 为 需要 的 URL 定义 了 属性 (代码 文件 Async/Book 
ServiceClientApp/Services/UrlService.cs): 


Public class UrlService 


{ 
public string BaseAddress => "http://localhost:1079/"; 
public string BooksApi => "api/BookChapters/"; 


} 


需要 将 UrlService 类 中 的 BaseAddress 更 改 为 服务 的 主机 和 端口 号 。 当 启动 服务 主机 时 ， 可 以 在 浏览 器 中 
看 到 端口 号 。 


在 示例 项 目 中 ， 泛 型 类 HttpClientService 创建 为 对 于 不 同 的 数据 类 型 只 有 一 种 实现 方式 。 构 造 函 数 需要 通 
过 DI 获 得 UrlService, 使 用 从 UrlService 中 检索 的 基地 址 创建 HttpClient (代码 文件 Async/BookService ClientApp/ 
Services/HttpClientService.cs): 

public abstract class HttpClientservice<T> : IDisposable 


where T: class 


{ 
private HttpClient httpClient:; 
private readonly UrlService urlServices 
private readonly ILogger<HttpClientService<T>> logger; 


public HttpClientService (UrlService urlService, 
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ILogger<HttpClientService<T>> logger) 
{ 


urlService = urlService ?23 
throw new ArgumentNullException (nameof (urlService))}); 
logger = logger ?2 throw new ArgumentNullException (nameof (logger)); 


httpClient = new HttpClient (}); 
httpCclient.BaseAddress = new Uri{ urlSservice.BaseAddress); 
} 
FE 
} 


注意 : 
在 示例 代码 中 ，ILogger 接口 用 于 向 控制 台 写 入 日 志 信 息 。 第 29 章 详细 讨论 了 日 志 记 录 。 


方法 GetIntermalAsync 发 出 一 个 GET 请 求 来 接收 一 组 项 。 该 方法 调用 HttpClient 的 GetAsync 方法 来 发 送 
GET 请 求 。HttpResponseMessage 包含 收 到 的 信息 。 响 应 的 状态 码 写 入 控制 台 来 显示 结果 。 如 果 服 务 器 返回 一 
个 错误 ， 则 GetAsync 方法 不 抛 出 异常 。 异 党 在 方法 EnsureSuccessStatusCode 中 抛 出 ， 该 方法 在 返回 的 
HttpResponseMessage 实例 上 调用 。 如 果 HTTP 状 态 码 是 错误 类 型 ,该 方法 就 抛 出 一 个 异常 。 啊 应 体 包 含 返回 的 JSON 
数据 。 这 个 JSON 信息 读 取 为 字符 串 并 返回 (代码 文件 Async/BookServiceClientApp/Services/HttpClientService.cs): 


private async Task<string> GetIinternalAsync (string requestUri) 
{ 


if (requestUri == null) throw new ArgumentNullException (nameof (requestUri)); 
if ( objectDisposed) throw new ObjectDisposedException(nameof!{ httpClient)}; 


HttpResponseMessage resp = await httpClient.GetAsync (requestUri).; 
LogInformation($"status from GET {resp.StatusCode}"™); 
resp-.EnsureSuccessSstatusCode (}); 

return await resp.Content.ReadAsstringAsync (); 


} 


private void LogInformation (string message., 
[CcallerMemberName] string callerName = null) =»> 
logger.LogInformation (人 
s"{nameof (HttpCclientSsService<T>)}.{callerName}: {message}"™); 


服务 器 控制 器 用 GET 请 求 定义 了 两 个 方法 : 一 个 方法 返回 所 有 章 ， 另 一 个 方法 只 返回 一 个 章 ， 但 是 需要 章 
的 标识 符 与 URI。 方 法 GetAllAsync 调用 GetInternalAsync 方法 ， 把 返回 的 JSON 信息 转换 为 一 个 集合 ， 而 方法 
GetAsync 将 结果 转换 成 单个 项 ,这 些 方 法 声明 为 虚拟 的 , 允许 在 派生 类 中 重 写 它们 (代码 文件 Async/BookService- 
ClientApp/Services/HttpClientService.cs): 


public async virtual Task<T> GetAsync (string requestUri) 
{ 


if (requestUri == null) throw new ArgumentNullException (nameof (requestUri)).; 


string JjJson = await GetIinternalAsync (requestUri); 
return JsonConvert.DeserializeObject<T> (json); 


} 


Public async virtual Task<IEnumerable<T>> GetAllAsync (string requestUri) 
{ 


if (requestUri == null) throw new ArgumentNullException (nameof (requestUri)); 


string JjJson = await GetInternalAsync (requestUri); 
return JsonConvert.DeserializeObject<IEnumerable<T>> (json); 


} 

在 客户 端 代码 中 不 使 用 泛 型 类 HttpClientService， 而 用 BookChapterClientService 类 进行 专门 的 处 理 。 这 个 
类 派生 于 HttpClientService， 为 泛 型 参数 传递 BookChapter。 这 个 类 还 重 写 了 基 类 中 的 GetAllAsync 方法 ， 按 章 
号 给 返回 的 章 排 序 (代码 文件 Async/BookServiceClientApp/Services/BookChapterClientService.cs): 


public class BookChapterClientservice : HttpClientService<BookChapter> 
{ 
Public BookChapterCclientService (UrlService urlSservice, 
ILOoOgger<BookChaptercCclientService> logger) 
: base (urlsService, logger) { } 


Public override async Task<IEnumerable<BookChapter>> GetAllAsyncl! 
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string requestUri) 
{ 
IENnumerable<BookChapter> chapters = await base.GetAllAsync (requestUri); 
return chapters.0rderBy l(c => c.Number):; 
} 
} 


BookChapter 类 包含 的 属性 是 用 JSON 内 容 得 到 的 (代码 文件 Async/BookServiceClientApp/Models/BookChapter.cs): 


public class BookChapter 

{ 
public Guid Id { get; set; } 
public int Number { get; set; } 
public string Title { get; set; } 
Public int Pages { get; set; } 

} 


客户 端 应 用 程序 的 Main0 方 法 调用 不 同 的 方法 来 显示 GET、POST、PUT 和 DELETE 请 求 ， 这 些 请 求 使 用 
了 SampleRequest 类 中 的 方法 。 在 此 之 前 ， 通 过 调用 ConfieureServices 方法 ， 注 册 用 于 DI 的 服务 (代码 文件 
Async/BookServiceClientApp/Proeram.cs): 


static async Task Main{() 
{ 
Console.WriteLine ("Client app, wait for service"™); 
Console.ReadLine (); 
ConfigureServices (1) ; 
Var test = ApplicationServices.GetRequiredService<SampleRequest»> (); 


await test.ReadChaptersAsync () ; 

已 Walt test.ReadChapterAsync(); 

awalit test.ReadNotExistingChapterAsync(); 
await test.ReadxXmlAsync (); 

await test.AddCchapterAsync (); 

awalit test.UpdateCchapterAsync (); 

awalit test.RemoveChapterAsync(); 
Console.ReadLine () ; 


} 
ConfigureServices0) 方 法 在 Microsoft.Extensions.DependencyInjection 容器 中 注册 所 需 的 服务 ， 并 配置 日 志 记 
录 ， 写 入 控制 台 (代码 文件 Async/BookServiceClientApp/Program.cs): 


Public static void ConfigureServices!{() 

{ 
Var SeEIVices = new ServiceCollection().; 
Services.Addsingleton<UrlService>().; 
Services.AddSsingleton<BookChapterCclientService> () ， 
Services.AddTransient<SampleRequest> (); 
Services.AddLogging (logger => 
| 

logger.BAddConsole (}; 

}); 


ApplicationServices = services.BuildSsServiceProvider (); 


} 

Public static IServiceProvider ApplicationServices { get; private set; } 

类 SampleRequest 实现 了 所 有 的 示例 方法 来 调用 BookChapterClientService 的 方法 。 在 构造 函数 中 ， 注 入 
UrlService 和 BookChapterClientService (代码 文件 Async/BookServiceClientApp/SampleRequest.cs): 


Public class SampleRequest 
{ 
private readonly UrlSsService urlSservices 
private readonly BookChapterCclientSservice client; 
public SampleRequest (UrlService urlService, 
BookCchapterClientService client) 
{ 
UrlService = urlSsService 33 
throw new ArgumentNullException (nameof (urlSservice))}); 
client = client 22 throw new ArgumentNullException (nameof (CLIILent) ) 7 
} 
f 
} 


ReadChaptersAsync0 方 法 从 BookChapterClient 中 调用 GetAllLAsync0 方 法 来 检索 所 有 章 , 并 在 控制 台 显示 章 
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的 标题 (代码 文件 Async/BookServiceClientApp/SampleRequest.cs): 


Public async Task ReadCchaptersAsyncl() 
{ 
Console.WriteLine (nameof (ReadChaptersAsync)); 
IEnumerable<BookChapter> chapters = 
awalt client.GetAllAsync( urlservice.BooksAp1); 
foreach (BookChapter chapter In chapters) 
{ 
Console.WriteLine (chapter.Title); 
} 
Console.WriteLine().; 


} 
运行 应 用 程序 (启动 服务 和 客户 端 应 用 程序 )，ReadChaptersAsync0 方 法 显示 了 OK 状态 码 和 章 的 标题 : 


ReadChaptersAsync 

info: BookServiceClientApp.Services.BookChapterCclientService[0] 
HttpClientService.GetInternalAsync: status from GET OK 

-NET Application Architectures 

Core Ct 

Objects and Types 

Object-Ooriented Programming with Ct# 

Generics 

Operators and Casts 

BIIAaAYS 

Delegates, Lambdas, and Events 


ReadChapterAsync0 方 法 显示 了 GET 请 求 来 检索 单 章 。 这 样 ， 这 一 章 的 标识 符 就 添加 到 URI 字符 串 中 (代码 
文件 Async/BookServiceClientApp/SampleRequest.cs): 


public async Task ReadChapterAsync() 

{ 
Console.WriteLine (nameof (ReadChapterAsync) ); 
var chapters = await client.GetAllAsync( urlService.BooksAp1); 
Guid id = chapters.First() .1Id; 
BookChapter chapter = await client .GetAsvync (Addresses.Bookshpi + id).; 
Console .WriteLine (s$" {chapter .Number} {chapter.Title}™"); 
Console.WriteLine (); 


} 
ReadChapterAsync0 方 法 的 结果 如 下 所 示 。 它 显示 了 两 次 OK 状态 ， 因 为 第 一 次 是 这 个 方法 检索 所 有 的 章 ， 
之 后 发 送 对 一 重 的 请 求 : 


ReadChapterAsync 

info: BookServiceClientApp.Services.BookChapterCclientService[0] 
HttpClientService.GetInternalAsync: status from GET OK 

Info 0 .NET Application Architectures 

: BookServyiceClientApp.Services.BookChapterCclientService[0] 
HttpClientService.GetInternalAsync: status from GET OK 


如 果 用 不 存在 的 章 标 识 符 发 送 GET 请 求 , 该 怎么 办 ? 具体 的 处 理 如 ReadNotExistineChapterAsync0 方 法 所 示 。 
调用 GetAsync0 方 法 类 似 于 前 面 的 代码 段 , 但 会 把 不 存在 的 标识 和 从 添加 到 URI, 在 HttpClientHelper 类 的 实现 中 ， 
HttpClient 类 的 GetAsync0 方 法 不 会 抛 出 异常 。 然 而 ，EnsureSuccessStatusCode 会 抛 出 异常 。 这 个 异常 用 
HttpRequestException 类 型 的 catch 块 捕获 。 在 这 里 ， 使 用 了 一 个 只 处 理 异常 码 404( 未 找到 ) 的 异常 过 滤器 ( 代 
码 文 件 Async/BookServiceClientApp/SampleRequest.cs): 


private async Task ReadNotExistingCchapterAsvync() 
{ 
Console.WriteLine (nameof (ReadNotExistingChapterAsync) ); 
string requestedIdentifier = Guid.NewGulid() .ToString(); 
try 
{ 
BookChapter chapter = awalt client.GetAsync!( 
Addresses.BooksApi + requestedIidentifier.ToSsString()); 
Console.WriteLine(s$" {chapter.Number} {chapter.Title}"); 
} 
catch (HttpRequestException ex) When (ex.Message.Contains ("404")) 
{ 
Console.WriteLine($"book chapter with the identifier ™ + 
s"{requestedIdentifier} not found™"); 
} 


Console.WriteLine (); 
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处 理 异常 和 使 用 异常 过 滤器 的 内 容 参 见 第 14 章 。 


方法 的 结果 显示 了 从 服务 返回 的 NotFound 结果 : 


ReadNotExistingChapterAsync 

info: BookServiceClientApp.Services.BookChapterCclientServicel[0] 
HttpClientService.GetInternalAsync: status from GET NotFound 

book chapter with the identifier a0fé629f4-8c46-4d66-8543-74592dba5d5b not found 


32.4.2 ”从 服务 中 接收 XML 


在 32.2.4 节 “ 修 改 啊 应 格式 ?中 , XML 格式 被 添加 到 服务 中 。 将 服务 设置 为 返回 XML 和 JSON, 添加 Accept 
标题 值 来 接受 application/xml 内 容 ， 就 可 以 显 式 地 请 求 XML 内 容 。 

具体 操作 如 下 面 的 代码 段 所 示 。 其 中 ， 指 定 application/xml 的 MediaTypeWithQualityHeaderValue 被 添加 到 
Accept 标题 集合 中 。 然 后 ， 结 果 使 用 XElement 类 解析 为 XML( 代 码 文件 BookServiceClientApp/Services/ 
HttpClientService.cs): 


public async Task<XElement> GetAllXxXmlAsync (string requestUuUri) 
{ 


if (requestUri is null}) throw new ArgumentNullException (nameof (requestUri})); 


USing (Var client = new HttpClient ()) 

{ 
Client.BaseAddress = baseAddress; 
client.DefaultRequestHeaders.AMccept.Addil 

new MediaTypeWithQualityHeaderValue ("application/xml1")); 

HttpResponseMessage resp = await client.GetAsvync (requestUri).; 
Console.WriteLine($"status from GET {resp.StatusCode}"); 
resp.EnNSUreSuccessSstatuscode (}; 
string Xml = awalt resp.Content.ReadAsStringAsync (); 
XElement chapters = XElement.Parse (xml); 
return chapterss; 


注意 ; 
XElement 类 和 XML 序列 化 参见 网 上 附加 第 2 章 。 


在 SampleRequest 类 中 , 调用 GetAllIXmlAsync0 方 法 直接 把 XML 结果 写 到 控制 合 (代码 文件 Async/BookService- 
ClientApp/SampleRequest.cs): 


private static async Task ReadxmlAsvync() 
{ 
Console .WriteLine (nameof (ReadXxXmlAsync) ); 
XElement chapters = awalt client.GetAllXmlAsync( urlService.BooksApi); 
Console .WriteLine (chapters).,; 
Console .WriteLine (); 


} 
运行 这 个 方法 ， 可 以 看 到 现在 服务 返回 了 XML 


ReadxmlAsync 
info: BooksServiceClientApp.Services.BookChapterCclientservice[0] 
HttpClientService.GetAllxmlAsync: status from GET OK 
<ArrayOfBookChapter xmlns:xsi="http://www.w3.0rg/2001/xXMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/xMLSchema"> 
<BookCchapter> 
<Id>015b0fb6-l1a0f-44ac-ba0d-3d6d743bf4df</Id> 
<Number>2</Number> 
<Title>Objects and Types</Title> 
<Pages>33</Pages> 
</BookChapter> 
<BookChapter> 
<Id>33ccl22a-6be2-48b6-83bl-e913fcl0da77</Id> 
<Number>0</Number> 
<Title>.NET Application Architectures</Title> 
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<Pages>35</Pages> 

</BookCchapter> 

<BookChapter> 
<Id>47bcfale-085e-4d11-9a63-ed2421cad912</Id> 
<Number>6</Number> 
<Title>Arrays</Title> 
<Pages>20</Pages> 

</BookChapter> 

<I—... more chapters ...—» 

</ArrayofBookCchapter> 


32.4.3 发送 POST 请 求 


下 面 使 用 HTTP POST 请 求 向 服务 发 送 新 对 象 。HTTP POST 请 求 的 工作 方式 与 GET 请 求 类 似 。 这 个 请 求 
会 创建 一 个 新 的 服务 器 端 对 象 。HttpClient 类 的 PostAsync 方法 需要 用 第 二 个 参数 添加 的 对 象 。 使 用 Json.NET 
的 JsonConvert 类 把 对 象 序列 化 为 JSON。 成 功 返 回 后 ，Headers.Location 属性 包含 一 个 链接 ， 其 中 ， 对 象 可 以 再 
次 从 服务 中 检索 。 啊 应 还 包含 一 个 带 有 返回 对 象 的 啊 应 体 。 在 服务 中 修改 对 象 时 ，Id 属性 在 创建 对 象 时 在 服务 
代码 中 填充 。 反 序列 化 JSON 代码 后 , 这 个 新 信息 由 PostAsync 方法 返回 (代码 文件 Async/BookServiceClientApp/ 
Services/HttpClientService.cs): 


Public async Task<T> PostAsync (string requestUri, T item) 

{ 
1if (requestUri is null) throw new ArgumentNullException (nameof (requestUri)); 
if (item 1is null}) throw new ArgumentNullException (nameof (item)); 
if ( objectDisposed) throw new ObjectDisposedException(nameof{ httpClLIent) ) : 


string json = JsonConvert.SerlializeOQbject (item).; 

HttpContent content = new StringContent (json, Encoding .UTFS8, 
"application/json™); 

HttpResponseMessage resp = await httpClient.PostAsync(requestUri, content); 

LogInformation(s$"status from POST {resp.StatusCode}"); 

resp.EnsureSuccessSstatusCode (}; 

LogIinformation($"added resource at {resp.Headers.Location}"™); 

json = awalt resp.Content.ReadAsStringAsync(); 

return JsonConvert.DeserializeObject<T> (json); 


} 

在 SampleRequest 类 中 ， 可 以 看 到 添加 到 服务 的 章 。 调 用 BookChapterClient 的 PostAsync0 方 法 后 ， 返 回 的 
Chapter 包含 新 的 标识 符 ( 代 码 文 件 Async/BookServiceClientApp/SampleRequest.cs): 

private static async Task AddChapterAsync() 


{ 
Console.WriteLine (nameof (AddChapterAsync)); 


var client = new BookChapterClient (Addresses.BaseAddress); 
BookcCchapter chapter = new BookcChapter 
{ 


Number = 34, 

Title = "ASP.NET Core Web API"., 

Pages = 35 
bs 
chapter = await client.PostAsvync (Addresses .BooksApi, chapter).; 
Console.WriteLine ($s$"added chapter {chapter.Title} with id {chapter.Id}"™); 
Console .WriteLine().; 


} 


AddChapterAsync0 方 法 的 结果 显示 了 创建 对 象 的 一 次 成 功 运行 : 


LddcCchapterAsync 
info added chapter ASP.NET Web API with id b490c5c3-ff30-A4ad4-8ca4-7436edfb04c0 


: BookServiceClientApp.Services.BookCchapterClientSsService[0] 
HttpClientService.PostAsync: status from POST Created 
info: BookServiceClientApp.Services.BookChapterclientService[0] 
HttpClientService.PostAsync: added resource at 
http://localhost:1079/api/BookChapters/bA490c5c3-ff30-4ad4-8ca4-7436edfb04c0 


32.4.4 发送 PUT 请求 
HTTP PUT 请 求 用 于 更 新 记录 ， 使 用 HttpClient 方法 PutAsync0 来 发 送 。PutAsync0 需 要 第 二 个 参数 中 的 更 新 
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内 容 和 第 一 个 参数 中 服务 的 URL， 其 中 包括 标识 符 ( 代 码 文 件 Async/BookServiceClientApp/HttpClientService.cs): 


public async Task PuUtRASYPnCIStIInG requestUri, T item) 

{ 
if (requestUri is null}) throw new ArgumentNullException (nameof (requestUri})); 
if (item is null) throw new ArgumentNullException (nameof (item)).; 
if ( objectDisposed) throw new ObjectDisposedException(nameof( httpclient)); 


string json = JsonConvert.SerializeObject (item); 

HttpContent content = new StringContent (json, Encoding .UTFS, 
"application/json").; 

HttpResponseMessage resp = await httpClient.PutAsync (requestUri, content).; 

LogInformation{($"status from PUT {resp.SsStatusCode}™); 

resp.EnsureSuccessSstatusCode () ; 


} 
在 SampleRequest 类 中 ， 章 .NET Application Architectures 更 新 为 男 一 个 标题 NET Applications and Tools ( 代 
码 文 件 Async/BookServiceClientApp/SampleRequest.cs): 


Public async Task UpdateCchapterAsync{) 
{ 
Console .WriteLine (nameof (UpdateChapterAsync)); 
var chapters = await client.GetAllAsync( urlService.BooksAp1i}; 
Var chapter = chapters.SingleOrDefault ( 
Cc => CcC.Title == "NET Application Architectures™}).; 
if (chapter != null) 
{ 
chapter.Title = ".NET Applications and Tools™; 
await client.PutAsync( urlService.BooksApi + chapter.Id, chapter); 
Console.WriteLine($"updated chapter {chapter.Title}"™); 
} 
Console .WriteLine(),; 


} 
UpdateChapterAsync0 方 法 的 控制 台 输 出 显示 了 HTTP NoContent 结果 和 更 新 的 章 标题 : 


UpdateCchapterAsync 

info: BookServiceClientApp.Services.BookChapterCclientServicel[0] 
HttpClientService.GetIinternalAsync: status from GET OK 

info: BookServiceClientApp.Services.BookChapterCclientsSservice[0] 
HttpClientService.PutAsync: status from PUT NoContent 

updated chapter .NET Applications and Tools 


32.4.5 ”发送 DELETE 请 求 


示例 客户 端的 最 后 一 个 请 求 是 HITPDELETE 请 求 。 调用 HttpClient 类 的 GetAsync、 PostAsync 和 PutAsync 
后 ， 显 然 发 送 DELETE 请 求 的 方法 是 DeleteAsync。 在 下 面 的 代码 段 中 ，DeleteAsync0 方 法 只 需要 一 个 URI 参 
数 来 识别 要 删除 的 对 象 (代码 文件 Async/BookServiceClientApp/Services/HttpClientService.cs): 


Public async Task DeleteAsync (string requestUri) 

{ 
if (requestUri is null}) throw new ArgumentNullException (nameof (requestUri})); 
if ( objectDisposed) throw new ObjectDisposedException (nameof( httpclient))}); 


HttpResponseMessage resp = await httpClient.DeleteAsync (requestUri); 
LogInformation($"status from DELETE {resp.StatusCode}™),;} 
resp.EnsureSuccessSstatuscCcode (}，; 


} 
SampleRequest 类 定义 了 RemoveChapterAsync0 方 法 (代码 文件 Async/BookServiceClientApp/SampleRequest.cs): 


Public async Task RemoveChapterAsynctl() 
{ 
Console .WriteLine (nameof (RemoveChapterAsync)).，} 
Var chapters = await client.GetAllAsync{ urlService.BooksAp1); 
Var Chapter = chapters.SingleOrDefault( 
Cc => CcC.Title == "Windows Communication Foundation™).; 
if (chapter != null) 
{ 
await client.DeleteAsync( urlService.BooksApi + chapter.Id}; 
Console.WriteLine($"removed chapter {chapter.Title}"™); 
} 


Console .WriteLine():; 
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运行 应 用 程序 时 ，RemoveChapterAsync0 方 法 首先 显示 了 HTITP GET 方法 的 状态 ,因为 是 先 发 出 GET 请 求 
来 检索 所 有 的 章 ， 然 后 发 出 成 功 的 DELETE 请 求 来 删除 Windows Communication Foundation 章节 : 


RemoveChapterAsync 

info: BookServiceClientApp.Services.BookChapterCclientService[0] 
HttpClientService.GetInternalAsync: status from GET OK 

info: BooksServiceClientApp.Services.BookChapterclientSservice[0] 
HttpClientService.DeleteAsync: status from DELETE OK 

removed chapter Windows Communication Foundatlion 


32.5 ” 写 入 数据 库 


第 26 章 介 绍 了 如 何 使 用 Entity Framework Core (EF Core) 将 对 象 映射 到 关系 上 。Web API 控制 器 可 以 很 容易 
地 使 用 DbContext。 在 示例 应 用 程序 中 , 不 需要 改变 控制 器 ， 只 需要 创建 并 注册 男 一 个 存储 库 ， 以 使 用 EF Core。 
本 节 摘 述 所 需 的 所 有 步骤 


32.5.1 使 用 EF Core 


下 面 开 始 访问 数据 库 。 为 了 使 用 EF Core 与 SQL Server, 需要 把 NuGet 包 Microsoft.EntityFrameworkCore. 
SqlServer 添加 到 包含 服务 的 库 项 目 中 。 

前 面 已 经 定义 了 BookChapter 类 。 这 个 类 保持 不 变 ， 用 于 填充 数据 库 中 的 实例 。 映 射 属性 在 BooksContext 
类 中 定义 。 在 这 个 类 中 ， 重 写 OnModelCreating 方法 ， 把 BookChapter 类 型 映射 到 Chapters 表 ， 使 用 数据 库 中 
创建 的 默认 唯一 标识 符 定义 I4d 列 的 唯一 标识 人 符 。Title 列 限制 为 最 多 120 个 字符 (代码 文件 Async/BookServiceSample/ 
Models/BooksContext.cs): 


Public class BooksContext: DbContext 
{ 
public BooksContext (DhbContextOptions<BooksContext> options) 
: base (options)} { } 


Public DbhSet<BookChapter> Chapters 1{ get; set; } 


protected override void OnModelCreating (ModelBuilder modelBuilder) 
{ 
modelBuilder.Entity<BookChapter> () 
.ToTable ("Chapters") 
-HasKey IC 一 > cc.Id); 
modelBuilder.Entity<BookChapter> 1() 
.Propertylc => c.Id) 
-HasColumnType ("Uniqueldentifier"™") 
-HasDefaultValueSgql ("newid (}"); 
modelBuilder.Entity<BookCchapter>() 
.Propertyl(c => c.Title) 
-HasMaxLength (120); 
} 

} 

对 于 依赖 注入 容器 ， 需 要 添加 EF Core 和 SQL Server 来 调用 扩展 方法 AddEntityFramework 和 
AddSqlServer。 刚 才 创 建 的 BooksContext 也 需要 注册 。 使 用 方法 AddDbContext 添加 BooksContext。 在 该 方法 的 
选项 中 ， 传 递 连接 字符 串 ( 代 码 文件 Async/BookServiceSampleHost/Startup.cs): 

Public async void ConfigureServices (IServiceCollection services) 

{ 

services.AddMvc () .AddxmlSerializerFormatters({).; 
7 
SEIrvices.AddDbContext<BooksContext> (optons 一 > 
options.UseSqlServertl 
Configuration.GetConnectionstring ("BooksConnection™m)))}); 


下 
} 


连接 字符 串 本 身 用 托管 应 用 程序 项 目 中 的 应 用 程序 设置 定义 (配置 文件 Async/BookServiceSampleHost/ 
appsettings.Json): 


"Connectionstrings": 1{ 
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"BooksConnection": "server=(localdb) \\mssqllocaldb;database=APIBooOksSample; 


trusted connection=true;MultipleActiveResultsets=true™ 


在 示例 应 用 程序 中 , 数据 库 将 由 C# 代 码 目 动 创建 。 这 是 通过 Startup 类 的 Configure 方法 注入 BooksContext， 
并 调用 Database 属性 的 EnsureCreated0 方 法 来 完成 的 。 如 果 数 据 库 不 存在 ， 则 EnsureCreated(0) 方 法 创建 它 。 如 
果 创 建 了 数据 库 ， 那 么 将 调用 CreateSampleChaptersAsync0 方 法 ， 回 数据 库 提 供 示例 章节 。SampleChapters 是 以 
前 内 存 中 章节 列表 使 用 的 相同 服务 (代码 文件 Async/BooksServiceSampleHost/Startup.cs): 


Public async void Configure (IApplicationBuilder app, 
SampleChapters sampleChapters, BooksContext booksContext) 
{ 


} 


IE (env.IsDevelopment(})) 
{ 
app.UseDeveloperExceptionPage () ; 


} 


apP-USeMwc (}; 
1 -- 


bool created = booksContext .Database.EnsureCreated().; 
if (created) 
{ 
await sampleChapters.CreateSampleChaptershsvync(); 
} 


注意 : 
EF Core 还 允许 使 用 Migration 创建 数据 库 。 如 何在 应 用 程序 中 实现 Migration 的 信息 ， 请 参阅 第 26 章 。 


32.52 创建 数据 访问 服务 


为 了 使 用 BooksContext ， 


IHostingEnvironment enyv, 


需要 创建 一 个 实现 接口 IBookChaptersService 的 服务 。 类 


DBBookChaptersService 利用 BooksContext， 而 不 是 像 BookChaptersService 那样 使 用 内 存 中 的 字典 (代码 文件 
Async/BookServiceSample/Models/DBBookChaptersService.cs): 


Public class DBBookChaptersService, IBookChaptersService 


{ 


Private readonly BooksContext booksContext; 
Public BookChaptersRepository (BooksContext booksContext) 
| 

booksContext = booksContext; 


} 


Public async Task AddAsync (BookChapter chapter) 
{ 
await booksContext.Chapters.AddAsync (chapter).; 
awalit booksContext .SaveChangesAsync (): 
} 


public Task<BookChapter> FindAsync (Guid 19) => 


booksContext .Chapters.FindAsyncDefaultAsync{(c => c.Id == 


19d); 


public async Task<IEnumerable<BookChapter>> GetAllAsync() 三 > 


await booksContext.Chapters.ToListAsync(); 


public async Task<BookChapter> RemoveAsync (Guid id) 
{ 
BookChapter chapter = awalt booksContext.Chapters 
-SingleorDefaultAsync{(c => c.Id == id); 
if (chapter == null}) return null; 


_booksContext .Chapters .Remove (chapter)， 
awalt booksContext .SaveChangesAsync tt) 7 
return chapter; 


} 


public async Task UpdateAsync (BookChapter chapter) 
{ 
_booksContext .Chapters .Update (chapter)， 
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引 Walt booksContext .SaveChangesAsync () : 
} 
} 


如 果 考 虑 是 否 要 使 用 上 下 文 ， 可 以 阅读 第 26 章 ， 它 涵盖 了 Entity Framework Core 的 更 多 信息 。 

要 使 用 这 个 服务 ， 必 须 在 容器 的 注册 表 中 删除 BookChaptersService( 或 将 其 注释 掉 )， 并 添加 
DBBookChaptersService， 使 依赖 注入 容器 在 要 求 提 供 接口 IJBookChaptersService 时 创建 这 个 类 的 一 个 实例 (代码 
文件 Async/BookServiceSampleHost/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 

{ 
services.BddMyc() .AddXmlSerializerFormatters{); 
/:/: services.Addscoped<IBookChaptersSservice, BookChaptersService> (); 
Services.AddScoped<IBookChaptersService, DBEBookChaptersService>().:; 
Services.AddSsScoped<SampleChapters> (); 


Services.AddDbContext<BooksContext> (options 三 > 
options.UseSqlSservertl 
Configuration.GetConnectionstring ("BooksConnection™))})); 
es 
} 


现在 ， 不 改变 控制 器 或 客户 端 ， 就 可 以 再 次 运行 服务 和 客户 端 。 根 据 最 初 在 数据 库 中 输入 的 数据 ， 可 以 看 
到 GET/POST/PUT/DELETE 请 求 的 结果 。 


32.6 用 OpenAPI 或 Swagger 创建 元 数据 


为 服务 创建 元 数据 允许 获得 服务 的 摘 述 , 并 人 允许 使 用 这 种 元 数据 创建 客户 端 。 通 过 使 用 SOAP 的 Web 服务 ， 
元 数据 和 Web 服务 描述 语言 (Web Service Description Language, WSDI) 自 SOAP 的 早期 就 已 经 存在 .如 今 ,REST 
服务 的 元 数据 也 在 这 里 。 目 前 它 不 像 WSDL 那样 是 一 个 标准 ， 但 描述 API 的 最 流行 的 框架 是 
Swagger(http:/Awww.swaggerio)。 自 2016 年 1 月 起 ，Swagger 规范 已 经 更 名 为 OpenAPI， 编 写本 书 时 ， 该 标准 已 
经 可 用 于 3.0 版 本 (http://www.openapis.org)。 这 个 规范 可 以 在 https://github.conyYOALOpenAPI-Specification/blob/ 
OpenAPInext/versions/3.0.0.md 上 用 作 GitHub 存储 库 。 

要 给 ASPNET Web API 服务 添加 Swagger 或 OpenAPI， 可 以 使 用 Swashbuckle。NuGet 包 Swashbuckle. 
AspNetCore 是 用 于 ASPNET Core 的 库 。 

在 添加 NuGet 包 之 后 ,需要 把 Swagger 添加 到 DI 容器 中 .AddSwaggerGen 是 一 个 扩展 方法 ,可 以 把 Swagger 
服务 添加 到 集合 中 。 为 了 配置 Swagger， 调 用 方法 SwaggerDoc。 传 递 mfo 对 象 ， 可 以 定义 标题 、 描 述 、 联 系 人 
信息 等 (代码 文件 Async/BooksServiceSampleHost/Startup.cs): 


Public void ConfijgureServices (IServiceCollection services) 

{ 
SEILvices.BAddMyci(}) .AddXmlSerializerFormatters({); 
/:/: services.Addscoped<IBookChaptersService, BookChaptersService> (); 
Services.Addscoped<IBookChaptersService, DBBookChaptersServicey> {(); 
Services.AddScoped<SampleChaptersy> (); 


SEIrvices.AddDbContext<BooksContext> (options => 
options.UseSqlServert 
Configuration.GetConnectionstring ("BooksConnection™.))})); 


Services.LAddSwaggerGen (options => 
{ 
options.SwaggerDoc ("v2", new Info 
{ 
Title = "Books Service API"™, 
Version = "v2", 
Description = "Sample service for Professional C# 7", 
Contact = new Contact 1{ Mame = "Christian Magel™", 
Url = "https://csharp.christiannagel.com" }, 
License = new License { Name = "MIT License" } 
}); 
}); 
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剩 下 的 就 是 在 Startup 类 的 Configure 方法 中 配置 Swagger。 扩 展 方法 UseSwagger 添加 Swagger 中 间 件 ， 指 
定 应 该 生成 一 个 JSON 模式 文件 。 

可 以 用 UseSwagger 配置 的 默认 URL 是 /swagger{fversiony/swaggerjson。 对 于 前 面 代 码 段 中 配置 的 文档 ， 
URL 是 /swaggervl/swaggerjson。 方 法 UseSwaggerUi 局 用 了 了 Swagger 图 形 用 户 界 面 ， 定 义 了 URL( 代 码 文 件 
Async/BooksServiceSampleHost/Startup.cs): 


Public async void Configure (IApplicationBuilder app, IHostingEnvironment enyv, 


{ 


} 


SamplecCchapters sampleCchapters, BooksContext bookscCcontext) 


if (env.IsDevelopment(})) 
{ 
app.UseDeveloperExceptionPage (}); 


} 


app-.UseMvec (}); 
app .UseSwagger (); 
app .UseSwaggerUl (options => 
options.SwaggerEndpoint("/swagger/v2/swagger .json", 
"Book Chapter Services"))}); 
ER 


配置 Swagger 后 运行 应 用 程序 , 可 以 看 到 服务 提供 的 API 信息。 图 32-2 显示 了 BooksServiceSample 提供 的 
API、Values 服务 生成 的 模板 和 BooksService 示例 ， 还 可 以 看 到 用 Swagger 文档 配置 的 标题 和 描述 。 


为 二 | 回 Swagger UI 


-一 一 二 ( 人 lecalhedt 


| dg yg er hittp:iocalhost 107%swaggeriv2/swagger. Eonk Chapter Servicees 


Books Service API 

Sample service for Professional C# 7 

Created by Christian Nagel 

See more at https//csharp.christiannagel.com 
MIT License 


BookChapters 

sam /apiBookChapters 
IapiBoeokGhapters 

maiad /apiBookChapters/d} 

lapiBookChapters/{id} 

JapiBookChapters/fid} 

Values 

GET /aplvValues 
Japiivalues 

DELETE api values/idy 

lapiValues/{id} 

su /apl/values/d} 


| VER 


32-2 


图 32-3 显示 了 BookChapters 服务 的 GET 请 求 细 节 ， 以 及 测试 API 调用 的 UI。 可 以 看 到 每 个 API 的 细节 ， 
包括 模型 。 
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嘻 本 | 回 swagger ul 


二 一 人 TD localhost t I | 码 让 四 
BookChapters ShowiHide List Operations 


/apiBookChapters 


Response Class (Status 200) 
SUCCESS 


Expand Operatiors 


Example Value 


"Ld"™: “strine”™, 
"number™s @, 
"title™: "string™, 


EE 愉 


Response Content Type |applicationjison E 


Hide Response 


| Try it outl 


Curl 

url -X GET --header ‘hccept: application/ son http://localhost: L1079/api/BookChapters" 
Request URL 

httpi/ /localhost: lor79/api/Bookchapters 


Response Body 
[] 


Response Code 


十 BBS 


Response Headers 


"transfer-enceoding”: “chunked”; 
“content-type": "application/ json; charset=utf-8", 
"server": "Kestrel”, | 
"x=s0urcefiles": "=}UTF-8?8QzpccHIvY3NovX Jwc29icmNlcixhcGlcUHlvinVc2lvbmF sdiMov TwNixBUE lAxXNSbmNc Om va3NTIXI2aNlIU2FitcGxlXEl 
"X-Powered=-by": "ASP.MET”, 
"date™: "Sat, 82 Dec 2817 19:16:81 MT” 


图 32-3 


Swageger 人 允许 使 用 .NET 特性 轻松 地 定制 输出 。 回 模型 类 型 添加 注释 (如 Required 和 DefaultValue) 使 其 成 为 
JSON 元 数据 定义 ， 并 显示 在 帮助 页 面 中 (代码 文件 Async/BooksServiceSample/Models/BookChapter.cs): 


Public class BookChapter 


{ 
Public Guid Id { get; set; } 
[Recquired] 
Public int Number { get; set; } 
[Recquired] 


[MaxLength (40)1 
Public string Title { get; set; } 
[DefaultValue (0)] 
PUublic int Pages { get; set; } 
} 


通过 控制 器 的 操作 方法 ， 可 以 为 啊 应 类 型 指定 不 同 的 选项 ， 用 ProducesResponseType 特性 在 特定 的 情况 下 
返回 模型 信息 (代码 文件 Async/BooksServiceSample/Controllers/BookChaptersController cs): 


[HttpPost] 

[ProducesResponseType (typeof (BookChapter) , 201)] 

[ProducesResponseType (400)] 

public async Task<IActionResult> PostBookChapterAsync!l 
[FromBody]BookcCchapter chapter) 


FF EE 
} 


还 可 以 


f XML 注释 写 入 控制 器 的 操作 方法 中 ， 这 将 显示 在 帮助 页 面 中 。 值 得 特别 关注 的 是 Swagger 使 用 
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啊 应 元 素 提 供 关 于 方法 可 能 结果 的 更 多 信息 (代码 文件 Async/BooksServiceSample/Controllers/BookChapters- 


Controller.cs): 
/i// <summary> 
/i// Creates a BookChapter 
/i// </summary> 
:i// <remarksy> 
/// Sample request.: 
ii POST api/bookchapters 
AAA/ { 
/i Number: 42, 
:ii Title: "Sample Title"™., 
ii Pages: 98 
/i } 
1 </remarksy> 
/i/ <param name="chapter"></param> 
/i// <returns>A newly created book chapter</returns> 
/i// <response code="201">Returns the newly created book chapter</response> 
/i/ <response code="400">If the chapter is null</response> 
[HttpPost] 


[ProducesResponseType (typeof (BookChapter), 


[ProducesResponseTypPe (400)1] 


201)] 


public async Task<IActionResult> PostBookChapterAsync! 


[FromBody]BookcCchapter chapter) 
{ 

/1 --- 
} 


要 从 XML 注释 生成 XML 文档 ， 需 要 启用 Project Settings 的 Build 配置 ， 并 选择 如 图 32-4 所 示 的 XML 
Documentation File 复 选 框 。 此 设置 指定 项 目 配置 文件 中 的 DocumentationFile 设置 (项 目 文 件 
Async/BooksServiceSample/BooksServiceSample.cspro]): 


二 


BooksServicesample 
py 

世相 

Application 


Build 
Build Everts 


Ceonfiguration: Aetive (Debug) 
Platform: Active (Ary CPU) 


Package Genmeral 


Debug Conditonal compilation symbols 


Deline DEBUG constant 
Define TRACE constant 


3igning 


Resources 


Platform target 


OD Allow unsafe code 
[ Dptimize code 


Errars and warnings 
Warning lewvel: 
SUpPress Warnings: 

Treat warnings as errors 
[1 None 
Al 
口 Specilic wamings: 

Output 
Output path: 


加 XML documentation file: 


Ganerate serialization assembly: 


NETSTANDARD2 0 


二 


1701:1702;1705 


bimDebug\netstandard2.0, 


docmbooksServiceSample.aml 


图 32-4 


<PIopertyGroup» 
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<DocumentationFile>..\docs\BooksServiceSample.xml</DocumentationFile> 


</PropertyGroup> 


Swagger 现在 还 需要 配置 为 在 调用 AddSwaggerGen 方法 时 使 用 这 个 生成 的 XML 文档 文件 (代码 文件 


Async/BooksServiceSampleHost/Startup.cs): 


Services.AddSswaggerGen (options 三 > 


| 


options.IncludeXmlComments("../docs/BooksServiceSample.xml").; 


options .SwaggerDoc("v2", new Info 


{ 
Title = "Books Service API", 
Version = "v2", 
Description = "Sample service for Professional C# 7"™, 
Contact = new Contact { Name = "Christian Nagel™, 
Url = "https://csharp.christiannagel.com"™" }, 
License = new License { Name = "MIT License"™ } 
}1) 5 
}) 5s; 
i... 


通过 添加 所 有 这 些 信 息 ，Swageger 就 会 显示 模型 ， 其 中 包含 注释 、 
殊 信 息 ， 如 图 32-5 所 示 。 


| 后 大 | 加 swaggerul x | 十 w 


rs 0 


TY localhost1079/5Wwaggere 
BookGhapters 
apvBookiuhapters 


sl apUBookihapters 
Implementation Notes 
Sample request: POST apiibookchapters { Number: 42, Titie: "Sample Tille”, Pages: 98 } 


一 天 


Hesponse Ulass (Status 201) 


Retums the newty created book chapter 
Model 


BookChapter 
Wl (string, optional), 
murmber (integear 
is (siring), 
pages fieger, Goonal) 
} 


一 


Response Content Type | applicatlonson | 


Parameters 
和 于 本 这 本 站 ww Parameter 
Parameler Value Description Type 
thapter bchy 
Paramater content type- 


applicationison 


Response Messages 


HITP status Code Reagson Respomnse odel 


488 I the chapter ls null 


Try i ott 


图 32-5 


32.7 创建 和 使 用 OData 服务 


来 自 XML 文档 的 信息 以 及 啊 应 代码 的 特 


Lreates a BookChapter 


Data Type 
Exampla Walue 


{ 
"Jd": “string”, 
"Timber 6, 
tithe: “strine”, 
时 

于 


Headers 


ASPNET Core 为 OData(Open Data Protocol) 2.1 版 本 提供 了 支持 。 编 写本 书 时 ，Web API OData 有 一 个 Beta 
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版 本 ， 请 查看 本 书 的 GitHub 页 面 ， 获 得 最 近 的 更 新 。 

OData 通过 HITP 协议 提供 了 对 数据 源 的 CRUD 访问 。 发 送 GET 请 求 会 检索 一 组 实体 数据 ，POST 请 求 会 
创建 一 个 新 实体 ，PUT 请 求 会 更 新 已 有 的 实体 ，DELETE 请 求 会 删除 实体 。 前 面 介 绍 了 映射 到 控制 器 中 动作 方 
法 的 HITP 方法 。OData 基于 JSON 和 AtomPub( 一 种 XML 格式 ) 进 行 数 据 序列 化 。ASPNET Core 也 直接 支持 
JSON 和 XML。OData 提供 的 其 他 功能 有 : 每 个 资源 都 可 以 用 简单 的 URL 查询 来 访问 。 为 了 说 明 其 工作 方式 
以 及 ASPNET Web API 如 何 实现 这 个 功能 ， 下 面 举例 说 明 ， 从 一 个 数据 库 开始 。 

对 于 服务 应 用 程序 BooksODataService， 为 了 提供 OData， 需 要 添加 NuGet 包 Microsoft.AspNetCore.OData。 
示例 服务 允许 查询 Book 和 BookChapter 对 象 ， 以 及 它们 之 间 的 关系 。 


32.7.1 创建 数据 模型 
示例 服务 为 模型 定义 了 Book 和 BookChapter 类 。Book 类 定义 了 简单 的 属性 以 及 与 BookChapter 类 型 的 一 


对 多 关系 (代码 文件 BooksODataService/Models/Book .cs): 


Public class Book 
{ 
Public Book() 
{ 
Chapters = new List<BookChapter> (); 
} 
Public int Id { get; set; } 
Public string Isbn { get; set; 1} 
public string Title { get; set; } 
public string Publisher { get; set; } 
public List<BookChapter> Chapters { get; set; } 
} 


BookChapter 类 定义 了 简单 的 属性 以 及 与 Book 类 型 的 多 对 一 关系 (代码 文件 BooksODataService/ 
Models/BookChapter.cs): 


Public class BookChapter 

{ 
public int Id { get; set; } 
public int BookId { get; set; } 
Public Book Book { get; set; } 
public string Title { get; set; } 
public int Number { get; set; } 


} 

BooksContext 类 定义 了 Books 和 Chapters 属性 ,以 及 SQL 数据 库 关 系 的 定义 (代码 文件 BooksODataService 
/Models/BooksContext.cs): 

public class BooksContext: DbContext 

{ 


public DbSet<Book> Books { get; set; } 
Public DbhSet<BookChapter> Chapters { get; set; } 
protected override void OnModelCreating (ModelBuilder modelBuilder) 
| 
base.OnModelCreating (modelBuilder); 
Var bookBuilder = modelBuilder.Entity<Book> (); 
bookBuilder.HasMany (b => b.Chapters) 
.Withone l(c => c.Book) 
.HasForeignKey (cc => c.BookId); 
bookBuilder.Propertyl(b => b.Title) 
-HasMaxLength (120) 
.IsReoquired(); 
bookBuilder.Propertyl(b => b.Publisher) 
.HasMaxLength (40) 
-IsRequired (false); 
bookBuilder.Property (b => b.Isbn) 
-HasMaxLength (20) 
-IsRequired (false).; 
var ChapterBuilder = modelBuilder.Entity<Chapter> ();} 
chapterBuilder.Property(c => c.Title) 
.HasMaxLength (120).}; 
chaptersBuilder.Hasone(c => c.Book) 
.WithMany (b => b.chapters) 


第 32 章 Web API | 843 


.HasFDTrelIgnKEKeYy(C => c.BookId).; 


32.7.2 创建 数据 库 


要 随时 使 用 示例 数据 创建 数据 库 ， 使 用 CreateBooksService 类 注入 一 个 BooksContext， 如 果 数 据 库 还 不 存 
在 ， 则 创建 它 。DatabaseFacade 类 上 的 EnsureCreated 方法 从 BooksContext 的 Database 属性 返回 ,确保 数据 库存 
在 。 如 果 创 建 了 数据 库 ， 则 EnsureCreated 方法 返回 tue， 然 后 通过 调用 CreateSampleBooks 方法 给 数据 库 填充 
一 些 书 籍 (代码 文件 BooksODataService/Services/CreateBooksService.cs): 


Public class CreateBooksService 

{ 
private readonly BooksContext booksContext; 
Public SampleBooks (BooksContext booksContext) 


{ 
booksContext = booksContext; 
} 
Public void CreateDatabase () 
{ 
bool created = booksConteXt .Database.EnsureCreated(); 
if (created) 
{ 
CreateSampleBooks (})} 
} 
} 
es 


} 


图 书 和 章节 的 示例 数据 在 字段 bookTitles、bookIsbns 和 chapterTitles 中 定义 (代码 文件 BooksODataService/ 
Services/CreateBooksService.cs): 


private string[] bookTitles = Dew[] 

{ 
"Professional C# 7 and .NET Core 2"™, 
"Professional C# 6 and -NET Core 1.0"， 
"Professional C# 5 and -NET 4.5.1"™" 

}; 


private string[] bookIsbns = mew[] 
{ 
"978—1-119-44927-0", 
"978-1-119-09660 一 3 ， 
于 号 了 旦 一 1 一 工 和 一 和 33 人 3 一 2 
} 7 


private string[] [] chapterTitles = mew[] 
{ 
new [|] 
{ 
"NET Applications and Too1lLs" ， 
"Core C#", 
"Objects and Types", 
"Object-Oriented Programming with C#", 
"Generics™, 
pF 
} 
} 


CreateSampleBooks 方法 使 用 通过 私有 字段 定义 的 数据 , 将 该 信息 写 入 数据 库 ( 代 码 文件 BooksODataService/ 
Services/CreateBooksService.cs): 


private void CreateSampleBooks () 
{ 
for {int 1 = 0; i < bookTitles.Length; 1++) 


{ 
var bb = new Book 
{ 
Title = bookTitles[1i], 
Isbn = bookIsbns[1i], 


Publisher = "Wrox Press"™ 
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}; 

Var chapters = GetChapters (i, b); 
booksContext.Chapters.AddRange (chapters}); 
booksContext .Books .Add (D) 7 

} 


int recordscCchanged = booksContext.SaveChanges () 


} 


32.7.3 ”OData 启动 代码 


在 ASPNET Core 中 ， 可 以 轻松 地 添加 OData 服务 。 需 要 将 服务 添加 到 依赖 注入 容器 中 ， 并 且 需 要 添加 中 
间 件 ， 与 前 面 的 ASPNET Core 章节 一 样 。 

在 Startup 类 的 ConfigureServices 方法 中 , CreateBooksService 类 注册 到 DI 容器 中 , 该 容器 允许 创建 数据 库 。 
使 用 AddDbContext 方法 时 ，EF Core 上 下 文 被 注册 到 DI 容器 中 ， 并 配置 为 使 用 SQL Server。 对 于 OData， 调 
用 扩展 方法 AddoData。 此 扩展 方法 注册 OData 所 需 的 多 个 服务 (代码 文件 BooksODataService/Startup.cs): 


Public void ConfigureServices (IServiceCollection services) 
{ 
SEIVICes.AddMvec (}).- 
servyvices.BddTransient<CreateBooksService>().-: 
Services.AddDbContext (options 一 > 


{ 


options.UseSgqlServer (Configuration.GetConnectionstring ("BooksConnection™))}); 
A (); 

} 

使 用 Configure 方法 配置 中 间 件 。 修 改 此 方法 的 参数 以 注入 CreateBooksService。 如 果 数 据 库 还 不 存在 ， 实 
现代 码 中 的 第 一 行将 创建 它 。OData 相关 代码 在 ODataConventionModelBuilder 的 创建 之 后 执行 。 
ODataConventionModelBuilder 将 .NET 类 映射 到 Entity Data Model(EDM)。OData 使 用 EDM 模型 来 定义 服务 公 
开 的 数据 。OData 路 由 是 通过 将 routeBuilder 参数 传递 给 UseMvc 扩展 方法 来 配置 的 。 通 过 调用 
MapODataServiceRoute 扩展 方法 指定 OData 路 由 。 该 方法 的 第 一 个 参数 指定 路 由 的 名 称 ; 第 二 个 参数 指定 路 由 
前 级 ; 第 三 个 参数 指定 使 用 先前 创建 的 ODataConventionModelBuilder 创建 模型 后 返回 的 正 dmModel (代码 文件 
BooksODataService/Startup.cs): 


Public void Configure (IApplicationBuilder app, IHostingEnvironment env, 
CreateBooksService sampleBooks) 

{ 
sampleBooks.CcreateDatabase (}); 


if (env.IsDevelopment () ) 
{ 
apbp.UseDeveloperExceptionPage (); 
} 
Var builder = new ODataConventionModelBuilder (app .ApplicationSservices).; 
builder.EntitySet<Book> ("Books").; 
builder.EntitvySet<BookChapter> ("BookChapters"):; 
app .UseMve (routeBuilder 一 > 
routeBuilder.MapODataServiceRoute(" "ODataRoute”, "odata”™, 
builder.GetEdmModel()}))); 


32.7.4 ”创建 OData 控制 器 


BooksController 类 需要 从 基 类 ODataController 中 派生 ,在 下 面 的 代码 片段 中 ,Get 方法 返回 包含 BookChapter 
对 象 的 Book 对 象 列 表 。 返 回 IQueryable 而 不 是 返回 IEnumerable 接口 以 月 用 OData 查询 。IEnumerable 接口 由 
EF Core 中 的 DbSet 类 实现 .从 内 存 数 据 中 返回 List<t>, 可 以 使 用 AsQueryable 扩展 方法 将 其 转换 为 IJQueryable。 
返回 一 个 结果 时 ， 如 果 使 用 OData 功能 ， 就 需要 返回 一 个 SingleResult 类 型 的 结果 。SingleResultCreate0 方 法 创 
建 一 个 SingleResult, 但 是 需要 IQueryable 作为 参数 (代码 文件 BooksODataService/Controllers/BooksController.cs): 


Public class BooksController: ODataController 
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private readonly BooksContext booksContext; 
Public BooksController (BooksContext booksContext) 
{ 

booksContext = booksContext; 


} 


Public IQueryable<Book> Get() => 
booksContext .Books.Include(b => b.cChapters); 


[EnableQuery()] 
PUublic SingleResult<Book> Get([FromODataUri] int id) => 
SingleResult.Create( booksContext -BOOKS -Where (D => b.1d == key); 
} 


ChaptersController 的 实现 与 此 类 似 一 一 返回 BookChapter 对 象 列表 和 单个 BookChapter( 代 码 文 件 
BooksODataService/Controllers/ChaptersController.cs):: 


public class ChaptersCcontroller : ODataCcontroller 
{ 
private readonly BooksContext booksContext; 
Public ChaptersController (BooksContext lbooksContext) 
{ 
booksContext = booksContext; 


} 


Public IQueryable<BookChapter> Get() 三 > 
booksContext .Chapters.Include l(c => Cc.Book); 


[Enablemueryl 
Public SingleResult<BookChapter> Get([FromoODataUri] int KeYy) => 
SingleResult.Create( booksContext -Chapters-Where(tCc => C-Id 一 KeYy) ) ; 


} 


除了 对 EnableQuery 特性 的 更 改 外 ， 不 需要 对 控制 器 执行 其 他 特殊 操作 。 
32.7.5 ”OData 查询 


使 用 下 面 的 URL 很 容易 获得 数据 库 中 的 所 有 图 书 (端口 号 可 能 与 读者 的 系统 不 同 ), odata 路 由 前 级 由 Startup 
类 中 的 OData 路 由 指定 ， 控 制 器 的 名 称 使 用 约定 ; 

http://localhost:50000/0data/Books 

返回 的 数据 由 JSON 数据 和 Book 对 象 组 成 : 


{"&@odata.context":"http://localhost:6614/0data/ $metadata#Books", 
"Value™: 

[{"Id™ :1,"Isbn™. "9078 1-—119—449217—0", 
"Title":"Professional C# 7 and .NET Core 2"]， 
"Publ1l1isher™.: "Wrox Press"l} 

{"Id™ :2,."Isbn™":"978-1-119-09660—3"™. 
"Title":"Professional C# 6 and .NET Core 1.0"}, 
"Publisher": "Wrox Press"} 
{"Id™":3,."Isbn™:"918—1—118-83303-—2", 
"Title™":"Professional C# 5 and .NET 4.5.1"}, 
"PubPI1I1iSsher™.: "Wrox Press"}]} 


同样 ， 使 用 如 下 URL 返回 BookChapter 对 象 ， 

http://localhost:50000/0data/Chapters 

要 只 获取 一 本 书 , 可 以 把 该 书 的 标识 符 和 URL 一 起 传递 给 方法 。 这 个 请 求 会 调用 Get 动作 方法 , 并 传递 键 ， 
返回 单一 结果 : 

http://localhost:50000/0data/Books (2) 

可 以 访问 生成 的 EDM 信息 ， 这 些 信 息 通 过 odata 前 级 后 面 的 $metadata 字符 串 传递 : 

http://localhost:50000/o0data/ $metadata 

这 将 使 用 ODataConventionModelBuilder 返回 从 模型 中 生成 的 EDM 信息 : 

<2xml version="1.0" encoding="UTF-—8"2> 


<edmx:Edmx xmlns:edmx="http://docs.o0asis-open.org/odata/ns/edmx" Version="4.0"> 
<edmx: DataServices> 
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<Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" 
Namespace="BooksODataService.Models"> 
<EntityType Name="Book™"> 
<KRey> 
<PropertyRef Name="Id"/> 
</Fey> 
<Property Name="Id" Nullable="false™" Type="Edm.Int32"/> 
<Property Name="Isbn" TYPe="Edm . String"/ > 
<Property Name="Title™" Type="Edm.string"/> 
<NavigationProperty Name="Chapters" 
Type="Collection (BooksODataService.Models.BookChapter) "/> 


</EntityType> 
<EntityType Name="BookChapter"> 
<Key~ 
<PropertyRef Name="Id"/> 
</Fey> 


<Property Name="Id" Nullable="false™" Type="Edm.Int32"/> 
<Property Name="BookId™" Type="Edm.Int32"/> 
<Property Name="Title™" Type="Edm.Sstring"/> 
<Property Name="Number™" Nullable="false" Type="Edm.Int32"/> 
<NavigationProperty Name="Book™. Type="BooksODataService.Models.Book"> 
<ReferentialConstraint ReferencedProperty="Id" Property="BookId"/> 
</Navigationproperty> 
</EntityType> 
</Schema> 
<Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" 
Namespace="Default™> 
<EntityContainer Name="Container"> 
<EntitySet Name="Books™" EntityType="BooksODataService.Models.Book"> 
<NavigationPropertyBinding Target="Chapters™" Path="Chapters"/> 
</EntitySet> 
<EntitySet Name="Chapters"™ 
EntityType="BooksODataService.Models.BookChapter™"> 
<NavigationPropertyBinding Target="Books"™" Path="Book"/> 
</EntitySet> 
</EntityCcontainer> 
</Schema> 
</edmx:DataServices> 
</edmx: Edmx> 


OData 提供 了 ASPNET Core Web API 支持 的 强大 查询 选项 。OData 规范 允许 将 参数 传递 给 服务 器 ， 进 行 分 
“过滤 和 排序 。 下 面 介绍 它们 。 
每 本 书 都 有 多 个 结果 。 在 URL 查询 中 ， 还 可 以 获取 书 的 标题 : 
http://localhost: 50000/0data/Books (1) /Title 
也 可 以 使 用 关系 来 检索 图 书 的 章节 : 
http://localhost:50000/0data/Books (1) /Chapters 
要 返回 数据 库 中 图 书 章节 的 数量 ， 可 以 使 用 $count 函数 : 
http://localhost:50000/o0data/Chapters/$count 
为 了 只 给 客户 端 返回 数量 有 限 的 实体 ,客户 端 可 以 使 用 $top 参数 限制 数量 。 也 允许 使 用 $skip 进行 分 页 ; 例 
如 ， 可 以 跳 过 3 个 结果 ， 再 提取 3 个 结果 : 
http://localhost:50000/0data/Books?$top=3&$skip=3 
Queryable 特性 还 有 一 些 命名 参数 来 限制 查询 , 例如 最 大 的 top 和 skip 值 、 最 大 的 扩展 深度 以 及 排序 的 限制 。 
为 了 根据 Book 类 型 的 属性 筛选 请 求 ， 可 以 将 $filter 选项 应 用 于 Book 的 属性 。 为 了 筛选 出 Wrox 出 版 社 出 
版 的 图 书 ， 可 以 使 用 eq( 等 于 ) 操 作 和 从 和 $filter 选项 : 
http://localhost:50000/o0data/Books?$filter=Publisher eq "Wrox Press' 
$filter 选项 还 可 以 与 (小 于 ) 和 gt( 大 于 ) 操 作 符 一 起 使 用 。 下 面 的 请 求 仅 返回 页 数 大 于 40 的 章 : 
http://localhost: 50000/o0data/Chapters?$filter=Id gt 40 
为 了 请 求 有 序 的 结果 ，$orderby 选项 定义 了 排序 顺序 。 添 加 desc 关键 字 按 降序 排序 : 


http://localhost:50000/0data/Book (2) /Chapters?$orderby=Title desc 
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所 有 这 些 得 询 函 数 都 需要 显 式 局 用 。 通 过 在 操作 方法 上 应 用 EnableQuery 特性 ， 或 者 使 用 了 下 outeBuilder 扩 
展 方法 来 全 局 地 月 用 OData 函数 和 限制 。 使 用 下 面 的 代码 片段 ，EnableQuery 特性 应 用 于 一 个 操作 方法 。 在 这 
里 ，AllowedQueryOptions 属性 设置 为 枚 举 值 AllowedQueryOptions.All。 还 可 以 定义 ODataQueryOptions 类 型 的 
参数 ， 以 检查 通过 URL 请 求 发 送 的 查询 选项 ， 并 以 编程 方式 验证 : 


[EnableQuery (AllowedQueryoOptions = AllowedQueryOptions.All)] 
Public IQueryable<Book> Get (ODataQueryOptions options) 
{ 
ODatavVvalidationSettings settings = new ODataValidationsettings () 
{ 
MaxExpansionDepth = 4 
上 
options.Validate (settings); 
var books = booksCcontext.Books.Include(b => b.chapters}; 
return books; 


} 

EnableQuery 特性 允许 指定 返回 的 最 大 节点 数 、 最 大 top 和 skip 值 、 最 大 页 面 大 小 、 是 否 允 许 基于 哪些 属性 
进行 排序 ， 以 及 允许 的 逻辑 和 算术 操作 符 、 允 许 的 函数 和 人 允许 的 查询 选项 。 

要 使 用 Startup 类 全 局 配置 选项 ， 可 以 使 用 SetDefaultQuerySettings 方法 设置 默认 值 ， 使 用 
GetDefaultQuerySettings 方法 检索 默认 值 。 


32.8 使 用 Azure Function 


使 用 ASPNET Core 创建 Web API 时 , 可 以 使 用 运行 ITS 的 Windows 服务 器 、 运行 Apache 的 Linux 服务 器 ， 
甚至 是 没有 其 他 Web 服务 器 前 辣 的 Kestrel 服务 器 来 托管 它 。 可 以 使 用 Platform as a Service (PaaS) 产 品 ， 例 如 
Azure App Services 来 托管 Web API。 使 用 Azure App Services 时 ， 需 要 根据 CPU 内 核 的 数量 、RAM 的 大 小 和 
存储 大 小 为 服务 器 实例 付费 。 这 些 资源 是 为 Web 应 用 程序 预 留 的 (可 以 在 一 个 App Service 实例 中 运行 多 个 Web 
应 用 程序 )。 

根据 负载 ， 还 有 一 个 托管 Web API 的 选项 ，Consumption 计划 或 App Service 计划 。 对 于 App Service 计划 ， 
可 以 在 可 能 已 经 拥有 的 App Service 中 运行 Azure Function。 男 一 种 变 体 即 Consumption 计划 ， 也 称 为 serverless 
或 Function as a Service(FaaS)。 使 用 此 选项 ,为 运行 Azure Function 所 需 的 请 求 数 和 内 存 付费 。 根据 需要 的 资源 ， 
这 个 选项 可 能 比 使 用 App Service 要 便宜 得 多 ， 但 也 可 能 更 昂贵 。 还 可 以 在 App Service 实例 中 运行 Azure 
Function， 该 实例 将 其 更 改 为 与 App Service 相同 的 支付 计划 。 

以 无 服务 器 的 方式 使 用 Azure Function 时 ， 它 后 面 仍然 有 一 个 服务 器 。Azure Function 技术 总 是 基于 App 
Service。 但 是 ， 以 无 服务 器 方式 使 用 它 时 ， 不 会 控制 这 个 服务 器 ， 也 没有 保留 CPU 和 内 存 。 这 就 是 价格 不 同 的 
原因 。 有 关 Microsoft Azure 定价 模型 的 更 多 信息 ， 请 参见 https://azure.microsoft.com/pricing/。 

使 用 Faas 托管 Azure Function 有 一 些 限制 。Azure Function 最 多 可 以 运行 10 分 钟 。 默 认 超时 为 $ 分 钟 ， 但 
可 以 延长 到 10 分 钟 ,如 果 Azure Function 需要 运行 更 长 的 时 间 , 就 应 该 在 App Service 计划 中 托管 Azure Function。 

Azure Function 是 用 静态 方法 实现 的 。 在 多 个 调用 之 间 共 享 静态 状态 。 但 是 ， 当 不 需要 Azure Function 时 ， 
它 就 会 另 载 ， 当 HTTP 请 求 再 次 到 达 时 ， 它 会 重新 加 载 和 实例 化 。 第 一 个 请 求 可 能 需要 更 长 的 时 间 来 返回 结果 。 
像 App Service 中 always on 这 样 的 选项 是 不 可 用 于 Consumption 计划 的 。 根 据 负 载 ， 可 以 使 用 Azure Function 
目 动 局 动 其 他 机 器 , 这 是 Consumption 计划 的 另 一 个 特性 。 只 需要 确保 在 静态 类 成 员 中 的 调用 之 间 不 共享 状态 。 
可 以 使 用 外 部 存储 特性 (如 Azure Storage 或 SQL 数据 库 ) 进 行 状态 共享 。 


32.8.1 创建 Azure Function 


如 果 使 用 通过 DI 使 用 的 服务 创建 Web API, 并 且 该 服务 是 在 NET 标准 库 中 定义 的 , 就 可 以 轻松 地 在 Azure 
Function 中 使 用 相同 的 服务 。 使 用 Visual Studio 2017 时 ， 可 以 在 Add New Project 中 选择 Cloud 类 别 ， 并 选择 
Azure Function 模板 ， 来 创建 Azure Function 项 目 。 需 要 安装 Visual Studio 扩展 “Azure Functions and Web Jobs 
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Tools “， 以 使 用 此 选项 。 选 择 此 选项 后 ， 可 以 看 到 如 图 32-6 所 示 的 第 一 个 配置 选项 。 
New Template - BookFunctionsApp 


Azure Functions vi (.NET Standard) 


| Storage Account (Azure\WWebJobsstorage) 
~ , 加 号 CS storage Emulator 


Empty Http trigger Queue trigger Timer trigger 


外 Some capabilities may require an Azure storage account. 


Access rights 


Anarny mos 


Creates an Azyre function project with an Hitp tngger. 
Additional triggers can be added during development 


Get started with Azure Functions ] OK ] Cancel 


32-6 


使 用 这 些 选 项 ， 可 以 选择 在 调用 函数 时 触发 器 的 类 型 。 有 许多 不 同 的 触发 器 可 用 。 这 些 触 发 器 的 例子 包括 : 
把 一 些 数据 写 入 Azure Cosmos DB、 激 活 一 个 WebHook、 在 Microsoft Graph 上 发 生 的 事件 、SMS 到 达 、 到 达 
Event Hub 的 事件 、 发 生 在 Blob Storage 中 的 事件 等 。 最 常用 的 触发 器 出 现在 这 个 对 话 框 中 ; 这 些 是 HITP 请 求 、 
Azure 存储 队列 中 的 项 和 计时 事件 。 对 于 存储 队列 ， 当 消息 到 达 队 列 时 ，Function 就 可 以 启动。 有 了 计时 器 触发 
器 ， 就 可 以 指定 时 间 间 隔 ， 或 者 在 特定 的 时 间 局 动 Function， 比 如 每 个 星期 六 或 每 个 月 的 第 一 个 星期 一 。Azure 
Function 是 在 间隔 时 间 运 行 所 需 后 台 功 能 的 最 好 实践 一 一 例如 ， 清 理 或 分 析 数 据 的 存储 过 程 。 这 一 章 主 要 讨论 
Web API， 这 里 将 使 用 HTTP 触及 器 触发 接收 HTTP 请 求 的 触发 器 。 

要 选择 的 另 一 个 选项 是 Azure Function 的 版 本 。 在 Azure Functions 1.0 中 创建 了 .NET Framework 库 。Azure 
Functions 2.0 使 用 .NET Standard 2.0， 这 通常 是 最 好 的 选择 。 只 需要 注意 什么 触发 器 可 用 于 所 选 的 版 本 。 在 撰写 
本 文 时 ，Webhook 还 不 能 用 于 Azure Functions 2.0， 但 可 以 用 于 Azure Functions 1.0。 

还 需要 一 个 带 有 Azure Function 的 存储 账户 。 要 在 本 地 系统 上 创建 和 测试 Azure Function， 可 以 使 用 存储 模 
拟 器 。 在 Azure Function 中 写 入 日 志 信 息 需 要 使 用 存储 账户 。 

有 了 访问 权限 ， 就 指定 哪些 函数 应 该 可 用 。 可 以 选择 只 从 其 他 函数 中 调用 可 访问 的 函数 ， 而 不 从 公共 函数 
调用 。 这 里 选择 Anonymous 作为 从 外 部 访问 Azure Function 的 访问 权限 。 

创建 这 个 项 目 时 , 会 创建 一 个 引用 了 NuGet 包 MicrosoftNETSdk Functions 的 .NET Standard 2.0 库 。 该 库 包 
含 源 文件 Function1.cs， 以 及 GET 请 求 的 简单 Hello, name 实现 。 下 一 节 将 对 其 进行 更 改 ， 以 便 在 GET、POST 
和 PUT 请 求 上 调用 BookChapterService。 


32.8.2 ”使 用 依赖 注入 容 兹 


虽然 BookChaptersService 很 容易 通过 默认 构造 函数 来 实例 化 , 但 是 对 于 许多 其 他 服务 来 说 , 这 是 不 可 能 的 ， 
比如 在 构造 函数 中 需要 BooksContext 的 DbBookChaptersService。 这 就 是 为 什么 添加 DI 容器 Microsoft.Extensions 
DependencyInjection NuGet 包 是 有 用 的 原因 。 

BookFunction 类 (托管 Azure Function 的 类 ) 的 静态 构造 图 数 调用 在 DI 容器 中 注册 服务 的 ConfieureServices 
方法 ， 使 用 SampleChapters 类 添加 示例 章节 的 FeedSampleChapters 方法 ， 以 及 GetRequiredService 方法 ， 在 该 
方法 中 ， 服 务 将 稍 后 由 Azure Function 的 所 有 特性 使 用 (代码 文件 Sync /BookFunctionApp/BookFunction.cs): 


Public static class BookFunction 


{ 
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static BOOKEFEunct1Ionr) 

{ 
ConfigureServices(); 
FeedSampleChapters () 
GetRequiredServices(); 

} 

ff-.-. 

} 


ConfigureServices 方法 将 服务 配置 到 DI 容器 中 ， 这 是 在 使 用 ASPNET Core 时 多 次 看 到 的 功能 : 


private static VolId ConfigureServices() 

{ 
VAaAIL SEIVIices = Nnew ServiceCollection().:; 
Services.AddSingleton<IBookChaptersService, BookCchaptersService> (}); 
services.Addsingleton<SsSampleChapters> (}); 
ApplicationServices = services.BuildServiceProvider(); 


} 

public static IServiceProvider Applicationservices { get; private set; } 

要 使 一 些 示 例 章节 可 用 ， 但 不 需要 创建 数据 库 ，CreateSampleChapters 方法 使 用 BookChaptersService 创建 
一 些 内 存 中 的 章节 。 在 生产 中 使 用 Azure Function 时 ， 请 记 住 不 要 在 内 存 中 共享 状态 。 而 这 里 使 用 它 ， 是 因为 
这 样 更 容易 演示 这 个 例子 。 在 很 短 的 时 间 内 ， 这 些 数据 一 直 存 在， 但 是 当 函 数 的 空 亲 时 间 足 够 长 ， 或 者 由 于 同 
时 创建 多 个 实例 有 较 高 的 负载 时 ， 束 可 能 会 得 到 意 想不到 的 结果 。 要 使 用 数据 库 获 得 稳定 的 结果 ， 只 需要 将 服 
务 注册 从 BookChaptersService 更 改 为 DbBookChaptersService， 并 添加 EF Core 上 下 文 : 


private static void FeedSampleChapters() 
{ 
Var sampleChapters = 
ApplicationServices.GetRequiredService<SampleChapters> (); 
samplechapters.cCcreateSampleChapters (}; 
} 
从 GET、POST 和 PUT 请 求 到 Azure Function， 都 需要 IBookChaptersService; 这 就 是 为 什么 要 在 静态 变量 
中 检索 和 存储 此 服务 的 原因 。 使 用 静态 构造 函数 调用 GetRequiredServices 时 ， 每 次 重新 启动 主机 时 ， 都 会 调用 
此 方法 : 
private static void GetRequiredServices  () 
{ 
5s bookCchaptersService = 


ApplicationServices.GetRequiredService<IBookChaptersService>(); 


} 


private static IBookChaptersService 5 bookChaptersServices 


在 完成 Azure Function 的 设置 之 后 ， 可 以 在 下 一 节 中 实现 主要 功能 。 
32.8.3 实现 GET、POST 和 PUT 请 求 


Azure Function 的 核心 是 用 静态 Run 方法 定义 的 。 图 数 的 名 称 由 FunctionName 特性 定义 。 参 数 通 过 触发 器 
的 类 型 来 区 分 。 示 例 代 码 使 用 HttpTrigger 特性 指定 HTTP 请 求 上 的 触发 器 。 由 于 这 个 特性 ，Run 方法 的 第 一 个 
参数 类 型 是 HttpRequest。 此 类 型 包含 HTTP 请 求 的 信息 ， 并 允许 发 送 HTTP 啊 应 。HttpTrigger 特性 指定 在 创建 
应 用 程序 时 指定 的 AuthorizationLevel， 并 在 Azure Function 应 该 被 激活 时 ， 在 其 后 面 添加 一 个 HTTP 谓词 的 可 
变 参 数列 表 。 还 可 以 使 用 参数 指定 此 Azure Function 的 路 由 信息 。 使 用 路 由 定义 的 参数 也 可 以 作为 参数 添加 到 
Run 方法 中 。 Run 方法 的 最 后 一 个 参数 是 TraceWiiter。 此 写 入 器 用 于 将 信息 记录 到 创建 应 用 程序 时 指定 的 Azure 
存储 账户 中 。Run 方法 实现 后 ， 根 据 接收 到 的 HTTP 方法 调用 DoGet、DoPost 和 DoPut 方法 (代码 文件 
Sync/BookFunctionApp/BookFunction.cs): 


[FunctionName ("BookFunction"™")] 

Public static IActionResult Run([HttpTrigger (AuthorizationLevel .Anonvymous, 
"get", "post"”, "Put”", Route = "null")]HttpRequest req, TraceWriter log) 

{ 
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log.Infol("cC# HTTP trigger function processed a request."™),; 


IACtionResult result = null; 
switch (reqg.Method) 
{ 
Case "GET™: 
result = DoGet (req); 
break; 
Case "POST™: 
result = DoPost (req); 
break; 
Case "PUT™: 
result = DoPut (req); 
break; 
default: 
result = new BadRequestResult (}); 
breaks 
} 
return result; 


} 

通过 GET 请 求 ， 客 户 端 可 以 检索 所 有 图 书 章节 ， 或 者 只 检索 一 个 章节 。 如 果 HTTP URL 包含 带 有 Id 
(/?Id=Guid) 的 查询 ， 则 解析 标识 符 ， 并 调用 IBookChaptersService 的 Find 方法 。 根 据 Find 方法 的 结果 ， 要 么 返 
回 NotFoundResult， 要 么 返回 包含 HTTP 主体 中 图 书 章节 的 OkObjectResult。 如 果 Id 不 是 查询 的 一 部 分 ， 则 使 
用 GetAll 方法 检索 所 有 图 书 章节 ， 并 将 结果 列表 放 入 OkObjectResult 的 构造 函数 中 (代码 文件 
Sync/BookFunctionApp/BookFunction.cs): 


private static IActionResult DoGet (HttpRequest redq) 
{ 
string id = req.Query["Id"]; 
if (ia != null) 
{ 
Guld guid = Guid.Parse (id); 


Var chapter = s bookChaptersService.Find (guid); 
if (chapter == null) 
{ 
return new NotFoundResult (}); 
} 


return new OkObJjectResult (chapter); 

} 

135e 

{ 
var chapters = s bookCchaptersService.GetAll ()}; 
return new OkKkObJectResult (chapters); 

} 

} 


使 用 HTTP POST 请 求 ， 调 用 DoPost 方法 。POST 请 求 包 括 请 求 的 HTTP 主体 中 的 新 书 章节 。 可 以 通过 访 
问 HttpRequest 的 Body 属性 来 检索 HTTP 主体 。Body 属性 的 类 型 是 Stream， 它 可 以 放 在 SteamReader 类 的 构 
造 国 数 中 。 使 用 StreamReader， 通 过 调用 ReadToEnd 检索 完整 的 JSON 字 付 串 。 接 着 在 Newtonsoft.Json 的 帮助 
下 , 将 这 个 JSON 字符 串 转换 为 BookChapter。 然后 将 转换 后 的 BookChapter 传递 给 IBookChaptersService 的 Add 
方法 (代码 文件 Sync/BookFunctionApp/BookFunction.cs): 

private static IActionResult DoPost (HttpRequest req) 

string json = new StreamReader (req.Body) .ReadToEna() ; 

BookChapter chapter = JsonConvert.DeserializeOQbject<BookChapter> (json); 


s bookChaptersService.Add (chapter); 
return new OkResult().; 


注意 : 
流 可 参阅 第 22 章 。 
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更 新 BookChapter 对 象 的 HITP PUT 请 求 与 以 前 的 HITP POST 请 求 非 常 相 似 。 这 一 次 只 是 调用 
IBookChaptersService 的 Update 方法 (代码 文件 Sync/BookFunctionApp/BookFunction.cs): 


private static IActionResult DoPut (HttpRequest req) 
{ 
string json = new StreamReader (regq.Body) .ReadToEnd (); 
BookChapter chapter = JsonConvert.DeserializeObject<BookChapter> (jsSon); 
s bookChaptersService.Update (chapter); 
return new OkResult (}).:; 


} 
有 了 这 些 ， 就 可 以 使 用 通过 ASPNET Core 提供 服务 时 已 经 实现 的 所 有 功能 。 使 用 服务 的 一 个 小 部 分 ， 服 
务 不 需要 任何 更 改 。 接 下 来 ， 运 行 并 发 布 Azure Function。 


32.8.4 运行 Azure Function 


在 Visual Studio 中 运行 应 用 程序 时 ， 一 个 控制 台 窗 口 显示 了 Azure Function 的 徽标 (参见 图 32-7)， 并 显示 了 
使 用 URL 访问 HITP 服务 的 侦 听 器 的 输出 。 现 在 可 以 使 用 浏览 器 发 出 GET 请 求 ， 并 测试 Azure Function。 对 于 
测试 POST 和 PUT 请求， 可 以 调整 先前 创建 的 客户 问 来 调用 Azure Function， 也 可 以 使 用 Postman 之 类 的 工具 
(https://www.getpostman.com) 创 建 POST 和 PUT 请 求 。 这 也 是 创建 集成 和 运行 集成 测试 的 好 工具 。 


CAWINDOWS system3a\cmd.ene 


图 32-7 


运行 应 用 程序 时 ， 会 发 现 bin/Debug/netstandard2.0/BookFunction 目录 下 的 文件 function.json。 此 文件 描述 了 
在 Microsoft Azure 上 发 布 时 部 署 的 Azure Function。 使 用 .NET 标准 库 时 ，function.json 的 信息 来 自 使 用 Run 方 
法 指定 的 注释 :可 以 看 出 ， 它 列 出 了 触发 器 的 类 型 、 触 发 器 的 配置 ， 如 HTTP 方法 和 Azure Function 的 入 口 点 : 


{ 
"generatedBy": "Microsoft.NET.Sdk.Functions.Generator-l1.0.6", 
"configurationSource"™"™: "attributes™, 
"bindings": [ 
{ 
"type™": "httpTrigger™, 
"methods™": I[ 
"GET” ， 
"POST ”， 
"PUT" 
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] ， 
"authLevel™": ”anonymous”， 
"name™": "redq™ 
} 

1 

"disabled": false, 

"scriptFile™": ™../bin/BookFunctionAaApp.dl1l™, 

"entryPoint": "BookKFUNCt1ionNnApp.BookKFUNCtion .RUunNn"™ 
} 


成 功 地 在 本 地 运行 应 用 程序 后 , 就 可 以 将 其 发 布 到 Microsoft Azure, 或 者 发 布 到 Consumption 或 App Service 
计划 中 。 


32.9 小结 


本 章 使 用 ASPNET Core 描述 了 Web API 的 功能 。 这 种 技术 允许 使 用 HttpClient 类 创建 服务 ， 并 在 任何 客 
户 端 (无 论 是 JavaScript 还 是 .NET 客户 端 ) 调 用 。 返 回 JSON 或 XML， 但 目前 JSON 是 首选 格式 。 

依赖 注入 已 经 用 于 本 书 的 几 章 ， 尤 其 是 第 20 章 。 本 章 介 绍 了 很 容易 把 使 用 字典 的 、 基 于 内 存 的 存储 库 蔡 换 
为 使 用 EF Core 的 存储 库 。 

本 章 还 介绍 了 OData， 它 使 用 资源 标识 符 ， 很 容易 引用 树 中 的 数据 。 

除了 使 用 ASPNET Core 托管 Web API 之 外 , 还 使 用 了 Azure Function 创建 与 前 面相 同 的 服务 。 服 务 是 独立 
于 托管 技术 实现 的 ， 因 此 很 容易 创建 一 个 小 的 facade 并 托管 来 自 Azure Function 的 服务 ， 在 Microsoft Azure 上 
托管 Web API 时 ，Azure Function 提供 了 不 同 的 成 本 模型 。 

下 一 章 开 始 本 书 的 第 IV 部 分 ， 也 是 介绍 如 何 使 用 XAML 创建 Windows 应 用 程序 的 第 一 章 。 


第 IV 部 分 
应 用 程序 


> 第 33 章 Windows 应 用 程序 
> 第 34 章 模式 和 XAML 应 用 程序 

> 第 35 章 样式 化 Windows 应 用 程序 
> 第 36 章 高 级 Windows 应 用 程序 


> 第 37 章 Xamarin.Forms 


和 洲 症 


Windows 应 用 程序 


本 章 要 点 

控件 

己 编 译 的 数据 绑 定 
导航 

布局 面板 


本 章 源 代码 下 载 : 
打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Windows 目录 的 

https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 
本 章 代码 分 为 以 下 几 个 主要 的 示例 文件 : 

ControlsSample 

ParallaxViewSample 

PageLayouts 

NavigationSample 

LayoutPanels 


33.1 Windows 应 用 程序 简介 


Windows 应 用 程序 使 用 .NET Core, 但 是 Web 应 用 程序 和 ASPNET Core 有 很 大 的 区 别 。Windows 应 用 程序 
只 在 Windows 平台 上 运行 ， 在 Windows 10 上 运行 。 这 些 应 用 程序 不 仅 适 用 于 桌面 ， 也 适用 于 Xbox、HoloLens 
和 Raspberry PI。 

注意 : 

要 在 iPhone 和 Android 上 使 用 XAML 创建 应 用 程序 ， 请 阅读 第 37 章 。 但 是 ， 一 定 要 先 读本 章 ， 因 为 第 37 
章 只 解释 了 差异 。 
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33.1.1 Windows 运行 库 


Windows 应 用 程序 还 利用 了 Windows 运行 库 (Windows Runtime，WinRT)。Windows 运行 库 是 使 用 C+ 和 
新 一 代 COM 对 象 创建 的 平台 。 因 此 , Windows 运行 库 不 仅 适 用 于 .NET 应 用 程序 ,也 适用 于 C++ 和 使 用 JavaScript 
创建 的 应 用 程序 。 为 了 从 这 些 不 同 的 平台 上 访问 Windows 运行 库 ， 还 创建 了 一 个 兼容 层 : 语言 投影 。 通 过 语言 
投影 ，Windows 运行 库 提供 的 API 看 起 来 像 .NET APTI。 

运行 库 看 起 来 像 .NET 是 由 于 语言 投影 。Windows 运行 库 的 元 数据 以 与 .NET 相同 的 形式 创建 。 可 以 使 用 相 
同 的 工具 (例如 ildasm) 在 Windows 运行 库 中 读 取 元 数据 信息 。 使 用 COM 动态 读 取 元 数据 已 经 有 不 短 的 历史 了 。 
那 时 ， 可 以 在 类 型 库 中 访问 元 数据 。 这 种 元 数据 技术 不 如 用 .NET 实现 时 的 元 数据 强大 。 在 .NET 中 ， 元 数据 可 
以 使 用 目 定义 属性 进行 扩展 ， 并 且 可 以 使 用 反射 进行 访问 (请 参阅 第 16 章 )。Windows 运行 库 现在 使 用 与 .NET 
相同 的 元 数据 格式 。 因 此 ， 可 以 使 用 ildasm 命令 行 打开 .winmd 文件 (Windows 运行 库 的 元 数据 文件 )， 查 看 带 有 
参数 的 API 调用 。Windows 元 数据 文件 可 以 在 目录 "%ProgramFiles(X86)NWindows Kits\10\References\ 中 找到 。 

语言 投影 将 Windows 运行 库 类 型 映射 到 NET 类 型 上 。 例如， 在 文件 WindowsFoundation 
FoundationContract.winmd 中 ， 名 称 空间 Windows.Foundation.Collections 包含 IIterable 和 Iterator 接口 。 这 些 接 
口 看 起 来 非常 类 似 于 NET 接口 IEnumerable 和 IEnumerator。 实 际 上 ， 它 们 是 用 语言 投影 自动 映射 的 。 

Windows 运行 库 不 包含 任何 集合 。 相 反 ， 集 合 是 由 使 用 Windows 运行 库 的 不 同 平台 实现 的 ， 例 如 C++、 
JavaScript 和 .NET。 

并 不 是 所 有 的 协定 接口 都 可 以 直接 映射 。 第 22 章 展 示 了 名 称 空间 Windows.Storage.Streams 中 带 有 Windows 
运行 库 的 文件 和 流 。 要 将 Windows 流 与 NET 流 一 起 使 用 ， 可 以 使 用 扩展 方法 ， 如 AsStream、AsStreamForRead 
和 AsStreamForWrite。 


注意 : 
使 用 .NET Core API 和 Windows Runtime API 创建 Windows 应 用 程序 。 


33.1.2 Hello Windows 


下 面 开 始 使 用 Visual Studio 2017 创建 一 个 新 的 Windows 应 用 程序 。 选 择 Universal Windows Platform 项 目 。 
要 回答 的 第 一 个 问题 是 指定 要 文 持 的 目标 平台 和 最 小 平台 (参见 图 33-1)。 在 每 一 个 更 新 的 平台 版 本 中 ， 都 有 更 
多 的 特性 。 然 而 ， 需 要 注意 用 户 有 什么 版 本 的 Windows 10。 如 果 不 支 持平 台 版 本 ， 他 们 就 无 法 安装 和 运行 
Windows 10 应 用 程序 。 

对 于 所 选择 的 目标 版 本 ， 指 定 应 用 程序 可 以 使 用 的 API 版 本 。 对 于 最 小 版 本 ， 指 定安 装 和 运行 应 用 程序 的 
构建 版 本 。 如 果 将 目标 版 本 和 最 小 版 本 设置 为 不 同 的 值 ， 就 需要 编写 目 适 应 代码 。 在 调用 API 之 前 ， 需 要 确保 
API 在 受 支 持 的 构建 版 本 中 可 用 。 如 果 没 有 新 的 API， 可 以 减少 应 用 程序 的 特性 ， 或 者 根据 用 户 正 在 运行 的 构 
建 版 本 提供 不 同 的 特性 。 


New Universal Windows Platiorm Project 


select the target and minimum platform versions that your UWP application will support. 


Target version: Windows 10 Fall Creators Update (10.0: Byuild 16299) 


Minimum version: "Windows 10 November Update (10.0; Build 10586) 


Which 号 


Windows 10 Anniversary Update (10.0; Build 14393) 
Windews 10 Nowember Update (10.0; Build 10586) 
Windews 10 (10,0: Build 10240) 


图 33-1 
表 33-1 列 出 了 Windows 10 版 本 、 构 建 号 、 发 布 日 期 和 构建 版 本 的 特性 。 在 API 文档 中 ， 有 时 需要 版 本 号 、 
有 时 需要 构建 号 来 了 解 是 否 有 API 满足 支持 需求 。 


表 33-1 


版 本 号 


1307 


1311 10386 November 2013.11 
Update 


1709 


注意 : 
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特 性 


2015.7 更 好 的 目 适 应 布局 、 已 编译 的 数据 绑 定 、 列 表 的 声明 式 增 量 呈现 ( 阶 
段 ). 延迟 UI 加 载 、RelativePanel、 SplitPanel、 CalendarDatePicker、 Cortana 
以 及 应 用 程序 之 间 的 通信 


Windows Hello、Storage API 更 新 以 及 用 于 实时 音频 /视频 调用 的 
ORTC(Object Real-Time Communication， 对 象 实时 通信 ) 


1607 14393 | Anniversary 2016.7 新 的 墨水 控件 、Cortana API、 带 有 XAML 图 像 的 动画 GIF、 合成 交互 
1703 15063 | Creators 2017.3 新 的 合成 API， 对 量 角 器 和 尺子 的 油 春 支持 ， 地 图 上 的 图 像 以 及 
Fall Creators 2017.10 .NET Standard 2.0, 流畅 的 设计 、 有 条 件 的 义 AML、 用 户 活动 、 My People 
Update 以 及 新 的 UI 控件 (ColorPicker、 NavigationView 、 PersonPicture 、 


RatmeControl) 


要 使 用 NET Standard 2.0 库 ， 应 用 程序 需要 构建 版 本 16299 作为 最 小 构建 号 。 本 书 的 大 多 数 示例 应 用 程序 
都 将 目标 版 本 和 最 小 版 本 设置 为 16299。 


33.1.3 ”应 用 程序 清单 文件 


可 以 使 用 项 目 属性 更 改 构建 目标 和 最 小 版 本 号 。Windows 应 用 程序 还 有 另 一 个 重要 的 打包 配置 。 文 件 
Package.appxmanifest 可 以 使 用 Package Manifest Editor 配置 。 
在 Application 设置 (参见 图 33-2) 中 ， 可 以 配置 应 用 程序 的 显示 名 称 、 默 认 语言 、 文 持 设备 的 旋转 以 及 定期 


的 目 动 块 更 新 。 


Application Visual Assets © Capabilities Declarations Content URIs Packaging 


Use this page to set the properties that identity and describe your app. 


Display name: Hells, Windeows 


Entry Point: HellaWindeows.App 
Default language: en-US | More information 


Descriptian: Sample App for Professional Ct 


Supported rotations: An optional setting that indicates the app's erientation prefereneces 


[- 是 im 


[| Landscape | | Portrait L | Landscape-flipped 


Lock screan notifications: | (net sety = 
Resource droup: 


Tile Update: 


Updates the app tile by Periodically polling a URI The UR template can contain “|language)} and “lregion) 


replaced at runtime to generate the UR| tc po L 


TFT 站 ie 
Raecurrenee: 【meat set 


URI Template: 


图 33-2 


口 


[| Portrait-fliipped 


" tokens that will be 
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在 Visual Assets 选项 卡 中 ， 可 以 配置 应 用 程序 的 所 有 不 同 图 标 : 给 不 同 的 磁 贴 大 小 、 不 同 的 设备 分 辨 率 、 
闪 屏 和 Windows Store 的 包 标 识 指定 磁 贴 图 像 。 

Capabilities 选项 卡 中 的 设置 (参见 图 33-3) 人 允许 选择 应 用 程序 所 需 的 功能 .默认 选择 的 功能 是 mtemet( 客 户 端 ) 
功能 。 如 果 需 要 对 服务 器 执行 网 络 请 求 ， 则 需要 打开 此 功能 。 其 他 功能 允许 访问 位 置信 息 ， 访 问 麦 元 风 和 摄像 
头 ， 访 问 文 件 系 统 上 的 不 同文 件 夹 ， 如 音乐 库 、 图 片 库 或 视频 库 。 


Package.apparmani 


Application Visual Assets Capabilities Declarations Content URIs Packaging 


[| Alljovn 

DD Appointments el 
| Background Media Playback Mare information 

|_| Blesked Chat beeenges 

| Bluetoath 

LL] Chat Message Mcmess 

| | Code Generation 

[| Contacts 

| Enterprise Authenitication 


| | Intemet (Client Mm Serer 


[_] Laeation 


|_| Lew Lewel Devices 

[| Micraphone 

国 uasie Library 

[| objects 3C 

[| Fhone Call 

DD Fhone Call Histery Pubilie 
DD Plctures Library 

DO Point of Sorviee 

|_| Private Netwarks (Client & Serverl 
L | Prawrmaty 

[| Reconded Calls Folder 
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在 Declarations 设置 (参见 图 33-4) 中 ， 可 以 添加 Windows 需要 了 解 的 应 用 程序 特性 。 例 如 ， 当 共享 一 个 应 
用 程序 的 数据 时 ，Windows 显示 接受 共享 数据 的 应 用 程序 。 为 此 ， 应 用 程序 需要 注册 为 Share Target。 该 选项 卡 
中 包含 将 应 用 程序 注册 为 共享 目标 ， 通 过 协议 或 文件 类 型 扩展 来 激活 ， 在 应 用 程序 服务 之 间 进 行 通 信 ， 以 及 更 
多 的 声明 设置 。 


Application Visual Assets Capabilities Declarations@ Content URIs Packaging 


Bore mnieormmatian 
Propartigs: 
Sheare descnptian: 


Data formats Li 


ps NR - 
toragelterrs i f |! h 


Add New| 


Supported tle types 避 


lies the tile types supported by ths 2 

pp support at least one data format 万 type 

a With B supported type is shared frorm ancther a 

Ti 更 村 ta torrmsts 

| Suppeorts arvy fle type 
GE New| 
| Executable rstarthagelsRaduired 
ApP settirngs 


Enecutable 


Enitry paint 
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Content URIs 选项 卡 允 许 在 应 用 程序 中 进行 深度 链接 。 在 这 里 ， 可 以 指定 在 应 用 程序 中 打开 页 和 面 的 URL。 
最 后 ， 使 用 Packaging 选项 卡 ， 可 以 配置 包 名 、 版 本 和 关于 发 布 者 的 信息 。 


本 书 中 讨论 了 一 些 功 能 和 声明 。 请 阅读 第 36 章 ， 获 得 有 关 此 类 功能 的 更 多 信息 。 


33.1.4 ”应 用 程序 启动 


应 用 程序 的 入 口 点 HelloWindows.App 在 应 用 程序 清单 中 定义 ， 如 前 一 节 所 示 。App 类 派生 目 Application 
基 类 ， 包 含 处 理 Suspending 事件 的 实现 代码 (代码 文件 HelloWindows/App.xam.cs): 
sealed partial class App : Application 
| public App() 
{ 


this.InitializeComponent () ; 
this.Suspending += OnSsSuspending; 


} 
Fs 
OnLaunched 方法 被 重 写 。 当 用 户 局 动 应 用 程序 时 ,将 调用 此 方法 。 如 应 用 程序 清单 所 述 ， 局 动 应 用 程序 有 
不 同 的 方式 。 应 用 程序 可 以 直接 由 用 户 局 动 ， 也 可 以 在 用 尸 从 男 一 个 应 用 程序 共计 数据 时 局 动 。 对 于 此 类 场景 ， 
可 以 重 写 不 同 的 激活 方法 。 
当 用 户 启动 应 用 程序 时 ， 也 存在 不 同 的 场景 。 可 以 重新 启动 应 用 程序 ， 或 者 ， 如 果 应 用 程序 以 前 被 挂 起 ， 
则 可 以 重新 启动 。 当 应 用 程序 启动 时 ,没有 当前 的 Frame， 就 会 创建 一 个 新 的 Frame。Frame 可 以 用 于 页 面 之 间 
的 导航 。 页 面包 含 UI 控 件 ,Frame 提供 页 面 之 间 的 导航 。 实 例 化 Frame 后 ,通过 将 Navigate 方法 调用 到 MainPage， 
进行 导航 (代码 文件 HelloWindows/App.xaml.cs): 
protected override void OnLaunched (LaunchActivatedEventArgs e) 
| Frame rootFrame = Window.Current.Content as Frame; 
if (rootFrame == null) 
{ 
rootFrame = new FEIame() : 
rootFrame .NavigationFailed += OnNavigationFailed; 
if (e.PrevyviousExecutlionstate == ApplicationExecutionSstate.Terminated) 


/TODO: Load state from previously suspended application 


} 
Window.Current.Content = rootFrame; 
} 
if (e.PrelaunchActivated == false) 
{ 
if 【FootETrame Content == null) 
{ 
rootFrame .Navigate (typecf (MainPage) ， e.Arguments).; 
} 
Window.Current .Activatel().; 
} 
} 


33.1.5 主页 


下 面向 MainPage 添加 一 个 珊 有 消息 的 按钮 .用 户 界 面 使 用 XAML((eXtensible Application Markup Language， 
可 扩展 应 用 程序 标记 语言 ) 定 义 ， 这 是 一 种 用 某 些 功能 扩展 XML 的 语言 。 对 于 按钮 控件 , Content 设置 为 显示 一 
个 简单 的 字符 串 , Click 事件 分 配给 OnButtonClicked 事件 处 理 程序 , 属性 HorizontalAlignment、VerticalAlignment 
和 Margin 用 来 使 按钮 占 满 网 格 中 除 按钮 页 边 距 之 外 的 全 部 空间 (代码 文件 HelloWindows/MainPage.xaml): 
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<Grid Background="{ThemeResource ApplicationPrageBackgroundThemeBrush}"> 
<Button 
Content="Hello, Windows!™" 
Click="OnNnButtonClicked"™ 
HorizontalAlignment="Stretch" 
VerticalAlianment="Stretch" 
Margin="20"™ /> 
</Grid> 


在 代码 隐藏 文件 中 ，MessageDialog 使 用 OnButtonClicked 事件 处 理 程 序 显示 。 为 了 不 阻塞 用 户 界 面 ， 
ShowAsync 方法 只 能 作为 异步 方法 使 用 。 

private asvyne vold OnBUtLLOC1LICkeaG (object sender, RoutedEventArgs e) 

{ 


await new MessageDialog("Hello, Windows!") .Showhsync().; 
} 


构建 、 部 署 和 运行 应 用 程序 时 ， 用 户 界 面 如 图 33-5 所 示 。Windows 应 用 程序 不 仅 需要 在 运行 之 前 构建 ， 还 
需要 部 署 。 在 Configuration Manager (Build | Configuration Manager) (参见 图 33-6) 中 设置 Deploy 配置 时 ， 就 可 以 
在 Visual Studio 构建 时 自动 完成 部 置 。 如 果 在 构建 时 没有 部 羞 应 用 程序 ， 束 需要 在 构建 后 部 署 它 ， 方 法 是 在 
Solution Explorer 中 选择 项 目 ， 在 上 下 文 菜 单 中 使 用 Deploy 选项 ;或 者 可 以 选择 Build | Deploy Solution， 使 用 
Visual Studio 部 署 解决 方案 中 的 所 有 项 目 。 


| 


Hello, Windows! 


Hello, Windows! 


图 33-5 


Configuration Mlanager 

Actve solution configurathon: Bctne solution plattorm 
Debug -6 

Project contexts (check the project configurations to build or deploy): 
Project Configuration Platform 


HelloWindows Debug “| 6 


图 33-6 
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33.2 和 XAIML 


用 ASPNET Core 编写 Web 应 用 程序 时 ， 除 了 需要 知道 C# 之 外 ， 还 需要 了 解 HTML、CSS 和 JavaScript。 
创建 Windows 应 用 程序 时 ， 除 了 C# 之 外 ， 还 需要 了 解 XAML。XAML 不 仅 用 于 创建 Windows 应 用 程序 ， 还 用 
于 Windows Presentation Foundation (WPF)、Windows Workflow Foundation (WF) 和 Xamarin 的 跨 平 台 应 用 程序 。 

可 以 用 XAML 完成 的 工作 都 可 以 用 C# 实 现 ， 每 个 XAML 元 素 都 用 一 个 类 表示 ， 因 此 可 以 从 C# 中 访问 。 
那么 ， 为 什么 还 需要 XAML? XAML 通 音 用 于 摘 述 对 象 及 其 属性 ， 可 以 描述 很 深 的 层次 结构 。 例 如 ，Page 包 
含 一 个 Grid 控件 ，Grid 控件 包含 一 个 StackPanel 和 其 他 控件 ，StackPanel 包含 按钮 和 文本 框 控件 。XAML 便于 

XAML 人 允许 以 声明 的 方式 编写 代码 ， 而 C# 主 要 是 一 种 命令 式 编程 语言 。XAML 支持 声明 式 定 义 。 在 命令 
式 编 程 语言 (如 C 胡 中， 用 C# 代 码 定义 一 个 for 循环 ， 编 译 器 就 使 用 中 间 语 言 GD) 代 码 创 建 一 个 for 循环 。 在 声明 
性 编程 语言 中 ， 声 明 应 该 做 什么 ， 而 不 是 如 何 完 成 。 


注意 : 
虽然 C# 不 是 纯粹 的 命令 式 编程 语言 , 但 使 用 LINQ 时 , 也 是 在 以 声明 方式 编写 语法 。Entity Framework Core 
(EF Core) 的 LINQ 提供 程序 将 LINQ 查询 转换 为 SQL 语句 。 参 见 第 26 章 。 


XAML 是 一 个 XML 语法 , 但 它 定义 了 XML 的 几 个 增强 特性 。XAML 仍然 是 有 效 的 XML, 但 是 一 些 增 强 
特性 有 特殊 的 意义 和 特殊 的 功能 ， 例 如 ， 在 XML 特性 中 使 用 花 括 号 ， 对 于 XML， 这 仍然 只 是 一 个 字符 串 ， 因 
此 是 有 效 的 XML。 对 于 XAML， 这 是 一 个 标记 扩展 。 
在 有 效 使 用 XAML 之 前 ， 需 要 了 解 这 门 语言 的 一 些 重要 特性 。 本 章 介 绍 了 如 下 XAML 特性 : 
e 依赖 属性 : 从 外 部 看 起 来 ， 依 赖 属 性 像 正常 属性 。 然 而 ， 它 们 需要 更 少 的 存储 空间 ， 实 现 了 变更 通知 。 
e 路 由 事件 : 从 外 部 看 起 来 ， 路 由 事件 像 正 常 的 NET 事件 。 然 而 ， 通 过 添加 和 删除 访问 器 来 使 用 自 定义 
事件 实现 方式 ， 就 允许 冒 泡 和 隧道 。 事 件 从 外 部 控件 进入 内 部 控件 称 为 隧道 ， 从 内 部 控件 进入 外 部 控 
件 称 为 冒 泡 。 

e 附加 属性 : 通过 附加 属性 ， 可 以 给 其 他 控件 添加 属性 。 例 如 ， 按 钮 控件 没有 属性 用 于 把 它 自己 定位 在 
Grid 控件 的 特定 行 和 列 上 。 在 XAML 中 ， 看 起 来 有 这 样 一 个 属性 。 

e 标记 扩展 : 编写 XML 特性 需要 的 编码 比 编写 XML 元 素 少 。 然而 , XML 特性 只 能 是 字符 串 ; 使 用 XML 
元 素 可 以 编写 更 强大 的 语法 。 为 了 减少 需要 编写 的 代码 量 ， 标 记 扩 展 允 许 在 特性 中 编写 强大 的 语法 。 


注意 : 
NET 属性 参见 第 3 章 。 事 件 ， 和 包括 通过 添加 和 删除 访问 器 编写 自 定义 事件 ， 详 见 第 8 章 。XML 的 功能 参 
见 网 上 附加 第 2 章 。 


33.2.1 XAML 标准 


WPF、UWP 和 Xamarin 对 XAML 元 素 使 用 (部 分 仍然 使 用 ) 不 同 的 语法 。 例 如 ， 对 于 WPF 和 UWP， 按 钮 
有 Content 属性 ， 而 Xamarin 的 按钮 有 Text 属性 。 在 WPF 和 UWP 中 ， 可 以 使 用 StackPanel 来 排列 多 个 元 素 。 
在 Xamarin 中 ， 类 似 的 控件 是 StackLayout。 

为 了 更 容易 地 在 不 同 的 UI 技术 堆栈 之 间 切 换 ， 定义 了 XAML 标准 。 有 关 标 准 的 实际 状态 ， 请 参见 
https://eithub.com/Microsoft/xaml-standard/。 


33.2.2 ”将 元 素 映 射 到 类 


在 每 个 XAML 元 素 的 后 面 都 有 一 个 具有 属性 、 方法 和 事件 的 类 。 如 前 所 述 , 可 以 使 用 C# 码 或 使 用 XAML 
创建 UI 元 素 。 下 面 看 一 个 例子 。 使 用 以 下 代码 片段 ， 定 义 了 一 个 包含 按钮 控件 的 StackPanel。 使 用 XML 特性 ， 


按钮 分 配 了 Content 属性 和 Click 事件 。Content 属性 只 包含 一 个 简单 的 字符 串 ， 而 Click 事件 引用 了 方法 
OnButtonClick 的 地 址 。 XML 特性 x:Name 用 于 同 按 钮 控件 声明 一 个 名 称 , 该 名 称 可 以 在 XAML 和 C# 代 码 隐藏 
文件 中 使 用 (代码 文件 XAMLIntro/MainPage.xaml): 
<StackPanel x:Name="stackPanell™> 
<Button Content="Click Me!™ x:Name="buttonil™" Click="OnButtonClick"™" /> 


lh 
</StackPanel> 


在 页 面 项 部 ， 可 以 看 到 带 有 XML 特性 x:Class 的 Page 元 素 。 这 定义 了 类 的 名 称 ， 在 该 类 中 ，XAML 编译 
圳 生成 了 部 分 代码 。 使 用 Visual Stmdio 中 的 代码 隐藏 文件 ， 可 以 看 到 这 个 类 中 能 修改 的 部 分 (代码 文件 
XAMLIntro/MainPage.xam!l): 

<Padge 


:Class="XAMLINtro .MainPage" 
<1-- ... -> 


代码 隐藏 文件 包含 类 MainPage 的 一 部 分 (XAML 编译 器 没有 生成 这 个 部 分 )。 在 构造 函数 中 ， 调 用 方法 
InitializeComponent。 InitializeComponent 的 实现 是 由 XAML 编译 器 创建 的 。 该 方法 加 载 XAML 文件 ， 并 将 其 
转换 为 XAML 文件 中 的 根 元 素 指定 的 对 象 。OnButtonClick 方法 是 之 前 在 XAML 代码 中 创建 的 按钮 的 Click 事 
件 处 理 程 序 。 这 个 实现 打开 了 一 个 MessageDialog( 代 人 码 文 件 XAMLIntro/MainPage.xam.cs): 

public sealed partial class Mainpage : Page 

| Bie Mainpage () 


this.InitializeComponent () ; 


} 
private async vold OnButtonClick (object sender, RoutedEventArgs e) 


await new MessageDialog ("button 1 clicked"™".) .ShowAsync (); 
} 
} 


现在 ， 在 C# 代 码 的 Button 类 中 创建 一 个 新 对 象 ， 并 将 其 添加 到 现 有 的 StackPanel 中 。 在 下 面 的 代码 片段 
中 ， 修 改 了 MainPage 的 构造 函数 ， 以 创建 一 个 新 按钮 ， 设 置 Content 属性 ， 并 为 Click 事件 分 配 一 个 Lambda 
表达 式 。 最 后 ， 新 创建 的 按钮 添加 到 StackPanel 的 Children 中 (代码 文件 XAMLIntro/mainpage.xaml.cs): 

public MainPage () 

{ 


this.InitializeComponent(); 
Var button2 = new Button 


Content = "created dynamically" 
上 7 
button2 .C1Lick += asyne (sender, e) => 
await new MessageDialog ("button 2 clicked") .ShowAsync(); 
stackPanell .Children.Add (button2).; 
} 


如 前 所 述 ，XAML 只 是 处 理 对 象 、 属 性 和 事件 的 另 一 种 方式 。 下 一 节 将 展示 XAML 在 用 户 界 面 上 的 优势 。 
33.23 通过 XAML 使 用 定制 的 .NET 类 


要 在 XAML 代码 中 使 用 上 自 定 义 的 .NET 类 ， 可 以 使 用 简单 的 POCO 类 ， 对 类 定义 没有 特殊 要 求 。 只 需要 
将 .NET 名 称 空 间 添加 到 XXAML 声明 中 。 为 了 演示 这 一 点 ,下面 设计 一 个 具有 FirstName 和 LastName 属性 的 简 
单 Person 类 (代码 文件 DataLib/Person.cs): 
public class Person 
public string FirstName { get; set; } 
public string LastName { get; set; |} 


public override string ToString() => $"{FirstName} {LastName}"™; 
} 


在 XAML 中 定义 了 一 个 名 为 datalib 的 XML 名 称 空间 别名 ， 它 映射 到 程序 集 DataLib 中 的 .NET 名 称 空间 
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DataLib。 有 了 这 个 别名 ， 现 在 就 可 以 把 别名 作为 元 素 的 前 级 ， 来 使 用 这 个 名 称 空间 中 的 所 有 类 。 
在 XAML 代码 中 添加 一 个 列表 框 ， 其 中 包含 Person 类 型 的 项 。 使 用 XAML 特性 , 可 以 设置 属性 FirstName 
和 LastName 的 值 .运行 应 用 程序 时 ,ToString 方法 的 输出 显示 在 列表 框 中 (代码 文件 XAMLIntro/MainPage.xaml): 


<Page XxX:Class="XamlIntro.MainPage"™ 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"™ 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml™" 
xmlns:local="using:XAMLINtro" 
mlns:datalib="using:DataLib" 
xmlns:d="http://schemas .microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas .openxmlformats .org/markup—-compatibility/2006" 
mc:Ignorable="d"»> 
<StackPanel xX:Name="stackPanell™ > 
<Button Content="Click Me!™" x:Name="buttonl™. Click="OnButtonClick"> 
<L1isStBoOx> 
<datalib:Person FirstName="Stephanie" LastName="Nagel" /> 
<datalib:Person FirstName="Matthias" LastName="Nagel" /> 
<datalib: Person FirstName="Katharina" LastName="Nagel" /> 
</ListBox> 
</StackPanel> 
</Window> 


注意 : 
WPF 和 Xamarin 在 别名 声明 中 使 用 clr-namespace 而 不 是 使 用 using。 原 因 是 ,使 用 UWP 的 XAML 既 不 基 
于 NET， 也 不 局 限于 NET。 可 以 使 用 本 机 C+H 和 XAML， 因 此 clr( 公 共 语 言 运行 库 ) 就 不 适合 了 。 


33.2.4 ”将 属性 用 作 特 性 


在 前 面 的 XAML 示例 中 ， 类 的 属性 用 XML 特性 来 设置 。 要 在 XAML 中 设置 属性 ， 只 要 属性 的 类 型 可 以 
表示 为 字符 串 ， 或 者 可 以 把 字符 串 转 换 为 属性 类 型 ， 就 可 以 把 属性 设置 为 特性 。 下 面 的 代码 片段 用 XML 特性 
设置 了 Button 元 素 的 Content 和 Backeround 属性 。 


<Button Content="Click Me!™" Background="LightGoldenrodYellow" /> 
在 上 面 的 代码 片段 中 , 因为 Content 属性 的 类 型 是 object， 所 以 可 以 接受 字符 串 。Background 属性 的 类 型 是 
Brush， 字 符 串 转换 为 派生 和 目 Brush 的 SolidColorBrush 类 型 。 


33.2.5 ”将 属性 用 作 元 素 


总 是 可 以 使 用 元 素 语法 给 属性 提供 值 .Button 类 的 Backeround 属性 可 以 用 子 元 素 Button. Background 设置 。 
下 面 的 代码 用 特性 定义 了 Button， 效 果 是 相同 的 : 


<Button»> 
Click Mel! 
<Button .Background> 
<SolidColorBrush Color="LightGoldenrodYellow" /> 
</Button .Background> 
</Button> 


使 用 元 素 代替 特性 ， 可 以 把 比较 复杂 的 画笔 应 用 于 Background 属性 (如 LinearGradientBrush)， 如 下 面 的 示 
例 所 示 ( 代 码 文件 XAMLIntro/MainWindow.xaml)。 


<Button x:Name="buttonl™" Click="OnButtonClick"™"> 
Click Me! 
<Button.Background> 
<LinearGradientBrush StartPoint="0.5,0.0"™ EndPoint="0.5, 1.0"> 
<GradientSstop Offset="0" Color="Yellow" /> 
<Gradientstop Offset="0.3" Color="Orange" /> 
<Gradientstop Offset="0.7" Color="Red™ /> 
<Gradientstop Offset="1" Color="DarkRed™ /> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 
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注意 : 

当 设 置 示例 中 的 内 容 时 ，Content 特性 和 Button.Content 元 素 都 不 用 于 编写 内 容 ; 相反 ， 内 容 会 直接 写 入 为 
Button 元 素 的 子 元 素 值 。 这 是 因为 在 Button 类 的 基 类 ContentControl 中 ，ContentProperty 特性 通过 
[ContentProperty("Content")| 应 用 。 这 个 特性 把 Content 属性 标记 为 ContentProperty。 这 样 ，XAML 元 素 的 直接 
子 元 素 就 应 用 于 Content 属性 。 


33.2.6 ”依赖 属性 


XAML 使 用 依赖 属性 完成 数据 绑 定 、 动 画 、 属 性 变更 通知 、 样 式 化 等 。 依 赖 属性 存在 的 原因 是 什么 ? 假设 
创建 一 个 类 ， 它 有 100 个 int 型 的 属性 ， 这 个 类 在 一 个 表单 上 实例 化 了 100 次 。 需 要 多 少 内 存 ? 因为 int 的 大 小 
是 4 个 字 节 ， 所 以 结果 是 4X100X100 = 40 000 字 节 。 刚 才 看 到 的 是 一 个 XAML 元 素 的 属性 ?由 于 继承 层次 
结构 非常 大 ， 一 个 XAML 元 素 定义 了 数 以 百 计 的 属性 。 属 性 类 型 不 是 简单 的 int， 而 是 更 复杂 的 类 型 。 这 样 的 
属性 会 消耗 大 量 的 内 存 。 然 而 ， 通 贡 只 改变 其 中 一 些 属 性 的 值 ， 大 部 分 的 属性 保持 对 所 有 实例 都 相同 的 默认 值 。 
这 个 难题 可 以 用 依赖 属性 解决 。 使 用 依赖 属性 ， 对 象 内 存 不 是 分 配给 每 个 属性 和 实例 。 依 赖 属 性 系统 管理 一 个 
包含 所 有 属性 的 字典 ， 只 有 值 发 生 了 改变 才 分 配 内 存 。 否 则 ， 默 认 值 就 在 所 有 实例 之 间 共 享 。 

依赖 属性 也 内 置 了 对 变更 通知 的 支持 。 对 于 普通 属性 ， 需 要 为 变更 通知 实现 INotifyProperty Changed 接口 。 
其 方式 参见 本 章 的 “数据 绑 定 ”一 节 。 这 种 变更 机 制 是 通过 依赖 属性 内 置 的 。 对 于 数据 绑 定 ， 绑 定 到 NET 属性 
源 上 的 UI 元 素 的 属性 必须 是 依赖 属性 。 现 在 ， 详 细 讨 论 依赖 属性 。 

从 外 部 来 看 ， 依 赖 属性 像 是 正常 的 .NET 属性 。 但 是 ， 正 向 的 .NET 属性 通常 还 定义 了 由 该 属性 的 get 和 set 
访问 器 访问 的 数据 成 员 。 

private int value; 

Public int Value 

get => value; 


号 已 七 => value 一 Value; 


} 

依赖 属性 不 是 这 样 。 依 赖 属性 通 渭 也 有 get 和 set 访问 器 。 它 们 与 普通 属性 是 相同 的 。 但 在 get 和 set 访问 
器 的 实现 代码 中 ， 调 用 了 Getvalue0 和 Setvalue0 方 法 。GetvValue0 和 SetValue0 方 法 是 其 类 DependencyObject 的 
成 员 ， 依 赖 对 象 需要 使 用 这 个 类 一 它们 必须 在 DependencyObject 的 派生 类 中 实现 。 

有 了 依赖 属性 ， 数 据 成 员 就 放 在 由 基 类 管理 的 内 部 集合 中 ， 仪 在 值 发 生变 化 时 分 配 数据 。 对 于 没有 变化 
的 值 ， 数 据 可 以 在 不 同 的 实例 或 基 类 之 间 共 享 。GetValue0 和 SetValue0 方 法 需要 一 个 DependencyProperty 参数 。 
这 个 参数 由 类 的 一 个 静态 成 员 定义 ， 该 静态 成 员 与 属性 同名 ， 并 在 该 属性 名 的 后 面 奶 加 Property 术语 。 对 于 Value 
属性 ,静态 成 员 的 名 称 是 ValueProperty。DependencyPropertyRegister0 是 一 个 辅助 方法 ， 可 在 依赖 属性 系统 中 注册 
属性 。 在 下 面 的 代码 片段 中 ， 使 用 Register0 方 法 和 4 个 参数 定义 了 属性 名 、 属 性 的 类 型 和 拥有 者 的 类 型 ( 即 
MyDependencyObject 类 )， 使 用 PropertyMetadata 指定 了 默认 值 ( 代 码 文 件 DependencyObjectSample/ 
MyDependencyObject.cs)。 

public class MyDependencyObject: DependencyObject 

public int Value 

get => (int)GetValue (ValueProperty); 


set => SetvVvalue (YalueProperty, Vvalue}),; 

} 

public static readonly DependencyProperty ValueProperty = 
DependencyProperty.Register("Vvalue", typeof (int), 


typeof (MyDependencyObject), new PropertyMetadata (0)); 
} 


33.2.7 ”创建 依赖 属性 
下 面 的 示例 定义 的 不 是 一 个 依赖 属性 ， 而 是 3 个 依赖 属性 。MyDependencyObject 类 定义 了 依赖 属性 Value、 
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Minimum 和 Maxinmmm。 所 有 这 些 属性 都 是 用 DependencyProperty.Register0 方 法 注册 的 依赖 属性 。GetValue0O 和 
SetValue0 方 法 是 基 类 DependencyObject 的 成 员 。 对 于 Minimum 和 Maximum 属性 ， 定 义 了 默认 值 ， 用 
DependencyPropertyRegister0 方 法 设置 该 默认 值 时 ， 可 以 把 第 4 个 参数 设置 为 PropertyMetadata。 使 用 带 一 个 参 
数 PropertyMetadata 的 构造 函数 ， 把 Minimum 属性 设置 为 0， 把 Maximum 属性 设置 为 100( 代 码 文件 
DependencyObjectSample/MyDependencyOblject.cs)。 


Public class MyDependencyObject: DependencyObject 
{ 


Public int Value 
{ 
get => (Int)GetValue (ValueProperty); 
set => SetValue (ValueProperty, value}); 
} 


public static readonly DependencyProperty ValueProperty = 
DependencyProperty.Reglster (nameof (Value), typeof (int)}), 
typeof (MyDependencyObject) ) ; 


Public int Minimum 
{ 
get => (int)GetValue (MinimumpProperty); 
set => SetValue (MinimumProperty, value),;} 
} 


Public static readonly DependencyProperty MinimumProperty = 
DependencyProperty.Reglster (nameof (Minimum), typeof (Int) ， 
typeof (MyDependencyObject), new PropertyMetadata (0})); 


Public int Maximum 
{ 
get => (int)GetValue (MaximumProperty); 
set => SetValue (MaximumProperty, value); 
} 


Public static readonly DependencyProperty MaximumProperty = 
DependencyProperty.Reglster (nameof (Maximum), typeof (1Int) ， 
typeof (MyDependencyObject), new PropertyMetadata (100)); 


注意 : 

在 get 和 set 属性 访问 器 的 实现 代码 中 ， 只 能 调用 GetValue0 和 SetValue0 方 法 。 使 用 依赖 属性 ， 可 以 通过 
GetValue0 和 SetValue0 方 法 从 外 部 访问 属性 的 值 ，UWP 也 是 这 样 做 的 ; 因此 ， 强 类 型 化 的 属性 访问 器 可 能 根 
本 就 不 会 被 调用 ， 包 含 它们 仅 为 了 方便 在 自 定义 代码 中 使 用 正常 的 属性 语法 。 


33.2.8 值 变更 回调 和 事件 


为 了 获得 值 变 更 的 信息 ， 依 赖 属性 还 文 持 值 变更 回调 。 在 属性 值 及 生变 化 时 调用 的 Dependency- 
PropertyRegister0) 方 法 中 ， 可 以 添加 一 个 DependencyPropertyChanged 事件 处 理 程 序 。 在 示例 代码 中 ， 把 
OnvalueChanged0O 处 理 程序 方法 赋予 PropertyMetadata 对 象 的 PropertyChangedCallback 属性 .在 OnValueChanged0) 
方法 中 ， 可 以 用 DependencyPropertyChangedEventAregs0 参数 访问 属性 的 新 旧 值 (代码 文件 
DependencyObjectSample/MyDependencyOblject.cs)。 


Public class MyDependencyObject: DependencyObject 


| 


Public int Value 

{ 
get => (int)GetValue (ValueProperty); 
号 已 七 “一 > SetValue (ValueProperty, value}); 


} 


Public static readonly DependencyProperty ValueProperty = 

DependencyProperty.Reglster (nameof (Value), typeof (Int) ， 
typeof (MyDependencyObject), 

new PropertyMetadata (0, OnValueChanged, CoerceValue)); 


Private static veoid OnValueChanged (DependencyObject obj, 
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DependencvyPropertyChangedEventArgs ee) 
{ 
int oldValue = (int})e.O0ldValue; 
int newValue = (int)e.NewValue,; 
jh: 
} 
} 


33.2.9 ”路 由 事件 


第 8 章 介绍 了 .NET 事件 模型 。 使 用 默认 实现 的 事件 ， 当 触发 事件 时 ， 将 调用 直接 连接 到 事件 的 处 理 程序 。 
使 用 UI 技术 时 ， 对 事件 处 理 有 不 同 的 需求 。 在 一 些 事件 中 ， 应 该 可 以 创建 一 个 带 有 容器 控件 的 处 理 程序 ， 并 
对 来 目 子 控件 的 事件 做 出 反应 。 这 可 以 通过 为 .NET 事件 创建 自 定 义 实现 代码 来 实现 , 如 第 8 章 的 add 和 remove 
访问 器 所 示 。 

UWP 提供 了 路 由 事件 。 示 例 应 用 程序 定义 的 用 户 界 面包 含 一 个 复 选 框 ， 如 果 选 中 它 ， 就 停止 路 由 ; 一 个 按 
钮 控件 ， 其 Tapped 事件 设置 为 OnTappedButton 处 理 程序 方法 ; 一 个 网 格 ， 其 Tapped 事件 设置 为 OnTappedGrid 
处 理 程 序 。Tapped 事件 是 Universal Windows 应 用 程序 的 一 个 路 由 事件 。 这 个 事件 可 以 用 鼠标 、 触 挽 屏 和 笔 设 
备 触发 (代码 文件 RoutedEvents/MainPage.xaml): 


OIid Tapped="OnTappedGrid"> 
<Grid.RowDefinitions> 
<RowDefinition Height="auto™" /> 
<RowDefinition Height="auto™ /> 
<RowDefinition /> 
</Grid.RowDefinitions> 
<StackPanel Grid.Row="0" Orientation="Horizontal™> 
<CheckBox xX:Name="CheckstopRouting">Stop Routing</CheckBox> 
<Button Click="OnCleanstatus">Clean Status</Button> 
</sStackPanel> 
<Button Grid.Row="1" Tapped="OnTappedButton">Tap me!</Button> 
<TextBlock Grid.Row="2" Margin="20" x:Name="textStatus"™" /> 
</Grid> 


OnTappedXX 处 理 程序 方法 把 状态 信息 写 入 一 个 TextBlock, 来 显示 处 理 程序 方法 和 事件 初始 源 的 控件 ( 代 
公文 件 RoutedEventsUWP/MainPage.xaml.cs): 


private void OnTappedButton (object sender, TappedRoutedEventArgs e) 
{ 

Showstatus (nameof (OnTappedButton}), e); 

e.Handled = CheckStopRouting.IsCchecked == true; 
} 


private void OnTappedGrid(object sender, TappedRoutedEventArgs e) 
{ 

ShowStatus (nameof (OnTappedGrid), e); 

e.Handled = CheckSstopRouting.Ischecked == true; 
} 


private void ShowSstatus (string status, RoutedEventArgs e) 

{ 
textSstatus.Text 十 = $"{status} {e.0riginalSource.GetType () .Name}™; 
textSstatus .Text += ™\Ir\An™s 


} 
DPIIVate void OnCcleanstatus (object sender, RoutedEventArgs e) 
{ 
textSstatus.Text = string.Empty; 
} 


运行 应 用 程序 ， 在 网 格 内 单 击 按钮 的 外 部 ， 就 会 看 到 处 理 的 OnTappedGrid 事件 ， 并 把 Grid 控件 作为 触发 
事件 的 源 : 

onTappedGrid Grid 

单 击 按钮 的 中 间 ， 会 看 到 事件 被 路 由 。 第 一 个 调用 的 处 理 程序 是 OnTappedButton， 其 后 是 OnTappedGrid: 


onTappedButton TextBlock 
onTappedGrid TextBlock 


同样 有 趣 的 是 ， 事 件 源 不 是 按钮 ， 而 是 TextBlock。 原 因 在 于 ， 这 个 按钮 使 用 TextBlock 设置 样式 ， 来 包含 
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按钮 的 文本 。 如 果 单 击 按钮 内 的 其 他 位 置 ， 还 可 以 看 到 Grid 或 ContentPresenter 是 原始 事件 源 。Grid 和 
ContentPresenter 是 创建 按钮 的 其 他 控件 。 

在 单 击 按钮 之 前 ， 选 中 复 选 框 CheckStopRouting， 可 以 看 到 事件 不 再 路 由 ， 因 为 事件 参数 的 Handled 属性 

onTappedButton TextBlock 

在 事件 的 Microsoft API 文档 内 ， 可 以 在 文档 的 备注 部 分 看 到 事件 类 型 是 否 路 由 。 在 Universal Windows 应 
用 程序 中 ，tapped、drag 和 drop、key up 和 key down、pointer、focus、manipulation 事件 是 路 由 事件 。 


33.2.10 ”附加 属性 


依赖 属性 是 可 用 于 特定 类 型 的 属性 。 而 通过 附加 属性 ， 可 以 为 其 他 类 型 定义 属性 。 一 些 容器 控件 为 其 子 控 
件 定义 了 附加 属性 ; 例如 ,如果 使 用 DockPanel 控件 , 就 可 以 为 其 子 控件 使 用 Dock 属性 。Grid 控件 定义 了 Row 
和 Column 属性 。 
下 面 的 代码 片段 说 明了 附加 属性 在 XAML 中 的 情况 。Button 类 没有 Grid.Dock 属性 ， 但 它 是 从 Grid 控件 
附加 的 。 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition /> 
<RowDefinition /> 
</Grid.RowDefinitions> 
<Button Content="First" Grid.Row="0" Background="Yellow"™ /> 
<Button Content="Second™" Gridad.Row="1" Background="Blue" /> 
</Grid> 


附加 属性 的 定义 与 依赖 属性 非常 类 似 ， 如 下 面 的 示例 所 示 。 定 义 附 加 属性 的 类 必须 派生 目 基 类 
DependencyObject， 并 定义 一 个 普通 的 属性 ， 其 中 get 和 set 访问 器 调用 基 类 的 Getvalue0 和 Setvalue0 方 法 。 这 些 都 
是 类 似 之 处 ,接着 不 调用 DependencyProperty 类 的 Register0 方 法 , 而 是 调用 RegisterAttached0) 方 法 .RegisterAttached0 
方法 注册 一 个 附加 属性 ， 现 在 它 可 用 于 每 个 元 素 ( 代 码 文件 AttachedProperty/MyAttached PropertyProvider.cs)。 


Public class MYRALtLacheadPropertYyPIOVIader: DependencyObject 
{ 
Public static readonly DependencyProperty MySampleProperty = 
DependencyProperty.ReglsterAttached 

"MySample”™., 
typeof (string), 
typeof (MyAttachedPropertyProvider), 
new PropertyMetadata (string.Empty)).; 


Public static void SetMySample (UIElement element, string value) => 
element.SetValue (MySamleProperty, Vvalue); 


public static int GetMyProperty(UIElement element) => 
(string)element.GetValue (MySampleProperty); 
} 


似乎 Grid.Row 属性 只 能 添加 到 Grid 控件 中 的 元 素 。 实 际 上 ， 附 加 属性 可 以 添加 到 任何 元 素 上 。 但 无 法 使 
用 这 个 属性 值 。Grid 控件 能 够 识别 这 个 属性 ， 并 从 其 子 元 素 中 读 取 它 ， 以 安排 其 子 元 素 。 它 不 从 子 元 素 的 子 元 
素 中 读 取 。 


在 XAML 代码 中 ， 附 加 属性 现在 可 以 附加 到 任何 元 素 上 。 第 二 个 Button 控件 button2 为 目 身 附加 了 属性 
MyAttachedPropertyProviderMySample， 其 值 指定 为 42( 代 码 文件 AttachedProperty/MainPage.xaml)。 


<Grid x:Name="gridl"™"> 
<GIrid.RowDefinitions»> 
<RowDefinition Height="Auto"™ /> 
<RowDefinition Height="Auto"™" /> 
<RowDefinition Height="*" /> 
</Grid.RowDefinitions> 
<Button Grid.Row="0" x:Name="buttonl" Content="Button 1" /> 
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Button Grid.Row="l1" x:Name="button2" Content="Button 2" 
local:MyAttachedPropertyProvider .MySample="42" /> 
<ListBox Grid.Row="2" x:Name="listl" /> 
</Grid> 


在 代码 隐藏 中 执行 相同 的 操作 时 ， 必 须 调用 MyAttachedPropertyProvider 类 的 静态 方法 SetMy Property0。 不 能 扩 
展 Button 类 ， 使 其 包含 某 个 属性 。SetProperty0 方 法 获取 一 个 应 由 该 属性 及 其 值 扩 展 的 UIElement 实例 。 在 如 下 的 代 
码 片 段 中 ， 把 该 属性 附加 到 buttonl 中 ， 将 其 值 设 置 为 sample value( 代 码 文件 AttachedProperty/MainPage.xaml.cs)。 


Public MainPage () 

{ 
InitializeComponent(); 
MyAttachedPropertyProvider.SetMySample (buttonl, "sample Value") : 
eh 

} 


为 了 读 取 分 配给 元 素 的 附加 属性 ， 可 以 使 用 VisualTreeHelper 友 代 层次 结构 中 的 每 个 元 素 ， 并 试图 读 取 其 
附加 属性 。VisualTreeHelper 用 于 在 运行 期 间 读 取 元 紊 的 可 见 树 。GetChildrenCount 方法 返回 子 元 系 的 数量 。 为 
了 访问 子 元 素 ， 可 以 使 用 GetChild 方法 ， 通 过 第 二 个 参数 传递 一 个 元 素 的 案 引 ， 该 方法 返回 元 素 。 只 有 当 元 素 
的 类 型 是 FrameworkElement( 或 派生 于 它 )， 且 用 Func 参数 传递 的 谓词 返回 true 时 , 该 方法 的 实现 代码 才 人 返回 元 
束 ( 代 码 文 件 AttachedProperty/MainPage.xaml.cs)。 


private IEnumerable<FrameworkEl]lement> GetChildren (FrameworkElement element, 
Func<FrameworkElement, bool> pred) 
{ 
int childrenCount = VisualTreeHelper .GetChildrenCount (rootElement).; 
for (int i = 0; i < childrenCount; i++) 
{ 
Var child = VisualTreeHelper.GetChild(rootElement, i) as FrameworkElement.; 
if {child != null gt& pred {child)) 
{ 
yield return child; 
} 
} 
} 


GetChildren 方法 现在 在 页 面 的 构造 函数 中 用 于 把 带 有 附加 属性 的 所 有 元 素 添 加 到 ListBox 控件 中 (代码 文件 
AttachedProperty/MainPage.xaml.cs): 
Public MainPage() 
{ 
InitializeComponent () ; 
MyAttachedPropertyProvider.SetMySample (buttonl, "sample Value") ，; 
foreach (var item in Getchildren (gridl, ee => 
MyAttachedPropertyProvider .GetMySample(le) 1= string.Empty)) 
{ 
listl.Items.Addql 
ss"{item.Name}: {MyAttachedPropertyProvider.GetMySample(item) }"); 
} 
} 


运行 应 用 程序 (WPF 或 UWP 应 用 程序 ) 时 ， 会 看 到 列表 框 中 的 两 个 按钮 控件 与 下 述 值 : 


buttonl: sample value 
buttonz2: 42 


注意 : 
本 章 的 “布局 面板 ”一 节 展 示 了 许多 不 同 的 附加 属性 和 许多 容器 控件 ， 如 Canvas、Grid 和 RelativePanel, 


33.2.11 标记 扩展 


通过 标记 扩展 ， 可 以 扩展 XAML 的 元 素 或 特性 语法 。 如 果 XML 特性 包含 花 括 号 ， 就 表示 这 是 标记 扩展 的 
一 个 符号 。 特 性 的 标记 扩展 弟弟 用 作 简 写 记号 ， 而 不 再 使 用 元 素 。 

这 种 标记 扩展 的 示例 是 StaticResourceExtension， 它 可 查找 资源 。 下 面 是 带 有 gradientBrushl 键 的 线性 渐变 
笔 刷 的 资源 (代码 文件 MarkupExtensions/MainPage.xaml): 
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<Padge.Resources> 
<LinearGradientBrush x:Key="gradientBrushl™" startPoint="0.5,0.0" 
EndPoint="0.5, 1.0"> 
<GradientStop Offset="0" Color="Yellow" /> 
<GradientStop Offset="0.3" Color="Orange" /> 
<GradientSstop Offset="0.7" Color="Red" /> 
<Gradientstop Offset="1" Color="DarkRed™ /> 
</LinearGradientBrush> 
</Page .Resources> 


使 用 StaticResourceExtension， 通 过 特性 语法 来 设置 Button 的 Backsground 属性 ， 就 可 以 引用 这 个 资源 。 特 
性 语法 通过 花 括号 和 没有 Extension 后 绥 的 扩展 类 名 来 定义 。 


<Button Content="Test" Background="{StaticResource gradientBrushl}" /> 


Windows 应 用 程序 不 支持 可 用 于 WPF 的 所 有 标记 扩展 , 只 支持 其 中 的 一 些 ,StaticResource 和 ThemeResource 
参见 第 35 章 , 绑 定 标记 扩展 Binding 和 x:Bind 在 本 章 的 “数据 绑 定 ”一 节 讨 论 。 从 Fall Creators Update (Windows 
10 构建 号 16299)] 开 始 ， 也 文 持 目 定 义 标 记 扩 展 的 创建 ， 如 下 所 述 。 


33.2.12 自 定 义 标记 扩展 


目 定义 标记 扩展 允许 在 XAML 代码 的 花 括号 中 添加 目 己 的 特性 。 可 以 创建 上 自 定 义 绑 定 、 基 于 条 件 的 评估 或 
简单 的 计算 器 ， 如 下 一 个 示例 所 示 。 

Calculator 标记 扩展 允许 使 用 加 、 减 、 乘 、 队 操作 计算 两 个 值 。 标 记 扩 展 非常 简单 : 类 名 包含 Extension 后 
级 ， 它 派生 自 基 类 MarkupExtension， 重 写 了 方法 ProvideValue。 使 用 ProvideValue， 标 记 扩 展 返 回 分 配给 属性 
的 值 或 对 象 (在 其 中 定义 了 标记 )。 返 回 值 的 类 型 由 MarkupExtensionRetumType 特性 定义 。 下 面 的 代码 片段 显示 
了 Calculator 标记 扩展 的 实现 。 这 个 扩展 定义 了 可 以 设置 的 三 个 属性 : X、Y 的 属性 ， 以 及 应 用 于 六 和 YY 的 
Operation。Operation 用 一 个 枚 举 来 定义 。 在 ProvideValue 方法 的 实现 中 , 对 X 和 立 应 用 一 个 操作 , 返回 结果 ( 代 
码 文 件 CustomMarkupExtension/CalculatorExtension.cs): 


Public enum OCperation 
{ 

Add, 

Subtract, 

Multiply, 

Divide 


} 


[MarkupExtensionReturnIlype (ReturnIvype = 七 YE (string))] 
Public class CalculatorExtension : MarkupExtension 
{ 

Public double X { get; set; } 

public double Y { get; set; } 

Public Operation Operation { get; set; } 


protected override object ProvideValue () 
{ 
double result = 0.; 
switch (Operation) 
{ 
case Operation.Add: 
result = 其 十 YY; 
break; 
Case Operation.SsSubtract: 
IESUlt = 下 一 YY; 
break; 
case Operation.Multiply: 
result = XR YY; 
break; 
Case Operation.Divide: 
result = X / Y¥:; 
breaks; 
default: 
break; 
} 


return result.ToSsString({(); 
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现在 ，Calculator 标记 扩展 可 以 与 XML 特性 语法 一 起 使 用 。 在 这 里 ， 初 始 化 标记 扩展 ， 以 设置 属性 。 返 回 
的 字符 串 应 用 于 TextBlock 的 Text 属性 (代码 文件 CustomMarkupExtension/MainPage.xam]): 

<TextBlock Text="{flocal:Calculator Operation=Add, X=38, Y=4}" /> 

使 用 标记 扩展 语法 ， 不 使 用 名 称 Extension。 这 个 后 缀 会 自动 应 用 。 当 然 ， 如 果 CalculatorExtension 类 仅仅 
用 于 将 它 实例 化 为 Text 属性 的 子 元 素 ， 并 设置 扩展 的 属性 ， 这 就 是 不 同 的 (代码 文件 CustomMarkupExtension/ 
MainPasge.Xaml): 


<TextBlock> 
<TextBlock. Text>» 
<local:CalculatorExtension Operation="Multiply" X="7" Y="6" /> 
</TextBlock. Text> 
</TextBlock> 


运行 应 用 程序 时 ， 在 所 使 用 的 两 个 操作 中 返回 值 42。 
33.2.13 条件 XAML 


如 果 需 要 支持 Windows 10 的 多 个 构建 版 本 ， 但 是 仍然 使 用 更 新 的 特性 ， 比 如 目 定 义 标 记 扩 展 ， 就 需要 编 
写 目 适应 代码 ， 这 样 ， 在 旧版 本 的 Windows 上 调用 新 API 时 ， 不 会 导致 应 用 程序 骨 沉 。 使 用 目 适 应 代码 时 ， 需 
要 在 调用 API 之 前 验证 它 是 否 可 用 ， 并 为 旧版 本 的 Windows 提供 蔡 代 方法 。 这 样 的 条 件 代 码 也 可 以 用 XAML 
实现 ， 只 要 支持 的 最 小 构建 版 本 号 是 15063。 条 件 XAML 不 支持 旧版 本 。 

条 件 XAML 是 通过 指定 XAML 名 称 空间 来 实现 的 ， 这 些 名 称 空 间 只 能 根据 特定 的 条 件 提供 。 例 如 ， 只 有 
给 Windows.Foundation.UniversalApiContract 传递 版 本 $ 的 ApiContractPresent 返回 tue， 才 能 使 用 名 称 空间 别 
名 contract5。 人 否则 ，XAML 编译 器 会 忽略 这 个 名 称 空间 别名 ， 不 使 用 这 个 别名 创建 元 素 或 特性 。 名 称 空间 之 后 
的 问号 “?” 定 义 了 别名 有 效 的 条 件 (XAML 文件 ConditionalXAML/MainPage.xaml): 

xmlns:contract5= 


"nttp://schemas .microsoft.com/winfx/2006/xaml /presentation? 
IsApiContractPresent (Windows .Foundation.UniversalApiContract, 5)" 


表 33-2 中 的 API 可 以 与 条 件 XAML 一 起 使 用 。 使 用 IsApiContractPresent 方法 ， 可 以 检查 特定 版 本 号 的 特 
定 API 是 否 可 用 。 如 果 指 定 的 控件 类 型 可 用 ， 则 IsTypePresent 返回 tue; 如 果 控 件 的 特定 属性 可 用 ， 则 
IsPropertyPresent 返回 true。 道 方法 也 用 所 有 这 些 方法 来 实现 。 道 方法 返回 反 布 尔 值 。 例 如 ， 如 果 
IsApiContractPresent 返回 tue， 则 方法 ApiContractNotPresent 返回 false。 那 么 ， 为 什么 道 方法 是 必需 的 ， 而 不 
能 仅仅 使 用 C# 的 ! 操 作 符 ? 原因 是 XAML 没有 这 样 的 操作 符 。 


表 33-2 
方 ” 法 逆 方 法 
IsApiContractPresent(contract, version) IsApiContractNotPresent(contract, version) 
IsTypePresent(type) IsTypeNotPresent(type) 
IsPropertyPresent(type, property) IsPropertyNotPresent(type, property) 


现在 ， 名 称 空 间 别 名 可 以 在 http://schemas.microsoft.com/win 仪 /2006/xaml/presentation 名 称 空 间 中 使 用 元 素 
和 特性 ， 例 如 ，TextBlock 的 Text 属性 : 


<TextBlock x:Name=textl1 contract5:Text="contract 5 PIeSentn /> 
使 用 C# 人 代码， 可 以 使 用 名 称 空 间 Windows.Foundation.Metadata 的 ApiInformation 类 中 定义 的 
IsApiContractPresent 方法 来 实现 类 似 的 功能 (代码 文件 ConditionalXAML/MainPage.xaml.cs): 
if (ApiInformation.IsApiContractPresent ( 
"Windows.Foundation.UniversalApiContract", 5)) 


{ 


textl1 .Text = "contract 5 present™; 


} 


第 33 章 Windows 应 用 程序 | 871 


在 XAML 代码 中 ， 不 能 多 次 设置 Text 属性 ， 而 必须 确保 该 属性 只 为 特定 的 版 本 设置 了 一 次 。 否 则 ， 将 得 
到 Text 属性 定义 多 次 的 错误 。 这 就 是 为 什么 定义 了 可 以 用 来 设置 别名 名 称 空间 的 道 方法 。 
可 以 根据 可 用 的 协定 ， 设 置 多 个 名 称 空间 (XAML 文件 ConditionalXAMIVMainPage.xam]): 


xmlns:contracto= 

"nttp://schemas.microsoft.com/winfx/2006/xaml/presentation? 
IsRApiContractPresent (Windows .Foundation.UniversalApiContract, 5)" 

xmlns:notcontract5="http://schemas .microsoft.com/winfx/2006/xaml /presentation? 
IshpiContractNotPresent (Windows.Foundation.UniversalApiContract, 5)" 


现在 使 用 不 同 的 名 称 空间 别名 来 设置 TextBlock 的 Text 属性 。 使 用 这 些 别名 定义 ， 可 以 确保 只 定义 其 中 一 
个 (XAML 文件 ConditionalXAML/MainPage.xaml): 
<TextBlock 
XxX: Name="textl1™ 


contract5: Text="contract 5 present" 
notcontract5:Text="contract 5 not present" /> 


在 哪里 可 以 找到 API 协定 的 名 称 ? 每 个 Windows Runtime API 都 记录 在 https://docs.microsoft.com/uwp/api 
中 ， 引 入 API 时， 文档 列 出 了 API 协定 与 版 本 号 。Windows.Foundation.UniversalApiContract 本 身 就 是 一 个 引用 
其 他 协定 的 参考 协定 。 在 文件 夹 %ProgramFiles(x86)%\Windows Kits\10\References 中 可 以 找到 所 有 协定 。 使 用 
ildasm 工具 可 以 读 取 包含 协定 信息 的 .md 文件 。 


33.3 ”控件 


由 于 Windows 应 用 程序 有 很 多 控件 可 用 ， 因 此 最 好 了 解 控 件 的 层次 结构 和 一 些 特定 基 类 的 UI 类 。 了 解 这 
些 会 更 容易 使 用 UWP 控件 ， 知 道 这 些 类 型 能 做 什么 工作 。 

下 面 讨论 用 于 Windows 应 用 程序 的 UI 类 的 层次 结构 。 

e DependencyObject 一 一 这 个 类 位 于 Windows Runtime XAML 元 素 的 层次 结构 顶部 。 派 生 自 
DependencyObject 的 每 个 类 都 可 以 有 依赖 属性 。 在 本 章 的 XAML 介绍 中 ， 己 经 介绍 了 依赖 属性 。 

e UIElement 一 一 这 是 带 有 视觉 外 观 的 元 素 的 基 类 。 这 个 类 提供 了 用 户 交 互 的 功能 ， 比 如 指针 事件 
(PointerPressed、PointerMoved 等 )， 键 处 理事 件 (KeyDown、KeyUp)， 焦 点 事件 (GotFocus、LostFocus)， 
指针 捕获 (CapturePointer、PointerCanceled 等 )， 拖 放 (DragOver、Drop 等 )。 这 个 类 还 提供 了 新 的 Lights 
属性 ， 从 构建 号 15063 开始 就 可 以 通过 light 高 亮 显示 。 

@ FrameworkElement 一 一 类 FrameworkElement 派生 目 UIElement, 添加 了 更 多 的 特性 .从 FrameworkElement 
派生 的 类 可 以 参与 布局 系统 。 属 性 MinWidth、MinHeight、Height 和 Width 由 FrameworkElement 类 定 
义 。FrameworkElement 也 定义 了 生命 周期 事件 Loaded、SizeChanged、Unloaded 都 是 这 些 事 件 中 的 一 
部 分 。 数 据 绑 定 特性 是 FrameworkElement 类 定义 的 男 一 组 功能 。 这 个 类 定义 了 DataContext、 
DataContextChanged、SetBinding 和 GetBindingExpression API。 

se Control 一 一 Control 类 派生 目 FrameworkElement ， 是 UU 控件 的 基 类 , 例如 TextBox、Hub、DatePicker、 
SearchBox、UserControl 等 。 控 件 通 常 有 一 个 默认 样式 , 其 ControlTemplate 分 配给 Template 属性 .Control 
类 为 基 类 UIElement 定义 的 事件 定义 了 可 重 写 的 On* 方 法 。 控件 定 义 了 TabIndex; 用 于 前 景 、 背 景 和 边 
界 (Foreground、Backeround、BorderBrush、BorderThickness) 的 属性 ， 启用 它 并 使 用 键盘 上 的 Tab 键 来 
访问 它 的 属性 (IsTabStop、TabIndex)。 

e ContentControl 一 一 类 ContentControl 派生 自 Control， 人 允许 将 任何 内 容 作 为 该 控件 的 子 内 容 。 
ContentControl 的 例子 有 AppBar、Frame、ButtonBase、GroupItem 和 ToolTip 控件 。ContentControl 定义 
了 可 以 分 配 任何 内 容 的 Content 属性 、 分 配 DataTemplate 的 ContentTemplate 属性 、 动 态 分 配 数据 模板 
的 ContentTemplateSelector 以 及 用 于 简单 动画 的 ContentTransitions 属性 。 

e ItemsControl 一 一 ContentControl 只 能 有 一 个 内 容 ， 而 ItemsControl 可 以 查看 内 容 列 表 。ContentControl 
定义 了 要 列 出 其 子 项 的 Content 属性 ， 而 ItemsControl 用 Items 属性 实现 了 这 个 功能 。ContentControl 和 
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ItemsControl 都 派生 目 基 类 Control。ItemsControl 可 以 显示 固定 数量 的 项 或 通过 列表 绑 定 的 项 。 派 生 自 
ItemsControl 的 控件 有 ListView、GridView、ListBox、Pivot 和 Selector。 

es Panel 一 一 另 一 个 可 以 作为 项 容器 的 类 是 Panel 类 。 这 个 类 派生 目 基 类 FrameworkElement。Panel 用 于 定 
位 和 排列 子 对 象 。 从 Panel 派生 的 类 的 例子 有 Canvas、Grid、StackPanel、VariableSizedWrapGrid、 
VirtualizngPanel、 ItemsStackPanel、 ItemsWrapGrid 以 及 RelativePanel。 

e RaneeBase 一 一 这 个 类 派生 自 Control 类 ， 是 ProgressBar、ScrollBar 和 Slider 的 基 类 。RangeBase 定义 了 
当前 值 的 Value 属性 、Minimum 和 Maximum 属性 ， 以 及 ValueChanged 事件 处 理 程序 。 

e FlyoutBase 一 一 这 个 类 直接 派生 自 DependencyObiject， 人 允许 在 其 他 元 素 上 显示 用 户 界 面 一 一 换 句 话说 , 它 
们 是 随时 可 弹出 的 。 


注意 : 
控件 模板 详 见 第 35 章 。 


在 浏览 了 主要 类 别 和 类 型 的 层次 结构 之 后 ， 下 面 了 解 细节 。 
33.3.1 框架 派生 的 Ul 元素 


有 些 元 素 不 是 真正 的 控件 ， 但 它们 仍然 是 派生 自 FrameworkElement 的 类 的 UI 元 素 。 这 些 类 不 允许 通过 指 
定 模 板 来 定制 外 观 。UI 元 素 的 类 别 使 用 这 个 基 类 :， 呈现 器 、 媒 体 元 素 和 文本 显示 元 素 ， 如 表 33-3 所 示 。 


表 33-3 
类 说 。 明 

Border 呈现 器 不 是 交互 式 的 类 ， 但 是 他 们 仍然 提供 视觉 外 观 。 

Viewbox Border 类 定义 了 围绕 单个 控件 的 边框 (可 以 是 包含 多 个 其 他 控件 的 Grid)。 

ContentPresenter Viewbox 能 够 拉 伸 和 缩放 子 元 素 。 

ItemsPresenter ContentPresenter 在 ControlTemplate 中 使 用 。 它 定义 控件 的 内 容 将 显示 在 何人 处 。 
ItemsPresenter 用 于 确定 项 在 TtemsControl 中 的 位 置 。 第 35 章 讨 论 了 控件 和 项 模板 

TextBlock TextBlock 和 RichTextBlock 控件 用 于 显示 文本 。 使 用 这 些 控 件 不 能 输入 文本 ; 它们 只 是 用 来 展示 的 。 

RichTextBlock TextBlock 控件 不 仅 允 许 分 配 简 单 的 文本 ， 还 允许 分 配 更 复杂 的 文本 元 素 ， 如 有 段落 和 内 联 元 素 。 
RichTextBlock 也 支持 溢出 ,注意 , RichTextBlock 不 支持 使 用 RTF( 富 文本 文件 )。 此 时 需要 使 用 RichEditBox。 
使 用 这 些 控件 显示 流 文 本 ， 如 第 36 章 所 示 

Ellipse Shape 类 派生 目 FrameworkElement。Shape 本 身 是 Ellipse、Polygon、Polyline、Path、Rectangle 等 的 基 类 . 

Polygon 这 些 类 用 于 将 向 量 绘制 到 屏幕 上 。 这 些 类 参见 第 35 章 

Polyline 

Path 

Rectangle 

Panel Panel 类 派生 目 FrameworkElement。Panel 用 于 组 织 屏幕 上 的 UI 元 素 。 派 生 目 Panel 类 的 不 同 面板 将 在 本 
章 的 “布局 面板 ”一 节 中 讨论 

CaptureElement CaptureElement 类 用 于 呈现 捕获 设备 (如 摄像 机 或 网 络 摄像 机 ) 的 流 。 该 类 在 第 36 章 中 使 用 

InkCanvas InkCanvas 控件 是 用 钢笔 和 墨水 绘制 的 绘图 区 域 。 阅 读 第 36 章 了 解 更 多 关于 使 用 墨水 的 信息 

Image Image 控件 用 于 显示 图 像 。 此 控件 支持 显示 如 下 格式 的 图 像 : PEG、PNG、BMP、GIF、TIFF、JPEG XR、 
ICO 以 及 SVG。 目 Windows 1703 版 本 开始 就 支持 SVG(Scalable Vector Graphics， 可 缩放 矢量 图 形 )， 从 
Windows 1607 版 本 开始 就 支持 GIF 动画 

ParallaxView ParallaxView 是 构建 版 本 16299 中 的 一 个 新 控件 ， 可 在 滚动 时 产生 视差 效果 
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1. 至 现 希 


在 PresentersPage 中 使 用 一 些 呈 现 器 控件 : Border 和 Viewbox 。Border 用 于 对 两 个 TextBox 元 素 分 组 。 因 为 
Border 元 素 只 能 包含 一 个 子 元 素 , 所 以 在 Border 元 素 中 使 用 StackPanel。 Border 指定 了 Background、BorderBrush 
和 BorderThickness。 

在 下 面 的 代码 片段 中 ， 两 个 Viewbox 控件 用 于 拉 伸 Button 控件 。 第 一 个 Viewbox 使 用 Fill 模式 的 延伸 ， 将 
Button 完全 填充 在 Viewbox 中 ， 而 第 二 个 Viewbox 使 用 Uniform 模式 的 延伸 。 对 于 Uniform， 要 保持 纵横 比 ( 代 
码 文 件 ControlsSamples /Views/PresentersPage.xaml): 


<Border Background="LightSsSeaGreen™." BorderBrush="DarkGreen™" BorderThickness="12" 
Margin="12™" Padding="8"> 
<StackPanel] Orientation="Vertical"> 
<TextBox Header="Title™ x:Name="Title™" FontSize="34" /> 
<TextBox Header="Publisher™" x:Name~=~"Publisher™" FontSsize="34" /> 
</StackPanel> 
</Border> 
<Viewbox Grid.Row="1" Stretch="F1il1l1"™" StretchDirection="Both"> 
<Button Margin="4" FontSize="14">Button with fill stretch</Button> 
</Viewbox> 
<Viewbox Grid.Row="2" Stretch="Uniform™" StretchDirection="Both"> 
<Button Margin="4" FontSize="14">Button with uniform stretch</Button> 
</Viewbox> 


图 33-7 显示 了 正在 运行 的 应 用 程序 的 呈现 器 页 面 。 在 这 里 可 以 看 到 TextBox 控件 是 如 何 被 包围 的 ， 按钮 显 
示 在 两 个 不 同 的 Viewbox 配置 中 。 


Conmtiolssyarmples 一 口 沽 


BuUuttonm vvith fill stretch 


Button with uniform stretch 


图 33-7 
注意 : 
控件 派生 的 类 有 一 个 隐 式 边界 ， 可 以 使 用 BorderThickness 和 BorderBrush 属性 来 定制 它 。 
2. 视差 


ParallaxView 提供 了 视差 效应 。 有 了 视差 效应 ， 就 可 以 在 前 景 中 显示 一 个 列表 ， 在 背景 中 显示 一 幅 图 片 。 
背景 中 的 图 片 比 前 景 移动 得 慢 ， 以 获得 立体 效果 ， 这 称 为 视差 效应 。 
示例 应 用 程序 ParallaxViewSample 演示 了 这 种 效果 ， 使 用 滑 块 可 以 增加 或 减少 该 效果 。 
示例 应 用 程序 中 显示 的 是 LunchMenu 对 象 的 一 个 简单 模型 (代码 文件 ParallaxViewSample/Models/LunchMenu.cs): 
public class LunchMenu 
public int MenuId { get; set; ] 
public string Text { get; set; } 


public string ImageUrl { get; set; } 
} 
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ParallaxView 控件 将 Image 定义 为 子 元 素 ， 也 可 以 为 背景 创建 其 他 形状 。ParallaxView 的 Source 属性 绑 定 
到 ListView 控件 。ListView 控件 显示 项 的 列表 ， 并 绑 定 到 LunchMenu 对 象 列 表 上 。 要 使 用 ParallaxView 定义 该 
效果 ， 需 要 设置 HorizontalShif 和 VerticalShif 属性 。 如 源 代码 所 示 ，ListView 垂直 滚动 ， 因 此 下 面 讨论 垂直 移 
动 。 当 VerticalShift 设置 为 0 时 ,没有 视差 效应 。 将 该 值 设置 为 100 意味 看 ，ParallaxView 配置 为 比 ListView 小 
100 像素 ， 因 此 ListView 的 滚动 速度 更 快 。 下 面 的 代码 片段 将 HorizontalShift 和 VerticalShift 属性 绑 定 到 一 个 
Slider， 因 此 可 以 在 应 用 程序 运行 时 配置 该 效果 (代码 文件 ParallaxViewSample/MainPage.xam]): 


<StackPanel Orientation="Vertical™"> 
<Slider xX:Name~="HorizontalSslider™" Header="Horizontal Shift™ Minimum="0" 
Maximum="1000"™ Value="0" /> 
<Slider xX:Name="VerticalSlider™" Header="Vertical Shift"™ Minimum="0" 
Maximum="1000"™" Value="0"™" /> 
</StackPanel> 


<ParallaxView Source="{x:Bind MenuIltems}" Grid.Row="1" 
HorizontalShift="{x:Bind Horizontalslider.Value, Mode=~OneWay}" 
VerticalShift="{x:Bind VerticalSslider.Value, Mode~OneWay} "> 
<Image Source="https://kantineml01 .blob.core.windows.net/menuimages/™ + 
"Hirschragout 1024"> 
</Image> 
</ParallaxView> 


<ListView HorizontalAliagnment="Center™" x:NMame="MenuItems" 
ItemsSource="{X:Bind Menus, Mode~OneWay}™ SelectionMode="None™ Grid.Row="1"> 
<ListVijew.ItemTemplate> 
<DataTemplate x:DataType="model: LunchMenu™"> 
<Grid Margin="12"> 
<Image Width="300"™" Source="{X:Bind ImageUrl, Mode=OneWay}™ /> 
<TextBlock Margin="8" VerticalAlignment="Bottom" 
HorizontalTextAlignment="Center™" Text="{XxX:Bind Text, Mode=OneWay}™" 
style="{StaticResource SubtitleTextBlockstyle}™" FontWeight="Bold"™" /> 
</Grid> 
</DataTemplate> 
</ListView.ItemTemplate> 
</ListView> 


注意 : 
本 章 的 “数据 绑 定 ”一 节 详 细 解释 数据 绑 定 。 
运行 该 应 用 程序 时 ， 可 以 看 到 背景 图 像 和 前 景 以 不 同 的 速度 移动 ， 如 图 33-8 所 示 。 


Furia sri aTip Ls 一 口 


TIE Sh 


要 在 水 平 模式 下 查看 视差 效果 ,可 以 将 ListView 更 改 为 水 平 滚动 。 为 此 ， 可 以 更 改 ListView 的 IemsPanel， 
如 下 面 的 代码 片段 所 示 。 在 可 下 载 的 代码 示例 中 ， 需 要 取消 对 这 个 ListView 配置 的 注释 ， 使 它 成 为 活动 的 ( 代 


第 33 章 Windows 应 用 程序 | 875 


码 文 件 ParallaxViewSample/MainPage.xaml): 


<ListView HorIzOntalalIgnment="Centern XxX:Name="MenuItems"™ 
ItemsSource="{Xx:Bind Menus, Mode~OneWay}" SelectionMode="None" 
ScrollViewer .VerticalScrollBarVisibility="Disabled" 
ScrollViewer .VerticalScrollMode="Disabled" Grid.Row="1" 
ScCrollViewer .HorizontalScrollBarVisibility="auto" 
SCrollViewer.HorizontalscrollMode="Enabled"> 
<ListView.lItemsPanel> 
<ItemsPanelTemplate> 
<ItemsStackPanel Orientation="Horizontal" /> 
</ItemsPanelTemplate> 
</ListView.ItemsPanel> 
<ListView.ItemTemplate> 
<DataTemplate XxX:DataType="model:LunchMenu™"> 
<Grid Margin="12"> 
<Image Width="300"™" Source="{x:Bind ImageUrl, Mode=OneWay}™ /> 
<TextBlock Margin="8"™" VerticalAlignment="Bottom" 
HorizontalTextAliagnment="Center™" Text="{xXx:Bind Text, Mode=OneWay}" 
style="{StaticResource SubtitleTextBlockSstyle}™" FontWeight="Bold”" /> 
</Grid> 
</DataTemplate> 
</ListView.ItemTemplate> 
</ListView> 


图 33-9 显示 了 ParallaxViewSample 的 水 平版 本 。 


ParallaxY bewSampbe 


Honzontal $hiit 


33.3.2 ”控件 派生 的 控件 
直接 从 基 类 Control 派生 的 控件 属于 这 个 类 别 。 表 33-4 描述 了 其 中 的 一 些 控件 。 


表 33-4 
控件 说明 
TextBox 此 控件 用 于 显示 简单 的 、 未 格式 化 的 文本 。 此 控件 可 用 于 用 户 输入 。 Text 属性 包含 用 户 输入 。PlaceholderText 
允许 向 用 户 提供 要 在 输入 字段 中 输入 的 信息 。 通 常 输入 文本 的 一 些 信息 会 显示 在 附近 。 这 可 以 直接 使 用 
ee 与 TextBox 控件 相反 ，RichEditBox 允许 输入 格式 化 的 文本 、 超 链接 和 图 像 。 文 本 对 象 模型 (Text Object 


Model ，TOM) 是 在 Document 属性 中 使 用 的 。 第 36 章 详 细 介 绍 了 如 何 使 用 这 个 控件 。 可 以 使 用 Microsoft 
Word 创建 能 读 入 RichEditBox 的 RTF 文件 
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( 续 表 ) 
控 件 说 明 

PasswordBox 此 控件 用 于 输入 密码 . 它 具 有 密码 输入 的 特定 属性 , 比如 PasswordChar 定义 在 用 户 输入 密码 时 显示 的 字符 。 
可 以 使 用 Password 属性 检索 输入 的 密码 。 此 控件 还 具有 与 TextBox 控件 类 羽 的 Header 和 PlaceholderText 
属性 

ProgressRing 此 控件 指示 操作 正在 进行 。 它 显示 为 一 个 环形 的 “旋转 器 ”。 男 一 个 显示 正在 进行 的 操作 的 控件 是 
ProgressBar， 但 是 这 个 控件 属于 范围 控件 

DatePicker DatePicker 和 CalendarDatePicker 控件 允许 用 户 选择 日 期 。 如 果 用 户 知 道 日 期 ， 则 显示 日 历 是 没有 用 的 ， 就 

CalendarDatePicker | 可 以 使 用 DatePicker 选择 日 期 。 CalendarDatePicker 在 内 部 使 用 Calendarwiew。 如 果 日 历 应 该 一 直 可 见 ， 

CalendarView 或 者 需要 选择 多 个 日 期 ， 就 可 以 使 用 CalendarView。 请 注意 ， 还 有 一 个 DatePickerFlyout( 派 生 目 Flyout 的 
控件 )， 它 允许 用 户 在 新 打开 的 窗口 中 选择 日 期 

TimePicker TimePicker 允许 用 户 输入 时 间 。 类 似 于 DatePicker， 通 过 TimePicker 还 可 以 使 用 TimePickerFlyout 

AppBarSeparator AppBarSeparator 控件 可 以 用 作 CommandBar 中 的 分 隔 符 

ColorPicker ColorPicker 允许 用 户 选 择 颜 色 

Hub Hub 控件 允许 在 平移 视图 中 对 内 容 进行 分 组 。 该 控件 中 的 内 容 是 在 多 个 HubSection 控件 中 定义 的 。Hub 控 

HubSection 件 与 许多 应 用 程序 一 起 使 用 ， 以 “Hero” 图 像 布 局 应 用 程序 的 主 视图 

UserControl UserControl 是 可 以 用 于 重用 的 控件 ， 并 使 用 页 面 简化 XAML 代码 。 用 户 控 件 可 以 添加 到 页 面 中 ， 本 章 和 
下 一 章 使 用 用 户 控件 

Page Page 类 本 身 派 生 自 UserControl， 因 此 它 也 是 UserControl。Page 用 于 在 Frame 中 导航 

PersonPicture PersonPicture 是 16929 构建 版 本 中 的 新 控件 . 它 用 来 显示 一 个 人 的 头像 .此 控件 与 ContactManager 和 Contact 
API 一 起 使 用 

RatingControl RatingControl 是 16929 构建 版 本 中 的 男 一 个 新 控件 。 使 用 此 控件 ， 用 户 可 以 输入 星 级 评分 

SemanticZoom SemanticZoom 控件 定义 了 两 个 视图 : 缩小 视图 和 放大 视图 。 这 人 允许 用 户 快 速 寻 航 到 大 型 数据 集 ， 例 如 ， 在 
缩小 视图 中 只 显示 第 一 个 字符 。 在 放大 视图 中 ， 用 户 用 选 定 的 字母 定位 数据 对 象 

SplitView SplitView 控件 有 一 个 窗 格 和 一 个 内 容 。 窗 格 可 以 打开 和 关闭 。 当 打开 窗 格 时 , 内 容 可 以 部 分 位 于 窗 格 后 面 ， 
也 可 以 向 右 移 动 。 打 开 的 窗 格 可 以 是 小 的 (紧凑 的 ) 或 宽 的 。SplitView 在 新 的 NavigationPane 中 使 用 

1. 使 用 文本 框 


包含 Control 派生 控件 的 第 一 个 示例 显示 了 几 个 TextBox 控件 。 在 TextBox 类 中 , 可 以 将 InputScope 属性 指 
定 为 大 量 值 列 表 中 的 值 ， 如 EmailNameOrAddress、CurencyAmountAndSymbol 或 Formula.。 如 果 应 用 程序 在 平 
板 模 式 下 使 用 ， 并 带 有 屏幕 键盘 ， 键 盘 会 根据 输入 字段 的 需要 调整 不 同 的 布局 并 显示 键 。 示 例 代 码 中 的 最 后 一 
个 文本 框 是 多 行 TextBox。 为 了 让 用 户 按 下 回 车 键 ， 可 以 设置 AcceptsRetum 属性 。 同 时 ， 如 果 文 本 在 一 行 中 放 
不 下 ， 就 设置 TextWrapping 属性 ， 使 文本 换行 。 文 本 框 的 高 度 设置 为 150。 如 果 输 入 的 文本 在 这 个 文本 框 中 放 
不 下 ， 则 使 用 附加 属性 ScrollViewer.VerticalScrollBarVisibility 来 显示 滚动 条 (代码 文件 ControlsSamples/Views/ 
TextPage.xaml): 

<TextBox Header="Email" Inputscope="EmailNameOrAddress"></TextBox> 

<TextBox Header="Currency" InputScope="CurrencyAmountAndSsymbol"></TextBox> 

<TextBox Header="Alpha Numeric"™" InputSscope="AlphanumericFull]Width"></TextBox> 

<TextBox Header="Formula™" InputSscope="Formula"></TextBox> 

<TextBox Header="Month" Inputscope="DateMonthNumber"></TextBox> 


<TextBox Header="Multiline" AcceptsReturn="True™" TextWrapping="Wrap™" 
Height="150" ScrollVviewer.VerticalscrollBarVisibility="Auto™" /> 


如 图 33-10 所 示 为 多 行文 本 框 的 结果 ， 其 中 包含 多 行 和 一 个 滚动 条 。 
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MAultiline 


PIE WUT LAVAWEL TAR IE VE LE lAY MU RAW i 
Umes 
The quick brown fox jumped over the lazy dogs down 12345367890 


times 
The quick brown fox jumped over the lazy dogs down 1244567890 
Umes 


图 33-10 
2. 选择 日 期 


对 于 选择 日 期 ， 可 以 使 用 多 个 选项 。 下 面 看 看 不 同 的 选项 ， 以 及 CalendarView 控件 的 特殊 特性 。 

在 以 下 代码 片段 中 ，CalendarView 配置 为 允许 选择 多 个 日 期 。 每 周 的 第 一 个 工作 日 设置 为 周一 ， 最 小 的 一 
天 设置 为 绑 定 属 性 MinDate， 事 件 CalendarViewDayItemChanging 和 SelectedDatesChanged 分 配给 事件 处 理 程 序 
(代码 文件 DateSelectionSample/MainPage.xam]): 


<CalendarView XxX:Name="CalendarViewl™" Margin="12"™ HorizontalAlignment="Center™ 
SelectionMode="Multiple" 
FirstDayofWeek="Monday™" 
MinDate="{x:Bind MinDate, Mode=OneTime}™" 
CalendarViewDayItemChanging="OnDayItemChanging™" 
SelectedDatesChanged="OnDatesCchanged"™ /> 


在 代码 隐藏 文件 中 ，MinDate 属性 设置 为 一 个 预定 义 的 日 期 。 用 户 不 能 使 用 日 历 提 前 一 天 到 达 ( 代 码 文件 
DateSelectionSample/MainPage.xaml.cs): 


public DateTimeOffset MinDate { get; } = 
DateTime0ffset.Parse("l1/1/1965, new CultureInfo ("en—-US")).; 


在 OnDayItemChanging 事件 处 理 程序 中 ， 应 该 将 某 些 日 期 标记 为 special。 当 天 之 前 的 日 期 应 该 排除 在 选择 
之 外 ， 根 据 实 际 的 预订 情况 ， 当 天 应 该 用 彩 线 标 记 。 

为 了 获得 预订 ， 将 定义 GetBookings 方法 ， 以 返回 示例 数据 。 在 真正 的 应 用 程序 中 ， 可 以 从 Web API 或 数 
据 库 中 获得 数据 。GetBookings 方法 只 返回 从 现在 开始 大 干 天 (2,3,5...) 的 预订 ， 通 过 返回 一 个 元 组 得 到 一 天 内 的 
预订 数量 (1,4,3...) (代码 文件 DateSelectionSample/MainPage.xaml.cs): 


private IEnumerable< (DateTime0Offset day, int bookings)> GetBookings () 
{ 

int[] bookingDays = { 2, 3, 5, 8, 12, 13, 18, 21, 23, 27 }; 

int[] bookingsPerDay = { 1, 4, 3, 6, 4, 5, 1, 3, 1, 1 }; 

for (Int 1 = 0; 1 < 10; 1++) 

{ 

yield return (DateTime0Offset.Now.Date.AddDays (bookingDays [1I]) ， 
bookingsPerDay[i]); 

} 

} 


注意 : 
元 组 和 本 地 函数 参见 第 13 章 。yield 语句 参见 第 12 章 。 


当 显 示 CalendarView 的 项 时 ， 将 调用 OnDayItemChanging 方法 。 每 个 显示 的 日 期 都 调用 此 方法 。 方 法 
OnDayItemChanging 是 使 用 本 地 函数 实现 的 。 该 方法 的 主 块 包含 一 个 switch 语句 ， 基 于 数据 绑 定 阶段 来 进行 切 
换 。CalendarView 控件 支持 多 个 阶段 ， 允 许 在 不 同 的 迭代 中 调整 用 户 界 面 。 第 一 阶段 很 快 ， 在 此 阶段 之 后 ， 己 
经 可 以 同 用 户 显示 一 些 信息 。 接 下 来 的 每 个 阶段 都 是 如 此 。 在 以 后 的 阶段 中 ， 可 以 从 Web API 中 检索 信息 ， 并 
更 新 这 些 信息 。 

在 OnDayItemChanging 的 实现 中 ， 第 一 个 阶段 调用 本 地 图 数 RegisterUpdateCallback 来 注册 对 
OnDayItemChanging 事件 处 理 程序 的 下 一 个 调用 。 在 第 二 阶段 ， 使 用 本 地 函数 SetBlackoutDates 将 日 期 涂 黑 。 
第 三 个 阶段 检索 预订 (代码 文件 DateSelectionSample/MainPage.xaml.cs): 


private volid OnDayItemChanging (CalendarView sender., 
CalendarViewDayItemChangingEventArgs args) 
{ 


switch (args.Phase) 
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Case U0: 
RegisterUpdateCallback (); 
breaks; 

Case 1: 
SetBlackoutDatesi().; 
break:; 

仁 恒 SB 之 : 
SetBookings () ; 
breaks; 

default: 
breaks; 


} 


/i local functions... 


} 


本 地 函数 RegisterUpdateCallback 只 是 调用 CalendarViewDayItemChangingEventArgs 参数 的 RegisterUpdate 
Callback， 传 递 事件 处 理 程 序 方法 ， 因 此 再 次 调用 此 方法 (代码 文件 DateSelectionSample/MainPage.xam.cs): 


private void OnDayItemChanging (CalendarView sender, 
CalendarViewDaylItemChangingEventArgs args) 

{ 
1 --- 
VOid RegisterUpdateCallback() => 

args.RegisterUpdateCcallback (OnDayItemChanging); 

fa 

} 


本 地 函数 SetBlackoutDates 浴 黑 今天 之 前 的 日 期 ， 以 及 所 有 的 星期 六 和 星期 天 。 从 args.Item 属性 返回 的 
CalendarViewDayItem 定义 了 IsBlackout 属性 (代码 文件 DateSelectionSample/MainPage.xam.cs): 


private void OnDayItemChanging (CalendarView sender, 
CalendarViewDayItemChangingEventArgs args) 


{ 
1 5。 
VO1I9 SetBlackoutDates () 
{ 
if (args.Item.Date < DateTimeOffset.Now || args.Item.Date.DayofWeek == 
DayofWeek.Saturday || args.Item.Date.DayofWeek == DayOfWeek.Sunday) 
{ 
args .Ttem.TsBlackout = true; 
} 
RegisterUpdateCallback(); 
} 
//-.--. 
} 


最 后 ，SetBookings 方法 检索 关于 预订 的 信息 。 如 果 在 预订 中 也 发 现 了 接收 日 期 ， 则 会 检查 在 
CalendarViewDayItem 中 找到 的 接收 日 期 。 如 果 是 ， 则 调用 SetDensityColors， 把 红色 或 绿色 的 列表 (取决 于 工作 
日 ) 添 加 到 日 期 项 中 。 最 后 ， 再 次 调用 RegisterUpdateCallback 本 地 函数 ; 否则 ， 只 会 在 第 三 阶段 调用 该 函数 ， 
显示 第 一 天 (代码 文件 DateSelectionSample/MainPage.xamlcs): 


private void OnDayItemChanging (CalendarView sender, 
CalendarViewDayItemChangingEventArgs args) 

{ 
Ea 


VOD1IQ SetBookings () 
{ 
var bookings = GetBookings() .ToList(); 


var booking = bookings.SingleOorDefault( 


b => b.day.Date == aArgs.Item.Date.Date}); 
if (booking.bookings > 0) 
{ 
Var COlOrSs = new List<Color>().: 
for {int 1 = 0; 1 < booking.bookings; 1++) 
{ 
if (args.Item.Date.DayOofWeek == DayOfWeek.Saturday || 
args.Item.Date.DayofWeek == DayofWeek.Sunday) 
{ 
COl1oOIrs.Add (Colors .Red); 
} 


全 ] Se 
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{ 
COloOrs.Add (Colors.Green); 
} 
} 


args.Item.SetDensityColors (colors) ; 
ER (0; 

} 

当 用 户 选择 日 期 时 ， 将 调用 OnDatesChanged 方法 。 在 这 个 方法 中 ， 所 有 选中 的 日 期 都 将 在 
CalendarViewSelectedDatesChangedEventArgs 中 接收 。 选中 的 日 期 写 入 currentDatesSelected 列表 ,取消 选择 的 日 
期 将 再 次 从 列表 中 删除 。 使 用 string.Join， 所 有 选中 的 日 期 都 显示 在 MessageDialog 中 (代码 文件 
DateSelectionSample/MainPage.xaml.cs): 


private List<DateTime0Offset> currentDatesSelected = new List<DateTimeOffset> (); 


private async void OnDatesChanged (CalendarView sender, 
CalendarViewSelectedDatesChangedEventArgs args) 
{ 
currentDatesSelected.AddRange (args .AddedDates):; 
arg3 .RemovedDates.ToList() .ForEach (date 三 > 
currentDatesSelected.Remove (date})}.; 


string selectedDates = string.Join({("™, "™, 
currentDatesSelected.select(d => d.Tostring ("dd"))})); 


awalt new MessageDialog($"dates selected: {selectedDates}") .ShowAsync (); 


} 


运行 这 个 应 用 程序 时 ， 可 以 看 到 日 历 ， 如 图 33-11 所 示 ， 前 几 天 以 及 周 六 / 周 日 都 被 涂 黑 了 ， 而 预订 的 信息 
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图 33-11 


单 击 日 历 的 月 份 时 ， 将 显示 完整 的 年 份 ， 如 图 33-12 所 示 。 单 击 顶部 的 年 份 时 ， 可 以 看 到 一 个 纪元 (参见 图 
33-13)。 所 以 很 容易 选择 很 远 的 日 期 。 


2018 "Sv 2010 - 2019 A 
Feb Mar Apr 2009 2010 2011 2012 
May Jun Jul AU 2013 2014 2015 2016 
Sep Oct Nov Dec 2017 2019 2020 
Jan Feb Mar Apr 2021 2022 2023 2024 


图 33-12 图 33-13 
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当 使 用 CalendarDatePicker 时 ， 没 有 像 CalendarView 那么 多 特性 ， 但 是 它 不 会 占用 屏幕 的 空间 ， 除 非 用 户 
打开 它 来 选择 日 期 。CalendarDatePicker 定义 了 DateChanged 事件 ; 只 能 选择 一 个 日 期 (代码 文件 
DateSelectionSample/MainPage.xaml): 


<CalendarDatePicker x:Name="CalendarDatePickerl™ Grid.Row="O0"™ Grid.Column="1" 
DateCchanged="OnDateChanged™" Margin="12"™" /> 


在 OnDateChanged 事件 处 理 程序 中 ， 会 接收 到 CalendarDatePickerDateChangedEventAres， 它 包含 NewDate 
属性 (代码 文件 DateSelectionSample/MainPage.xaml.cs): 
private async void OnDateChanged (CalendarDatePlicker sender, 
CalendarDatePickerDateChangedEventArgs args) 
{ 
awalt new MessageDialog ($"date changed to {args.NewDate}") .ShowAsync (); 
} 
图 33-14 显示 了 打开 日 历时 的 用 户 界面 。 
DatePicker 的 XAML 代码 非常 相似 。 它 只 是 不 显示 日 历来 选择 日 期 , 而 是 有 一 个 完全 不 同 的 视图 (代码 文件 
DateSelectionSample/MainPage.xaml): 


<DatePicker DateChanged="OnDateChangedl1™" x:Name="DatePickerl™" Grid.Row="1" 
Margin="12" /> 


DatePicker 的 事件 处 理 程序 接收 对 象 和 DatePickerValueChangedEventAres 参数 (代码 文件 
DateSelectionSample/MainPage.xaml): 


private async vold OnDateChangedl] (object sender, 
DatePickerValueChangedEventArgs e) 
{ 
awalit new MessageDialog($"date changed to {e.NewDate}") .ShowAsync(); 
} 


图 33-15 显示 了 打开 时 的 DatePicker。 如 果 用 户 不 查看 日 历 ( 例 如 生日 ) 就 知道 日 期 ， 那 么 深 动 年 份 、 月 份 和 
日 期 要 快 得 多 。 


October 


Nowermber 


Becember 


图 33-14 图 33-15 


选择 日 期 的 最 后 一 个 选项 是 Flyout。Flyout 可 以 与 其 他 控件 一 起 使 用 ,这 里 使 用 一 个 按钮 控件 ,按钮 的 Flyout 
属性 定义 为 使 用 DatePickerFlyout。 


<Button Content="Select a Date™ Grid.Row="1"™ Grid.column="1" Margin="12"> 
<Button .Flyout.» 
<DatePickerFlyout x:Name="DatePickerFlyoutl" DatePicked="OnDatePicked" /> 
</Button .Flyout> 
</Button> 


单 击 按钮 将 打开 弹出 窗口 ， 如 图 33-16 所 示 。 
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33.3.3” 沙 围 控 件 
范围 控件 ( 见 表 33-5)， 如 ScrollBar、ProgressBar 和 Slider 都 派生 自 同 一 个 基 类 RangeBase。 


表 33-5 
控 件 说 明 
ScrollBar ScrollBar 控件 包含 一 个 Thumb， 用 户 可 以 从 Thumb 中 选择 一 个 值 。 例 如 ， 如 果 文 档 在 屏幕 中 放 不 下 ， 就 可 以 使 
用 滚动 条 。 一 些 控 件 包含 滚动 条 ， 如 果 内 容 过 多 ， 就 显示 滚动 条 
ProgressBar | 使 用 ProgressBar 控件 ， 可 以 指示 时 间 较 长 的 操作 的 进度 
Slider 使 用 Slider 控件 ， 用 户 可 以 移动 Thumb， 选 择 一 个 范围 的 值 


1. ProgressBar 

示例 应 用 程序 显示 了 两 个 PogressBar 控件 。 将 第 二 个 控件 的 IsIndeterminate 属性 设置 为 tue。 如 果 不 知 道 一 
个 活动 需要 多 长 时 间 , 最 好 使 用 这 个 属性 。 如 果 想 知道 操作 需要 多 长 时 间 , 可 以 在 ProgressBar 中 设置 当前 状态 值 ， 
而 不 需要 设置 IsIndeterminate 模式 ， 默认 值 为 False( 代 码 文 件 ControlsSamples/Views/Range Controls Page.xaml): 


<ProgressBar x:Name="progressBarl™. Grid.Row="0" Margin="12" /> 
<ProgressBar IsIndeterminate="True" Grid.Row="1" Margin="12"™" /> 


在 加 载 页 面 时 ， 将 调用 ShowProgress 方法 。 这 里 ， 第 一 个 ProgressBar 的 当前 值 是 使 用 DispatcherTimer 设 
置 的 ,将 DispatcherTimer 配置 为 每 秒 触发 一 次 , ProgressBar 的 Value 属性 每 秒 都 递增 (代码 文件 ControlsSamples/ 
Viliews/RanegeControlsPage.xaml.cs): 


private volid ShowProgress () 
{ 
var timer = new DispatcherTimer(); 
timer.Interval = TimeSpan.FromSeconds (1) ; 
Int i = 0; 
timer.Tick += (sender, ee) 一 > 
{ 
progressBarl .Value = i++; 
if (i = 100} 
{ 


了 三 Ws 
} 
时 
timer.start(}.:; 
} 
注意 : 


DispatcherTimer 类 详 见 第 21 章 。 


运行 应 用 程序 时 ， 可 以 看 到 两 个 ProgressBar 控件 处 于 活动 状态 。 使 用 第 一 个 ProgressBar 控件 可 以 看 到 状 
态 ， 第 二 个 则 显示 水 平 漂浮 的 点 (参见 图 33-17)。 
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图 33-17 
2. Slider 


使 用 Slider 控件 ， 可 以 指定 Minimum 和 Maximum 值 ， 并 使 用 Value 属性 来 分 配 当 前 值 。 代 码 示例 使 用 一 
个 文本 框 来 显示 滑 块 的 当前 值 (代码 文件 ControlsSamples /Views/RangeControlsPage.xaml): 
<Slider x:Name="slider" Minimum="10" Maximum="140" Value="60" 
Grid.Row="2" Margin="12" /> 


<TextBox Header="Slider Value" IsReadonly="True" 
Text="{Xx:Bind slider.Value, Mode=OneWay}™"™ Grid.Row="3" Margin="12"™" /> 


在 图 33-18 中 可 以 看 到 Slider 和 TextBox; 注意 它们 是 如 何 相 互 关联 的 ， 因 为 TextBox 显示 了 Slider 的 实 
际 值 。 


一 一 一 一 一 一 一 一 个 一 


slider Value 
560 


图 33-18 


33.3.4 ”内 容 控 件 


内 容 控 件 ( 见 表 33-6) 的 Content 属性 允许 添加 任何 单一 内 容 。 不 允许 使 用 多 个 内 容 对 和 象 作为 Content 属性 的 
直接 子 对 象 ， 但 是 可 以 添加 (例如 )StackPanel， 它 本 和 喘 可 以 把 多 个 控件 作为 子 控件 。 


表 33-6 
控 件 说 明 

ScrollViewer ScrollViewer 是 一 个 内 容 控 件 ， 可 以 包含 单项 ， 并 提供 水 平和 垂直 的 滚动 条 。 还 可 以 使 用 带 有 附加 属性 的 
ScrollViewer， 如 前 面 介 绍 的 ParallaxViewSample 所 示 

Frame Frame 控件 用 于 页 面 之 间 的 导航 

SelectorItem 这 些 控件 是 ContentControl 对 象 ， 作 为 属于 某 ItemsControl 的 项 。 例 如 ，ComboBox 控件 包含 ComboBoxItem 

ComboBoxItem | 对 象 ，ListBox 控件 包含 ListBoxItem 对 象 ，Pivot 控件 包含 PivotItem 对 象 。GroupItem 对 象 通常 不 直接 使 用 ; 

FlipViewItem 使 用 带 有 分 组 配置 的 IemsControl 派生 控件 时 ， 会 使 用 它们 

GridViewlItem 

ListBoxItem 

ListViewltem 

Groupltem 

PivotItem 

ToolTip 当 用 户 悬 停 在 信息 上 ， 显 示 工 具 提 示 时 ，ToolTip 会 弹出 一 个 窗口 。 可 以 使 用 ToolTipService.ToolTip 附加 属性 
配置 ToolTip。 工 具 提 示 内 能 是 文本 ; 这 是 一 个 内 容 控件 

CommandBar 使 用 CommandBar， 可 以 安排 AppBarButton 控件 和 属于 命令 元 素 的 控件 (如 AppBarSeparator)。CommandBar 
为 这 些 控件 提供 了 一 些 布 局 特性 。 在 Windows 8 中 ， 使 用 AppBar 而 不 是 CommandBar 一 一 这 就 是 为 什么 按钮 
有 这 些 名 称 的 原因 。CommandBar 派生 和 目 AppBar。 但 是 ， 如 果 CommandBar 中 的 布局 不 能 满足 需求 ， 也 可 以 
使 用 其 他 控件 来 布局 命令 

ContentDialog 使 用 ContentDialog 打开 一 个 对 话 框 。 可 以 使 用 对 话 框 所 需 的 任何 XAML 控件 自 定 义 此 控件 

SwipeControl SwipeControl 允许 通过 触摸 交互 执行 上 下 文 命令 一 一 例如 ， 在 用 户 同 左 或 同 右 滑动 时 为 某 些 项 打开 特定 的 操作 
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注意 : 


下 一 节 包 含 一 个 示例 ， 它 使 用 按钮 填充 内 容 控件 的 内 容 一 一 按钮 本 身 就 是 一 个 内 容 控件 


33.3.5 ”按钮 

按钮 组 成 了 一 个 层次 结构 。ButtonBase 类 派生 自 ContentControl， 因 此 按钮 有 一 个 Content 属性 ， 可 以 包含 
任何 单个 内 容 。ButtonBase 类 还 定义 了 Command 属性 ; 因此 ， 所 有 按钮 都 可 以 有 一 个 相关 的 命令 。 下 面 比 较 
一 下 不 同 的 按钮 ， 见 表 33-7。 


表 33-7 
探 件 说 明 
Button Button 类 是 最 党 用 的 按钮 。 这 个 类 派生 目 ButtonBase( 其 他 按钮 也 一 样 )。ButtonBase 是 所 有 按钮 的 基 类 
HyperlinkButton HyperlinkButton 显示 为 链接 。 可 以 在 浏览 器 中 打开 Web 页 面 、 打 开 其 他 应 用 程序 或 导航 到 其 他 页 面 
RepeatButton RepeatButton 是 一 个 按钮 ， 当 用 户 按 下 按钮 时 ，cClick 事件 连续 触发 。 使 用 常规 按钮 ，Click 事件 只 触 
发 一 次 
AppBarButton AppBarButton 用 于 激活 应 用 程序 中 的 命令 。 可 以 将 该 按钮 添加 到 CommandBar， 并 使 用 图 标 和 标签 来 显 
示 用 户 的 信息 
AppEBarToggleButton | CheckBox、RadioButton 和 AppBarToggleButton 派生 自 基 类 TogsgleButton. ToggleButton 可 以 使 用 “bool?” 
CheckBox 表示 三 种 状态 : Checked、Unchecked 和 Indeterminate。AppBarToggleButton 是 CommandBar 的 切换 按钮 


RadioButton 


1. 替换 按钮 的 内 容 


按钮 是 一 个 内 容 控件 ， 可 以 有 任何 内 容 。 下 面 的 示例 同 包含 Ellipse 和 TextBlock 的 按钮 添加 Grid 控件 。 该 
按钮 还 定义 了 Click 事件 ， 以 演示 它 的 不 同 外 观 ， 但 它 的 行为 是 相同 的 (代码 文件 ControlsSample/Views/ 
ButtonsPage.xaml): 

<Button Margin="12" Click="OnButtonClick"> 

<GIrid> 
<Ellipse Width="200" Height="90" Fill="red"™" /> 


<TextBlock HorizontalAliqgnment="Center™. VerticalAlignment="Center™" 
Text="Click Me!™ FontSize="24"™ /> 


</Grid> 
</Button> 
在 图 33-19 中 ， 可 以 看 到 按钮 的 新 外 观 。Content 属性 蔡 换 了 前 景 ,但 是 按钮 仍 ee 
然 具 有 默认 的 背景 。 图 33-19 
注意 : 


要 替换 按钮 的 完整 外 观 (包括 背景 )， 并 使 按钮 变 成 非 矩 形 的 形状 ， 需 要 为 按钮 创建 一 个 ControlTemplate。 
详 见 第 35 章 。 


2. 通过 HyperlinkButton 进行 链接 


使 用 HyperlinkButton 控件 ， 可 以 轻松 激活 其 他 应 用 程序 。 将 NavigateUri 属性 设置 为 URL， 单 击 按钮 ， 会 
打开 默认 浏览 器 ， 以 打开 Web 页 面 。 
<HyperlinkButton NavigateUri="https://csharp.christiannagel .com" 


Content="C# Infos™ Grid.Column="1" 
Style="{StaticResource TextBlockButtonstyle}"™" FontSize="24" /> 


默认 情况 下 ，HyperlinkButton 看 起 来 像 浏览 器 中 的 一 个 链接 。 使 用 HyperlinkButton 可 以 设置 NavigateUri 
或 定义 Click 事件 ， 但 不 能 同时 执行 这 两 个 操作 。 作 为 Click 事件 的 操作 ， 可 以 以 编程 方式 导航 到 另 一 个 页 面 。 
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不 仅 可 以 为 NavigateUri 属性 分 配 http:// 或 https:// 值 ， 还 可 以 使 用 ms-appx:// 激 活 其 他 应 用 程序 。 


33.3.6 ”项 控件 


与 ContentControl 相反 , ItemsControl 控件 ( 见 表 33-8) 可 以 包含 项 的 列表 。 通过 ItemsControl, 可 以 使 用 Items 
属性 来 确定 某 些 项 ， 也 可 以 使 用 数据 绑 定 和 ItemsSource 属性 来 确定 某 些 项 。 但 不 能 同时 使 用 这 两 种 方式 。 


表 33-8 
控 ” 件 说 明 
ItemsControl ItemsControl 是 所 有 其 他 项 控件 的 基 类 ， 也 可 以 直接 用 于 显示 项 的 列表 
Pivot Pivot 控件 是 为 应 用 程序 创建 类 似 于 表 的 行为 的 控件 


AutoSuggestBox | AutoSuggestBox 替换 了 先前 的 SearchBox.。 使 用 AutosuggestBox， 用 户 可 以 输入 文本 ， 控 件 提 供 上 自动 完成 功 
能 。 这 个 控件 的 使 用 详 见 第 36 章 


ListBox ListBox、ComboBox 和 FlipView 是 三 个 派生 上 自 基 类 Selector 的 控件 。Selector 派生 目 ItemsControl， 并 添加 

ComboBox SelectedItem 和 SelectedValue 属性 ， 以 便 从 集合 中 选择 某 项 。ListBox 显示 了 用 户 可 以 从 中 选择 的 列表 。 

FlipView ComboBox 结合 了 一 个 文本 框 和 一 个 下 拉 列 表 ， 人 允许 选择 列表 ， 且 使 用 更 少 的 屏幕 空间 。FlipView 控件 允许 
使 用 触摸 交互 来 浏览 项 目 列表 ， 而 只 显示 一 项 

ListView Listwiew 和 GridView 派生 自 基 类 ListViewBase，ListViewBase 派生 自 Selector。 因 此 这 些 是 最 强大 的 选择 器 。 

GridView ListViewBase 提供 了 附加 的 拖 放 项 、 重 新 排序 项 、 添 加 页 眉 和 页 脚 ， 并 人 允许 选择 多 个 项 。ListView 垂直 显示 


项 目 (但 也 可 以 创建 一 个 模板 ， 水 平 显 示 列 表 )。GridView 用 行 和 列 显示 数据 项 


33.3.7 ”Flyout 控件 


Flyout 控件 ( 见 表 33-9) 用 于 在 其 他 UI 元 素 ( 例 如 上 下 文 淋 单 ) 之 上 打开 窗口 。 所 有 的 Flyout 都 派生 自 基 类 
FlyoutBase。FlyoutBase 类 定义 了 一 个 Placement 属性 ， 人 允许 定义 Flyout 的 位 置 。 它 可 以 在 屏幕 中 居中 ， 也 可 以 
围绕 目标 元 素 定 位 。 


表 33-9 
控 件 说 明 
MenuFlyout MenuFlyout 控件 用 于 显示 菜单 项 的 列表 
Flyout Flyout 控件 可 以 包含 一 个 能 使 用 元 素 自 定义 的 项 


33.4 数据 绑 定 


对 于 基于 XAML 的 应 用 程序 来 说 ， 数 据 绑 定 是 一 个 极其 重要 的 概念 。 数 据 绑 定 把 数据 从 NET 对 象 传递 给 
UI， 或 从 UI 传递 给 NET 对 象 。 简 单 对 象 可 以 绑 定 到 UI 元 素 、 对 象 列 表 和 XAML 元 素 上 。 在 数据 绑 定 中 ， 目 
标 可 以 是 XAML 元 素 的 任意 依赖 属性 ，CLR 对 象 的 每 个 属性 都 可 以 是 绑 定 源 。 因 为 XAML 元 素 也 提供 了 .NET 
属性 ， 所 以 每 个 XAML 元 素 也 可 以 用 作 绑 定 源 。 图 33-20 显示 了 绑 定 源 和 绑 定 目标 之 间 的 连接 。 绑 定 定义 了 该 

Binding 对 象 支持 源 与 目标 之 间 的 几 种 绑 定 模式 。 绑 定 可 以 是 单 癌 的 ， 即 从 源 信息 指向 目标 ， 但 如 果 用 户 在 
用 户 界面 上 修改 了 该 信息 ， 则 源 不 会 更 新 。 要 更 新 源 ， 需 要 双向 绑 定 。 
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表 33-10 
绑 定 模式 说 明 
一 次 性 绑 定 从 源 指 向 目标 ， 且 仅 在 应 用 程序 启动 时 , 或 数据 上 下 文 改变 时 绑 定 一 次 。 通 过 这 种 模式 可 以 获得 数据 的 
单 回 绑 定 从 源 指 同 目标 。 这 对 于 只 读数 据 很 有 用 ， 因 为 它 不 能 从 用 户 界 面 中 修改 数据 。 要 更 新 用 户 界面 ， 源 必须 
实现 INotifyPropertyChanged 接口 
双向 在 双向 绑 定 中 ， 用 户 可 以 从 UU 中 修改 数据 。 绑 定 是 双向 的 一 一 从 源 指向 目标 ， 从 目标 指向 源 。 源 对 象 需要 


实现 读 / 写 属性 ， 才 能 把 改动 的 内 容 从 UI 更 新 到 源 对 象 上 
指向 源 的 单 向 采用 这 种 绑 定 模式 ， 如 果 目 标 属 性 改变 ， 源 对 象 也 会 更 新 。 这 种 绑 定 不 能 用 于 UWP， 但 可 以 用 于 WPF 和 


注意 : 

JWP 支持 两 种 绑 定 类 型 : 使 用 Binding 标记 扩展 的 传统 绑 定 ,以 及 使 用 x:Bind 标记 扩展 的 新 编译 绑 定 。 请 
注意 ， 绑 定 模式 的 默认 值 在 这 些 绑 定 类 型 之 间 存 在 差异 ， 因 此 最 好 总 是 指定 绑 定 模式 。 本 节 主 要 关注 新 的 编译 
绑 定 。 


除了 绑 定 模式 之 外 ， 数 据 绑 定 还 涉及 许多 方面 。 本 节 详 细 介 绍 与 简单 的 NET 对 象 和 列表 的 绑 定 。 通 过 更 改 
通知 ， 可 以 使 用 绑 定 对 象 中 的 更 改 更 新 UI。 本 节 也 将 论述 如 何 动态 地 选择 数据 模板 。 

下 面 从 DataBindingSamples 示例 应 用 程序 开始 。 该 应 用 程序 显示 图 书 列 表 ， 并 允许 用 户 选择 一 本 书 ， 来 坦 
看 图 书 细节 。 


33.4.1 用 INotifyPropertyChanged 更 改 通知 


首先 创建 模型 。 为 了 在 属性 值 变化 时 把 更 改 信 息 传 递 给 用 户 界 面 ， 必 须 实 现 INotifyPropertyChanged 接 
口 。 为 了 重用 此 实现 代码 ， 创 建 实现 此 接口 的 BindableBase 类 。 该 接口 定义 了 PropertyChanged 事件 处 理 程 
序 ， 该 事件 在 OnPropertyChanged 方法 中 触发 。 方 法 Set 用 于 更 改 属性 值 ， 并 触发 PropertyChanged 事件 。 如 果 
要 设置 的 值 与 当前 值 没 有 不 同 ， 则 不 触发 事件 ， 且 方法 仅 返 回 false。 只 有 使 用 不 同 的 值 时 ,属性 才 设 置 为 新 值 ， 
并 触发 PropertyChanged 事件 。 这 个 方法 在 C# 中 通过 CallerMemberName 属性 来 使 用 调用 者 信息 。propertyName 
参数 通过 这 个 属性 定义 为 可 选 参数 ，C# 编 译 器 就 会 通过 这 个 参数 传递 属性 名 ， 所 以 不 需要 在 代码 中 添加 硬 编码 
字符 串 (代码 文件 DataBindingSamples/Models/BindableBase.cs): 

public abstract class BindableBase : INotifyPropertyChanged 


{ 
Public event PropertyChangedEventHandler PropertyChanged; 


Public virtual bool Set<T»> (ref T item, T value,. 
[CallerMemberName] string propertyName = null) 
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if (EqualityCcomparer<T>.Default.Equals(item, value)})} return false; 
item = Vvalue; 

OnPropertyChanged (propertyName).: 

return true; 


Protected virtual Void OnPropertyChanged(string propertyName) 一 > 
PropertyChanged? .TInvoke (this, new PropertyChangedEventArgs (propertyName))}).; 


调用 者 信息 参见 第 14 章 。INotifyPropertyChanged 的 实现 参见 第 34 章 。 


Book 类 派生 自 基 类 BindableBase， 并 实现 了 属性 BookId、Title、Publisher 和 Authors。BookId 属性 是 只 读 
的 ; Title 和 Publisher 使 用 来 自 基 类 的 变更 通知 实现 ，Author 是 一 个 只 读 属 性 ， 返 回 作者 列表 (代码 文件 
DataBindineSamples/Models/Book.cs): 


public class Book : BindableBase 
{ 
public Book(int id, string title, string publisher, params string[] authors) 
{ 
BookId = id; 
Title = title- 
Publisher = publisher; 
BAuthors = authorss 


public int BookId { get; } 


private string title; 
public string Title 


get => title; 
set => Setl(ref title, value}); 


private string publisher; 
public string Publisher 


get => publisher; 
Set => Setl(ref publisher, value); 


public IEnumerable<string> Authors { get; } 


Public override string ToString(}) => Title; 


33.4.2 创建 图 书 列 表 


GetSampleBooks 方法 返回 应 使 用 Book 类 的 构造 函数 显示 的 图 书 列表 (代码 文件 DataBindingSamples/Services/ 
SampleBooksService.cs): 


public class SampleBooksService 
{ 
public IEnumerable<Book> GetSampleBooks() 三 > 
new List<Book> () 
{ 
new Book(l1, "Professional C# 7 and .NET Core 2", "Wrox Press", 
"Christian Nagel"™"), 
new Book(2, "Professional C# 6 and .NET Core 1.0™, "Wrox Press", 
"Christian Nagel"), 
new Book(3, "Professional C# 5.0 and .NET 4.5.1", "Wrox Press"™, 
"Christian Nagel™", "Jay Glynn™", "Morgan Skinner™), 
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new Book(4, "Enterprise Services with the .NET Framework™., "AWL"™, 
"Christian Nagel"™) 
}; 
现在 ，BooksService 类 提供 了 RefreshBooks、GetBook、AddBook 方法 以 及 属性 Books。 属 性 Books 返回 
一 个 ObservableCollection=Book=> 对 象 。ObservableCollection 是 一 个 泛 型 类 ， 通 过 实现 接口 INotifyCollection- 
Changed 来 提供 更 改 通 知 (代码 文件 DataBindingSamples /Services/BooksService.cs): 
Public class BooksService 


| 


private ObservableCcollection<Book> books = new ObservableCollection<Book> (); 


Public void RefreshBooks () 
{ 
books.Clear (}); 
Var SampleBooksService = new SampleBooksService(); 
Var books = sampleBooksService.GetSampleBooks (); 
foreach (var book in books) 
{ 
_books .Add (book); 
} 
} 


PUublic Book GetBook (int bookId) => 
_books .Where (b => b.BookId == bookId) .SingleorDefault (); 


Public Vold AddBook (Book book) => books.Add (book); 


Public IEnumerable<Book> Books 三 > books; 


注意 : 
第 11 章 详 细 介 绍 了 泛 型 类 ObservableCollection 。 


33.4.3 列表 绑 定 


现在 可 以 显示 图 书 列表 了 了。 可 以 使 用 任何 ItemsSource 派生 控件 指定 ItemsSource 属性 ， 绑 定 到 列表 上 。 下 
面 的 代码 片段 使 用 ListView 控件 将 ItemsSource 绑 定 到 Books 属性 上 。 使 用 标记 扩展 x:Bind 时 ， 指 定 的 第 一 个 
名 称 是 绑 定 的 源 ，Mode 参数 确定 了 绑 定 模式 。 对 于 OneWay， 当 消息 源 发 生变 化 时 ， UWP 利用 变更 通知 来 更 
新 用 户 界 面 : 

<ListView ItemsSource="{x:Bind Books，Mode=OneWayl" Grid.Row="1" /> 

在 代码 隐藏 文件 中 ， 指 定 Books 属性 以 引用 BooksService 的 Books 属性 (代码 文件 DataBindingSamples/ 
MainPage.xaml.cs): 


public sealed partial class MainPage : Page 
{ 


private BooksService booksService = new BooksService(}; 
public MainPage() 
{ 
this.InitializeComponent () ， 
} 


Public IEnumerable<Book> Books => booksService.Books; 


} 


33.4.4 ”把 事件 绑 定 到 方法 


如 果 没 有 在 BooksService 中 调用 RefreshBooks 方法 ， 列 表 将 为 空 。 使 用 XAML 文件 ， 会 创建 一 个 
CommandBar, 其 中 列 出 两 个 AppBarButton 控件 ,通过 AppBarButton 控件 , Click 事件 再 次 绑 定 到 OnRefreshBooks 
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和 OnRefresh 方法 上 (代码 文件 DataBindingSamples/MainPage.xaml): 


<CommandBar Grid.Row="0" Grid.Column="0"™" Grid.cCcolumnSspan="2"> 
<APpPRarButton Icon="Refresh™” Label="Refresh™ 
Click="{x:Bind OnRefreshBooks}"™" /> 
<AppBarButton Icon="Add™" Label="Add Book™ Click="{x:Bind OnAddBook}™ /> 
</CommandBar> 


如 果 方 法 没有 参数 或 具有 事件 的 委托 类 型 指定 的 参数 ， 则 可 以 将 事件 绑 定 到 方法 。 在 以 下 代码 片段 中 ， 
OnRefreshBooks 和 OnAddBook 方法 声明 为 void， 没 有 参数 (代码 文件 DataBindingSamples/MainPage.xaml.cs): 


public void CnRefreshBooks () 
{ 
booksService.RefreshBooks (); 


} 
public void OnAddBook() => 
booksService.AddBook (new Book (GetNextBookId(), 


sn"professional C# {GetNextBookId() + 3}", "Wrox Press")); 


private int GetNextBookId()} => Books.Select(b => b.BookId) .Max() + 1; 


绑 定 到 方法 上 只 能 使 用 x:Bind 标记 扩展 ， 不 能 使 用 传统 的 Binding 标记 扩展 。 


正在 运行 的 应 用 程序 带 有 两 个 AppBar 按钮 ， 如 图 33-21 所 示 。 单 击 Refresh 按钮 加 载 图 书 ， 并 显示 图 书 标 
题 ， 因 为 Book 类 的 ToString 方法 返回 标题 。 单 击 Add 按钮 会 创建 一 个 新 的 book 对象， 该 对 象 会 出 现在 列表 
中 ， 因 为 列表 的 类 型 是 ObservableCollection。ObservableCollection 通过 接口 INotifyCollectionChanged 实现 了 
更 改 通知 。 


DataBindingSamples 


Professional Cé# 7 and .ET Core 2 
Professional C# 6 and .NET Core 1.0 


Professional C# 5.0 and .NET 4.5.1 


Enterprise Services with the .NET Framework 


Professional C# 8 


Professional CC# 人 9 


图 33-21 


33.4.5 ”使 用 数据 模板 和 数据 模板 选择 器 


为 了 创建 不 同 的 项 外 观 ， 可 以 创建 一 个 DataTemplate。 可 以 使 用 x:key 特性 指定 的 键 引 用 DataTemplate。 使 
用 x:DataType 特性 时 ， 可 以 在 数据 模板 中 使 用 已 编译 绑 定 。 已 编译 绑 定 需要 在 编译 时 绑 定 到 的 类 型 。 要 绑 定 到 
Title 属性 ， 类 型 由 Book 类 定义 (代码 文件 DataBindingSamples/MainPage.xam]l): 


<Page.Resources> 
<DataTemplate x:DataTlype="models:Book" xX:Key="WroxTemplate"> 
<Border Background="Red™" Margin="4" Padding="4" BorderThickness="2" 
BorderBrush="DarkRed™ > 
<TextBlock Text="{x:Bind Title, Mode=OneWay}" Foreground="White"™ 
Width="300"™" /> 
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</Border> 
</DataTemplate> 
1 一 。。。 一 一 > 
</Page .Resources> 


在 ItemsControl 中 使 用 的 数据 模板 可 以 使 用 ItemsControl 的 ItemTemplate 属性 来 引用 。 现 在 使 用 
DataTemplateSelector， 根 据 出 版 社 的 名 称 动态 地 选择 DataTemplate， 而 不 是 指定 DataTemplate。 

BookDataTemplateSelector 派生 目 基 类 DataTemplateSelector 。 数 据 模 板 选 择 器 需要 重 写 方法 
SelectTemplateCore 并 返回 所 选 的 DataTemplate。 在 实现 BookTemplateSelector 时 , 指定 了 两 个 属性 WroxTemplate 
和 DefaultTemplate。 在 SelectTemplateCore 方法 中 , 会 接收 Book 对 象 。 可 以 使 用 模式 匹配 与 switch 语句 ， 这 样 ， 
如 果 出 版 社 是 Wrox Press， 则 返回 WroxTemplate。 在 其 他 情况 下 ， 会 返回 DefaultTemplate。 可 以 使 用 更 多 的 出 
版 社 扩展 switch 语句 (代码 文件 DataBindingSamples/Utilities /BookTemplateSelector.cs): 


Public class BookTemplateSelector : DataTemplateSelector 


{ 
Public DataTemplate WroxTemplate { get; set; } 
public DataTemplate DefaultTemplate { get; set; } 


protected override DataTemplate SelectTlTemplateCore (object item) 
{ 
DataTemplate selectedTemplate = null; 


switch (item)} 


{ 


Case Book b when b.Publisher == "Wrox Press™: 
selectedTemplate = WroxTemplate; 
break; 
default: 
selectedTemplate = DefaultTemplate; 
break; 


} 
return selectedTemplates; 
} 
} 


注意 : 
模式 匹配 详 见 第 13 章 。 


接 下 来 ， 需 要 实例 化 和 初始 化 数据 模板 选择 器 。 可 以 在 XAML 代码 中 完成 这 个 工作 。 在 这 里 ， 指 定 属性 
WroxTemplate 和 DefaultTemplate 来 引用 先前 创建 的 DataTemplate 模 板 ( 代 码 文件 DataBindingSamples/MainPage.xaml): 


<Page.Resources> 
<DataTemplate Xx:DataType="models:Book™ XxX:Eey="WIioxTemplate™> 
<Border Background="Red" Margin="4" Padding="4" BorderThickness="2" 
BorderBrush="DarkRed"> 
<TextBlock Text="{Xx:Bind Title, Mode=OneWay}" Foreground="White™" 
Width="300"™ /> 
</Border> 
</DataTemplate> 
<DataTemplate Xx:DataType="models:Book™ XX:Eey="DefaultTemplate"> 
<Border Background="LightBlue"™" Margin="4" Padding="4" BorderThickmess="2" 
BorderBrush="DarkBlue™"> 
<TextBlock Text="{X:Bind Title, Mode~OneWay}™" Foreground="Black" 
Width="300"™ /> 
</Border> 
</DataTemplate> 
<UuUtils:BookITIemplateSelector x:Kev="BookITemplateSelector" 
WroxTemplate=" {StaticResource WroxTemplate}”" 
DefaultTemplate="{StaticResource DefaultTemplate}" /> 
</Page .Resources> 


为 了 将 BookTemplateSelector 与 ListView 中 的 项 一 起 使 用 ,ItemTemplateSelector 属性 使 用 键 和 StaticResource 
标记 扩展 来 引用 模板 : 


890 | 第 lV 部 分 应 用 程序 


<ListView ItemsSource="{X:Bind Books, Mode~=OneWay}" 
ItemlemplateSelector=" {StaticResource BookTemplateSelector}" 
Grid.Row="1"™ /> 


在 此 阶段 运行 应 用 程序 时 ， 图 33-22 显示 了 基于 出 版 社 的 不 同 视 图 的 新 输出 。 


DataBindingSamples 一 口 


5 


” 


professional C# 7 and .NET Core 2 


Professional t# 6 and .NET Core 1.0 


Professional C# 5,0 and .NET 4.5.1 


Enterpnse services With the .NET Framework 


Professional CC#@ 8 


professional CC# 9 


Professional C# 10 


图 33-22 


33.4.6 ” 绑 定 简单 对 象 


不 只 是 绑 定 列表 ， 单 本 书 应 该 显示 在 应 用 程序 的 右 侧 。 已 编译 绑 定 用 于 绑 定 Book 对 象 的 BookId、Title 和 
Publisher 属性 (代码 文件 DataBindingSamples/Views/BookUserControl.xaml): 


<USsercontrol 
xX:Class="DataBindingSamples .Views.BookUserControl™" 
xmlns="http://schemas .microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas .microsoft.com/winfx/2006/xaml™" 
xmlns:local="using:DataBindingSamples .Views" 
xmlns:conv="using:DataBindingSamples.Converters" 
xmlns:d="http://schemas .microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas .openxmlformats.org/markup—compatibility/2006" 
mec:Ignorable="d"™" 
d:DesignHeight="300" 
d:DesignWidth="400"> 
TI 一» 
<StackPanel Orientation="Vertical™" Grid.Row="1"> 
<TextBox Header="BookId™” IsReadonly="TIrue™ 
Text=" {x:Bind Book.BookId, Mode=OneWay}" /> 
<TextBox Header="Title" Text="{x:Bind Book.Title, Mode=TwoWay}"™" /> 
<TextBox Header="Publisher"™ 
Text=" {x:Bind Book.Publisher, Mode=TwoWay}" /> 


过 1 一 一 -一 一 思 
</SstackPanel> 
</Grid> 
</UserCcontrol> 


在 代码 隐藏 文件 中 ，Book 属性 定义 为 一 个 依赖 属性 。 当 值 更 改 时 ， 需 要 更 改 通 知 来 进行 更 新 ， 这 就 是 为 什么 
要 使 用 依赖 属性 的 原因 。 还 可 以 实现 INotifyPropertyChanged, 但 是 由 于 依赖 属性 已 经 可 以 从 基 类 DependencyObject 
中 获得 ， 所 以 可 以 轻松 地 使 用 依赖 属性 (代码 文件 DataBindingSamples/Views/BookUser Control.xamlcs): 

Public Book Book 

Jet => (Book})} GetValue (BookEkProperty).: 


set 三 > SetValue (BookProperty, value); 
} 
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Public static readonly DependencyProperty BookProperty = 
DependencyProperty.Register ("Book", typeof (Book), typeof (BookUserControl), 
new PropertyMetadata (null})}); 


现在 ， 用 户 控 件 需 要 显示 在 MainPage 中 ， 当 前 选中 的 图 书 应 该 分 配给 用 户 控件 的 Book 属性 。 为 此 可 以 使 
用 XAML 代码 。BookUserControl 在 MainPage 的 Grid 中 添加 ， 在 ListView 中 ，SelectedItem 属性 绑 定 到 Book 
属性 。 这 次 ， TwoWay 绑 定 需要 在 ListView 中 更 新 UserControl( 代 码 文件 DataBindingSamples/MainPage.xaml): 


<ListView X:Name="BooksList" ItemsSource="{x:Bind Books, Mode=OneWay}" 
ItemTemplateSelector="{StaticResource BookTemplateSelector}" 
SelectedItem="{x:Bind CurrentBook .Book, Mode=TwoWay}" Grid.Row="1" /> 
<V1ewWw3:BookUserControl x:Name="CurrentBook" Grid.Row="1"™ Grid.Column="1" 
Margin="4" /> 


注意 : 

也 可 以 以 另 一 种 方式 创建 绑 定 一 一 将 BookUserControl 绑 定 到 ListView。 这 样 ，OneWay 绑 定 就 足够 了 一 一 
只 需要 将 更 新 后 的 值 从 ListView 获取 到 BookUserControl。 但 是 在 这 里 XAMILI 编译 器 会 报错 ， 因 为 它 不 能 将 一 
个 对 象 (来 自 ListView) 分 配给 BookUserControl 的 强 类 型 Book 属性 。 可 以 通过 创建 一 个 值 转换 器 ( 稍 后 讨论 ) 来 
解决 这 个 问题 。SelectedItem 属性 不 存在 这 个 问题 ， 因 为 微软 改变 了 实现 ， 最 新 的 Windows 10 版 本 不 再 报错 。 
在 早期 版 本 中 ， 还 需要 在 该 场景 中 使 用 对 象 到 对 象 的 转换 器 。 


在 运行 应 用 程序 时 ， 可 以 看 到 图 书 ， 在 列表 中 选择 一 本 书 时 ， 详 细 信 息 显 示 在 用 户 控件 中 ， 如 图 33-23 
所 示 。 


DataBindingSamples 


Professional C# 7 and .NET Core 2 


Publisher 


Wrox Press 


Professional CC# 8 


图 33-23 


33.4.7 值 的 转换 


作者 还 没有 显示 在 用 户 控件 中 。 原 因 是 Authors 属性 是 一 个 列表 。 可 以 在 用 户 控 件 中 定义 一 个 ItemsControl 
来 显示 Authors 属性 。 但 是 ， 仅 为 了 显示 一 个 以 逗号 分 隔 的 作者 列表 ， 使 用 TextBlock 即 可 。 只 需要 一 个 转换 器 
就 可 以 将 IEnumerable=<string>(Authors 属性 的 类 型 ) 转 换 为 字符 串 。 

值 转 换 器 是 TValueConverter 接口 的 实现 。 这 个 接口 定义 了 Convert 和 ConvertBack 方法 。 对 于 双 回 绑 定 ， 需 
要 实现 这 两 个 方法 。 使 用 单 问 绑 定 ，Convert 方法 就 足够 了 了 了。 类 CollectionToStringConverter 使 用 string.Join 方法 
创建 单个 字符 串 ， 实 现 了 Convert 方法 。 值 转换 器 还 接收 一 个 对 象 parameter， 可 以 在 使 用 值 转换 器 时 指定 该 参 
数 。 这 里 ， 将 该 参数 用 作 字 符 串 分 隔 符 (代码 文件 DataBindingSamples/Converters/CollectionToStrineConverter.cs): 

public class CollectionTostringConverter : IValueConverter 

public object Convert (object value, Type targetType, object parameter, 

string language) 
| IEnumerable<string> names = (IEnumerable<string>)value; 


return string.Join(parameter?.ToString{() 32 ", ", names); 


} 


892 | 第 部 分 应 用 序 


public object ConvertBack (object value, Type targetType, object parameter, 
string language) 


throw new NotImplementedException (); 


} 
} 
使 用 用 户 控件 ，CollectionToStringConverter 在 资源 部 分 实例 化 (代码 文件 DataBindingSamples/Views/Book- 
UserControl.xam!l): 


<USercontrol .Resources> 
<conv:CollectionTostringConverter x:Key="CollectionToSstringConverter™ /> 
</UserCcontrol .Resources> 


现在 可 以 使 用 Converter 属性 在 x:Bind 标记 扩展 中 引用 转换 器 。ConverterParameter 属性 指定 在 之 前 的 
string.Join 方法 中 使 用 的 字符 串 分 隔 符 (代码 文件 DataBindingSamples/Views/BookUserControl.xam)): 
<TextBox Header="Authors™”" IsReadonly="True"™ 
Text=" {x:Bind Beck .Authors, Mode=OneWay ， 


Converter={StaticResource CollectionToStringConverter}, 
ConverterParameter="'; '}" /> 


运行 该 应 用 程序 时 ， 作 者 将 如 图 33-24 所 示 。 


DataBindingSamples 


Bookld 


Title 


Professional C# 5,0 and .NET 4.5.1 | Professional C# 5,0 and ,NET 4.5.1 ] 


Professional C# 7 and .NET Core 2 


Professional C# 6 and .NET Core 1.0 


Publisher 


Wrox Press 


professional C# 8 Authors 


Christian Nagel' Jay Glynn; Morgan Skinner 


图 33-24 


注意 : 
第 36 章 介 绍 了 使 用 已 编译 数据 绑 定 的 更 多 特性 , 例如 使 用 绑 定 生命 周期 、 在 资源 文件 中 的 编译 绑 定 和 阶段 
绑 定 。 


33.5 “导航 


如 果 应 用 程序 是 由 多 个 页 面 组 成 的 ， 就 需要 能 在 这 些 页面 之 间 导 航 。 有 不 同 的 应 用 程序 结构 需要 导航 ， 比 
如 使 用 汉堡 包 按 钮 导航 到 不 同 的 根 页 面 ， 或 者 使 用 不 同 的 选项 卡 和 痊 换 选项 卡 项 。 

如 果 需 要 为 用 户 提供 导航 的 方法 ， 导 航 的 核心 是 Frame 类 。Frame 类 人 允许 使 用 Navigate 方法 ， 选 择 性 地 传 
递 参数 ， 导 航 到 具体 的 页 面 上 。Frame 类 有 一 个 要 导航 的 页 面 堆栈 ， 因 此 可 以 后 退 、 前 进 ， 限 制 堆栈 中 页 面 的 
数量 等 。 

导航 的 一 个 重要 方面 是 能 够 返回 。 下 面 几 节 介绍 了 使 用 回 航 的 Windows 10 方法 。 


33.5.1 导航 回 最 初 的 页 面 
下 面 开 始 创 建 一 个 有 多 个 页 面 的 Windows 应 用 程序 ， 在 页 面 之 间 导 航 。 模 板 生成 的 代码 在 App 类 中 包含 
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OnLaunched 方法 ， 在 该 方法 中 ， 实 例 化 一 个 Frame 对 象 ， 再 调用 Navigate 方法 ， 导 航 到 MainPage (代码 文件 
PageNavigation/ App.xaml.cs): 


protected override void OnLaunched (LaunchActivatedEventArgs e) 


{ 


Frame rootFrame = Window.Current.Content as Frame; 
if (rootFrame == null) 
{ 
rootFrame = new Frame().; 
rootFrame .NavigationFailed 十 = OQnNavigationFailed.; 
IE (e.PrevyviousExecutlionstate == ApplicationExecutionSstate.Terminated) 


/TODO: Load state from previously suspended application 
0 = rootFrame,; 
(IoOoOtFIrame.Content == null} 
| rootFrame .Navigate (typeof (MainPage) ， e.LArguments); 
} 


Window.Current.Activater(y}):; 


注意 : 
源 代码 有 一 个 TODO 注释 ， 从 前 面 暂停 的 应 用 程序 中 加 载 状态 。 如 何 处 理 暂停 在 第 36 章 中 解释 。 


Frame 类 有 一 个 已 访问 的 页 面 堆栈 。GoBack 方法 可 以 在 这 个 堆栈 中 回 航 (如 果 CanGoBack 属性 返回 true)， 
GoForward 方法 可 以 在 后 退 后 前 进 到 下 一 页 。Frame 类 还 提供 了 几 个 导航 事件 ， 如 Navigating、Navigated、 
NavigationFailed 和 NavigationStopped。 

为 了 查看 导航 操作 ， 除 了 MainPage 之 外 ， 还 创建 SecondPage 和 ThirdPage 页 面 ， 在 这 些 页 面 之 间 导 航 。 
在 MainPage 上 ， 可 以 导航 到 SecondPage， 通 过 传递 一 些 数据 可 以 从 SecondPage 导航 到 ThirdPage。 

因为 有 这 些 页 面 之 间 的 通用 功能 ， 所 以 创建 一 个 基 类 NavigationPage， 所 有 这 些 页 面 都 派生 目 它 。 
NavigationPage 类 派生 自 基 类 Page， 实 现 了 接口 INotifyPropertyChanged， 用 于 更 新 用 户 界 面 (代码 文件 
PageNavigation/NavigationPage.cs): 


Public abstract class NavigationPage : Page, INotifyPropertyChanged 


{ 


Public event PropertyChangedEventHandler PropertyChanged; 


protected virtual void OnpPropertyCchanged( 
[callerMemberName] string propertyName = null) =»> 
PropertyChanged?.Invoke (this, new PropertyChangedEventArgs (propertyName) )，} 


protected bool SetProperty<T> (ref T item, T Value ， 
[callerMemberName] string propertyName = null) 

{ 
If (EqualityComparer<T>.Default.Equals(item, Vvalue)) return false; 
item = Value; 
OnPropertyChanged (propertyName); 
return trues 


} 


private string navigationMode; 
Public string NavigationMode 
{ 
get => navigationMode; 
set => SetPropertyl(ref navigationMode, value); 


} 
hss 


33.5.2 ” 重 写 Page 类 的 导航 
Page 类 是 NavigationPage 的 基 类 (也 是 XAML 页 面 的 基 类 ), 该 类 定义 了 用 于 导航 的 方法 。 当 导航 到 相应 的 
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页 面 时 ， 会 调用 OnNavigatedTo 方法 。 在 这 个 页 和 面 中 ， 可 以 看 到 导航 是 如 何 操作 的 (NavigationMode 属性 ) 和 导 
航 参 数 。OnNavigatingFrom 方法 是 从 页 面 中 退出 时 调用 的 第 一 个 方法 。 在 这 里 ， 导 航 可 以 取消 。 从 这 个 页 面 中 
退出 时 ， 最 终 调用 的 是 OnNavigatedFrom 方法 。 在 这 里 ， 应 该 清理 OnNavigatedTo 方法 分 配 的 资源 (代码 文件 
PageNavlgatlon App.Xamlcs): 


Public abstract class NavigationPage : Page, INotifyPropertyChanged 
{ 
A 
Protected override void OnNMavigatedTo (NavigationEventArgs e) 
{ 
base.OnNavigatedTo (e);} 
NavigationMode = S$"Navigation Mode: {e.NavigationMode}™"; 
Ff 
} 


Protected override void OnNavigatingFrom(NavigatingCancelEventArgs e) 
{ 
base.OnNavigatingFroml(e); 


} 


protected override void OnNavigatedFrom'(NavigationEventArgs e) 
| 
pase -DnNavlIgatedEFTromI(e) ; 
} 
} 


33.5.3 在 页 面 之 间 导 航 


下 面 实现 3 个 页 面 。 为 了 使 用 NavigationPage 类 ， 代 码 隐藏 文件 需要 修改 ， 以 使 用 NavigationPage 作为 基 
类 (代码 文件 PageNavigation/MainPage.xaml.cs): 


Public sealed partial class MainPage : NavigationPage 
{ 

EE 
} 


基 类 的 变化 也 需要 反映 在 XAML 文件 中 : 使 用 NavigationPage 元 素 代 蔡 Page (代码 文件 PageNavigatiom/ 
MainPage.xam!l): 


<local:MavigationPage 
X:Class="PageNavigation.MainPage" 
xmlns="http://schemas .microsoft.com/winfx/2006/xaml/presentation"™ 
xmlns:x="http://schemas .microsoft.com/winfx/2006/xaml™" 
xmlns:local="using:PageNavigation™" 
xmlns:d="http://schemas .microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats .org/markup-compatibility/2006" 
mc:Ianorable="d"> 


MainPage 包含 一 个 TextBlock 元 素 和 一 个 Button 控件 ，TextBlock 元 素 绑 定 到 BasePage 中 声明 的 
NavigationMode 属性 上 ， 按 钮 的 Click 事件 绑 定 到 OnNavigateToSecondPage 方法 上 (代码 文件 PageNavigation/ 
MainPage.xam!l): 


<StackPanel Orientatijon="Vertical™"> 
<TextBlock Style="{StaticResource TitleTextBlockSstyle}" Margin="8"> 
Main Page</TextBlock> 
<TextBlock Text="{x:Bind NavigationMode, Mode=OneWay}" Margin="8" /> 
<Button Content="Navigate to SecondPage™" Click="OnNavigateToSecondPage" 
Margin="8" /> 
</StackPanel> 


处 理 程 序 方法 OnNavigateToSecondPage 使 用 Frame Navigate 导航 到 SecondPage。Frame 是 Page 类 上 返回 
Frame 实例 的 一 个 属性 (代码 文件 PageNavigation/MainPage.xaml.cs): 

public void OnNavigateToSecondPage () 

{ 


Frame .Navigate (typeof (SecondPage)),; 
} 
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当 从 SecondPage 导航 到 ThirdPage 时 ， 把 一 个 参数 传递 给 目标 页 面 。 参 数 可 以 在 绑 定 到 Data 属性 的 文本 
框 中 输入 (代码 文件 PageNavigation /SecondPage.xaml): 


<StackPanel Orientation="Vertical™> 
<TextBlock Style="{StaticResource TitleTextBlockstyle}™" Margin="98"»> 
Second Page</TextBlock> 
<TextBlock Text="{x:Bind NavigationMode, Mode=OneWay}" Margin="8"™" /> 
<TextBox Header="Data"™ Text="{x:Bind Data, Mode=TwoWay}" Margin="8" /> 
<Button Content="Navigate to Third Pagen" 
Click="{xX:Bind QnNavigateToThirdPage, Mode=OneTime}"™" Margin="8" /> 
</sStackPanel> 


在 代码 隐藏 文件 中 ， 将 Data 属性 传递 给 Navigate 方法 (代码 文件 PageNavigation /SecondPage.xaml.cs): 
Public string Data { get; set; } 


Public void OnNavigateToThirdPrage () 
{ 

Frame .Navigate (typeof (ThirdPage) ， Data).; 
} 


接收 到 的 参数 在 ThirdPage 中 检索 。 在 OnNavigatedTo 方法 中 ，NavigationEventArgs 用 Parameter 属性 接收 
参数 , Parameter 属性 是 object 类 型 , 可 以 给 页 面 导航 传递 任何 数据 (代码 文件 PageNavigation/ThirdPage.xaml.cs): 


protected override Vvoid OnNavigatedTo (NavigationEventArgs e) 
{ 

base .OnNavigatedTo (e}).; 

Data = ee.Parameter as string; 


} 


private string data; 
public string Data 


Jet => data; 
set => SetProperty(ref data, value): 


33.5.4 ”后 退 按钮 


当 应 用 程序 中 有 导航 要 求 时 ， 必须 包括 返回 的 方式 。 在 Windows 8 中 ， 定 制 的 后 退 按钮 位 于 页 面 的 左上 和 角 。 
在 Windows 10 中 仍然 可 以 这 样 做 。 的 确 ， 一 些微 软 应 用 程序 包括 这 样 一 个 按钮 ，Microsoft Edge 在 左上 角 放 置 
了 后 退 和 前 进 按钮 。 应 在 前 进 按钮 的 附近 放置 后 退 按钮 。 在 Windows10 中 ， 可 以 利用 系统 的 后 退 按钮 。 

根据 应 用 程序 运行 在 条 面 模式 还 是 平板 电脑 模式 ， 后 退 按钮 位 于 不 同 的 地 方 。 要 局 用 这 个 后 退 按钮 ， 需 要 
把 SystemNavigationManager 的 AppViewBackButtonVisibility 设置 为 AppViewBackButton Visibility， 在 下 面 的 代 
码 中 ，Frame.CanGoBack 属性 返回 true 时 ， 就 是 这 种 情况 (代码 文件 PageNavigation/NavigationPage.cs): 


protected override Vvoid OnNavigatedTo (NavigationEventArgs e) 
{ 
NavigationMode = $"Navigation Mode: {e.NavigationMode}™; 
SYSstemNavigaticonManager .GetForCurrentView!() .AppViewBackButtonVisibility = 
Frame .CanGoBack ? AppViewBackButtonVisibility.Vvisible : 
ApPpPVlewBackButtonVisibility.Collapsed; 
base.OnNavigatedTo (e),; 
} 


接 下 来 ， 使 用 SystemNavigationManager 类 的 BackRequested 事件 。 对 BackRequestedEvent 的 啊 应 可 以 用 于 
完整 的 应 用 程序 ， 如 这 里 所 示 。 如 果 只 在 几 页 上 需要 这 个 功能 ， 还 可 以 把 这 段 代 码 放 在 页 面 的 OnNavigatedTo 
方法 中 (代码 文件 PageNavigation/App.xaml.cs): 


protected override void OnLaunched (LaunchActivatedEventArgs e) 
{ 
FF 
SystemNavigationManager.GetForCurrentView() .BackRequested += 
APP BackRequested; 
Window.Current.Activater():; 


} 
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处 理 程 序 方法 App BackRequested 在 frame 对 象 上 调用 GoBack 方 法 (代码 文件 PageNavigation/App.xaml.cs): 


private void App BackRequested (object sender, BackRequestedEventArgs e) 


{ 
Frame TootETrame = Window.Current.content as Frame; 
if (rootFrame == null}) return; 
if (rootFrame.CanGoBack && ee.Handled == false) 


{ 
e.Handled = true; 
rootFrame .GoBack ().; 
} 
} 
在 桌面 模式 中 运行 这 个 应 用 程序 时 ， 可 以 看 到 后 退 按钮 位 于 上 边界 的 左边 角落 里 ( 见 图 33-25)。 如 果 应 用 程 
序 在 平板 模式 下 运行 ， 边 界 是 不 可 见 的 ， 但 后 退 按钮 显示 在 底部 边界 Windows 按钮 的 旁边 ( 见 图 33-26)。 这 是 
应 用 程序 的 新 后 退 按钮 。 如 果 应 用 程序 不 能 导航 ， 用 户 按 下 后 退 按 钮 ， 就 导航 回 以 前 的 应 用 程序 。 


PageNavigation 一 口 


Second Page 


Navigation Mode: New 


Data 


Navigate to Third Page 


图 33-25 33-26 
33.9.5 Hub 


也 可 以 让 用 户 使 用 Hub 控件 在 单个 页 面 的 内 容 之 间 导 航 。 这 里 可 以 使 用 的 一 个 例子 是 , 希望 显示 一 个 图 像 ， 
作为 应 用 程序 的 入 口 点 ， 用 户 滚动 时 显示 更 多 的 信息 (参见 图 33-27 中 Microsoft Store 的 照片 搜索 应 用 程序 )。 

使 用 Hub 控件 可 以 定义 多 个 部 分 。 每 个 部 分 有 标题 和 内 容 。 也 可 以 让 标题 可 以 单 击 ， 例 如 ， 导 航 到 详细 信 
恩 页 面 上 。 以 下 代码 示例 定义 了 一 个 Hub 控件 , 在 其 中 可 以 单 击 部 分 2 和 部 分 3 的 标题 。 单 击 菜 部 分 的 标题 时 ， 
就 调用 Hub 控件 的 SectionHeaderClick 事件 指定 的 方法 。 每 个 部 分 都 包括 一 个 标题 和 一 些 内 容 。 部 分 的 内 容 由 
DataTemplate 定义 (代码 文件 NavigationControls / HubPage.xaml): 


<Hub Background="{ThemeResource ApplicationPageBackgroundThemeBrush}" 
SectionHeadercClick="{X:Bind OnHeadercClick} "> 
<Hub.Header> 
<StackPanel Orientation="Horizontal"> 
<TextBlock>Hub Header</TextBlock> 
<TextBlock Text="{x:Bind Info, Mode=TwoWay}™" /> 
</StackPanel> 
</Hub.Header> 
<HubSection Width="400™ Background="LightBlue™ Tag="Section 1"> 
<HubSsSection.Header> 
<TextBlock>Section 1 Header</TextBlock> 
</HubSection.Header> 
<DataTemplate> 
<TextBlock>Section 1l</TextBlock> 
</DataTemplate> 
</HubSection> 
<HubsSection Width="300™ Background="LightGreen™" IsHeaderIinteractive="True" 
Tag="Section 2"> 
<HubSection.Header> 
<TextBlock>Section 2 Header</TextBlock> 
</HubSection.Header> 
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<DataTemplate> 
<TextBlock>Section 2</TextBlock> 
</DataTemplate> 
</HubSection> 
<HubSection Width="300"™ Background="LightGoldenrodYellow" 
IsHeaderIinteractive="True™" Tag="Section 3"> 
<HubSection.Header> 
<TextBlock>Section 3 Header</TextBlock> 
</HubSection.Header> 
<DataTemplate> 
<TextBlock>Section 3</TextBlock> 
</DataTemplate> 
</HubSection> 
</Hub> 


单 击 标题 部 分 时 ，Info 依赖 属性 就 指定 Tag 属性 的 值 。Info 属性 绑 定 在 Hub 控件 的 标题 上 (代码 文件 
NavigationControls /FubPage.xaml.cs): 


Public void OnHeaderClick (object sender, HubSectionHeaderClickEventArgs e) 
{ 


Info = e.Section.Tag as string; 


} 


public string Info 
{ 
get => (string)GetValue (InfoProperty); 
Set => SetValue (InfoProperty, value); 
} 


Public static readonly DependencyProperty Inforroperty = 
DependencyProperty.Register("Info", typeof (string), typeof (HubPagel) ， 
new PropertyMetadata (string.Empty)); 


Picture Seareh 


Picture Search 


图 33-27 


运行 这 个 应 用 程序 时 ， 可 以 看 到 多 个 hub 部 分 (参见 图 33-28)， 在 部 分 2 和 部 分 3 上 有 See More 链接 ， 因 


为 在 这 些 部 分 中 ， 将 IsSHeaderInteractive 设置 为 tue。 当 然 ， 可 以 创建 一 个 定制 的 标题 模板 ， 给 标题 指定 不 同 的 
外 观 。 
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NavigationcC ontrals 


Section 3 Header 


Section 3 
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注意 : 
创建 自 定 义 模 板 参见 第 35 章 。 


33.5.6 Pivot 


使 用 Pivot 控件 可 以 为 导航 创建 类 似 枢 轴 的 外 观 。Pivot 控件 可 以 包含 多 个 PivotItem 控件 。 每 个 PivotItem 
控件 都 有 一 个 标题 和 内 容 。Pivot 本 刁 包 含 左 、 右 标题 。 示 例 代 人 码 填 充 了 右 标 题 (代码 文件 NavigationControls/ 
PivotPage.Xaml): 


<Pivot TILt1Le="P1IVct Sample" 

Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 

<Pivot.RightHeader> 
<StackPanel> 

<TextBlock>Right Header</TextBlock> 

</StackPanel> 

</Pivot.RightHeader> 

<PlivotItem> 
<PivotItem.Header>Header Pivot l</PivotItem.Header> 
<TextBlock>Pivot 1 Content</TextBlock> 

</PivotItem> 

<PlivotItem> 
<PivotItem.Header>Header Pivot 2</PivotItem.Header> 
<TextBlock>Pivot 2 Content</TextBlock> 

</PivotIitem> 

<PlivotItem> 
<PivotItem.Header>Header Pivot 3</PivotItem.Header> 
<TextBlock>Pivot 3 Content</TextBlock> 

</PivotItem> 

<PlivotItem> 
<PivotItem.Header>Header Pivot 4</PivotItem.Header> 
<TextBlock>Pivot 4 Content</TextBlock> 

</PivotItem> 

</Pivot> 


运行 应 用 程序 时 ， 可 以 看 到 Pivot 控件 (参见 图 33-29)。 右 标题 在 右边 总 是 可 见 。 单 击 一 个 标题 ， 可 以 查看 
项 的 内 容 。 


Pivot Sample 


Right Header 


Header Pivot 2 Header Pivot 3 Header Pivot 4 


Pivat 2 Content 


图 33-29 


第 33 章 Windows 应 用 程序 | 899 


如 果 所 有 标题 不 符合 屏幕 的 大 小 ,用户 就 可 以 滚动 。 使 用 鼠标 进行 导航 , 可 以 看 到 左右 边 的 箭头 , 如 图 33-30 
所 示 。 


Navigationt .ontrols 


Piwaet Sample 


Right Header 


eader Pivot 2 Header Pivot 3 Header Pivot > 


Pivot 2 Content 
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33.5./ NavigationView 


Windows 10 应 用 程序 通常 使 用 SplitView 控件 和 汉堡 包 技 钮 。 汉 堡 包 按 钮 用 于 打开 沫 单列 表 。 于 单 会 显示 
为 一 个 图 标 ， 如 果 有 更 多 的 可 用 空间 ， 素 单 就 显示 图 标 和 文本 。 为 了 给 内 容 和 玉 单 安排 空间 ，SplitView 控件 开 
始 发 挥 作用 。SplitView 为 窗 格 和 内 容 提供 了 空间 ， 其 中 窗 格 授 常 包含 菜单 项 。 窗 格 可 以 有 一 个 小 尺寸 和 一 个 大 
尺寸 ， 可 以 根据 可 用 的 屏幕 大 小 对 其 进行 配置 。 

在 Windows 10 构建 号 16299 之 前 ， 必 须 使 用 SplitView、 汉 堡 包 按钮 和 显示 在 窗 格 中 的 菜单 列表 ， 手 工 构 
建 用 户 界面 。 从 本 书 前 一 版 《C# 高 级 编程 (第 10 版 ) C#6 & .NET Core 1.0》 的 代码 下 载 中 可 以 获得 一 个 示例 ， 
如 果 需 要 支持 构建 号 16299 之 前 的 Windows 10 版 本 ， 这 是 必需 的 。 在 构建 号 16299 版 本 中 ， 可 以 使 用 
NavigationView 控件 .NavigationView 将 所 有 这 些 行为 集成 到 一 个 控件 中 。 图 33-31 显示 了 打开 的 NavigationView 
窗 格 。 单 击 汉堡 包 按钮 或 缩小 应 用 程序 ， 将 窗 格 更 改 为 紧凑 模式 ， 如 图 33-32 所 示 。 进 一 步 减 小 应 用 程序 的 大 
小 ， 将 NavigationView 的 左 侧 部 分 减少 为 汉堡 包 按 钮 ， 如 图 33-33 所 示 。 


Welcome CD] paireh 1 import 


i Home 


Main Tools 
上 Apps 
DD Games 


$a husic 


Nore in 人 


Settings 


图 33-31 
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图 33-32 


NavigationViewSample 


= Welcome OO Refresh I Import 


图 33-33 


下 面 讨论 NavigationView 的 特性 。 图 33-34 突出 显示 了 NavigationView 的 不 同 部 分 。NavigationView 中 定 
义 的 第 一 部 分 是 Menultems 列表 。 这 个 列表 包含 NavigationViewItem 对 象 。 每 一 项 都 包含 Ion、Content 和 
Tag。 可 以 通过 编程 方式 使 用 Tag 来 利用 这 些 信息 进行 导航 。 对 于 其 中 的 一 些 项 , 使 用 预定 义 的 图 标 。 用 home 
标记 的 NavigationViewItem 使 用 Unicode 编号 为 E10F 的 FontIcon。 要 分 离 菜 单项 ， 可 以 使 用 
NavigationViewItemSeparator。 在 NavigationViewItemHeader 中 ， 可 以 为 一 组 项 指定 标题 内 容 。 注 意 在 窗 格 处 于 紧 
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次 模式 时 不 要 前 切 该 内 容 。 在 下 面 的 代码 片段 中 , 如 果 窗 格 没有 完全 打开 , 则 会 隐藏 NavigationViewItemHeader( 代 
码 文 件 NavigationViewSample/MainPage.xaml): 


<NavigationView XxX:Name="NavigationViewl" 
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
<NavigationView.MenuItems> 
<NavigationViewItem Content="Home™" Tag="home"> 
<NavigationvViewItem.Icon> 
<FontIcon Glyph="&#xE10F; "/> 
</NavigationViewItem.Icon> 
</NavigationViewItem> 
<NavigationViewItemSeparator/> 
<NavigationViewItemHeader Content="Main Tools" 
Visibility="{x:Bind NavigationvVviewl.IsPaneQpen, Mode~OneWay}"/> 
<NavigationViewItem Icon="AllApps" Content="Apps" Tag="apps"/> 
<NavigationViewItem Icon="Video™" Content="Games" Tag="games"/> 
<NavigationViewItem Icon="Audio"™" Content="Music" Tag="music"/> 
</NavigationView.MenuItems> 


汪 i 


</NavigationView> 


Hamburger 
Navigatron\ eSamep button 


Welcome CY) pepesh = et Import 


EM HeaderTemplate 


AutoSuggestBox 


Main Tools 
注 Apps a : 
NavigationViewltemHeader 


,anes 
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PaneFooter 


More info 


局 ”Settings 
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NavigationView 的 AutoSuggestBox 属性 允许 向 导航 添加 一 个 AutoSuggestsBox 控件 。 这 显示 在 菜单 项 的 顶 
部 。AutoSuggestBox 参见 第 36 章 (代码 文件 NavigationViewSample/MainPage xaml): 


<NavigationView.AutoSuggestBox> 
<AutoSuggestBox xX:Name="autoSuggest" QueryIcon="Find"/> 
</NavigationView.AutoSuggestBox> 


使 用 HeaderTemplate， 可 以 定制 应 用 程序 的 顶部。 下 面 的 代码 片段 定义 了 一 个 带 有 Grid、TextBlock 和 
CommandBar 的 标题 模板 (代码 文件 NavigationViewSample/MainPage.xaml): 


<NavigationvVview.HeaderTemplate> 
<DataTemplate> 
<Grid Margin="8,8,0,0"> 

<Grid.columnDefinitions> 
<ColumnDefinition Width="Auto"/> 
<ColumnDefinition/> 

</Grid.columnDefinitions> 

<TextBlock Style="{StaticResource TitleTextBlockSstyle}" 
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FontSize="28" 
VerticalAlignment="Center™ 
Text="Welcome"/> 

<CommandBar Grid.cCcolumn="1" 
DefaultLabelPosition="Right"™ 
Background="{ThemeResource SystemControlBackgroundAltHighBrush}"> 
<AppBarButton Label="Refresh" Icon="Refresh"/> 
<AppBarButton Label="Import™" Icon="Import"/> 

</CommandBar> 

</Grid> 
</DataTemplate> 
</NavigationvView.HeaderTemplate> 


PaneFooter 定义 了 窗 格 的 下 半 部 分 。 在 页 脚下 方 ， 默认 显示 Settings 的 菜单 项 ; 这 个 菜单 是 默认 包含 的 ， 由 
许多 应 用 程序 使 用 (代码 文件 NavigationViewSample/MainPage.xaml): 


<NavigationView.PaneFooter> 
<HyperlinkButton x:Name="MoreInfoBtn"™ 
Content="More info™" 
Margin="12,0"/> 
</NavigationView. PaneFooter> 


最 后 ,NavigationPane 的 内 容 被 Frame 控件 覆盖 。 此 控件 用 于 导航 到 页 面 。NavigationPane 围绕 页 面 内 容 ( 代 
码 文 件 NavigationViewSample/MainPage.xaml): 


<Frame XxX:Name="ContentFrame" Margin="24"> 
<Frame.CcontentTransitions> 
<TransitionCollection> 
<NavigationThemeTransition/> 
</TransitionCollection> 
</Frame .ContentTransitions> 
</Frame> 


33.6 布局 


前 一 节 中 讨论 的 NavigationView 控件 是 组 织 用 户 界面 布局 的 一 个 重要 控件 。 在 许多 新 的 Windows 10 应 用 
程序 中 ,可 以 看 到 这 个 控件 用 于 主要 布局 。 其 他 几 个 控件 也 定义 布局 。 本 节 演示 了 Variable SizedWrapGrid 在 网 
格 中 安排 自动 包装 的 多 个 项 ，RelativePanel 相对 于 彼此 安排 各 项 或 相对 于 父 项 安排 子 项 ， 自 适应 触发 器 根据 窗 
口 的 大 小 重新 排列 布局 。 


33.6.1 StackPanel 


作为 其 内 容 ， 如 果 要 在 只 能 包含 一 个 元 素 的 控件 中 包含 多 个 元 素 ， 最 简单 的 方式 就 是 使 用 StackPanel。 
StackPanel 是 一 个 简单 的 面板 ， 只 能 逐个 地 显示 元 素 。StackPanel 的 方 癌 可 以 是 水 平 或 垂直 。 

在 下 面 的 代码 片段 中 , 页 面包 含 了 一 个 StackPanel, 其 中 包含 了 垂直 放置 的 各 个 控件 。 在 第 一 个 ListBoxItem 
的 列表 框 中 ， 包 含 一 个 横 回 排列 的 StackPanel( 代 码 文 件 LayoutSamples/Views/StackPanelPage.xaml): 


<GIid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
<StackPanel Orientation="Vertical™»> 
<TextBox Text="TextBox"™" /> 
<CheckBox Content="Checkbox™ /> 
<CheckBox Content="Checkbox"™ /> 
<ListBox> 
<L1istBoxItem> 
<StackPFanel Orientation="Horizontal"™> 
<TextBlock Text="One A™ /> 
<TextBlock Text="One B" /> 
</StackPanel> 
</ListBoxItem> 
<ListBoxItem Content 一 Twon /> 
</ListBox> 
<Button Content="Button™ /> 
</StackPanel> 
</Grid> 


在 图 33-35 中 , 可 以 看 到 StackPanel 垂直 显示 的 子 控件 。 


图 33-35 


33.6.2 Canvas 


Canvas 是 一 个 允许 显 式 指定 控件 位 置 的 面板 。 它 定义 了 相关 的 Left、Right、Top 和 Bottom 属性 ， 这 些 属性 
可 以 由 子 元 素 在 面板 中 定位 时 使 用 (代码 文件 LayoutSamples/Views/CanvasPage.xaml)。 
图 33-36 显示 了 Canvas 面板 的 结果 ， 其 中 定位 了 子 元 素 TextBlock、TextBox 和 Button 。 


<Canvas Background="LightBlue™"> 
<TextBlock Canvas.Top="30" Canvas.Left="20">Enter here:</TextBlock> 
<TextBox Canvas.Top="30" Canvas.Left="120"™ Width="100" /> 
<Button Canvas.Top="70" Canvas.Left="120" Content="Click Me!™" Padding="4" /> 


</Canvas> 
LayoutSamples 
| 
33-36 
注意 : 
Canvas 控件 最 适合 用 于 图 形 元 素 的 布局 ， 例 如 第 35 章 介 绍 的 Shape 控件 。 
33.6.3 Grid 


Grid 是 一 个 重要 的 面板 .使 用 Grid, 可 以 在 行 和 列 中 排列 控件 .对 于 每 一 列 , 可 以 指定 一 个 ColumnDefinition; 
对 于 每 一 行 ， 可 以 指定 一 个 RowDefinition。 下 面 的 示例 代码 显示 两 列 和 三 行 。 在 每 一 列 和 每 一 行 中 ， 都 可 以 指 
定 宽度 或 高 度 。ColumnDefinition 有 一 个 Width 依赖 属性 ，RowDefinition 有 一 个 Height 依赖 属性 。 可 以 以 设备 
独立 的 像素 为 单位 定义 高 度 和 宽度 ， 或 者 把 它们 设置 为 Auto， 根 据 内 容 来 确定 其 大 小 。Grid 还 允许 使 用 “ 星 型 
大 小 ”， 即 根据 具体 情况 指定 大 小 ， 即 根据 可 用 的 空间 以 及 与 其 他 行 和 列 的 相对 位 置 计 算 行 和 列 的 空间 。 在 
为 列 提供 可 用 空间 时 ， 可 以 将 Width 属性 设置 为 “*”。 要 使 某 一 列 的 空间 是 男 一 列 的 两 倍 ， 应 指定 “2*”。 下 
面 的 示例 代码 定义 了 两 列 和 三 行 ， 列 使 用 “ 星 型 大 小 ”， 第 一 行 的 大 小 固定 ， 第 二 行 和 第 三 行 再 次 使 用 “ 星 型 大 
小 ” 在 计算 高 度 时 ， 可 用 空间 需要 减 去 第 一 行 的 200 像素 ,剩余 的 区 域 在 第 二 行 和 第 三 行 中 按 比例 1.5:1 来 分 配 。 

这 个 Grid 包含 几 个 Rectangle 控 件 , 它 们 用 不 同 的 颜色 使 单元 格 的 尺寸 可 见 。 因 为 这 些 控件 的 父 控件 是 Grid， 
所 以 可 以 设置 附加 属性 Column、ColumnSpan、Row 和 RowSpan( 代 码 文 件 LayoutSamples/Views/GridPage.xaml)。 


<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
<GIrid.columnDefinitions> 
<ColumnDefinition /> 
<ColumnDefinition /> 
</Grid.columnDefinitions> 
<Grid.RowDefinitions> 
<RowDefinition Height="200" /> 
<RowDefinition Height="1.5*" /> 
<RowDefinition Height="#*"™ /> 
</Grid.RowDefinitions> 
<Rectangle Fill="Blue™" /> 
<Rectangle Grid.Row="0" Grid.Column="1" Fill="Red™ /> 
<Rectangle Grid.Row="1" Grid.columm="0" Grid.cColumnspan="2" Fill="Green"™" /> 
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<Rectangle Grid.Row="2" Grid.Column="0" Grid-ColumnSpan="2" Fill="Yellow" /> 
</Grid> 


在 Grid 中 排列 控件 的 结果 如 图 33-37 所 示 。 


,| Layout$amples 


图 33-37 
33.6.4 VariableSizedWrapGrid 


VariableSizedWrapGrid 是 一 个 包装 网 格 ， 如 果 网 格 可 用 的 大 小 不 够 大 ， 它 会 目 动 换 到 下 一 行 或 列 。 这 个 表 
格 的 第 二 个 特征 是 允许 项 放 在 多 行 或 多 列 中 ， 这 就 是 为 什么 它 称 为 可 变 的 原因 。 

下 面 的 代码 片段 创建 一 个 VariableSizedWrappedGrid， 其 方向 是 Horizontal， 行 中 最 多 有 20 项 ， 行 和 列 的 大 
小 是 S0( 代 码 文件 LayoutSamples/Views/VariableSizedWrapGridSample.xaml): 


<VariableSsizedWrapGrid x:Name="gridl™" MaximumRowsoOrColumns="20"™" ItemHeight="50" 
ItemWidth="50" Orientation="Horizontal™" /> 


VariableSizedWrapGrid 填充 了 30 个 随机 大 小 和 颜色 的 Rectangle 和 TextBlock 元 素 。 根 据 大 小 ， 可 以 在 网 
格 内 使 用 1 到 3 行 或 列 。 项 的 大 小 使 用 附加 属性 VariableSizedWrapGrid.ColumnSpan 和 VariableSizedWrap- 
Grid.RowSpan 设置 (代码 文件 LayoutSamples/Views/VariableSizedWrapGridSample. xaml.cs): 


protected override void OnNavigatedTo (NavigationEventArgs e) 
{ 
base.OnNavigatedTo (e); 
Random 工 = new Random!().; 
Grid[] items = 
Enumerable.Range (0, 30) .Select(1i 三 > 
{ 
byte[] colorBvytes = new bytel[l3]; 
r.NextBytes (colorBytes).; 
var rect = new Rectangle 


Height = r.Next (40, 150), 
Width = r.Next (40, 150), 


Fill = new SolidColorBrush (new Color 
{ 
及 = colorBytes[0], 
G = colorBytes[i1], 
B = colorBytes[2], 
A 一 255 
}) 
上 


var textBlock = new TextBlock 

{ 
Text = (1 + 1) .ToStringt{(), 
HorizontalAlignment = HorizontalAlignment.Center, 
VerticalAlignment = VerticalAlignment.Center 


}s 
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var grid = new Grid(}); 
grid.children.Add (Tect) ; 
grid.children.Add (textBlock); 
return grid; 

}) .ToArray (}; 


foreach (var item in items) 
{ 
gridl.children.Add (item); 
Rectangle rect = item.Children.First() as Rectangle; 
if (rect.Width > 50) 
{ 
int columnspan = ((int)rect-Widadth / 50) + 1; 
VariableSizedWHrapGrid.SetColummSpan(litem, colummSpan); 
int rowSspan = (({int)rect.Height / 50) + 1; 
VariableSizedWHrapGrid.SetRowSpanl(litem, rowSpan); 


} 
} 
运行 应 用 程序 时 ， 可 以 看 到 矩形， 它们 占用 了 不 同 的 窗口 ， 如 图 33-38 和 图 33-39 所 示 。 


LayoutSamples 


33-39 
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33.6.5 RelativePane| 


RelativePanel 是 UWP 的 一 个 新 面板 ， 允 许 一 个 元 素 相 对 于 男 一 个 元 素 定 位 。 如 果 使 用 的 Grid 控件 定义 了 
行 和 列 ， 且 需要 插入 一 行 ， 就 必须 修改 插入 行 下 面 的 所 有 元 素 。 原 因 是 所 有 行 和 列 都 按 数字 索引 。 使 用 
RelativePanel 就 没有 这 个 问题 ， 它 允许 根据 元 素 的 相对 关系 放置 它们 。 


注意 : 
与 RelativePanel 相 比 ，Grid 控件 仍然 有 它 的 自动 、 星 形 和 固定 大 小 的 优势 。 


下 面 的 代码 片段 在 RelativePanel 内 对 齐 数 个 TextBlock 和 TextBox 控件 、 一 个 按钮 和 一 个 矩形 。TextBox 元 
素 定 位 在 相应 TextBlock 元 素 的 右边 ; 按钮 相对 于 面板 的 底部 定位 ， 拖 形 与 第 一 个 TextBlock 的 顶部 对 齐 ， 与 第 
一 个 TextBox 的 右边 对 齐 (代码 文件 LayoutSamples/Views/RelativePanelPage.xaml): 


<RelativePanel> 
<TextBlock x:Name="FirstNameLabel"™ Text="First Namen Margin="8" /> 
<TextBox Xx:Name="FirstNameText" RelativePanel .Rightof="FirstNameLabel" 
Margin="8" Width="150" /> 
<TextBlock Kk:Name="LastNameLabel™ Text="Last Name™ 
RelativePanel .Below="FirstNameLabel™" Margin="8" /> 
<TextBox xXx:Name="LastNameText" RelativePanel .Rightof="LastNameLabel™" 
Margin="8" RelativePanel .Below="FirstNameText" Width="150" /> 
<Button Content="Save" RelativePanel.AlignHorizontalCenterWith="LastNameText" 
RelativePanel.AlignBottomWithPanel="True" Margin="8" /> 
<Rectangle xXx:Name="Image™" Fill="Violet™ Width="150" Helght="250" 
RelativePanel .AlignTopWith="FirstNameLabel™ 
RelativePanel .Rightof="FirstNameText" Margin="8" /> 
</RelativePanel> 


图 33-40 显示 了 运行 应 用 程序 时 对 齐 控件 。 


Lawoutsarmples5 


图 33-40 


33.6.6” 自 适应 触发 器 


RelativePanel 是 用 于 对 齐 的 一 个 好 控件 。 但 是 ， 为 了 文 持 多 个 屏幕 大 小 ， 根 据 屏 幕 大 小 重新 排列 控件 ， 可 
以 使 用 目 适 应 触发 器 与 RelativePanel 控件 。 例如 , 在 小 屏幕 上 , TextBox 控件 应 该 安排 在 TextBlock 控件 的 下 方 ， 
但 在 大 的 屏幕 上 ，TextBox 控件 应 该 在 TextBlock 控件 的 右边 。 
在 以 下 代码 中 ， 之 前 的 RelativePanel 改 为 删除 RelativePanel 中 不 应 用 于 所 有 屏幕 尺寸 的 所 有 附加 属性 ， 添 
加 一 个 可 选 的 图 片 (代码 文件 LayoutSamples/Views/AdaptiveRelativePanelPage.xam]l): 
<RelativePanel Scroll]Viewer.VerticalScrollBarVisibility="Auto™ Margin="16"> 
<TextBlock x:Name="FirstNameLabel™" Text="First Name" Margin="8" /> 
<TextBox x:Name="FirstNameText" Margin="8" Width="150" /> 
<TextBlock x:Name="LastNameLabel™ Text="Last Name™ Margin="8" /> 
<TextBox x:Name="LastNameText" Margin="8"™ Width="150" /> 


<Button Content="Save" RelativePanel.AlignBottomWithPanel="TIrue" 
Margin="8" /> 
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<Rectangle Xx:Name="Image™" Fill="Violet"™" Width="150™" Heilght="250" 
Margin="8" /> 
<Rectangle x:Name="OptionallImage" RelativePanel .AlignRightWithPanel="True™" 
Fill="Red™" Width="350" Height="350" Margin="8" /> 
</RelativePanel> 


使 用 自 适 应 触发 器 (当局 动 触发 器 时 ， 可 以 使 用 自 适 应 触发 器 设置 MinWindowWidth)， 设 置 不 同 的 属性 值 ， 
根据 应 用 程序 可 用 的 空间 安排 元 素 。 随 着 屏幕 太 寸 越 来 越 小 ， 这 个 应 用 程序 所 需 的 宽度 也 会 变 小 。 癌 下 移动 元 
系 ， 而 不 是 癌 劳 边 移 动 ， 可 以 减少 所 需 的 宽度 。 另 外 ， 用 户 可 以 网 下 滚动 。 对 于 最 小 的 窗口 宽度 ， 可 选 图 像 设 
置 为 收缩 (代码 文件 LayoutSamples/Views/AdaptiveRelativePanelPage.xaml): 


<VisualstateManager .VisualstateGroups> 
<VisualSstateGroup> 
<Visualstate x:Name="WideSstate™"> 
<VisualSstate.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="1024" /> 
</VisualState.StateTriggers> 
<Visualstate.Setters> 
<Setter Target="FirstNameText. (RelatijvePanel .Rightof})" 
Value="FirstNameLabel"™" /> 
<Setter Target="LastNameLabel. (RelativePanel.Below)™" 
Value="FirstNameLabel™ /> 
<Setter Target="LastNameText. (RelativePanel .Below)™" 
Value="FirstNameText"™" /> 
<Setter Target="LastNameText. (RelativePanel .Rightof})™" 
Value="LastNameLabe]l™ /> 
<Setter Target="Image. (RelativePanel .AlignTopWith)™" 
Value="FirstNameLabel™ /> 
<Setter Target="Image. (RelativePanel .Rightof)" Value="FirstNameText™ /> 
</VisualSsState.Setters> 
</Visualstate> 
<Visualstate x:Name="MediumSstate"™> 
<Visualstate.SstateTriggers> 
<AdaptiveTrigger MinWindowWidth="720"™ /> 
</Visualstate.StateTriggers> 
<Visualstate.Setters> 
<Setter Target="FirstNameText. (RelativePanel .Rightof)}" 
Value="FirstNameLabel™ /> 
<Setter Target="LastNameLabel. (RelativePanel .Below)™" 
Value="FirstNameLabel™ /> 
<Setter Target="LastNameText. (RelativePanel .Below)™" 
Value="FirstNameText"™ /> 
<Setter Target="LastNameText. (RelativePanel .Rightof)™" 
Value="LastNameLabel™ /> 
<Setter Target="Image. (RelativePanel.Below)" Value="LastNameText" /> 
<Setter Target="Image. (RelativePanel.AlignHorizontalCenterWith)" 
Value="LastNameText™ /> 
</Visualstate.Setters> 
</Visualstate> 
<Visualstate x:Name="NarrowSstate"> 
<Visualstate.SstateTriggers> 
<AdaptiveTrigger MinWindowWidth="320"™ /> 
</Visualstate.SsStateTriggers> 
<Visualstate.SsSetters> 
<Setter Target="FirstNameText. (RelativePanel .Below)™" 
Value="FirstNameLabel™ /> 
<Setter Target="LastNameLabel. (RelativePanel.Below)™" 
Value="FirstNameText"™ /> 
<Setter Target="LastNameText. (RelativePanel .Below})™" 
Value="LastNameLabel™ /> 
<Setter Target="Image. (RelativePanel.Below)" Value="LastNameText" /> 
<Setter Target="OptionalImage .Visibility" Value="Collapsed"™" /> 
</Visualstate.SsSetters> 
</Visualstate> 
</VisualstateGroup> 
</VisualstateManager .VisualstateGroups> 


通过 ApplicationView 类 设置 SetPreferredMinSize， 可 以 建立 应 用 程序 所 需 的 最 小 窗口 宽度 (代码 文件 
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LayoutSamples/App.xXaml.cs): 


protected override void OnLaunched (LaunchActivatedEventArgs e) 
{ 

ApplicationView.GetForCurrentView() .SetPreferredMinsize ( 

new Size { Width = 320, Height = 300 }); 

PF 。 
} 


运行 应 用 程序 时 , 可 以 看 到 最 小 宽度 的 布局 安排 ( 见 图 33-41)、 中 等 宽度 的 布局 安排 ( 见 图 33-42) 和 最 大 宽度 
的 布局 安排 ( 见 图 33-43)。 


Livoutdamples 一 日 号 


First Narme 


[I _ | 


Last Name 


图 33-41 


LayoutSamples 一 口 总 


Last Marne ] 


ae 


图 33-42 
Liye ule 一 面 | 二 


Last Name | 


dawe 


图 33-43 
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33.6.7 XAML 视图 


目 适 应 触发 器 可 以 帮助 支持 很 多 不 同 的 窗口 大 小 ， 支 持 应 用 程序 的 布局 ， 以 便 在 Xbox、HoloLens 和 不 同 
分 辨 率 的 蝎 面 上 运行 。 如 果 应 用 程序 的 用 户 界 面 应 该 有 比 使 用 RelativePanel 更 多 的 差异 ， 最 好 的 选择 是 使 用 不 
同 的 XAML 视图 。XAML 视图 只 包含 XAML 代码 ， 并 使 用 与 相应 页 面相 同 的 代码 隐藏 文件 。 可 以 为 每 个 设备 
系列 创建 同一 个 页 面 的 不 同 XAML 视图 。 

通过 创建 一 个 文件 夹 DeviceFamily-Mobile， 可 以 为 移动 设备 定义 XAML 视图 。 设 备 专用 的 文件 夹 总 是 以 
DeviceFamily 名 称 开 头 。 支 持 的 其 他 设备 系列 有 Team、Desktop 和 IoT。 可 以 使 用 这 个 设备 系列 的 名 字 作 为 后 
级 ， 指 定 相 应 设备 系列 的 XAML 视图 。 使 用 XAML View Visual Studio 项 模板 创建 一 个 XAML 视图 。 这 个 模板 
创建 XAML 代码 ， 但 没有 代码 隐藏 文件 。 这 个 视图 需要 与 应 该 更 换 视 图 的 页 面 同名 。 

除了 为 移动 XAML 视图 创建 男 一 个 文件 夹 之 外 ,还 可 以 在 页 面 所 在 的 文件 夹 中 创建 视图 , 但 视图 文件 使 用 
DeviceFamily-Mobile 命名 。 


33.6.8 ”延迟 加 载 


为 了 使 证 更 快 ， 可 以 把 控件 的 创建 延迟 到 需要 它们 时 再 创建 。 在 小 型 设备 上 ， 可 能 根本 不 需要 一 些 控件 ， 
但 如 果 系 统 使 用 较 大 的 屏幕 ， 也 比较 快 ， 就 需要 这 些 控 件 。 在 XAML 应 用 程序 的 先前 版 本 中 ， 添 加 到 XAML 
代码 中 的 元 系 也 被 实例 化 。Windows 10 不 再 是 这 种 情况 ， 而 可 以 把 控件 的 加 载 延 迟到 需要 它们 时 加 载 。 

可 以 使 用 延迟 加 载 和 目 适 应 触发 器 ， 只 在 稍 后 的 时 间 加 载 一 些 控件 。 一 个 样本 场景 是 ， 用 户 可 以 把 小 窗口 
调整 得 更 大 。 在 小 窗口 中 ， 有 些 控件 不 应 该 是 可 见 的 ， 但 它们 应 该 在 更 大 的 窗口 中 可 见 。 延 迟 加 载 可 能 有 用 的 
另 一 个 场景 是 ， 布 局 的 某 些 部 分 可 能 需要 更 多 时 间 来 加 载 。 不 是 让 用 户 等 待 ， 直 到 显示 出 完整 如 载 的 布局 ， 而 
可 以 使 用 延迟 加 载 。 

要 使 用 延迟 加 载 ， 需 要 给 控件 添加 x: Load 特性 (其 值 为 Falsej， 如 下 面 带 有 Grid 控件 的 代码 片段 所 示 。 这 
个 控件 也 需要 分 配 一 个 名 字 ( 代 码 文 件 LayoutSamples/Views/DelayLoadinePage.xaml): 

所 GT x:Load="False" x:Name="deferGrid"> 

<CGrid.columnDefinitions> 
<ColumnDefinition /> 
<ColumnDefinition /> 
</CGrid.columnDefinitions> 
<CGrid.RowDefinitions> 
<RowDefinition /> 
<RowDefinition /> 
</CGrid.RowDefinitions> 
<Rectangle Fill="Red™" Grid.Row="0"™" Grid.Column="0" /> 
<Rectangle Fill="Green™" Grid.Row="0" Grid.Columm="1" /> 
<Rectangle Fill="Blue™" Grid.Row="1"™ Grid.column="0" /> 


<Rectangle Fill="Yellow" Grid.Row="1" Grid.Colummnm="1" /> 
</Grid> 


为 了 使 这 个 延迟 的 控件 可 见 ， 只 需要 调用 FindName 方法 访问 控件 的 标识 符 。 这 不 仅 使 控件 可 见 ， 而 且 会 
在 控件 可 见 前 加 载 控件 的 XAML 树 (代码 文件 LayoutSamples/Views/DelayLoadingPage. xaml.cs): 
private void DOnDeferLoad (ob]Jject sender, RoutedEventArgs e) 


FindName (nameof (deferGrid})).; 


注意 : 
x:Load 特性 是 构建 版 本 15063 中 新 增 的 。 在 构建 版 本 15063 之 前 ， 可 以 使 用 x:DeferLoadingStrategy 特性 。 
XxX:Load 的 优点 是 元 素 也 可 以 在 加 载 后 却 载 。 


运行 应 用 程序 时 ， 可 以 用 Live Visual Tree 窗口 验证 ， 包 含 deferGrid 元 素 的 树 不 可 用 ( 见 图 33-44)， 但 在 调 
用 FindName 方法 找到 deferGrid 元 素 后 ，deferGrid 元 素 就 添加 到 树 中 (参见 图 33-45)。 
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口 | 虽 回 品 | 得 所 于 团 印 
Search Live Visual Tree (Alt+6) 
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二 是 
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Search Live Visual Tree (Alt+6) 
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4 《yy [RootscrollViewer] 
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口 [Rectangle] 图 
b Dy [Button| 加 


图 33-45 


特性 x:Load 有 大 约 600 字 节 的 开销 ， 所 以 应 该 只 在 需要 隐藏 的 元 素 上 使 用 它 。 如 果 在 容器 元 素 上 使 用 此 特 


性 ， 就 只 需要 向 应 用 该 特性 的 元 素 支付 一 次 开销 。 


33.7 ”小 结 


本 章 介 绍 了 Windows 应 用 程序 编程 的 许多 不 同方 面 ， 了 解 了 XAML 的 基础 ， 以 及 它 如 何 使 用 附加 属性 和 
标记 扩展 来 扩展 XML。 学 习 了 如 何 使 用 条 件 XAML 处 理 不 同 Windows 10 版 本 中 的 XAML 差异 。 

本 章 讨 论 了 如 何 处 理 不 同 的 屏幕 大 小 、 使 用 不 同 面板 布置 控件 的 选项 ， 以 及 不 同 控件 的 类 别 和 特性 。 

下 一 章 将 继续 介绍 基于 XAML 的 应 用 程序 、MVVM 模式 、 命 令 和 创建 可 共享 的 视图 模型 。 


二 


模式 和 XAML 应 用 程序 


本 章 要 点 

共享 代码 

创建 模型 

创建 存储 库 

创建 视图 模型 

页 面 之 间 的 导航 

自 适 应 用 户 界面 
使 用 事件 聚合 器 

带 视图 模型 的 列表 项 


本 章 源 代码 下 载 地 址 (wrox.com); 

打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Patterms 和 
PatternsXamarinShared 目录 的 https://github.com/ProfessionalCSharp/ProfessionalCSharp7 中 找到 。 库 在 第 34 章 和 
第 37 章 之 间 共 享 。 

本 章 代 码 包 含 项 目 BooksApp。 


34.1 使 用 MVVM 的 原因 


技术 和 框架 一 直 在 改变 。 我 用 ASPNET Web Forms 创建 了 公司 网 站 的 第 1 版 (http://www.cninnovation.com)。 
在 ASPNET MVC 出 现时 , 我 试 着 把 网 站 的 功能 迁移 到 MVC。 进度 比 预期 的 要 快 得 多 。 一 天 之 内 就 把 完整 的 网 
站 改 为 MVC。 该 网 站 使 用 SQL Server, 集成 了 RSS 提要 , 显示 了 培训 和 图 书 。 关于 培训 和 图 书 的 信息 来 自 SQL 
Server 数据 库 。 可 以 快速 迁移 到 ASPNET MVC， 只 是 因为 我 从 一 开始 就 分 离 了 关注 点 ， 为 数据 访问 和 业务 好 
辑 创 建 了 独立 的 层 。 有 了 ASPNET Web Forms， 可 以 在 ASPX 页 面 中 直接 使 用 数据 源 和 数据 控件 。 分 离 数 据 访 
问 和 业务 逻辑 ， 一 开始 花 了 更 多 的 时 间 ， 但 它 变 成 一 个 巨大 的 优势 ， 由 于 它 允 许 单 元 测试 和 重用 。 因 为 以 这 样 
的 方式 进行 分 离 ， 所 以 迁移 到 男 一 个 技术 真是 太 容 易 了 。 目 前 这 个 站 点 使 用 ASPNET Core 运行 。 

对 于 Windows 应 用 程序 ， 技 术 也 变 得 很 快 。 多 年 来 ，Windows Forms 技术 包装 了 本 地 Windows 控件 ， 来 创 
建 桌 面 应 用 程序 ,之 后 出 现 了 Windows Presentation Foundation(WPF), 在 其 中 用 户 界 面 使 用 eXtensible Application 
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Markup Language (XAML) 定 义 。Silverlight 为 在 浏览 器 中 运行 的 、 基 于 XAML 的 应 用 程序 提供 了 一 个 轻 量 级 的 
框架 。Windows Store 应 用 程序 随 着 Windows 8 而 出 现 ， 在 Windows 8.1 中 改 为 通用 Windows 应 用 程序 ， 运 行 
在 个 人 电脑 和 Windows Phone 上 。 在 Windows 8.1 和 Visual Studio 2013 中 ， 创 建 了 三 个 带 有 共享 代码 的 项 目 ， 
同时 支持 个 人 电脑 和 手机 。 接 着 义 变 成 Visual Studio 2015、Windows 10、 通 用 Windows 平台 (UWP)。 一 个 项 目 
可 以 支持 个 人 电脑 、 手 机 、Xbox One、Windows IoT、 带 有 Surface Hub 的 大 屏幕 ， 甚 至 Microsoft 的 HoloLens。 

一 个 支持 所 有 Windows 10 平台 的 项 目 可 能 不 满足 需求 。 可 以 编写 一 个 仅 文 持 Windows 10 的 程序 吗 ? 一 些 
客户 可 能 仍 在 运行 Windows 7。 在 这 种 情况 下 , 应 使 用 WPF, 但 它 不 支持 手机 和 其 他 Windows 10 设备 ,如 HoloLens 
和 Xbox。 如 何 文 持 Android 和 iOS 呢 ? 在 这 里 ， 可 以 使 用 Xamarin 创建 C# 和 .NET 代码 ， 但 它 是 不 同 的 。 

目标 应 该 是 重用 尽 可 能 多 的 代码 ， 文 持 所 需 的 平台 ， 很 容易 从 一 种 技术 切换 到 另 一 种 。 这 些 目标 (在 许多 组 
织 中 ， 管 理 和 开发 部 门 加 入 DevOps， 会 很 快 给 用 户 带 来 新 的 功能 ， 修 复 缺 陷 ) 要 求 上 自动化 测试 。 单 元 测试 是 必 
需 的 ， 应 用 程序 体系 结构 需要 支持 它 。 


注意 : 
单元 测试 参见 第 28 章 。 


有 了 基于 XAML 的 应 用 程序 , Model-View-ViewModel(MVVM) 设 计 模 式 便于 分 离 视 图 和 功能 。 该 设计 模式 
是 由 Expression Blend 团队 的 John Gossman 发 明 ， 能 更 好 地 适应 XAML， 改 进 了 Model-View-Controller (MVC) 
和 Model-View-Presenter(MVP) 模 式 ， 因 为 它 使 用 了 XAML 的 首要 功能 : 数据 绑 定 。 

有 了 基于 XAML 的 应 用 程序 ，XAML 文件 和 代码 隐藏 文件 是 紧密 耦合 的 。 这 很 难 重 用 代码 隐藏 文件 ， 单 
元 测试 也 很 难 做 到 。 为 了 解决 这 个 问题 ， 人 们 提出 了 MVVM 模式 ， 它 允许 更 好 地 分 离 用 户 界面 和 代码 。 

原则 上 ，MVVM 模式 并 不 难 理解 。 然 而 ， 基 于 MVVM 模式 创建 应 用 程序 时 ， 需 要 注意 更 多 的 需求 :， 几 个 
模式 会 发 挥 作用 ， 使 应 用 程序 工作 起 来 ， 使 重用 成 为 可 能 ， 包 括 依 赖 注入 机 制 独立 于 视图 模型 的 实现 和 视图 模 
型 之 间 的 通信 。 

本 章 介 绍 这些 内 容 ， 有 了 这 些 信息 ， 不 仅 可 以 给 Windows 应 用 程序 和 卓 面 应 用 程序 使 用 相同 的 代码 ， 还 可 
以 在 Xamarin 的 帮助 下 把 它 用 于 iOS 和 Android。 本 章 给 出 一 个 示例 应 用 程序 ， 其 中 包括 了 所 有 不 同 的 方面 和 
模式 ， 实 现 很 好 的 分 离 ， 支 持 不 同 的 技术 。 


34.2 定义 MVVM 模式 


首先 看 看 MVVM 模式 的 起 源 之 一 : MVC 设计 模式 。Model-View-Controller (MVC) 模 式 分 离 了 模型 、 视 图 
和 控制 器 ( 见 图 34-1)。 模 型 定义 视图 中 显示 的 数据 ， 以 及 改变 和 操纵 数据 的 业务 规则 。 控 制 器 是 模型 和 视图 之 
间 的 管理 器 ， 它 会 更 新 模型 ， 给 视图 发 送 要 显示 的 数据 。 当 用 户 请 求 传 入 时 ， 控 制 器 就 采取 行动 ， 使 用 模型 ， 


更 新 视图 。 
、 人 
图 34-1 


C 模式 大 量 用 于 ASPNETMVC， 参 见 第 31 章 。 
通过 Model-View-Presenter(MVP) 模 式 ( 见 图 34-2)， 用 户 与 视图 交互 操作 。 显 示 程 序 包 含 视图 的 所 有 业务 逻 
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和 辑 。 显 示 程 序 可 以 使 用 一 个 视图 的 接口 作为 协定 ， 从 视图 中 解除 耦合 。 这 样 就 很 容易 改变 单元 测试 的 视图 实现 。 
在 MVP 中 ， 视 图 和 模型 是 完全 相互 隔离 的 。 


Eb 


图 34-2 


基于 XAML 的 应 用 程序 使 用 的 主要 模式 是 Model-View-ViewModel(MVVM)( 见 图 34-3)。 这 种 模式 利用 数 
据 绑 定 功能 与 XAML。 通 过 MVVM， 用 户 与 视图 交互 。 视 图 使 用 数据 绑 定 来 访问 视图 模型 的 信息 ， 并 在 绑 定 
到 视图 上 的 视图 模型 中 调用 命令 。 视 图 模型 没有 对 视图 的 直接 依赖 项 。 视 图 模型 本 喘 使 用 模型 来 访问 数据 ， 获 
得 模型 的 变更 信息 。 


图 34-3 


本 半 的 下 面 几 节 介绍 如 何 使 用 这 个 架构 与 应 用 程序 创建 视图 、 视 图 模型 、 模 型 和 其 他 需要 的 模式 。 


34.3 ”共享 代码 


在 创建 这 个 示例 解雇 方案 ， 开 始 创建 模型 之 前 ， 需 要 回 过 头 来 看 看 不 同 的 选项 如 何在 不 同 的 平台 之 间 共 享 
代码 。 本 节 讨 论 不 同 的 选项 ， 考 虑 需要 支持 的 不 同 平台 和 所 需要 的 API。 


34.3.1 使 用 APl 协定 和 通用 Windows 平台 


通用 Windows 平台 定义 了 一 个 可 用 于 所 有 Windows 10 设备 的 API。 然 而 ， 这 个 API 在 新 版 本 中 会 改变 。 
使 用 Project Properties 中 的 Application 设置 (参见 图 34-4)， 可 以 定义 应 用 程序 的 目标 版 本 (这 是 要 构建 的 版 本 ) 
和 系统 所 需 的 最 低 版 本 。 所 选 Software Developer Kits (SDK) 的 版 本 需要 安装 在 系统 上 , 才能 验证 哪些 API 可 用 。 
为 了 使 用 目标 版 本 中 最 低 版 本 不 可 用 的 特性 ， 需 要 在 使 用 API 之 前 ， 以 编程 方式 检查 设备 是 否 支持 所 需要 的 具 
体 功能 。 
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5 | UMWpSnarin aqCode - UWPsS harnn aCede 


日 ol 
Build Events 


Debug General 
Reference Paths ee 
Signing 

Code Analysis Default namespace: UWPSharingCode 


Assembly Information... 


Package Manifest... 
Targeting 
Target: Universal Windows 


Target version: Windows 10 Fall Creators Update (10.0; Build 16299 ~ 


Min version: Windows 10 Creators Update (10.0 Build 15063) ~ 
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通过 UWP 可 以 支持 不 同 的 设备 系列 .UWP 定义 了 几 种 设备 系列 :通用 、 桌 面 (PC)、 手 机 、 物 联网 (Raspberry 
Pi)、Surface Hub、Holographic (HoloLens) 以 及 Xbox。 随 着 时 间 的 推移 ， 会 出 现 更 多 的 设备 系列 。 这 些 设 备 
系列 提供 的 API 只 能 用 于 这 个 系列 。 通 过 API 协定 指定 设备 系列 的 API。 每 个 设备 系列 可 以 提供 多 个 API 
协定 。 

可 以 使 用 设备 系列 特有 的 特性 ， 也 可 以 创建 运行 在 所 有 设备 上 的 二 进 制图 像 。 通 常情 况 下 ， 应 用 程序 不 文 
持 所 有 的 设备 系列 , 可 能 文 持 其 中 的 一 些 设备 。 为 了 文 持 特定 的 设备 系列 , 使 用 这 些 系列 的 API, 可 以 在 Solution 
Explorer 中 添加 一 个 Extension SDK; 选择 References | Add Reference， 然 后 选择 Universal Windows | Extensions 
(参见 图 34-5)。 在 那里 可 以 看 到 安装 的 SDK， 并 选择 需要 的 SDK。 


b Assemblies Filtered te: SDKks applicable to UWPSharingCode 


b Projects 
tb Shared Projects 
二 Universal Windows 


Car 
Extensions 
Recent 


kb Browse 


Name 

Microsoft Gerveral MID| DLS for Unrversal Windo... 
Microsoft Gerveral MID DLS for Universal Windo,... 
Micresett nrversal CRT Debug Runtime 
Micresoft Universal CRT DebBug Runtime 
Miecrosoft Universal CRT Debug Runtime 
Microsoft Viswal C+ 2013 Runtime Package for... 
Microsoft Wisual Studio Test Core 

Microsoft Visual Studic Test Core 

MSTest for Managed Projects 

MsTest for Managed Projects 

Wisual C++ 2012 UWP Desktop Runtime for nati... 
Visual C++ 2013 UWP Desktop Runtime for nati,., 


Visual C+ 2015 Runtime for Universal Windows... 


Visual C++ 2015 UWP Desktop Runtime for nati... 
Windows Deskteop Extensions for the UWP 
Windows Desktop Extensions for the UWP 
Windows Desktop Extensions for the UWP 
Windows loT Extensions foer the UWP 
Windows loT Extensions for the UWP 
Windows leT Extensiens fer the UWP 
Windows Mobile Extensions tor the UWP 
Windows Mobile Extenslions tor the UWP 
Windows Mobile Extensions for the UWP 
Windows Tearm Extensions for the UWP 
Windows Team Extensions for the UWP 
Windows Taam Extensions far the UWP 


Verslon 
10.0.15063.0 
10.0 .143930 
10.0,.16299.0 
10.0.15063.0 
10.0.14393.0 
14.0 

19,3 

15.0 

15.5 

15.0 

1 续 .0 

1#.0 

14.0 

0 
10.0,16299.0 
10015063.0 
10.0.14393.0 
190.0.16299.0 
10.0,15063.0 
10.0,.14393.0 
100162990 


10.0.14393.0 
190.0.16299.0 
10.0.15063.0 
10.0.14393.0 
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Name: 

Windews Maebile Extensions for 
the UWP 

Wersion: 

10.0.15063.0 

Targets: 

UAP 10.0.15063.0 


Meore Informatien 
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选择 Extension SDK 后 ， 验 证 API 协定 是 否 可 用 ， 就 可 以 在 代码 中 使 用 API。ApiInformation 类 (名 称 空间 
Windows.Foundation.Metadata) 定 义 了 IsApiContractPresent 方法 ， 在 其 中 可 以 检查 特定 主 次 版 本 的 API 协定 是 否 
可 用 。 下 面 的 代码 片段 需要 Windows Phone PhoneContract 的 主 版 本 1。 如 果 本 协定 可 用 ， 就 可 以 使 用 
VibrationDevice: 


if (ApiInformation.IsApiContractPresent ("Windows.Phone.PhoneContract", 1)) 
{ 
VibrationDevice vibration = VibrationDevice.GetDefault(); 
vibration.Vibrate (TimeSpan.FromSeconds (1)); 


} 


注意 : 
还 可 以 使 用 XAML 代码 检查 可 用 的 API 协定 。 条 件 XAML 参见 第 33 章 。 


在 所 有 地 方 检查 API 协定 的 代码 是 否 非常 复杂 ? 其 实 ， 如 果 只 针对 单一 设备 系列 ， 就 不 需要 检查 API 是 否 
存在 。 在 前 面 的 示例 中 ， 如 果 应 用 程序 只 针对 手机 ， 就 不 需要 检查 API。 如 果 针 对 多 个 设备 平台 ， 就 只 需要 检 
查 特定 于 设备 的 API 调用 。 可 以 使 用 通用 的 API 编写 有 用 的 应 用 程序 ， 用 于 多 个 设备 系列 。 如 果 用 很 多 特定 于 
设备 的 API 调用 支持 多 个 设备 系列 ， 建 议 避 人 免 使 用 ApiInformation， 而 应 使 用 依赖 注入 。 


注意 : 
依赖 注入 (DD) 和 使 用 DI 容器 参见 本 章 34.7.4 节 “ 服 务 、ViewModel 和 依赖 注入 ” 。 


34.3.2 ”使 用 共享 项 目 


对 API 协定 使 用 相同 的 二 进 制 只 适用 于 通用 Windows 平台 。 如 果 需 要 分 享 代码 ， 就 不 能 使 用 这 个 选项 ， 例 
如 , 在 带 有 WPF 的 Windows 昌 面 应 用 程序 和 UWP 应 用 程序 之 间 分 享 代码 , 或 Xamarin.Forms 应 用 程序 和 UWP 
应 用 程序 之 间 分 享 代 码 。 在 不 能 使 用 相同 二 进 制 文件 的 地 方 创建 这 些 项 目 类 型 ， 就 可 以 使 用 Visual Studio 2017 
的 Shared Project 模板 。 
使 用 Shared Project 模板 与 Visual Studio 创建 的 项 目 ， 没 有 创建 二 进 制 一 一 没有 创建 程序 集 。 相 反 ， 代 码 在 
所 有 引用 这 个 共享 项 目的 项 目 之 间 共 享 。 在 每 个 引用 共享 项 目的 项 目 中 编译 代码 。 
创建 一 个 类 ， 如 下 面 的 代码 片段 所 示 ， 这 个 类 可 用 于 引用 共享 项 目的 所 有 项 目 。 甚 至 可 以 通过 预 处 理 器 指 
令 使 用 特定 于 平台 的 代码 。Visual Studio 2017 的 Universal Windows App 模板 设置 条 件 编译 从 号 
WINDOWS UWP， 以 便 将 这 个 符号 用 于 应 该 只 为 通用 Windows 平台 编译 的 代码 。 对 于 WPF， 通 过 WPF 项 目 
把 WPF 添加 到 条 件 编译 符号 中 。 对 于 Xamarin.， 可 以 给 条 件 编译 符号 添加 XAMARIN。 
Public partial class Demo 
PUublic int Id { get; set; } 
Public string Title { get; set; ]} 
#1if WPF 
PUublic string WPFOnN]lY { get; set; } 
#endiff 
#if WINDOWS UWP 
Public string WindowsApponly {get; set; } 
#endif 
#if XAMARIN 
Public string XamarinApponly {get; set; } 
#endif 
} 


通过 Visual Studio 编辑 器 编辑 共享 代码 ， 可 以 在 左上 方 的 栏 中 选择 项 目 名 称 ， 灰 显 不 用 于 实际 项 目的 部 分 
代码 (参见 图 34-6)。 编 辑 文件 时 ， 智 能 感知 功能 还 为 所 选 的 相应 项 目 提 供 了 API。 
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-3 WPShe film ade - Gemeocs 
Bemocs 忆 其 | 


加 Uwpsharingcode "| 牌 SharedProjectDemao 
namespace SharedProject 


public class Demo 


public int 1d { get; set; } 

public string Title { get; set; } 
i#if WPF 

public string WPFOnly { Eet: set; | 
#if WINDOWS_ UWP 

public string WindowsAppOnly { get; set; } 
#1 XAMARIN 


DubBlic 5 
| 


34-6 
除了 使 用 预 处 理 器 指令 之 外 ， 还 可 以 在 WPF、UWP 或 Xamarin 项 目 中 保留 类 的 不 同 部 分 。 所 以 要 把 类 声 
明 为 partial。 
注意 : 
C# 的 partial 关键 字 参 见 第 3 章 。 


在 WPF 项 目 中 定义 相同 的 类 名 和 相同 的 名 称 空 间 时 ， 就 可 以 扩展 共 至 类 。 还 可 以 使 用 基 类 (假设 共享 项 目 
没有 定义 基 类 ): 


Public class MyBase 


{ 
i 
} 
public partial class Demo: MyBase 
{ 
public string WPFTitle => S$"WPF{Title}™; 
} 


34.3.3 使 用 .NET 标准 库 


共享 代码 的 男 一 个 选择 是 .NET 标准 库 。 如 果 所 有 技术 都 可 以 使 用 NET 标准 ， 这 就 是 一 个 简单 的 任务 : 创 
建 一 个 NET 标准 库 ， 就 可 以 在 不 同 的 平台 之 间 共 享 它 。 只 需要 关注 要 使 用 的 .NET 标准 的 版 本 就 可 以 了 。 示 例 
应 用 程序 使 用 NET 标准 2.0 库 ， 从 构建 版 本 16299、Xamarin iOS 10.14、Xamarin .Android 8.0、Xamarin Mac 3.8 
和 .NET Framework 4.6.1 开始 ， 它 就 可 以 在 Windows 应 用 程序 中 使 用 。 

注意 ;: 

标准 库 是 可 移植 类 库 (Portable Class Library，PCL) 的 替代 品 ， 使 用 起 来 要 容易 得 多 。 创 建 ,NET 标准 库 详 见 
第 19 章 。 

使 用 NET 标准 库 ， 每 个 新 版 本 都 有 额外 的 API。API 永远 不 会 被 删除 。 创 建 NET 标准 库 之 后 ， 可 以 使 用 
Project Properties 选择 应 该 文 持 的 标准 版 本 (参见 图 34-7)。 选 择 它 们 后 ， 就 限制 了 可 用 于 该 版 本 的 API。 
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Build 
Build Events 
Package hssembly name: Default namaespace: 


N/A 


Debug BooksLib Bookslib 


3igning Target framework: Output type: 


ee Class Library 

‘NET Standard 1.0 

NET Standard 1.1 

NET Standard 1.2 

NET Standard 1.3 

.NET Standard 1.4 

'NET Standard 1.5 

‘NET Standard 1. 

‘NET Standard 20 

Install other frameweorks.. | 
A manifest determines specific settngs for an application. To embed a custom manifest, first 
add it to your project and then select it from the list below. 


lean: 
Default leeon) 


tmbed manilest with default settings 


中 Resource file: 


图 34-7 


使 用 共享 项 目 时 ， 可 以 编写 只 用 于 一 个 平台 的 代码 。 要 将 代码 与 其 他 平台 区 分 开 来 ， 只 能 在 为 这 个 平台 编 
译 代码 时 ， 使 用 预 处 理 器 语句 来 编译 代码 。NET 标准 库 不 能 这 么 做 。 解决 这 个 问题 的 一 个 办 法 是 ,可 以 使 用 标 
准 库 为 代码 定义 协定 ， 在 需要 的 地 方 使 用 特定 于 平台 的 库 实现 协定 。 要 在 特定 于 平台 的 库 中 使 用 代码 和 不 特定 
于 平台 的 库 ， 可 以 使 用 依赖 注入 。 如 何 做 到 这 一 点 是 本 章 更 大 示例 的 一 部 分 ， 参 见 34.7 节 “ 视 图 模型 ”。 


注意 : 

使 用 NET 标准 库 , 可 以 添加 对 非 标准 NET 库 的 引用 。 只 要 不 使 用 在 所 有 目标 平台 上 都 不 可 用 的 API 即 可 。 
只 要 使 用 特定 于 一 个 目标 平台 的 API， 其 他 平台 就 会 崩 演 。 可 以 在 使 用 特定 的 API 之 前 添加 运行 时 检查 ， 以 避 
免 这 个 问题 。 使 用 特定 于 平台 的 代码 的 更 清晰 的 解决 方案 是 依赖 注入 ， 如 示例 应 用 程序 所 示 。 


34.4 示例 解决 方案 


示例 解决 方案 包括 一 个 Universal Windows Platform 应 用 程序 ， 用 于 显示 和 编辑 一 个 图 书 列表 。 在 第 37 章 
中 ， 这 款 应 用 将 扩展 到 iPhone 和 Android 上 。 为 此 ， 解 决 方案 使 用 如 下 项 目 : 
e BooksApp 一 一 UWP 应 用 程序 项 目 ， 是 现代 应 用 程序 的 UI， 此 应 用 程序 包含 带 有 XAML 代码 的 应 用 程 
序 视图 ， 以 及 服务 特定 于 平台 的 实现 。 
se BooksLib 一 一 一 个 .NET 标准 库 2.0， 提 供 模 型 、 视 图 模型 和 服务 来 创建 、 读 取 和 更 新 图 书 ， 所 有 平台 都 
支持 .NET 标准 2.0。 
se Framework 一 一 一 个 NET 标准 库 2.0, 包含 可 用 于 所 有 基于 XAML 的 应 用 程序 的 类 。 其 中 包括 视图 模型 
的 基 类 ， 实 现 INotifyPropertyChanged、ICommand 以 及 其 他 有 用 特性 的 实现 代码 。 
应 用 程序 的 用 户 界 面 有 两 个 视图 : 一 个 视图 显示 图 书 列表 ， 一 个 视图 显示 图 书 的 详细 信息 。 从 列表 中 选择 
一 本 书 ， 就 会 显示 细节 ， 也 可 以 添加 和 编辑 图 书 。 
BooksLib 和 Framework 库 可 以 由 带 有 XAML 代码 的 多 个 应 用 程序 使 用 一 一 例如 , UWP、WPF 和 Xamarin。 
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Framework 库 以 可 由 不 同 的 应 用 程序 使 用 的 方式 构建 而 不 仅仅 是 处 理 图 书 的 应 用 程序 。BooksLib 中 实现 了 特定 
于 图 书 的 功能 。 示 例 应 用 程序 演示 了 不 仅 在 UWP 和 Xamarin 之 间 共 享 视图 模型 ， 还 在 需要 主 /从 功能 的 不 同 应 
用 程序 之 间 共 享 视图 模型 。 视 图 模型 的 基 类 在 Framework 库 中 实现 。 


34.5 ”模型 


下 面 先 定义 模型 ， 尤 其 是 Book 类 型 。 这 个 类 型 在 UI 中 显示 和 编辑 。 为 了 支持 数据 绑 定 ， 在 用 户 界面 中 更 
新 的 属性 值 需要 实现 变更 通知 .BookId 属性 只 是 显示 , 而 不 改变 ,所 以 变更 通知 不 需要 使 用 这 个 属性 .SetProperty 
方法 由 基 类 BindableBase 定义 (代码 文件 BookslibModels/Book.cs): 


Public class Book: BindableBase 
{ 
Public int BookId { get; set; } 


private string title; 
public string Title 
{ 
get => title; 
set => Setl(ref title, value}); 
} 


private string publisher; 
public string Publisher 
{ 
get => publisher; 
set => Setl{lref publisher, value); 
} 


public override string ToString{} => Title; 
} 


34.5.1 ”实现 变更 通知 


XAML 元 素 的 对 象 源 需 要 依赖 属性 或 INotifyPropertyChanged, 才 人 允许 更 改 通知 与 数据 绑 定 ,有 了 模型 类 型 ， 
才能 实现 INotifyPropertyChanged。 为 了 让 一 个 实现 可 用 于 不 同 的 项 目 ,实现 代码 在 类 BindableBase 的 Framework 
库 项 目 内 完成 。INotifyPropertyChanged 接口 定义 了 PropertyChanged 事件 。 为 了 触发 更 改 通知 ，SetProperty 方 
法 实现 为 一 个 泛 型 函数 ， 以 文 持 任 何 属性 类 型 。 在 触发 通知 之 前 ， 检 查 新 值 是 否 与 当前 值 不 同 (代码 文件 
Framework/BindableBase.cs): 


Public abstract class BindableBase: INotifyPropertyChanged 
{ 
Public event PropertyChangedEventHandler PropertyChanged; 


protected virtual void OnPropertyChanged'( 
[CcallerMemberName] string propertyName = null) =»> 
PropertyChanged? .Invoke (this, 
new PropertyChangedEventArgs (propertyName))}).: 


protected virtual bool SetProperty<T> (ref T item, T Value， 
[CcallerMemberName] string propertyName = null) 

{ 
if (EqualityComparer<T>.Default.Equals (item, value)) return false; 
item = value; 
OnPropertyChanged (propertyName).: 
return true; 


注意 : 
依赖 属性 参见 第 33 章 。 
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34.5.2 ”使 用 Repository 模式 


接 下 来 ,需要 一 种 方法 来 检索 、 更 新 和 删除 Book 对 象 . 使 用 EF Core 可 以 在 数据 库 中 读 写 图 书 .虽然 EF Core 
可 以 在 通用 Windows 平台 上 访问 ， 但 通 彰 这 是 一 个 后 台 任 务 ， 因 此 本 章 未 涉及 。 为 了 使 后 问 可 以 在 客户 端 应 用 
程序 中 访问 ， 在 服务 器 端 选择 Web API 技术 。 这 些 主题 参见 第 26 章 和 第 32 章 。 在 客户 端 应 用 程序 中 ， 最 好 能 
独立 于 数据 存储 。 为 此 ， 定 义 Repository 设计 模式 。Repository 模式 是 模型 和 数据 访问 层 之 间 的 中 介 ， 它 可 以 作 
为 对 象 的 内 存 集合 。 它 抽象 出 了 数据 访问 层 ， 使 单元 测试 更 方便 。 

通用 接口 IQueryRepository 定义 的 方法 通过 DD 获取 一 项 , 或 获取 一 个 条 目 列表 (代码 文件 Bookslib/Services/ 
IQueryRepository.cs): 


Public interface IQueryRepository<T, in TKey> 
where T: class 

{ 
Task<T> GetItemAsync (TRKey 1d).; 
Task<IEnumerable<T>> GetItemsAsync (); 

} 


通用 接口 IUpdateRepository 定 义 方法 来 添加 、 更 新 和 删除 条 目 (代码 文件 Bookslib/Services/TUpdateRepository.cs): 


public interface IUpdateRepository<T, in TEey> 
where T: class 
{ 
Task<T> AddAsync(T item); 
Task<T> UpdateAsync (T item); 
Task<bool> DeleteAsync (TEey 1d); 
} 


IBooksRepository 接口 为 泛 型 类 型 工 定 义 Book 类 型 ,使 前 两 个 泛 型 接口 更 具体 (代码 文件 Bookslib/Services/ 
IBooksRepository.cs): 


public interface IBooOksRepository: IQUueryRepository<Book, Int> ， 
IUpdateRepository<Book, int> 

{ 

} 


使 用 这 些 接口 ， 可 以 改变 存储 库 。 创 建 一 个 示例 库 BooksSampleRepository， 它 实现 接口 IBooksRepository 
的 成 员 ， 包 含 一 个 图 书 的 初始 列表 (代码 文件 Bookslib/Services/BooksSampleRepository.cs): 


Public class BooksSampleRepository: IBooksRepository 
{ 
private List<Book> books; 
Public BooksRepository () 
{ 
InitSsampleBooks (); 
} 


private void InitSampleBooks{() 
{ 
_books = new IISt<Book> () 
{ 
new Book 
{ 
BookId = 1, 
Title = "Professional C# 了 and .NET Core 2", 
Publisher = "Wrox Press™" 
}, 
new Book 
{ 
BookId = Zz, 
Title = "Professional C# 6 and -NET Core 1.0", 
FuUublisher = "Wrox Press" 
}, 
new Book 
{ 
BookId = 3, 
Title = "Professional C# 5-0 and -NET 4.5.1"™, 
Publisher = "Wrox Press" 
}, 
new Book 


{ 
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BookId = 4, 
Title = "Enterprise Services with the -NET FTamework" ， 
Publisher = "AWL" 
} 
}; 
} 


Public Task<bool> DeleteAsync(int 1d) 
{ 


Book bookToDelete = books.Find(b => b.BookId == 1d); 
jf (bookToDelete != null) 
{ 
return Task.FromResult<bool>( books.Remove (bookToDelete)}) )}; 
} 


return Task.FromrResult<bool> (false); 
} 


public Task<Book> GetItemAsync(int 1id) => 
Task.FromResult!( books.Find(b => b.BookId == 1d))}); 


Public Task<IEnumerable<Book>> GetItemsAsync() 三 > 
Task.FromResult<IEnumerable<Book>>( books); 


public Task<Book> UpdateAsync (Book item) 
{ 


Book bookToUpdate = books.Find(b => b.BookId == item.BookId); 
int ix = books.Indexof (bookToUpdate)}); 
books[ix] = item; 


return Task.FromResult!( books[ix]); 


} 


public Task<Book> AddAsvync (Book item) 
{ 
item.BookId = books.Select(b => b.BookId) -Max() + 1; 
books.Add (item); 
return Task.FromResult (item); 
} 
} 


注意 : 
存储 库 定义 了 异步 方法 ， 但 这 里 不 需要 它们 ， 因 为 书 的 检索 和 更 新 只 在 内 存 中 进行 。 方 法 定义 为 异步 ， 是 
因为 用 于 访问 ASPNET Core Web API 的 存储 库 在 本 质 上 是 异步 的 。 


34.6 ”服务 


要 从 存储 库 中 获取 图 书 ， 需 要 使 用 一 个 服务 ， 并 且 可 以 在 访问 相同 数据 的 多 个 视图 模型 中 使 用 它 。 因 此 ， 
服务 是 在 视图 模型 之 间 共 享 数 据 的 好 地 方 。 

图 书 的 示例 服务 实现 了 泛 型 接口 ItemsService。 这 个 接口 定义 了 类 型 ObservableCollection 的 Items 属性 。 
当 集 合 发 生变 化 时 ，ObservableCollection 实现 了 用 于 通知 的 INotifyCollectionChanged 接口 。 接 口 IItemsService 
也 定义 了 SelectedItem 属性 ， 并 使 用 事件 SelectedItemChanged 更 改 通 知 。 除 此 之 外 ，RefreshAsync、 
AddOrUpdateAsync 和 DeleteAsync 都 是 需要 由 服务 类 实现 的 方法 (代码 文件 Framework/Services/IItemsService.cs): 

public interface IItemsService<T> 


{ 
Task 及 ETTEShRASYmCT) ， 


Task<T> AddOrUpdateAsync{(T item); 

Task DeleteAsync(T item); 
ObservableCollection<T> Items { get; } 

T SelectedItem { get; set; ]} 

event EventHandler<T> SelectedItemChanged; 


} 
类 BooksService 派生 目 基 类 BindableBase， 并 实现 了 泛 型 接口 IItemsService。BooksSelrvice 使 用 以 前 创建 的 
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SampleBooksRepository， 但 只 需要 IBooksRepository 接口 提供 的 这 个 类 的 功能 。 该 类 通过 构造 函数 注入 ， 
刷新 图 书 列表 、 添 加 或 更 新 图 书 以 及 删除 图 书 (代码 文件 BooksLib/Services/BooksService.cs): 


public class BooksService : BindableBase, IItemsService<Book> 


| 


} 


private ObservableCcollection<Book> books = new ObservableCollection<Book> () 7 
private readonly IBooksRepository booksRepository; 


public event EventHandler<Book> SelectedItemChanged; 


Public BooksService (IBookKsRepository repository) 
{ 
booksRepository = repository; 


} 
Public ObservableCollection<Book> Items 一 > books; 


private Book selectedItem; 
Public Book SelectedItem 
{ 

可 Et 一 > selectedIitem; 


Set 


if (Setl(lref selectedItem, Valuel) 
{ 
SelectedItemChanged? .InVOke (this, SelectedIitem); 
} 
} 
} 


Public async Task<Book> AddorUpdateAsvync (Book book) 
1 

Book updated = null; 

if (book.BookId == 0) 


{ 
updated = awalt booksRepository.AddAsync (book); 
} 
已】 Se 
{ 
updated = awalt booksRepository.UpdateAsync (book); 
} 
return updated; 


} 


Public Task DeleteAsync (Book book) => 
_booksRepository.DeleteAsync (book .BookId).; 


Public async Task RefreshAsync() 

{ 
IEnumerable<Book> books = awalt booksRepository.GetItemsAsync(); 
books.Clear (}); 
foreach (var book in books) 


{ 
books .Add (book); 
} 
SelectedItem = Items.FirstorDefault().; 


} 


既然 服务 功能 己 经 就 绪 ， 下 面 就 继续 讨论 视图 模型 。 


34.7 ”视图 模型 


每 个 视图 或 页 面 都 有 一 个 视图 模型 。 在 示例 应 用 程序 中 ，BooksPage 与 BooksViewModel 关联 。 在 后 面 的 
示例 中 ， 用 户 控件 也 可 以 有 其 特定 的 视图 模型 ， 但 这 并 不 总 是 必需 的 。BookDetailPage 与 BookDetailViewModel 
关联 。 如 果 书 的 列表 和 细节 可 以 在 同一 个 页 面 中 实现 ， 这 就 是 一 个 UI 设计 决策 。 这 取决 于 应 用 程序 的 可 用 屏 
幕 大 小 。 屏 幕 上 可 以 放 什 么 ? 对 于 示例 应 用 程序 ， 采 用 了 一 种 灵活 的 方法 。 如 果 应 用 程序 可 用 的 空间 足够 大 ， 
则 BooksPage 显示 列表 和 详细 信息 ; 如 果 空 间 不 够 大 ， 则 数据 将 显示 在 多 个 单独 的 页 面 中 ， 其 中 包含 导航 。 

页 面 视 图 和 视图 模型 之 间 是 一 对 一 上 映射。 实际 上 ， 视 图 和 视图 模型 之 间 还 有 多 对 一 映射 ， 因 为 视图 存在 于 
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用 于 
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不 同 的 技术 中 一 一 WPF、UWP 和 Xamarin。 视 图 模型 必须 对 视图 一 无 所 知 ， 但 视图 要 了 解 视 图 模型 。 视 图 模型 
用 .NET 标准 库 实 现 ， 这 样 就 可 以 把 它 用 于 许多 技术 。 

对 于 视图 模型 的 通用 功能 ， 创 建 基 类 是 有 意义 的 。Framework 库 包 含 一 个 ViewModelBase 类 ， 该 类 为 进度 
信息 和 错误 实现 了 特性 (代码 文件 Framework/ViewModels/ViewModelBase.cs): 


Public abstract class ViewModelBase : BindableBase 
{ 

// functionality for progress information and 

// error information 


} 

示例 应 用 程序 显示 了 图 书 列表 ， 并 允许 用 户 选 择 图 书 。 在 这 里 ， 为 具有 属性 Items 和 SelectedItem 的 视图 模 
型 定义 泛 型 基 类 是 有 用 的 。 这 些 属性 的 实现 利用 了 先前 创建 的 服务 来 实现 IItemsService 接口 (代码 文件 
Framework/ViewModels/MasterDetallViewModel.cs): 


public abstract class MasterDetallViewModel<TItemViewModel, TItem> : 
ViewModelBase 
where TItemvyviewModel : IItemViewModel<TItem> 
where IItem: class 

{ 


private readonly IItemsSerVICe<TItem> litemsServices 


Public MasterDetaillViewModel (IlItemsService<TItem> itemsSservice) 
{ 


itemsService = itemsService; 


a 
} 


Public ObservableCollection<TItem> Items => jtemsService.Items; 


protected TItem selectedItem; 
public virtual TItem SelectedItem 
| 
get => itemsService.SelectedItem; 
Set 
{ 
if (IEqualityComparer<TItem>.Default.Equals'l 
itemsService.SelectedItem, value)}) 
{ 
litemsService.SelectedItem = value; 
OnPropertycChanged (); 
} 
} 
} 


Fhews 


注意 : 
泛 型 参见 第 5 章 。 


要 详细 显示 一 项 ， 基 类 ItemViewModel 定义 了 Item 属性 (代码 文件 Framework/ViewModels/ItemView- 
Model.cs): 


Public abstract class ItemViewModel<T> : ViewModelBase, IItemViewModel<T> 


{ 
private T item; 
Public virtual T Item 
{ 
get => item; 
set => Setl(ref item, value}); 
} 
} 


比 简单 类 ItemViewModel 更 复杂 的 是 视图 模型 类 EditableItemViewModel。 这 个 类 通过 人 允许 编辑 来 扩展 
ItemViewModel ， 因 此 它 定 义 了 读 取 或 编辑 模式 。 属 性 IsReadMode 只 是 ISEditMode 的 逆 属 性 。 
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EditableItemViewModel 使 用 与 MasterDetailViewModel 类 相同 的 服务 ， 该 服务 实现 了 接口 IftemsService。 这 样 ， 
EditableItemViewModel 和 MasterDetailViewModel 类 就 可 以 共享 相同 的 项 和 相同 的 选择 。 视 图 模型 类 人 允许 用 户 
取消 输入 。 为 此 , 项 通过 EditItem 属性 具有 复制 版 本 (代码 文件 Framework/ViewModels/EditableltemViewModel.cs): 


Public abstract class EditableItemViewModel<TItem> : ItemViewModel<TItem>, 
IEditableObject 
Where TItem : class 


| 


private readonly IItemsService<TItem> jtemsService; 


public EditableItemViewModel (IItemsService<TItem> itemsService) 
{ 

itemsService = itemsService; 

Item = itemsService.SelectedItem; 


PropertyChanged += (sender, ee) 三 > 


{ 
if (e.PropertyName == nameof (Item)) 
{ 
onPropertyChanged (nameof (EditItem)); 
} 
上 
2 
} 
ff 


private bool 1sEditMode; 
public bool IsReadMode => !IsEditMode; 
Public bool IsEditMode 
{ 
get => 1sEditMode; 
写 忆 七 
{ 
if {Set(ref 1isEditMode, value)) 
{ 
OnPropertyChanged (nameof (IsReadMode}}.; 
lss 


} 

} 
} 
private TItem editItem; 
Public TItem EditItem 
{ 

get => editItem ?2? Item; 

Set = Set (ref editItem, value); 
】 


34.7.1 使 用 IEditableObject 


接口 下 ditableObject 定义 方法 来 在 不 同 编辑 状态 之 间 更 改 对象 . 这 个 接口 在 名 称 空间 System.ComponentModel 
中 定义 。IEditableObject 定义 了 方法 BeginEdit、CancelEdit 和 EndEdit。 调 用 BeginEdit 来 将 项 从 读 取 模 式 更 改 
为 编辑 模式 。CancelEdit 取消 编辑 并 切换 回 “ 读 取 ” 模 式 。EndEdit 是 用 于 编辑 模式 的 成 功 结束 ， 因 此 需要 保存 
数据 。EditableItemViewModel 类 通过 切换 编辑 模式 、 创 建 项 的 副本 并 保存 状态 来 实现 这 个 接口 的 方法 。 这 个 视 
图 模型 类 是 一 个 泛 型 类 ， 不 知道 如 何 复制 和 保存 该 项 。 通 过 使 用 二 进 制 串 行 化 可 以 进行 复制 。 然 而 ， 并 不 是 所 
有 的 对 象 都 支持 二 进 制 序列 化 。 相 反 ， 实 现代 码 转发 到 派生 自 EditableItemViewModel 的 类 中 ， 类 似 于 保存 方法 
OnSaveAsync 。 OnSaveAsync 和 CreateCopy 定义 为 抽象 方法 ， 因 此 需要 由 派生 类 实现 。 另 一 个 方法 
OnEndEditAsync 定义 为 在 CancelEdit 和 EndEdit 结尾 调用 。 这 个 方法 可 以 由 派生 类 实现 , 但 是 没有 必要 这 样 做 。 
这 就 是 为 什么 方法 声明 为 空 的 原因 (代码 文件 Framework/ViewModels/EditableItemViewModel.cs): 


Public virtual void BeginEdit() 
{ 
ISEditMode = true; 
TItem itemCopy = CreateCopy (Item); 
if (itemCopy != null) 
{ 
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EditItem = itemCopy; 
} 
} 


Public async virtual void CancelEdit() 
{ 
IsEditMode = false; 
EditItem = default (TItem); 
await ilitemsService.RefreshAsync(); 
awalit OnEndEditAsync(); 


} 
Public async virtual void EndEdit() 
{ 
using (人 (StartInProgress() ) 
{ 
await OnSaveAsync(); 
EditItem = default (TItem); 
IsEditMode = false; 
await litemsSservice.RefreshAsync () : 
await OnEndEditAsync (}); 
} 
} 


PuUublic abstract Task OnSsSaveAsync () ; 
Public abstract TItem CreateCopy (TItem item); 
Public virtual Task OnEndEditAsync() => Task.ComletedTask; 


34.7.2 ”视图 模型 的 具体 实现 


下 面 继 续 讨 论 视 图 模型 的 具体 实现 。BookDetailViewModel 派生 目 EditableItemViewModel， 并 将 Book 指定 
为 泛 型 参数 。 由 于 基 类 已 经 实现 了 主要 功能 ， 因 此 这 个 类 可 以 很 简单 。 它 为 接口 ItemsService 和 
INavigationSerivce 注入 服务 。 在 OnSaveAsync 方法 中 ， 请 求 转发 到 IItemsService。OnSaveAsync 方法 还 使 用 了 
ILogger 和 IMessageService 接口 。 在 视图 模型 类 中 ，CreateCopy 方法 实现 图 书 副本 的 创建 。 这 个 方法 由 基 类 调 


用 (代码 文件 BooksLib/ViewModels/BookDetailViewModel.cs): 


public class BookDetailViewModel : EditableItemViewModel<Book> 
{ 
private readonly IlItemsService<Book> litemsService; 
private readonly INavigationService navigationService; 
private readonly IMessageService messageService; 
private readonly ILogger logger; 


public BookDetailViewModel (IItemsService<Book> itemsService, 


INavigationService navigationService, IMessageService messageService, 


ILogger<BookDetalilViewModel> logger) 
base (ltemsService) 
{ 
itemsService = itemsService; 
_ navigationSsService = navigationService; 
messageService = messageService; 
_ Logge = logger: 


itemsService.SelectedItemChanged += (sender, book) => 
{ 
Item = book; 
}; 
} 


public bool UseNavigation 1{ get; set; } 


Public override Book CreateCopy (Book item) 三 > 
new Book 


{ 
BookId = item?.BookId ?2? -1, 
Title = item?.Title 22 "enter a title"™, 
Publisher = item?.Publisher ?2? "enter a publisher™" 


}; 


Public override async Task OnsaveAsync() 
| 

try 

{ 
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await itemsService.AddOrUpdateAsync (EditItem); 

} 

catch (Exception ex) 

{ 
logger.LogError("error {0} in {1}", ex.Message, nameof (DODnSaveasyYync) ) ， 
awalit messageService.ShowMessageAsync ("Error saving the data"™); 


注意 : 
ILogger 接口 参见 第 29 章 。 接口 IMessageService 将 在 本 章 后 面 的 34.8.1 节 “ 从 视图 模型 中 打开 对 话 框 ”中 
讨论 。 导 航 服务 的 定义 和 使 用 将 在 本 章 后 面 的 34.8.2 节 “页面 之 间 的 导航 ”中 讨论 。 


类 BooksViewModel 可 以 通过 继承 MasterDetailViewModel 的 主要 功能 来 保持 简单 。 这 个 类 只 是 注入 稍 后 讨 
论 的 INavigationService 接口 ， 将 IItemsService 接口 转发 给 基 类 ， 并 重 写 由 基 类 调用 的 OnAdd 方法 (代码 文件 
BooksLib/ViewModels/BooksViewModel.cs): 


Public class BooksViewModel : MasterDetalillViewModel<BookItemVyViewModel]l, Book> 
{ 


private readonly IItemsService<Book> booksService; 
private readonly INavigationService navigationService; 


Public BooksViewModel (IItemsService<Book> booksService, 
INavigationService navigationService) 
: base (booksService) 
{ 
booksService = booksService 2?? 
throw new ArgumentNullException (nameof (booksService)); 


navigationSsService = navigationSservice ?2 
throw new ArgumentNullException (nameof (navigationService)); 
Fa 


} 


public override void OnAda () 
{ 
VAaAr newBook = new Book(}):; 
Items.Add (newBook) ; 
SelectedItem = newBook; 


} 
gm 


34.7.3 命令 


视图 模型 提供 了 实现 ICommand 接口 的 命令 。 合 令 人 允许 通过 数据 绑 定 来 分 离 视 图 和 命令 处 理 程序 方法 。 命 
令 还 提供 局 用 或 禁用 命令 的 功能 。ICommand 接口 定义 了 方法 Execute 和 CanExecute， 以 及 CanExecuteChanged 
事件 。 

要 将 命令 映射 到 方法 ， 在 Framework 库 中 定义 了 RelayCommand 类 。 

RelayCommand 定义 了 两 个 构造 函数 ， 其 中 一 个 委托 可 以 传递 应 通过 命令 调用 的 方法 ， 另 一 个 委托 定义 了 
命令 是 否 可 用 (代码 文件 Framework/RelayCommand.cs): 

public class RelayCommand: ICommand 


| 


private readyonly Action execute; 


private readonly Func<bool> canExecute; 


Public RelayCommand (Action execute, Func<bool> canExecute) 

{ 
execute = execute 32 throw new ArgumentNullException (nameof (execute))}); 
_CanExecute = CanExecuter 


} 


Public RelayCommand (Action execute) 
: this (execute, null) 
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{ } 
Public event EventHandler CanExecuteChanged.; 
public bool CanExecute (object parameter) 三 > CanExecute3.Invoke() 22? trues 


public void Execute(object parameter) => execute(); 


} 

EditableItemViewModel 的 构造 函数 创建 新 的 RelayCommand 对 象 ， 在 执行 命令 时 ， 指 定 前 面 所 示 的 方法 
BeginEdit、CancelEdit 和 EndEdit。 所 有 这 些 命令 还 使 用 ISReadMode 和 IsEditMode 属性 来 检查 该 命令 是 否 可 用 。 
当 IsEditMode 属性 发 生 更 改 时 ， 将 触发 命令 的 CanExecuteChanged 事件 ， 相 应 地 更 新 命令 (代码 文件 
Framework/ViewModels/EditableItemViewModel.cs): 


Public abstract Class EditablelItemViewModel<TItem> : ItemViewModel<TItem>, 
IEditableoObject 
where TItem : class 


private readonly IItemsSerVICe<TItem> litemsService; 


public EditableItemvViewModel (IItemsService<TItem> itemsSservice) 
{ 

itemsService = itemsService; 

Item = itemsService.SelectedItem; 


EditCommand = new RelayCommand (BeginEdit, ()} => IsReadMode). 
CancelCommand = new RelavyCommand(CancelEdit, () =»> IsEditMode). 
SaveCommand = new RelayCommand (EndEdit, () =» IsEditMode).; 

} 


Public RelavyCommand EditCommand { get; } 
Public RelavCommand CancelCommand { get,; } 
Public RelayCommand SaveCommand { get; } 


Sg Pa 


public bool IsEditMode 
{ 
get => 1isEditMode; 
Set 
{ 

if (Setl{(ref 1isEditMode, value)) 

{ 
OnPropertycCchanged (nameof (IsReadMode)); 
CancelCommand .OnCanExecuteChanged (}); 
SaveCommand .OnCanExecuteChanged ().; 
EditCommand.OnCanExecuteChanged(); 


Phans 
} 


从 XAML 代码 中 , 命令 绑 定 到 按钮 的 Command 属性 。 在 创建 视图 时 , 将 对 此 进行 更 详细 的 讨论 (代码 文件 
BooksApp/Views/BookDetailUserControl.xam!l): 


<AppBarButton Content="Edit"™ Icon="Edit" 

Comand="{x:Bind ViewModel .EditCommand, Mode=OneTime}" /> 
<AppBarButton Content="Save" ICon="Save™" 

Comand=" {Xx:Bind ViewModel .SaveCommand, Mode=OneTime}" /> 
<AppBarButton Content="Cancel™ Icon="Cancel™ 

Comand=" {x:Bind ViewModel .CancelCommand, Mode=OneTime}"™" /> 


34.7.4 服务、ViewModel 和 依赖 注入 


视图 模型 和 服务 注入 服务 , 需要 创建 视图 模型 .为 此 , 可 以 使 用 依赖 注入 容器 。 样 例 应 用 程序 使 用 Microsoft. 
Extensions.DependencyInjection。 该 容器 在 ApplicationServices 类 中 配置 。 这 个 类 是 用 单 例 模式 实现 的 。 在 构造 
函数 中 ， 配 置 DI 容器 。 属 性 ServiceProvider 返回 可 检索 服务 的 容器 (代码 文件 BooksApp/App.xaml.cs): 


Public class ApplicationSservices 


{ 


private ApplicationServices() 
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VAIL SerIVvices = New ServiceCcollection'().; 
Services.AddSsingleton<IBooksRepository, BooksSampleReposltory> (); 
Services.AddSingleton<IItemsService<Book>, BooksService> ();}; 
SErIvices.AddTransient<BooksVlewModel>().; 
SeErvices.AddTransient<BookDetalillVijewModel>(). 
Services.AddTranslient<MainPageViewModel> (); 
services.Addsingleton<IMessageService, UWHPMessageServicey>(),，} 
Services.AddSsingleton<INavigationService, UWPNavigationService> (); 
Services.AddSsingleton<UWPInitializeNavigationService> (}); 
services.AddLogging (builder => 


{ 
#if DEBUG 
builder.AddDebug (); 
#endifEf 
}); 
ServiceProvider = services.BuildSsServiceProvider(); 


} 


private static ApplicationServices jinstance; 
private static object instanceLock = new Ob]ect () ; 
Private static ApplicationServices GetInstance() 


{ 
lock ( instanceLock) 
{ 
return instance ?2? ( instance = new Applicationservices()); 
} 
} 


Public static ApplicationServices Instance => instance ?2? GetInstance (}; 


Public IServiceProvider ServiceProvider |{ get; } 


} 

现在 视图 模型 需要 与 视图 相关 联 ， 为 此 ， 在 BooksPage 中 访问 App 类 的 AppServices 属性 ， 并 从 DI 容器 中 
调用 GetService 方法 。 然 后 ， 容 器 用 视图 模型 类 的 构造 函数 中 定义 的 所 需 服务 实例 化 视图 模型 类 。BooksPage 
包含 了 一 个 用 户 控 件 , 以 获取 需要 不 同 视图 模型 的 图 书 的 详细 信息 。 此 视图 模型 是 通过 设置 BookDetailUC 用 户 
控件 的 ViewModel 属性 来 分 配 的 (代码 文件 BooksApp/Views/BooksPage.xaml.cs): 


Public sealed partial class BooksPage : Padge 
{ 
public BooksPage{() 
{ 
this.InitializeComponent (); 
ViewModel .UseNavigation = false; 
BookDetailUC .ViewModel = 
ApplicationServices. TInstance.ServiceProvider 
.GetService<BookDetailViewModel> (); 
} 
Public BooksViewModel ViewModel { get; } = 
(Application.Current as APP) .AppServices.GetSservice<BooksViewModel>():; 


在 BookDetailPage 中 ， 与 视图 模型 的 关联 是 类 似 的 (代码 文件 BooksApp/Views/BookDetailPage.xaml.cs): 


public sealed partial class BookDetailPage : Padge 
{ 
Public BookDetailPage{() 
{ 
this.InitijalijzeComponent (); 
ViewModel .UseNavigation = true; // if the Page is used, enable navigation 


} 
Public BookDetailViewModel ViewModel { get; } = 


ApplicationServices. Instance. ServiceProvider 
.GetService<BookDetailViewModel>().; 


34.8 ”视图 


前 面 介绍 了 视图 模型 的 创建 ， 并 将 视图 连接 到 视图 模型 ， 现 在 就 该 介绍 视图 了 。 
应 用 程序 的 主 视图 由 MainPage 定义 。 该 页 面 使 用 的 是 Windows 10 update 16299 (Fall Creators Update) 中 新 
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增 ) 的 NavigationView 控件 。 通 常 ， 如 果 只 有 一 个 导航 项 的 小 列表 ， 就 不 应 该 使 用 这 个 UI 控件 。 但 是 ， 在 示例 
应 用 程序 中 使 用 了 控件 ， 因 为 假定 应 用 程序 中 的 选项 将 增长 到 8 个 以 上 。 

NavigationView 控件 将 SelectionChanged 事件 分 配给 MainPageViewModel 的 OnNavigationSelectionChanged 
方法 。 这 个 视图 模型 与 其 他 模型 非常 不 同 ， 将 在 34.8.2 节 “ 页 面 之 间 的 导航 ”中 讨论 。 定 义 一 个 
NavigationViewItem， 以 导航 到 BooksPage( 代 人 码 文件 BooksApp/MainPage.xaml): 

<NavigationView Background= 

"{ThemeResource ApplicatlionPageBackgroundThemeBrush}" 
SelectionChanged=" {x:Bind ViewModel .OnNavigationSelectionChanged, 
Mode=OneTime} "> 
<NavigationView.MenuItems> 
<NavigationViewItem Content="Books" Tag="books"> 
<NavigationvViewltem. Icon> 
<FontIcon FontFamily="Segoe MDL2 Assets" Glyph="&#xE82D;" /> 
</NavigationViewItem.Icon> 
</NavigationViewItem> 
</NavigationView.MenuItems> 


<Frame XxX:Name="ContentFrame™" Margin="24"> 
<Frame .ContentTransitions> 
<TransitionCcollection> 
<NavigationThemeTransition/> 
</TransitionCollection> 
</Frame.ContentTransitions> 
</Frame> 
</Navigationview> 


NavigationView 控件 参见 第 33 章 。 


Books $ample App 


图 34-8 显示 了 正在 运行 的 应 用 程序 的 NavigationView， 其 中 包含 指向 BooksPage 的 导航 项 。 


~ 
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Books 


Settings 


图 34-8 


BooksPage 包含 一 个 ListView， 并 将 ItemsSource 绑 定 到 BooksViewModel 的 ItemsViewModel 属性 上。 通常 
将 它 绑 定 到 BooksViewModel 的 Items 属性 上 。 然 而 ， 单 个 列表 项 不 仅 用 于 显示 Book 对 象 的 值 ， 还 包含 绑 定 到 
命令 的 按钮 。 要 实现 这 样 的 功能 ， 该 项 将 使 用 另 一 个 视图 模型 (代码 文件 BooksApp/Views/BooksPage.xaml): 


<StackPanel Orientation="Horizontal™" Grid.Row="1"> 
<ApPpBRarButton Icon="Refresh™” IsCompact="True™ 
Command=" {XxX:Bind ViewModel .RefreshCommand}™ 
Label="Get Books™ /> 
<APPBarButton Icon="Add™” IsCompact="True™ 
Command="{X:Blind ViewModel .AddCommand}™ 
Label="Add Book™ /> 
</sStackPanel> 
ListView ItemTemplate="{StaticResource BookItemTemplate}" Grid.Row="2" 
ItemsSource=" {xX:Bind ViewModel .ItemsViewModels, Mode=OneWay}" 
SelectedItem="{x:Bind ViewModel .SelectedItemViewModel, Mode=TwoWay}" > 
</ListView> 
<Vlews:BookDetaillUserControl x:Name="BookDetalillUCcC" Visibility="Collapsed" 
Grid.Column="1" Grid.Row="1" Grid.RowSpan="2" /> 


BookDetailPage 仅仅 包含 一 个 用 户 控件 BookDetailUserControl。 BookDetailPage 关联 了 BookDetailViewModel, 
如 前 所 述 .。 将 BookDetailPage 的 ViewModel 属性 分 配给 BookDetailUserControl 的 ViewModel 属性 ， 把 这 个 视图 
模型 转发 到 BookDetailUserControl (代码 文件 BooksApp/Views/BookDetailPage.xaml): 


<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
<Views:BookDetailUserControl ViewModel="{x:Bind ViewModel, Mode=OneTime}™" /> 
</Grid> 


BookDetailUserControl 的 依赖 属性 显示 在 下 面 的 代码 片段 中 。 然 后 ， 将 对 该 视图 模型 的 映射 用 于 XAML 代 
码 中 的 数据 绑 定 (代码 文件 BooksApp/Views/BookDetailUserControl.xaml.cs): 


Public BookDetailViewModel ViewModel 

{ 
Get => (BookDetallViewModel)GetValue (ViewModelProperty),; 
Set => SetValue (ViewModelProperty, value); 

} 


Public static readonly DependencyProperty ViewModelProperty = 
DependencyProperty.Register("ViewModel™", typeof (BookDetailViewModel)}), 
typeof (BookDetailUserControl), new PropertyMetadata (null)); 


BookDetailUserControl 的 用 户 界 面 使 用 了 两 个 StackPanel 元 素 。 对 于 第 一 个 StackPanel, AppBarButton 控件 
的 Command 属性 绑 定 到 视图 模型 中 定义 的 EditCommand、SaveCommand 和 CancelCommand 命令 。 按 钮 将 根 
据 命 令 的 状态 上 自动 启用 或 禁用 。 在 第 二 个 StackPanel 中 ，TextBox 元 素 用 于 显示 Book 的 Title 和 Publisher 属性 。 
对 于 只 读 显 示 , 把 IsSReadOnly 属性 分 配给 视图 模型 的 ReadMode 属性 . 当 视 图 模型 设置 为 编辑 模式 时 , TextBox 
控件 允许 输入 数据 (代码 文件 BooksApp/Views/BookDetailUserControl.xaml): 


<StackPanel Orientation="Horizontal™"> 
<AppBarButton Content="Edit"™" Icon="Edit" 
Command="{x:Bind ViewModel .EditCommand, Mode=OneTime}"™" /> 
<ApPpPBarButton Content="Save”" Icon="Save™ 
Command="{x:Bind ViewModel .SaveCommand, Mode=OneTime}"™" /> 
<ApPBarButton Content="Cancel™ Icon="Cancel™ 
Command="{x:Bind ViewModel .CancelCommand, Mode=OneTime}"™ /> 
</StackPanel> 
<StackPanel Orientation="Vertical™ Grid.Row="1"> 
<TextEBox Header="Title" 
IsReadOnly="{x:Bind ViewModel .IsReadMode, Mode=OneWay}" 
Text=" {x:Bind ViewModel .EditItem.Title, Mode=TwoWay ， 
UpdateSourceTrigger=PropertyChanged}" /> 
<TextEBox Header="Publisher" 
IsReadonly=" {xX:Bind ViewModel .IsReadMode, Mode=OneWay}" 
Text=" {x:Bind ViewModel .EditIltem. Publisher, Mode=TwoWay ， 
UpdateSourceTrigger=PropertyChanged}" /> 
</StackPanel> 


图 34-9 显示 了 在 ListView 中 使 用 图 书 的 运行 应 用 程序 ,在 BookDetailUserControl 中 , 当前 禁用 Save 和 Cancel 
命令 ， 启 用 Edit 命令 。 
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34.8.1 从 视图 模型 中 打开 对 话 框 


有 时 需要 在 视图 模型 中 的 操作 显示 对 话 框 。 由 于 视图 模型 是 在 NET 标准 库 中 实现 的 ， 因 此 不 可 能 从 UWP 
中 访问 MessageDialog 类 。 无 论 如 何 ， 都 应 该 避免 这 种 情况 ， 因 为 MessageDialog 是 特定 于 UWP 的 。 在 WPF 
中 ， 可 以 使 用 MessageBox 类 。 在 Xamarin.Forms 中 ， 可 以 使 用 Page.DisplayAlert。 

我 们 需要 定义 一 个 可 以 由 视图 模型 和 服务 使 用 的 协定 。 该 协定 在 BooksLib 库 中 用 IMessageService 接口 定 
义 ( 代 码 文 件 BooksLib/Services/IMessageService.cs): 

BE interface IMessageService 


Task ShowMessageAsync (string message); 


} 
在 BookDetailViewModel 中 ， 把 IMessageService 注入 构造 图 数 中 ， 用 于 OnSaveAsync 方法 。 在 出 现 异 常 时 
调用 ShowMessageAsync 方法 (代码 文件 BooksLib/ViewModels/BookDetailViewModel.cs): 


Public override async Task OnsaveAsynct() 


{ 
try 
{ 
await litemsService.AddorUpdateAsync (EditItem); 
} 
catch (Exception ex) 
{ 
lJogger-LogError("error {0} In {1}", ex.Message, nameof (OnSaveAsync)); 
await messageService.ShowMessageAsync("Error saving 七 he data")., 
} 
} 


现在 只 需要 一 个 用 于 通用 Windows 平台 的 特定 实现 。ShowMessageAsync 方法 是 使 用 MessageDialog 类 实 
现 的 。UWPMessageService 在 通用 Windows 平台 应 用 中 实现 ， 这 就 是 为 什么 现在 可 以 访问 MessageDialog 的 原 
因 ( 代 码 文 件 BooksApp/Services/UWPMessageService.cs): 


Public class UWPMessageService : IMessageService 
{ 
public async Task ShowMessageAsync (string message) => 
await new MessageDialocog (message) .Showhsvync(); 
} 


在 ApplicationServices 构造 函数 中 ， 服 务 通过 依赖 注入 容器 注册 ，UWPMessageService 类 注册 为 
IMessageService 协定 的 实现 类 。 这 就 是 为 什么 视图 模型 接收 UWP 实现 的 原因 (代码 文件 
BooksApp/ApplicationServices.cs): 


private ApplicationServices() 

{ 
VAaAr SEIVICes = New ServiceCollection(); 
services.AddSingleton<IBooksRepository, BooksSampleRepository>(); 
Services.Addsingleton<IItemsService<Book>, BooksService>().; 
services.AddTransient<BooksViewModel>():; 
services.AddTranslient<BookDetalilViewModel> (); 
Services.AddTransient<MaljnPageViewModel> (); 
services.hddSingleton<IMessageService, UWHPMessageService2>(); 
services.AddSingleton<INavigationService, UWPNavigationService>(); 
Services.Addsingleton<UPInitializeNavigationService>(); 
Services.AddLogging (builder 三 > 


{ 
#if DEBUG 
builder.AddDebug () ; 
#end1if 
}); 
ServiceProvider = services.BuildServiceProvider (}; 


} 
如 果 出 现 错误 ， 则 可 以 看 到 如 图 34-10 所 示 的 对 话 框 。 
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Error saving the data 


34-10 


34.8.2 ”页 面 之 间 的 导航 


与 打开 对 话 框 一 样 ， 不 同 技术 之 间 的 页 面 导 航 也 不 同 。 在 UWP 中 ，Frame 类 用 于 在 应 用 程序 中 导航 页 面 。 
在 WPF 中 ， 它 也 是 一 个 Frame 类 ， 但 它 是 一 个 不 同 的 类 。 在 Xamarin Forms 中 ， NavigationPage 用 于 导航 。 
使 用 这 些 技 术 实 现 导 航 的 方式 也 有 所 不 同 。 在 UWP 中 ， 需 要 Type 对 象 来 导航 。 在 Xamarin.Forms, 中 ， 需 要 页 
面 的 对 象 实例 ， 其 导航 方法 是 异步 的 ， 而 它们 与 UWP 是 同步 的 。 为 此 ， 再 次 需要 一 个 共同 的 协定 。 

在 示例 应 用 程序 中 ， 需 要 导航 到 页 面 ， 还 需要 进行 导航 回 深 。 此 外 ， 需 要 访问 当前 页 面 ， 以 了 解 是 否 需 要 
进行 导航 。 为 此 ， 定 义 了 接口 INavigationService。 这 个 接口 是 基于 字符 串 的 导航 ， 因 此 可 以 为 不 同 的 平台 创建 
实现 代码 (代码 文件 Framework/Services/INavigationService.cs): 

public interface INavigationsService 

bool UseNavigation { get; set; } 

Task NavigateToAsync (string page); 
Task GoBackasync () ; 


string CurrentPage { get; } 
} 


UWPNavigationService 需要 分 配 一 个 Frame， 以 便 为 UWP 导航 。 当 定义 Frame 的 属性 时 ， 不 可 能 访问 它 ， 
因为 在 外 部 只 使 用 INavigationService 接口 。 在 INavigationService 接口 中 ,不 能 使 用 Frame， 因 为 这 个 接口 
位 于 .NET 标准 库 中 。 使 用 UWP 中 的 INavigationService 时 ， 可 以 将 其 转换 为 UWPNavigationService， 以 访 
问 特定 的 UWP 属性 。 需 要 进行 类 型 转换 不 是 良好 的 设计 。 相 反 ， 可 以 轻松 地 指定 一 个 特定 于 UWP 的 服务 ， 
比如 UWPInitializeNavigationService 并 将 其 注入 UWPNavigationService 的 构造 国 数 中 。 在 内 部 ， 当 访问 Pages 
和 Frame 属性 时 ， 这 些 信息 从 初始 化 服务 中 获取 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文 件 BooksApp/Services/ 
UWPNavigationSeIVice.cs): 

public class UWPNavigationservice : INavigationservice 


| 


private readonly UWPInitializeNavigationService lnitializeNavigation; 


Public UWPNavigationServicel 
UWPINnitializeNavigationSservice initializeNavigation) 
{ 
initiallizeNavigation = linitializeNavigation 22? 
throw new ArgumentNullException (nameof (initializeNavigation)).; 


} 


private Dictionary<string, Type> pages; 
private Dictionary<string, Type> Pages => pages 2?? 
({ pages = 1linitializeNavigation.Pages); 


private Frame frame; 
private Frame Frame => frame 33 ( frame = initializeNavigation.Frame); 
es 

} 


CurrentPage 属性 、GoBackAsync 方法 和 NavigateToAsync 方法 的 实现 现在 都 在 使 用 Frame.GoBack 和 
Frame.Navigate 方法 (代码 文件 BooksApp/Services/UWPNavigationService.cs): 
public class UWPNavigationService : INavigationService 


{ 


private string currentPage; 
Public string CurrentPage => currentPage; 
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public Task GoBackAsync() 
{ 
PageSstackEntry stackEntry = Frame.BackSstack.Last()}); 
Tybpe backPageType = stackEntry.SourcePageTYyYpe; 
EeyValuePair<string, Type> pageEntry = 
Pages.FirstOrDefault (pair => pair.Value == backPpageType); 
CurrentPage = pageEntry.Key; 


Frame .GoBack ().:; 
return Task.CcompletedTask; 
} 


public Task NavigateToAsync (string pageName) 
{ 
CurrentPage = pageName; 
Frame .Navigate (Pages [pageName]l]).; 
return Task.completedTask; 
} 
} 


UWPInitializeNavigationService 提供 的 唯一 功能 是 用 Frame 和 页 面 字 典 初 始 化 它 ， 并 检索 这 个 信息 (代码 文 
件 BooksApp/Services/UWPInitializeNavigationService.cs): 


public class UWPInitializeNavigationService 
{ 
public void Initialize (Frame frame, Dictionary<string, Type> pages) 
{ 
Frame = frame 22 throw new ArgumentNullException (nameof (frame) ) ， 
Pages = pages ?2? throw new ArgumentNullException (nameof (pages)); 
} 
Public Frame Frame { get; private set; } 
public Dictionary<string, Type> Pages { get; private set; } 
} 


现在 可 以 在 Frame 可 用 的 位 置 初始 化 UWPInitializeNavigationService。 在 UWP 示例 应 用 程序 中 ， 这 个 位 置 
在 MainPage 中 。 在 前 面 指定 的 NavigationView 控件 中 ， 指 定名 为 ContentFrame 的 框架 。 现 在 可 以 在 MainPage 
的 代码 隐藏 文件 中 或 特定 于 UWP 的 MainPageViewModel 中 定义 初始 化 。 对 于 示例 应 用 程序 , 选择 第 二 个 选项 。 

在 下 面 的 代码 片段 中 ，MainPageViewModel 保存 了 用 于 导航 的 页 面 列表 ， 并 在 调用 SetNavigationFrame 时 
初始 化 导航 服务 (代码 文件 BooksApp/ViewModels/MainPageViewModel.cs): 


Public class MainPageViewModel : ViewModelBase 

{ 
private Dictionary<string, Type> pages = new Dictionary<string, Type> 
{ 

[PageNames .BooksPage] = typeof (BooksPage), 

[FageNames.BookDetailPage] = typeof (BookDetalilPrage) 

} 7 


private readonly INavigationService navigationService; 
private readonly UWPInitializeNavigationService initializeNavigatlionService; 
Public MainPageViewModel (INavigationService navigationService, 
UWPINnitializeNavigationService initializeNavigationService) 
{ 
_ navigationSsService = navigationService; 
initializeNavigationSservice = linitializeNavigationSservice; 


} 


Public void SetNavigationFrame (Frame frame) => 
_initializeNavigationService.Ilnitialize(frame, pages); 


Eh 
} 


有 了 这 个 视图 模型 ，MainPage 的 代码 隐藏 文件 中 需要 ViewModel 属性 ， 并 通过 调用 SetNavigationFrame 方 
法 将 ContentFrame 传递 给 导航 服务 (代码 文件 BooksApp/MainPage.xaml.cs): 


Public sealed partial class MainPage : Page 
{ 
public MainPage () 
{ 
this.InitializeComponent () ; 
ViewModel = 
(Application.Current as App) .AppServices.GetService<MainPageViewModel> (); 
ViewModel .SetNavigationFrame (ContentFrame); 
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} 


Public MainPpageViewModel ViewModel 1{ get; } 
} 


BooksPage 的 第 一 个 导航 发 生 在 MainPageViewModel 中 。 方 法 OnNavigationSelectionChanged 是 
NavigationView 控件 的 NavigationSelectionChanged 事件 处 理 程序 。 把 Tag 设置 为 books, 使 用 INavigationService 
导航 到 BooksPage (代码 文件 BooksApp/ViewModels/MainPageViewModel.cs): 


Public class MainPageViewModel : ViewModelBase 
{ 
Ff 
Public void OnNavigationSselectionCchanged (NavigatilonView sender., 
NavigationVviewSelectionChangedEventArgs args) 
{ 
if (args.SelectedItem 15 NavigationVviewItem navigationItem) 
{ 
switch (navigationItem.Tag) 
{ 
case "books™: 
navigationservice.NavigateTloAsync (PageNames .BooksPage); 
break; 
default: 
break; 
} 
} 
} 
} 


从 BooksPage 的 导航 直接 在 共享 的 视图 模型 中 执行 .从 BooksPage 到 BooksDetailPage 的 导航 在 选择 列表 项 
时 发 生 ， 因 此 触发 PropertyChanged 事件 。 导 航 也 只 有 在 UseNavigation 属性 设置 为 tue 时 才能 完成 。 如 前 所 述 ， 
在 UWP 中 ， 当 UI 足够 大 时 ， 在 这 个 地 方 不 需要 导航 ， 因 为 详细 信息 会 与 列表 并 排 显 示 ( 代 码 文 件 BooksLib/ 
ViewModels/BooksViewModel.cs): 


Public class BooksViewModel : MasterDetailViewModel<BookItemViewModel]l, Book> 
{ 

private readonly IItemsService<Book> booksService; 

private readonly INavigationService navigationService; 


public BooksViewModel (IItemsServyice<Book> booksService, 
INavigationService navigationService) 
: base (booksService) 
{ 
booksService = booksService ?2? 
throw new ArgumentNullException (nameof (booksService)); 
navigationSsService = navigationService ?2 
throw new ArgumentNullException (nameof (navigationService)); 


PropertyChanged += asvyne (sender, ee) 一 六 
{ 
if (UseNavigation && e.PropertyName == nameof (SelectedIlItem) && 
_navigationService.CurrentPage == PageNames .BooksPage) 
{ 
await navigationService.NavigateToAsyncl(PageNames .BookDetailPage); 
} 
}; 
} 


Public bool UseNavigation 1{ get; set; } 
fw 
} 


为 了 使 用 户 界 面 小 到 需要 在 页 面 之 间 进 行 导航 ， 下 一 节 将 解释 上 自 适 应 用 户 界 面 。 


34.8.3 自 适 应 用 户 界面 
根据 屏幕 上 可 用 的 空间 ,用户 控件 应 该 在 列表 控件 或 单独 的 页 面 中 并 排 显示 。 为 此 ， 通过 BookDetailUserControl 
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在 BooksPage 中 使 用 ，Visibility 属性 默认 设置 为 Collapsed( 代 码 文件 BooksApp/Views/BooksPage.xaml): 


<ViewSs:BookDetallUserControl x:Name="BookDetailUC" Visibility="Collapsed" 
Grid.Ccolumn="1" Grid.Row="1" Grid.RowSpan="2" /> 


现在 , 可 以 使 用 AdaptiveTrigger 来 使 控件 显示 在 宽度 大 于 1023 的 窗口 中 。 当 AdaptiveTrigger 触发 时 , Setter 
将 用 尸 控件 的 Visibility 属性 设置 为 Visible( 代 码 文件 BooksApp/Views/BooksPage.xam]l): 


<Grid> 
I 
<Vviews:BookDetailUserCcontrol x:Name="BookDetailUCcC" Visibility="Collapsed" 
Grid.Ccolumn="1" Grid.Row="1" Grid.RowSpan="2" /> 


<VisualstateManager.VisualSstateGroups> 
<VlsualSstateGroup xX:Name="WindowSstates"> 
<Visualstate x:Name="Widestate™"> 
<VisualSstate.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="1024"/> 
</VisualState .StateTriggers> 
<VisualSstate.Setters»> 
<Setter Target="BookDetailUC .Visibility" Value="Visible" /> 
</VisualState.Setters> 
</Visualstate> 
<Visualstate x:Name="MediumSstate"™> 
<VisualSstate.SstateTriggers> 
<AdaptiveTrigger MinWindowWidth="720"/> 
</Visualstate.SstateTriggers> 
</Visualstate> 
所 1 一 一 ... 一 一 > 
</VisualstateGroup> 
</VisualstateManager.VisualstateGroups> 
</Grid> 


运行 该 应 用 程序 时 ， 可 以 看 到 显示 用 户 控件 的 BooksPage( 参 见 图 34-11)。 图 34-12 显示 了 隐藏 用 户 控 件 的 
较 小 状态 。 在 这 里 ，NavigationView 也 会 引发 一 个 更 小 的 视图 。 使 应 用 程序 更 小 ， 设 置 为 NarrowState( 参 见 图 
34-13)， 市 有 NavigationView 的 AdaptiveTrigger 会 再 次 触发 ， 只 显示 汉堡 包 按 钮 。 然 后 ， 只 有 单 击 汉堡 包 按 钮 ， 
才 显 示 NavigationView 的 窗 格 。 

Books Sample App 四 


回 Books 


OD + 2 


Title 
Professional C# 7 and ,NET Core 2 


| professional C# 7 and .NET Core 2 


Publisher 


Professional C# 6 and .NET Core 1.0 WroxPress 


professional C# 5.0 and .ET 4.5.1 


Enterprise Services With the .NET Framework 


吕 ! Settings 


图 34-11 
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Books Sample App 二 口 “er Books $ample App 


Professional C# 7 and .NET Core 2 professional C¥# 7 and .NET Core 2 

Professional C# 6 and .NET Core 1.0 Professional Ct# 6 and .NET Core 1 

Professional C# 5.0 and .NET 4.5.1 Professional C# 5.0 amd .NET 4.5.1 

Enterprise Services with the .NET Framework Enterpnse Services with the .NET F 
和 


图 34-12 图 34-13 


注意 : 
有 关 自 适应 触发 器 的 更 多 信息 ， 请 参阅 第 33 章 。 


注意 : 
这 里 缺少 的 是 更 改 视图 模型 的 UseNavigation 属性 , 以 使 用 或 不 使 用 导航 。 一 种 方法 是 直接 或 通过 服务 设置 
视图 模型 的 属性 。 另 一 种 方法 是 使 用 事件 聚合 器 ， 参 见 本 章 34.8.6 节 “使 用 事件 传递 消息 ”。 


34.8.4 ”显示 进度 信息 


在 许多 应 用 程序 和 许多 视图 模型 中 ， 显 示 进 上 度 信 息 是 必要 的 。 这 就 是 为 什么 在 示例 应 用 程序 中 ， 在 
ViewModelBase 类 中 实现 了 进展 信息 的 显示 。 

在 视图 模型 中 显示 进度 信息 可 以 像 布尔 显示 属性 ShowProgress 一 样 人 简单 。 对 于 可 以 启动 多 个 并 行 操 作 的 更 
复杂 场景 ， 可 以 使 用 计数 器 创建 实现 代码 。 在 调用 SetInProgress 方法 之 后 ， 为 了 不 瑟 记 再 次 减少 计数 ， 
StartInProgress 方法 返回 一 个 IDisposable， 它 会 自动 对 Dispose 进行 递减 (代码 文件 Framework/ViewModels/ 


ViewModelBase.cs): 
public abstract class ViewModelBase : BindableBase 
{ 
private class StateSetter : IDisposable 
{ 


private Action end; 
public StateSetter (Action start, Action end) 
{ 

start?.Invokel).; 

_end = end; 


} 
public void Dispose(} => end?.Invoke(); 
} 
private int inPprogressCounter = 0; 
protected void 3etInNPFrogress{(bool Set = true) 
{ 
if (set) 
{ 
Interlocked.Increment (ref inProgressCounter)}); 
onPropertychanged (nameof (InProgress)); 
} 
居 1] Se 
{ 


Interlocked.Decrement (ref _ inProgressCounter); 
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OnPropertyChanged (nameof ( 工 亿 ETODGITESSJ DT 
} 
} 
public IDisposable StartInProgress() => 
new StateSetter(() => SetInProgress{(}, () => SetInProgress (false}))}):; 


Public bool InProgress => linProgressCounter != 0; 
f/f/---. 
} 


对 于 每 个 可 能 需要 更 长 时 间 的 动作 , 例如， 用 于 保存 的 EndEdit 方法 ， 调 用 StartInProgress 方法 ， 将 该 方法 
返回 的 内 容 传递 给 using 语句 。 因 此 ， 在 using 语句 的 末尾 调用 Dispose 方法 ， 再 次 减少 进度 计数 (代码 文件 
Framework/ViewModels/EditableViewModel.cs): 


Public async virtual void EndEdit () 
{ 
usSing (StartIinProgress'()) 
{ 
await OnsaveAsync(); 
EditItem = default (TItem) ; 
IsEditMode = false; 
await litemsSservice.RefreshAsync () : 
await OnEndEditAsync(); 
} 
} 


现在 ， 可 以 使 用 ProgressBar， 将 Visibility 属性 绑 定 到 视图 模型 的 mProgress 属性 ， 并 上 自动 显示 进度 条 (代码 
文件 BooksApp/Views/BooksPage.xaml): 
<ProgressBar Margin="8" HorizontalAlignment="Stretch" 


Visibility="{X:Bind ViewModel .InProgress, Mode=OneWay}" 
IsIndeterminate="True™" Grid.cCcolumnspan="2"™ /> 


34.8.5 ”使 用 列表 项 中 的 操作 


在 现代 用 户 界面 中 ， 当 显示 列表 时 ,列表 项 还 提供 了 一 些 附加 信息 , 或 者 允许 在 项 上 悬 停 时 执行 一 些 操作 。 
例如 ， 微 软 的 Mail 程序 允许 用 户 在 不 首先 选择 邮件 的 情况 下 就 可 以 标记 /删除 /归档 邮件 。 这 是 怎么 做 到 的 ? 

可 以 绑 定 BookItemViewModel 对 象 , 而 不 是 直接 将 Book 项 目 绑 定 到 列表 中 。 使 用 BookItemViewModel 项 ， 
除了 图 书 的 信息 之 外 ， 还 可 以 定义 命令 。 

在 样 例 代码 中 ，BookItemViewModel 是 包装 Book 对 象 的 视图 模型 。 与 其 他 视图 模型 相反 ， 它 不 会 通过 DI 
容器 创建 ， 因 此 可 以 在 构造 函数 中 使 用 Book 对 象 。book 实例 分 配给 ItemViewModel 基 类 的 Item 属性 。 除 了 基 
类 之 外 ，BookItemViewModel 还 定义 了 DeleteBookCommand 和 OnDeleteBook 方法 ， 设 方法 调用 IItemsService 
的 DeleteAsync 方法 (代码 文件 BooksLib/ViewModels/BookItemViewModel.cs): 

public class BookItemViewModel : ItemViewModel<Book> 


{ 


private readonly IItemsService<Book> booksService; 


public BookItemViewModel (Book book, IItemsService<Book> booksService) 
{ 

Item = book; 

booksService = booksService; 

DeleteBookCommand = new RelayCommand (OnDeleteBook); 


} 

public RelayCommand DeleteBookCommand { get; set; } 
private async vold OnDeleteBook() 

await booksSservice.DeleteAsync (Item); 


} 
} 


当 BookItemViewModel 没有 通过 DI 容器 创建 时 ， 它 是 如 何 创 建 的 呢 ? MasterDetailViewModel 不 仅 定 义 了 
可 以 绑 定 到 列表 控件 的 Items 属性 ， 还 定义 了 ItemsViewModels 属性 。 这 个 属性 只 使 用 抽象 方法 ToViewModel 
将 Items 转换 为 TItemViewModel( 代 码 文件 Framework/ViewModels/MasterDetailViewModel.cs): 
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Public abstract class MasterDetallViewModel<TItemViewModel, TItem> : 
ViewModelBase 
where TItemviewModel : IItemVviewModel<TItem> 
where TItem: class 
{ 
FT 


Public ObservableCollection<TItem> Items => itemsService.Items; 
protected abstract TItemViewModel ToViewModel (TItem item); 


Public virtual IEnumerable<TItemViewModel> ItemsViewModels 三 > 
Items.Select (item =» ToViewModel (item)}):; 
站 
} 


派生 类 BooksViewModel 只 需要 重 写 ToViewModel 方法 , 以 将 Book 对 象 转 换 为 BookItemViewModel 对 象 。 
为 此 , 只 需要 创建 BookItemViewModel 对 象 ,来 传递 Book 和 所 需 的 服务 (代码 文件 BooksLib/ViewModels/Books- 
ViewModel.cs): 


protected override BookItemViewModel ToViewModel (Book item) 三 > 
new BookItemViewModel (item, booksService); 


现在 可 以 将 视图 模型 类 型 绑 定 到 ListView 上 。 定 义 一 个 用 户 控 件 ， 以 显示 列表 项 。 如 何 确 保 只 有 当 上 鼠标 巧 停 在 
列表 项 时 ， 才 显示 按钮 ? 已 经 在 目 适 应 用 户 界 面 中 用 过 的 一 种 技术 是 ， 把 一 个 元 素 (本 例 中 是 Grid 控件 ) 的 visibility 
设置 为 Collapsed。 现 在 ， 使 用 HoverButtonsShown 和 HoverButtonsHidden 定义 定制 的 Visual State 元 素 。 在 状态 
HoverButtonsShown 中 ，Grid 的 visibility 设置 为 Visible( 代 码 文件 BooksApp/Views/BookItemUserControl.xam]l): 

<GIrid> 

<VisualSstateManager .VisualSstateGroups> 
<VisualSstateGroup x:Name="HoveringSstates"> 
<Visualstate x:Name="HoverButtonsSshown"> 
<Visualstate. Setters»> 
<Setter Target="hoverArea .Visibility" Value="Visible" /> 
</VisualState.Setters> 
</VisualState> 
<Visualstate x:Name="HoverButtonsHidden"> 
</Visualstate> 
</VisualstateGroup> 
</VisualstateManager.VisualstateGroups> 


<GIrid.columnDefinitions> 
<ColumnDefinition Width="*" /> 
<ColumnDefinition Width="auto™ /> 
</GCrid.columnDefinitions> 
<StackPanel VerticalAlignment="Center"> 
<TextBlock 
Text="{x:Bind Mode~OneWay, Path=BookItemViewModel.Item.Title}™" /> 
</StackPanel> 
<GT19 Grid.Ccolumn="1" x:Name="hoverArea" Visibility="Collapsed" 
VerticalAliqgnment="Center™"™> 
<AppBarButton 
Command="{X:Bind Mode=OneWay, Path=BookItemViewModel .DeleteBookCommand}™" 
Icon="Delete™" Label="Delete™" IsTabstop="False™ 
VerticalAlignment="Stretch"/> 
</Grid> 
</Grid> 


在 代码 隐藏 文件 中 , 通过 OnPointerEntered 和 OnPointerExited. 重 写 方法 , 使 用 VisualStateManager 设置 状态 。 
只 有 当 用 户 使 用 鼠标 或 钢笔 时 ， 才 设置 状态 (代码 文件 BooksApp/Views/BookItemUserControl.xaml.cs): 


Public sealed partial class BookItemUserControl : UserControl 
{ 
Public BookItemUserControl () 
{ 
this.InitializeComponent (}; 


} 


Public BookItemViewModel BookItemViewModel 

{ 
get => (BookItemVvViewModel)GetValue (BookItemvyviewModelProperty).; 
set => SetValue (BookItemViewModelProperty, value);} 

} 
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public static readonly DependencyProperty BookItemViewModelProperty = 
DependencyProperty.Register ("BookViewModel™", typeof (BookItemViewModel), 
typeof (BookItemUserControl}, new PropertyMetadata (null)}; 


Protected override void OnPointerEntered (PointerRoutedEventArgs e) 
{ 


base.OnPointerEntered (e). 


if (ee.Pointer.PointerDeviceType == PointerDeviceType.Mouse || 
e.Pointer.PointerDeviceTlype == PointerDeviceType.Pen) 
{ 
VisualstateManager.GoloState (this, "HoverButtonsSshown", true).; 
} 
} 


Protected override woid OnPointerExited (PointerRoutedEventArgs e) 
{ 


base.OnPointerExited (e}.; 


VisualStateManager .GoTIoState (this, "HoverButtonsHidden", true); 


} 
} 
运行 应 用 程序 时 ， 把 鼠标 悬 停 在 列表 项 上 时 ， 就 可 以 看 到 状态 的 变化 ， 如 图 34-14 所 示 。 
Books Sample App 口 we 
回 Books 
DD 十 Ea 
Title 
Professional C# 7 and ,NET Ceore 2 r 一 一 一 
| Professional C# 7 and .NET Core 2 
publisher 
Professional C# 6 and ,NET Core 10 本 四 | | Wrox press | 
i Dalate | 
Professional C# 5.0 and .NET #4.5.1 
Enterprise Services with the .NET Framework 
Ee Settings 


图 34-14 


34.9 ”使 用 事件 传递 消息 


对 于 应 用 程序 的 当前 状态 ， 有 一 个 问题 需要 根据 应 用 程序 窗口 的 大 小 , 设置 视图 模型 的 状态 ， 以 使 用 导航 。 
处 理 此 问题 的 一 种 方法 是 创建 带 有 事件 的 单 例 服 务 ， 使 用 视图 模型 中 的 这 个 服务 来 订阅 事件 ， 然 后 主 窗口 触发 
事件 。 这 样 的 服务 也 可 以 在 全 球 范围 内 定义 一 一 为 事件 定义 的 服务 。 对 于 许多 MVVM 框架 ， 这 也 称 为 事件 聚 
合 器 。 

Framework 项 目 定义 了 一 个 泛 型 EventAggregator。 该 聚合 器 定义 了 一 个 名 为 Event 的 事件 ， 其 中 Action 
<object, TEvent> 类 型 的 处 理 程序 可 以 订阅 和 取消 订阅 ， 方 法 Publish 触发 事件 。 这 个 聚合 器 实现 为 一 个 单 例 ， 使 
其 易于 访问 ， 而 不 需要 创建 实例 (代码 文件 Framework/EventAggregator.cs): 


public class EventAggregator<TEvent> 
where TEvent: EventArgs 
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private static EventAggregator<TEvent> s eventAggregator; 


Public static EventAggregator<TEvent> Instance => 
5s eventAggregator 22 (s eventAggregator = new EventAggregator<TEvent>()); 


private EventAggregator() 

{ 

} 

Public event Action<object, TEvent> Event; 


Public void Publish (object source, TEvent ev) 一 > 
Event?.Invoke (source, ev}); 


注意 : 
对 于 泛 型 的 单 例 类 ， 不 止 创建 一 个 实例 ， 每 个 泛 型 参数 类 型 都 有 一 个 实例 。 这 对 于 EventAggregator 来 说 很 
好 ， 因 为 不 同 的 事件 类 型 不 需要 共享 一 些 数据 ， 并 且 它 允许 更 好 的 可 伸缩 性 。 


要 将 有 关 导 航 的 信息 从 主 窗口 传递 到 视图 模型 ， 需 要 使 用 NavigationInfoEvent。 这 个 事件 信息 类 使 用 布尔 
属性 来 定义 是 否 应 该 使 用 导航 (代码 文件 BooksLib/Events/NavigationInfoEvent.cs): 


public class NavigationInfoEvent : EventArgs 


| 
Public bool UseNavigation { get; set; } 
} 


BooksViewModel 现在 可 以 订阅 事件 。 使 用 BooksViewModel 的 构造 函数 可 以 访问 静态 成 员 Instance， 以 获 
取 NavigationInfoEvent 类 型 的 singleton 对 象 ， 并 将 UseNavigation 属性 方法 分 配给 事件 信息 eUseNavigation( 代 
码 文 件 BooksLib/ViewModels/BooksViewModel.cs): 


public BooksViewModel (IItemsService<Book> DooKsSeTVILCe ， 
INavigationService navigationService) 
: base (booksService) 
{ 
booksService = booksService ?3? 
”七 hrow new ArgumentNullException (nameof (pooksSerVwICE) ) ; 
navigationService = navigatlionService ?3 
throw new ArgumentNullException (nameof (navigationService})); 


EventAggregator<NavigationInfoEvent»>.Instance.Event += (sender, e) => 
{ 
UseNavigation = ee.UseNavigation; 
}; 
于 
} 


当主 页 面 的 大 小 发 生变 化 时 ， 将 发 布 该 事件 。 在 MainPage 类 中 ，OnsizeChanged 事件 处 理 程序 注册 到 页 面 
的 SizeChanged 事件 。 在 事件 处 理 程序 中 ，EventAggregator 可 以 像 使 用 静态 Instance 属性 来 访问 订阅 那样 ， 通 
过 调用 Publish 方法 来 访问 ， 该 方法 传递 一 个 NavigationInfoEvent 对 象 。NavigationInfoEvent 对 象 根据 窗口 的 大 
小 进行 初始 化 (代码 文件 ViewModels/BooksViewModel.cs): 


public sealed partial class MainPage : Page 
{ 
a 
private Volad OnsizeChanged (object sender, SizeChangedEventArgs e) 
{ 
EventAggregator<NavigationIinfoEvent>.Instance.Publish (this, 
new NavigationIinfoEvent { UseNavigation = e.NewSize.Width < 1024 }); 


34.10 ”使 用 框架 


在 示例 应 用 程序 中 ， 看 到 Framework 项 目 中 定义 的 类 ， 例 如 ，BindableBase 、DelegateCommand 和 
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EventAggregator。 基 于 MVVM 的 应 用 程序 需要 这 些 类 ， 但 不 需要 目 己 来 实现 它们 。 其 工作 量 不 大 ， 但 可 以 使 
用 现 有 的 MVVM 框架 。 

Laurent Bugnion 的 MVVM Light(http://mvvmlight.net) 是 一 个 小 框架 ， 完 全 符合 MVVM 应 用 程序 的 目的 ， 
可 用 于 许多 不 同 的 平台 。 

男 一 个 框架 Prism.Core ( http://github.com/PrismLibrary ) 最 初 由 Microsoft Patterns and Practices 团队 创建 ， 现 
在 转移 到 社区 。 虽 然 Prism 框架 非常 成 熟 ， 支 持 插 件 和 定位 控件 的 区 域 ,但 Prism.Core 很 轻 ， 仅 包含 几 个 类 型 ， 
如 BindableBase、DelegateCommand 和 ErrorsContainer。 


34.11 小 结 


本 章 围 绕 MVVM 模式 提供 了 创建 基于 XAML 的 应 用 程序 的 架构 指南 。 讨 论 了 模型 、 视 图 和 视图 模型 的 关 
注 点 分 离 。 除 此 之 外 ， 还 介绍 了 使 用 接口 INotifyPropertyChanged 实现 更 改 通 知 ， 分 离 数 据 访问 代码 的 存储 库 模 
式 ， 使 用 事件 在 视图 模型 之 间 传 递 消息 (这 也 可 以 用 来 与 视图 通信 )， 以 及 使 用 IoC 容器 注入 依赖 项 。 

本 章 还 展示 了 可 以 跨 应 用 程序 使 用 的 视图 模型 库 。 这 些 都 允许 代码 共享 ， 同 时 仍然 允许 使 用 特定 平台 的 功 
能 。 可 以 通过 库 和 服务 实现 使 用 特定 于 平台 的 特征 ,协定 可 用 于 所 有 的 平台 。 第 37 章 利用 同样 的 库 创 建 了 一 个 
带 有 Xamarin 的 应 用 程序 。 

第 35 章 将 继续 讨论 XAML、 样 式 和 资源 。 


二 


样式 化 Windows 应 用 程序 


本 章 要 点 

为 Windows 应 用 程序 指定 样式 
用 形状 和 几何 形状 创建 基础 图 
用 转换 进行 缩放 、 旋 转 和 扭曲 
使 用 笔 刷 填充 背景 

处 理 样 式 、 模 板 和 资源 
创建 动画 

Visual State Manager 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 wwwwrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Styles 目录 的 
https://github.conyProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 
® Shapes 
Geometry 
Transftormation 
Bmushes 
Styles and Resources 
Template 
Animation 
Transitions 
Visual State 


35.1 样式 设置 


近年 来 ， 开 发 人 员 越 来 越 关心 应 用 程序 的 外 观 。 当 Windows Forms 是 创建 桌面 应 用 程序 的 技术 时 ， 用 户 界 
面 没有 提供 许多 设置 应 用 程序 样式 的 选项 。 控 件 有 标准 的 外 观 ， 根 据 正在 运行 应 用 程序 的 操作 系统 版 本 而 略 有 
不 同 ， 但 不 大 容易 定义 完整 自 定 义 的 外 观 。 
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Windows Presentation Foundation(WPF) 改 变 了 这 一 切 。WPF 基于 DirectX， 从 而 提供 了 同 量 图 形 ， 人 允许 方便 
地 调整 窗口 和 控件 的 大 小 。 控 件 是 完全 可 定制 的 ， 可 以 有 不 同 的 外 观 。 设 置 应 用 程序 的 样式 变 得 非常 重要 。 应 
用 程序 可 以 有 任何 外 观 。 有 了 优秀 的 设计 , 用 户 可 以 使 用 应 用 程序 , 而 不 需要 知道 如 何 使 用 Windows 应 用 程序 。 
相反 ， 用 户 只 需要 拥有 特定 领域 的 知识 。 例 如 ， 苏 歼 世 机 上 场 创建 了 一 个 WPF 应 用 程序 ， 其 中 的 按钮 看 起 来 伐 
飞机 。 通 过 按钮 ， 用 户 可 以 获取 飞机 的 位 置信 息 (完整 的 应 用 程序 看 起 来 像 机 场 )。 按 钮 的 颜色 可 以 根据 配置 有 
不 同 的 含义 : 它们 可 以 显示 航线 或 飞机 的 准时 /延迟 信息 。 通 过 这 种 方式 ， 应 用 程序 的 用 户 很 容易 看 到 目前 在 机 
场 的 飞机 有 或 长 或 短 的 延误 。 

应 用 程序 拥有 不 同 的 外 观 ， 这 对 于 现代 Windows 应 用 程序 更 加 重要 。 在 这 些 应 用 程序 中 ， 以 前 没有 使 用 过 
Windows 应 用 程序 的 用 户 可 以 使 用 这 些 设 备 。 对 于 非常 熟悉 Windows 应 用 程序 的 用 户 ， 应 该 考虑 通过 使 用 户 工 
作 得 更 方便 的 典型 过 程 ， 帮 助 这 些 用 户 提高 效率 。 

在 设置 WPF 应 用 程序 的 样式 时 ， 微 软 公司 没有 提供 很 多 指导 。 应 用 程序 的 外 观 主要 取决 于 设计 人 员 的 想象 力 。 
对 于 UWP 应 用 程序 ， 微 软 公司 提供 了 更 多 的 指导 和 预定 义 的 样式 ， 也 能 够 修改 任意 样式 。 

本 章 首先 介绍 XAML 的 核心 元 素 shapes， 它 允许 绘制 线条 、 椭 圆 和 路 径 元 素 。 介 绍 了 形状 的 基础 之 后 ， 就 
讨论 geometry 元 素 。 可 以 使 用 geometry 元 素来 快速 创建 基于 矢量 的 图 形 。 

使 用 transformation， 可 以 缩放 、 旋 转 任何 XAML 元 素 。 用 brush 可 以 创建 纯色 、 渐 变 或 更 高 级 的 背景 。 本 
章 将 论述 如 何在 样式 中 使 用 画笔 和 把 样式 放 在 XAML 资源 中 。 

最 后 ， 使 用 template 模板 可 以 完全 目 定 义 控 件 的 外 观 ， 本 章 还 要 学 习 如 何 创建 动画 。 


35.2 “形状 


形状 是 XAML 的 核心 元 率 。 利 用 形状 ， 可 以 绘制 矩形 、 线 条 、 顶 圆 、 路 径 、 多 边 形 和 折线 等 二 维 图 形 ， 这 
些 图 形 用 派生 自 抽 象 类 Shape 的 类 表示 。 图 形 在 Windows. UIXaml.Shapes 名 称 空间 中 定义 。 

下 面 的 XAML 示例 绘制 了 一 个 黄色 笑脸 , 它 用 一 个 椭圆 表示 笑脸 ， 两 个 椭圆 表示 眼睛 ， 两 个 椭圆 表示 眼睛 
中 的 瞳孔 ， 一 条 路 径 表 示 嘴 型 (代码 文件 Shapes/MainPage.xaml): 


<Canvas> 

<Ellipse Canvas.Left="10"™ Canvas.Top="10"™ Width="100"™" Height="100" 
stroke="Blue™" StrokeThickness="4" Fill="Yellow" /> 

<Ellipse Canvas.Left="30"™" Canvas.Top="12"™ Width="60" Height="30"> 
<Ellipse.Fill> 

<LinearGradientBrush StartPoint="0.5,0™ EndPoint="0.5, 1™> 
<Gradientstop Cffset="0.1" Color="DarkGreen"™ /> 
<Gradientstop Offset="0.7" Color="Transparent™" /> 
</LinearGradientBrush> 

</Ellipse.Fill> 

</Ellipse> 

<Ellipse Canvas.Left="30"™" Canvas.Top="35"™" Width="25" Height="20" 
Stroke="Blue" StrokeThickness="3" Fill="White™ /> 

<Ellipse Canvas.Left="40"™" Canvas.Top="43"™ Width="6" Helght="5" 
Fill="Black™ /> 

<Ellipse Canvas.Left="65" Canvas.Top="35" Width="25" Helilght="20" 
Stroke="Blue™" StrokeThickness="3" Fill="White™" /> 

<Ellipse Canvas.Left="1715" Canvas.Top="43"™ Width="6" Helght="5" 
Fill="Black™" /> 

<Path Stroke="Blue" StrokeThickness="4" 
Data="M 40,74 ©Q 57,95 80,74" /> 

</Canvas> 


图 35-1 显示 了 这 些 XAML 代码 的 结果 。 

无 论 是 按钮 还 是 线条 、 和 矩形 等 图 形 ， 所 有 这 些 XAML 元 素 都 可 以 通过 编程 来 
访问 。 把 Path 元 素 的 Name 或 x:Name 属性 设置 为 mouth， 就 可 以 用 变量 名 mouth 
以 编程 方式 访问 这 个 元 素 : 


<Path Name="mouth" Stroke~="Blue™" StrokeThickness="4" 
Data="M 40,74 9 57,95 80,74 ™ /> 图 35-1 


第 35 章 样式 化 Windows 应 用 程序 | 943 


接 下 来 更 改 代码 ， 脸 上 的 嘴 在 后 台 代 码 中 动态 改变 。 添 加 一 个 按钮 和 单 击 处 理 程序 ， 在 其 中 调用 SetMouth 
方法 (代码 文件 Shapes/MainPage.xaml.cs): 

private void OnchangeSshape (object sender, RoutedEventArgs e) 

{ 


SetMouth(}.: 
} 


在 后 台 隐 藏 文件 中 ， 可 以 使 用 图 片 和 片段 创建 几何 图 形 。 首 先 ， 创 建 一 个 二 维 数组 ， 其 中 包含 的 6 个 氮 定 
义 了 表示 快乐 状态 的 3 个 点 ， 和 表示 悲伤 状态 的 3 个 点 (代码 文件 Shapes/MainPage. xaml.cs): 


private readonly Point[,] mouthPoints = new Point[2, 3] 
{ 
{ 
new Point (40, 74), new Point (57, 3935), new Point (80, 74), 
】， 
{ 
new Point (40, 82), new Point (57, 65), new Point (80, 82), 
} 
}; 


接 下 来 ， 将 一 个 新 的 PathGeometry 对 象 分 配给 Path 的 Data 属性 。PathGeometry 包含 定义 了 起 点 的 
PathFigure( 设 置 StartPoint 属性 与 路 径 标记 语法 中 的 字母 M 是 一 样 的 ) PathFigure 包含 QuadraticBezierSegment， 
其 中 的 两 个 Point 对 象 分 配给 属性 Pointl 和 Point2 (与 带 有 两 个 点 的 字母 Q 一 样 ): 


private bool laugh = false; 
Public void SetMouth ( ) 
{ 


int index = laugh ? 0: 1; 


var figure = new PathrFigure(} { StartPoint = mouthPoints[index, 0] }; 
figure.Segments = new PathSsegmentCollection(); 
Var Sedgment1l = new QuadraticBezierSegment 
{ 
Pointl 
Point2 
} 


mouthPoints[index, 1]; 
mouthPoints[index, 2]; 


figure.Segments.Add (segment1) ; 

Var geometry = new PathGeometry()}); 
Jeometry.Figures = new PathrFrigureCollection(); 
geometry.Figures.Add (figure).; 


mouth.Data = geometry; 
laugh = ! laugh; 
} 


分 段 和 图 片 的 使 用 在 下 一 节 详 细 说 明 。 运行 应 用 程序 , 图 35-2 显示 悲 念 的 脸 。 
表 35-1 描述 了 名 称 空 间 System.Windows.Shapes 和 Windows.Ui.Xaml.Shapes 
中 可 用 的 形状 。 


35-2 
表 35-1 
Shape 类 说 明 
Line 可 以 在 坐标 (X1,Y1) 到 (X2,Y2) 之 间 绘 制 一 条 线 
Rectangle 使 用 Rectangle 类 ， 通 过 指定 Width 和 Height 可 以 绘制 一 个 矩形 
Fllipse 使 用 Ellipse 类 ， 可 以 绘制 一 个 椭圆 
Path 使 用 Path 类 可 以 绘制 一 系列 直线 和 曲线 。Data 属性 是 Geometry 类 型 。 还 可 以 使 用 派生 自 基 类 Geometry 的 类 绘 
制图 形 ， 或 使 用 路 径 标记 语法 来 定义 图 形 
Polygon 使 用 Polygon 类 可 以 绘制 由 线段 连接 而 成 的 封闭 图 形 。 多 边 形 由 一 系列 赋予 Points 属性 的 Point 对 象 定义 


Polyline 类 似 于 Polygon 类 ， 使 用 Polyline 也 可 以 给 制 连接 起 来 的 线段 。 与 多 边 形 的 区 别 是 ， 折 线 不 一 定 是 封闭 图 形 
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35.3 ”几何 图 形 


前 面 示例 显示 ， 其 中 一 种 形状 Path 使 用 Geometry 来 绘图 。Geometry 元 素 也 可 用 于 其 他 地 方 ， 如 用 于 
DrawlnpgBIrush 。 

在 某 些 方面 ，Geometry 元 素 非 常 类 似 于 形状 。 与 Line、Ellipse 和 Rectangle 形状 一 样 ， 也 有 绘制 这 些 形状 
的 Geometry 元 素 : LineGeometry、EllipseGeometry 和 RectangleGeometry。 形状 与 几何 图 形 有 显著 的 区 别 。Shape 
是 一 个 FrameworkElement, 可 以 用 于 把 UIElement 用 作 其 子 元 素 的 任意 类 .FrameworkElement 派 生 自 UIElement。 
形状 会 参与 系统 的 布局 ， 并 呈现 目 身 。 而 Geometry 类 不 呈现 目 身 ， 特 性 和 系统 开销 也 比 Shape 类 少 。Geometry 
类 直接 派生 自 DependencyObject。 

Path 类 使 用 Geometry 来 绘图 。 几 何 图 形 可 以 用 Path 的 Data 属性 设置 。 可 以 设置 的 简单 的 几何 图 形 元 素 有 
绘制 椭圆 的 EllipseGeometry、 绘 制 线条 的 LineGeometry 和 绘制 矩形 的 RectangleGeometry。 


35.3.1 使 用 段 的 几何 图 形 


也 可 以 使 用 段 来 创建 几何 图 形 。 几 何 图 形 类 PathGeometry 使 用 段 来 绘图 。 下 
面 的 代码 段 使 用 BezierSegment 和 LineSegment 元 素 绘 制 一 个 红色 的 图 形 和 一 个 绿 A 
色 的 图 形 ， 如 图 35-3 所 示 。 第 一 个 BezierSegment 在 图 形 的 起 点 (70.40)、 终 点 
(150.63) 、 控 制 点 (90.37) 和 (130.46) 之 间 绘 制 了 一 条 贝 塞 尔 曲 线 。 下 面 的 
LineSegment 使 用 贝 塞 尔 曲 线 的 终点 和 (120,110) 绘 制 了 一 条 线段 (代码 文件 图 35-3 
Geometries/MainPage.xam!l ): 


<Path Canvas.Left="0"™ Canvas.Top="0"™ Fill="Red™" Stroke="Blue" 
strokeThickness="2.5"> 
<Path.Data> 
<GeometryGroup> 
<PathGeometry> 
<PathGeometry.Figures> 
<PathFigure StartPoint="70,40™" IsClosed="True"> 
<PathFigure.Segqments> 
<BezlilerSegment Pointl="90,37"™" Point2="130,46" 
Point3="150, 63" /> 
<LineSegment Point="120,110" /> 
<BezlerSegment Pointl="100,95"™" Point2="70,90" 
Point3="45,91" /> 
</PathFigure.Segments> 
</PathFigqure> 
</PathGeometry.Figures> 
</PathGeometry> 
</GeometryGroup> 
</Path.Data> 
</Path> 


<Path Canvas.Left="0"™" Canvas.Top="0" Fill="Green™" Stroke="Blue™" 
strokeThickness="2.5"> 
<Path.Data> 
<CGeometrySroup> 
<PathGeometry> 
<PathGeometry.Figures> 
<PathFigure StartPoint="160,70"> 
<PathFigure.Segqgments> 
<BezlerSegment Pointl="175,85™" Point2="200,99" 
Point3="215,100" /> 
<LineSegment Point="195,148" /> 
<BezierSegment Pointl="174,150" Point2="142,140" 
Point3="129,115" /> 
<LineSegment Point="160,70"™ /> 
</PathFigure.Segments> 
</PathFigqgure> 
</PathGeometry.Figures> 
</PathGeometry> 
</GeometryGroup> 
</Path.Data> 
</Path> 
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除了 BezierSegment 和 LineSegment 元 素 之 外 ， 还 可 以 使 用 ArcSegment 元 素 在 两 点 之 间 绘 制 椭 圆 弧 。 使 用 
PolyLineSegment 可 以 绘制 一 组 线段 ，PolyBezierSegment 由 多 条 贝 塞 尔 曲线 组 成 ，QuadraticBezierSegment 创建 一 
条 二 次 贝 塞 尔 曲线 ，PolyQuadraticBezier- Sesgment 由 多 条 二 次 贝 塞 尔 曲线 组 成 。 


35.3.2 ”使 用 PathMarkup 的 几何 图 形 


本 章 前 面 使 用 了 路 径 标记 和 Path 形状 。 在 后 台 使 用 路 径 标记 ， 可 以 通过 
StreamGeometry 进行 高 效 的 绘图 。UWP 应 用 程序 的 XAML 会 创建 图 形 和 片段 。 
通过 编程 ， 可 以 创建 线段 、 贝 塞 尔 曲线 和 圆 弧 ， 以 定义 图 形 。 通 过 XAML 可 以 使 
用 路 径 标记 语法 。 路 径 标 记 语 法 可 以 与 Path 类 的 Data 属性 一 起 使 用 。 特 殊 字 符 
定义 点 的 连接 方式 。 在 下 面 的 示例 中 ，M 标记 起 点 , 工 是 到 指定 点 的 线条 命令 ， 
Z 是 闭合 图 形 的 闭合 命令 。 图 35-4 显示 了 这 个 绘图 操作 的 结果 。 路 径 标 记 语 法 多 
许 使 用 更 多 的 命令 ， 如 水 平 线 (D、 垂 直线 (V)、 三 次 贝 塞 尔 曲线 (CI)、 二 次 贝 塞 尔 
曲线 (Q)、 光 滑 的 三 次 贝 塞 尔 曲 线 (S)、 光 滑 的 二 次 贝 塞 尔 曲 线 (T)， 以 及 椭圆 弧 
(A)( 代 码 文件 Geometries/MainPage.xaml): 

<Path Canvas.Left="0" Canvas.Top="200" Fill="Yellow" Stroke="Bluen 

StrokeThickness="2.5" 
Data="M 120,5 L 128,80 L 220,50 L 160,130 L 190,220 L 100,150 


L 80,230 L 60,140 10,110 170,80 Zz" strokeLineJoin="Round"> 
</Path> 


35.4 变换 


因为 XAML 基于 矢量 ， 所 以 可 以 重 置 每 个 元 紊 的 大 小 。 在 下 面 的 例子 中 ， 基 于 矢量 的 图 形 现在 可 以 缩放 、 
旋转 和 倾斜 。 不 需要 手工 计算 位 置 ， 就 可 以 进行 单 击 测试 (如 移动 鼠标 和 鼠标 单 击 )。 

图 35-5 显示 了 一 个 矩形 的 几 个 不 同形 式 。 所 有 的 矩形 都 定位 在 一 个 水 平方 同 的 StackPanel 元 素 中 ， 以 并 排 
放置 和 矩形。 第 1 个 矩形 有 其 原始 大 小 和 布局 。 第 2 个 矩形 重 置 了 大 小 ,第 3 个 矩形 移动 了 ， 第 4 个 矩形 旋转 了 ， 
第 5 个 矩形 倾斜 了 ， 第 6 个 和 矩 形 使 用 变换 组 进行 变换 ， 第 7 个 矩形 使 用 和 窍 阵 进行 变换 。 下 面 各 节 讲述 所 有 这 些 


选项 的 代码 示例 。 


js 翅 


图 35-5 


图 35-4 


35.4.1 缩放 


给 Rectangle 元 素 的 RenderTransform 属性 添加 ScaleTransform 元 素 ， 如 下 所 示 ， 把 整个 画布 的 内 容 在 义 轴 
方 同 上 放大 0.5 倍 ， 在 立轴 方向 上 放大 0.4 倍 (代码 文件 Transformations/MainPage. xaml)。 
<Rectangle 而 1dth="120"” Height="60"™ Fill="Red™" Margin="20"> 
<Rectangle.RenderTransform> 
<ScaleTransform ScaleXx="0.5" ScaleY="0.4" /> 


</Rectangle .RenderTransform> 
</Rectangle> 


除了 变换 像 矩 形 这 样 简 单 的 形状 之 外 ， 还 可 以 变换 任何 XAML 元 素 ， 因 为 XAML 定义 了 矢量 图 形 。 在 以 
下 代码 中 ， 前 面 所 示 的 脸 部 Canvas 元 素 放 在 一 个 用 户 控件 SmilingFace 中 ， 这 个 用 户 控件 先 显示 没 有 转换 的 状 
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态 ， 再 显示 调整 大 小 后 的 状态 。 绪 果 如 图 35-6 所 示 。 


<local:smilingFace /> 
<local:smilingFace> 
<local:smilingFace.RenderTransform> 
<ScaleTransform ScaleXx="1 .6" ScaleY¥Y="0.8" CenterY¥Y="180" /> 
</local:sSmilingFace.RenderTransform> 


@S) E> 


</local:smilingFace> 图 35-6 
35.4.2 平移 


在 义 轴 或 Y 轴 方向 上 移动 一 个 元 素 时 ， 可 以 使 用 TranslateTransform。 在 以 下 代码 片段 中 ， 给 义 指 定 -90， 
元 素 同 左 移动 ， 给 指定 20， 元 系 同 底部 移动 (代码 文件 Transformations/MainPage.xam]): 
<Rectangle Width="120"™" Heijght="60"™" Fil]l]="Green™" Margin="20"> 
<Rectangle.RenderTransform> 
<TranslateTransform X="—-90"™" Y="20"™ /> 


</Rectangle.RenderTransform> 
</Rectangle> 


35.4.3 旋转 


使 用 RotateTransform 元 素 , 可 以 旋转 元 素 。 对 于 RotateTransform, 设置 旋转 的 角度 , 用 CenterX 和 CenterY 
设置 旋转 中 心 (代码 文件 Transformation/MainPage xaml ): 
<Rectangle Width="1]20" Heijght="60"™" Fill]="Orange”" Margin="20"> 
<Rectangle.RenderTransform> 
<RotateTransform Angle="45" CenterX="10" CenterY¥="-—80" /> 


</Rectangle.RenderTransform> 
</Rectangle> 


35.4.4 倾斜 


对 于 倾斜, 可 以 使 用 SkewTransform 元 素 。 此 时 可 以 指定 义 轴 和 YY 轴 方 向 的 倾斜 角度 (代码 文件 Transformation/ 
MamPage.xaml ): 
<Rectangle Width="120"™" Height="60"™" Fill="LightBlue™" Margin="20"> 
<Rectangle.RenderTransform> 
<SkewTransform AngleX="20" AngleY="30" CenterxX="40" CenterY="390" /> 
</Rectangle.RenderTransform> 
</Rectangle> 


35.4.5 组 合 变换 和 复合 变换 


同时 执行 多 种 变换 的 简单 方式 是 使 用 CompositeTransform 和 TransformationGroup 元 素 .TransformationGroup 
元 素 可 以 包含 SkewTransform、RotateTransform、TranslateTransform 和 ScaleTransform 作为 其 子 元 素 ( 代 人 码 文 件 
Transtormatons/MalnPage. xaml): 


<Rectangle Width="120™" Heilght="60™ Fil]l="LightGreen™" Margin="20"> 
<Rectangle.RenderTransform> 
<TransformGroup> 
<SkewTransform AngleX="45" AngleY¥Y="20"™" CenterX="—-390" CenterY¥="40" /> 
<RotateTransform Angle="90" /> 
<ScaleTransform ScaleX="0.5" ScaleY="1.2" /> 
</TransformGroup> 
</Rectangle.RenderTransform> 
</Rectangle> 


为 了 同时 执行 旋转 和 倾斜 操作 ， 可 以 定义 一 个 TransformGroup， 它 同时 包含 RotateTransform 和 
SkewTransform。 类 CompositeTransform 定义 多 个 属性 ， 用 于 一 次 进行 多 个 变换 。 例 如 ，ScaleX 和 ScaleY 进行 
缩放 ，TranslateX 和 TranslateY 移动 元 素 。 也 可 以 定义 一 个 MatrixTransform， 其 中 Matrix 元 素 指定 了 用 于 拉 伸 
的 M11 和 M22 属性 ， 以 及 用 于 倾斜 的 M12 和 M21 属性 ， 见 下 一 节 。 
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35.4.6 ”使 用 矩阵 的 变换 


同时 执行 多 种 变换 的 另 一 个 选择 是 指定 一 个 矩阵 .这 里 使 用 MatrixTransform.MatrixTransform 定义 了 Matrix 
属性 ， 它 有 6 个 值 。 设 置 值 1.0.0.1.0.0 不 改变 元 素 。 值 0.5.1.4.0.4.0.5.-200.0 会 重 置 元 素 的 大 小 、 倾 斜 和 平移 元 
素 (代码 文件 Transformations/MainPage.xam]); 
<Rectangle Width="120" Height="é60"™ Fil1ll="Gold™" Margin="20"> 
<Rectangle.RenderTransform> 
<MatrixTransform Matrix="0.5, 1.4, 0.4, 0.5, -200, 0"™ /> 
</Rectangle .RenderTransform> 
</Rectangle> 


如 果 将 一 个 字符 串 赋 给 Matrix 属性 ， 则 MatrixTransform 类 按 顺 序 定义 公共 字段 M11、M12、M21、M22、 
OffsetX 和 OffsetY。IMatrixTransform 实现 了 一 个 仿 射 变换 ， 所 以 9 个 矩阵 成 员 中 只 有 6 个 需要 指定 。 其 余 矩 阵 
成 员 使 用 固定 值 0、0、1。M11 和 M22 字段 具有 默认 值 1， 用 于 在 x 和 YY 方向 上 伸缩 。M12 和 M21 的 默认 值 
为 0， 用 于 倾斜 控件 。OffsetX 和 OffsetY 的 默认 值 为 0， 用 于 平移 控件 。 


35.5 画笔 


本 节 演 示 了 如 何 使 用 XAML 的 画笔 绘制 背景 和 前 景 。 本 节 将 学 习 如 何 使 用 纯色 和 线性 渐变 的 笔 刷 ， 使 用 笔 
刷 绘 制图 像 ， 使 用 新 的 AcrylicBrush 和 RevealBrush 。 


35.5.1 SolldColorBrush 


图 35-7 中 的 第 一 个 按钮 使 用 了 SolidColorBrmsh, 顾名思义 ,这 支 
画笔 使 用 纯色 。 全 部 区 域 用 同一 种 颜色 绘制 。 

把 Background 特性 设置 为 定义 纯色 的 字符 串 ， 就 可 以 定义 纯色 。 
使 用 BrushValueSerializer 把 该 字符 串 转 换 为 一 个 SolidColorBrush 元 素 
(代码 文件 Brushes/MainPage.xaml )。 

<Button Background="#FFC9659C">solid Color</Button> 图 35-7 

当然 ， 通 过 设置 Backeground 子 元 素 并 把 SolidColorBmsh 元 素 添 
加 为 它 的 内 容 ， 也 可 以 得 到 同样 的 效果 。 应 用 程序 中 的 第 一 个 按钮 使 用 十 六 进 制 值 用 作 纯 背景 色 (代码 文件 
Brushes/MainPage.xam!l): 

<Button Content="Solid Color 2"> 


<Button.Background> 
SolidColorBrush Color="#FFC9659C" /> 


</Button.Background> 
</Button> 


35.5.2 LinearGradientBrush 


对 于 平滑 的 颜色 变化 ,可 以 使 用 LinearGradientBrush, 如 图 35-8 所 示 。 这 个 画笔 定义 了 StartPoint 和 EndPoint 
属性 。 使 用 这 些 属性 可 以 为 线性 渐变 指定 2D 坐标 。 默 认 的 渐变 方 癌 是 从 (0.0) 到 (1.1) 的 对 角 线 。 定 义 其 他 值 可 
以 给 渐变 指定 不 同 的 方向 。 例 如 ，StartPoint 指定 为 (0.0)，EndPoint 指定 
为 (0,1)， 就 得 到 了 一 个 垂直 渐变 。StartPoint 和 EndPoint 值 指定 为 (1.0)， 
就 得 到 了 一 个 水 平 渐变 。 

通过 该 画笔 的 内 容 ， 可 以 用 GradientStop 元 素 定义 指定 偏 移 位 置 的 
颜色 值 。 在 各 个 偏 移 位 置 之 间 ， 颜 色 是 平滑 过 渡 的 (代码 文件 
Brushes/MainPage.xaml)。 图 35-8 

<Button Content="Linear Gradient Brush"> 


<Button .Background> 
<LinearGradientBrush StartPoint="0,0" EndPoint="0,1"> 
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<GradientStop Offset="0" Color="LightGreen" /> 
<GradientStop Offset="0.4" Color="Green" /> 
<GradientStop Offset="1" Color="DarkGreen" /> 
</LinearGradientBrush> 
</Button.Background> 
</Button> 


39.9.3 |ImageBrush 


要 把 图 像 加 载 到 画笔 中 ， 可 以 使 用 ImageBrush 元 素 。 通 过 这 个 元 素 ， 显 示 ImageSource 属性 定义 的 图 像 。 
图 像 可 以 在 文件 系统 中 访问 ， 或 从 程序 集 的 资源 中 访问 。 在 代码 示例 中 ， 添 加 文件 系统 中 的 图 像 ( 代 码 文件 
Brushes/MainPage.xaml): 
<Button Content="Image Brush™" FontWeight="ExtraBold"™" 
FoNntS1ze="28"™ 
RenderTransformorigin="0.5,0.5™" > 
<Button.Background> 
<ImageBrush ImageSource="msbuild.png" Opacity="0.5" /> 
</Button.Background> 
</Button> 


运行 应 用 程序 时 ， 可 以 看 到 如 图 35-9 所 示 的 按钮 。 
39.9.4 AcrylicBrush 


Windows 10 构建 版 16299 的 一 个 新 画笔 是 ActylicBrush 。 这 种 画笔 是 新 Fluent Design 的 一 部 分 。 
AcirylicBrush 提供 了 透明 效果 ， 让 应 用 或 主机 的 其 他 元 素 通 过 该 画笔 显示 出 来 。 

发布 为 Windows 10 一 部 分 的 一 个 应 用 程序 是 Calculator。 这 个 计算 器 有 一 些 透 明度 ， 可 以 让 其 他 应 用 程序 
或 壁纸 图 像 在 应 用 程序 中 显示 出 来 (参见 图 3$S-10)。 这 种 效果 并 不 适用 于 计算 器 中 的 主 数字 按钮 ， 但 是 计算 器 的 
其 他 元 素 可 以 让 背景 光线 透 出 来 。 


三 tandard 


图 35-10 


给 按钮 的 Background 属性 分 配 了 AcrylicBrush。TintOpacity 的 值 取 自 滑 块 的 值 。 这 样 ， 移 动 应 用 程序 中 的 
滑 块 时 ， 就 可 以 根据 不 透明 度 来 得 看 画笔 的 不 同 效果 。TintColor 属性 指定 笔 刷 的 主 色 。 

使 用 BackgroundSource 属性 ， 可 以 在 HostBackdrop 或 Backdrop 之 间 进 行 选择 。 使 用 Backdrop 时 ， 应 用 程 
序 本 身 的 颜色 就 会 透 出 来 。 这 就 是 所 谓 的 in-app acrylic。 控 件 中 使 用 该 画笔 覆盖 的 元 素 会 显示 出 来 。 而 使 用 
HostBackdrop 时 ， 会 选取 应 用 程序 下 面 的 颜色 ， 这 就 是 background acrylic。 由 于 acrylic 的 UI 效果 需要 GPU 的 
功能 ， 因 此 这 一 特性 可 以 缩短 电池 寿命 。 当 系统 的 功 耗 较 低 时 ，AcrylicBrmsh 使 用 由 FallbackColor 属性 定义 的 
纯色 。 还 可 以 配置 属性 AlwaysUseFallback 以 始终 使 用 FallbackColor。 用 户 配 置 可 以 触发 此 设置 ， 以 提高 电池 寿 
命 (代码 文件 Brushes/MainPage.xam)): 


<Button Content="Acrylic Brush Host Backdrop"> 
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<Button.Background> 
<acTY1LICBIUSh Backgroundsource="HostBackdrop" 
TintColor="#FFFFOO000" 
TintOpacity="{Xx:Bind sliderl .Value, 
Mode=OneWay}™" 
FallbackColor="Orange™ /> 
</Button.Background> 
</Button> 


35-11 显示 了 当前 的 TintOpacity 设置 为 0.2 的 
AcrylicBrmsh。 顶 部 的 按钮 用 HostBackdrop 配置 。 这 里 可 
以 看 到 应 用 程序 下 面 的 背景 透 出 来 。 底 部 的 按钮 用 
Backdrop 配置 。 这 里 可 以 看 到 按钮 下 面 的 一 个 橙色 定形 透 
出 来 。 


注意 : 

何 时 使 用 acrylic 和 画笔? acrylic 给 应 用 程序 增加 了 纹理 
和 深度 。 应 用 程序 内 的 导航 和 命令 在 acrylic 背景 下 看 起 来 
令 人 印象 深刻 。 然 而 ， 应 用 程序 的 主要 内 容 应 该 使 用 纯粹 
的 背 未 。 
35.5.5 RevealBrush 

Windows 10 构建 版 16299 的 另 一 个 新 画笔 是 RevealBrush。 这 个 画笔 突出 显示 用 户 使 用 灯光 效果 移动 鼠标 
的 区 域 。 使 用 此 画笔 样式 化 按钮 的 一 种 简单 方法 是 使 用 ButtonRevealStyle， 如 下 面 的 代码 片段 所 示 ( 代 码 文 件 
Brushes/MainPage.Xam]): 


<Button Content="Button with Reveal Style™" Padadling="12"” Margin="12" 
Style=" {StaticResource ButtonRevealStyle}" /> 


图 35-11 


注意 : 
样式 和 StaticResource 标记 扩展 参见 下 一 节 。 


使 用 ButtonRevealStyle 时 ， 需 要 仔细 观察 应 用 程序 在 运行 时 的 效果 。 下 面 的 按钮 定义 了 一 个 较 厚 的 边框 ， 
该 边框 使 用 主题 资源 SystemColorControlHighlightAccentRevealBorderBrush 中 定义 的 BorderBrush， 以 帮助 更 清 
楚 地 看 到 效果 。 在 按钮 周围 移动 鼠标 时 ， 按 钮 的 边框 会 突出 显示 出 来 。 
<Button Margin="4™" BorderThickness="98" 
Background="{ThemeResource SystemControlHighlightAccentRevealBackgroundBrush}" 


BorderBrush=" {TIhemeResource SystemControlHighlightAccentRevealBorderBrush}"> 
With Reveal Border</Button> 


35.6 ”样式 和 资源 


设置 XAML 元 每 的 FontSize 和 Background 属性 ， 就 可 以 定义 XAML 元 素 的 外 观 ， 如 Button 元 每 所 示 ( 代 
码 文 件 StylesAndResources/MainPage.xaml): 

<Button Width="150" FontSize="12" BackgTOUnG="A1LiIceBlLUen Content="Click Me!™ /> 

除了 定义 每 个 元 素 的 外 观 之 外 , 还 可 以 定义 用 资源 存储 的 样式 。 为 了 完全 定制 控件 的 外 观 ， 可 以 使 用 模板 ， 
再 把 它们 存储 到 资源 中 。 


35.6.1 梓 式 


控件 的 Style 属性 可 以 赋予 附带 Setter 的 Style 元 素 。Setter 元 素 定 义 Property 和 Value 属性 ， 并 给 目标 元 素 
设置 指定 的 属性 和 值 。 下 例 设置 Backeround、FontSize、FontWeight 和 Margin 属性 。 把 Style 设置 为 TargetIype 
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Button， 以 便 直 接 访问 Button 的 属性 (代码 文件 StylesAndResources/MainPage.xaml)。 


<Button 而 LIQEh="150"” Content="Click Me 1 nm> 
<Button. Style> 
<Style TargetType="Button"»> 
<Setter Property="Background" Value="Yellow" /> 
<Setter Property="FontSsize™" Value="14" /> 
<Setter Property="FontWeight" Value="Bold" /> 
<Setter Property="Margin™" Value="5" /> 
</Style> 
</Button.Style> 
</Button> 


直接 通过 Button 元 素 设置 Style 对 样式 的 共享 没有 什么 帮助 。 样 式 可 以 放 在 资源 中 。 在 资源 中 ， 可 以 把 样 
式 赋 予 指定 的 元 素 ， 把 一 个 样式 赋予 某 一 类 型 的 所 有 元 素 ， 或 者 为 该 样式 使 用 一 个 键 。 要 把 样式 赋予 菜 一 类 型 
的 所 有 元 素 , 可 使 用 Style 的 TargetType 属性 , 将 样式 赋予 一 个 按钮 。 要 定义 需要 引用 的 样式 ,必须 设置 x:Key: 


<Pagqe.Resources»> 
<Style TargetType="Button™"> 
<Setter Property="Background"™" Value="LemonChiffon™ /> 
<Setter Property="FontSize" Value="18" /> 
<Setter Property="Margin" Value="5" /> 
</Style> 
<Style x:Key="ButtonStylel" TargetType="Button"> 
<Setter Property="Background"™" Value="Red™ /> 
<Setter Property="Foreground™" Value="White"™ /> 
<Setter Property="FontSize" Value="18" /> 
<Setter Property="Margin™" Yalue="5"™" /> 
</Style> 
</Page.Resources> 


在 样 例 应 用 程序 中 ， 在 页 面 内 全 局 定义 的 样式 在 Page 元 紊 的 Resources 属性 中 指定 。 

在 下 和 面 的 XAML 代码 中 ， 第 一 个 按钮 没有 用 元 素 属 性 定义 样式 ， 而 是 使 用 为 Button 类 型 定义 的 样式 。 对 
于 下 一 个 按钮 ， 把 Style 属性 用 StaticResource 标记 扩展 设置 为 {StaticResource ButtonStyle}， 而 ButtonStyle 指定 
了 前 面 定义 的 样式 资源 的 键 值 ， 所 以 该 按钮 的 背景 为 红色 ， 前 景 是 日 色 。 


<Button Width="200" Content="Default Button style”" Margin="3" /> 
<Button Width="200™ Content="Named style"™" 
Style="{StaticResource ButtonStylel}" Margin="3" /> 


除了 把 按钮 的 Backeround 设置 为 单个 值 之 外 ， 还 可 以 将 Backsground 属性 设置 为 定义 了 渐变 色 的 
LinearGradientBrush， 如 下 所 示 : 


<Style KX: Key="FancyButtonstyle™”" TargetType="Button™> 
<Setter Property="FontSize" Value="22" /> 
<Setter Property="Foreground™" Value="White"™" /> 
<Setter Property="Margin™" Value="5" /> 
<Setter Property="Background™"> 
<Setter.Value> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0.0" Color="LightCyan™ /> 
<Gradientstop Offset="0.14" Color="Cyan™ /> 
<Gradientstop Offset="0.7" Color="DarkCyan™ /> 
</LinearGradientBrush> 
</Setter.Value> 
</Setter> 
</Style> 


本 例 中 下 一 个 按钮 的 样式 采用 青色 的 线性 渐变 效果 : 


<Button Width="200™ Content="Fancy button style"™ 
Style="{StaticResource FancyButtonStyle}" Margin="3" /> 


样式 提供 了 一 种 继承 方式 。 一 个 样式 可 以 基于 男 一 个 样式 。 下 面 的 AnotherButtonStyle 样式 基于 
FancyButtonStyle 样式 。 它 使 用 该 样式 定义 的 所 有 设置 ， 且 通过 BasedOn 属性 引用 ， 但 Foreground 属性 除外 ， 
它 设置 为 LinearGradientBrush: 
<Style x:Key="AnotherButtonstyle" Basedon="{StatijcResource FancyBUttoOnStY1Lel 
TargetType="Button™"™> 
<Setter Property="Foreground™"> 


Setter.Value> 
<LinearGradientBrush> 
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<GradientStop Oftfset="0-2"” Color="White"™" /> 
<Gradientstop Offset="0.5" Color="LightYellow" /> 
<Gradientstop Offset="0.9" Color="Orange"™ /> 


</LinearGradientBrush> 
</Setter.Value> ie 
</Setter> Default Button style 


</Style> 
Named style 


最 后 一 个 按钮 应 用 了 AnotherButtonStyle: 


<Button Width="200™" Content="Style inheritance"™" 
Style="{StaticResource AnotherButtonstyle}" Margin="3" /> Style inherit: 


图 35-12 显示 了 所 有 这 些 按钮 样式 化 后 的 效果 。 图 35-12 


35.6.2 资源 


从 样式 示例 可 以 看 出 ， 样 式 通常 存储 在 资源 中 。 可 以 在 资源 中 定义 任意 可 共享 的 元 素 。 例 如 ， 前 面 为 按钮 
的 背景 样式 创建 了 画笔 ， 它 本 上身 就 可 以 定义 为 一 个 资源 ， 这 样 就 可 以 在 需要 画笔 的 地 方 使 用 它 。 

下 面 的 示例 在 StackPanel 资源 中 定义 一 个 LinearGradientBrush, 它 的 键 名 是 MyGradientBrush。buttonl 使 用 
StaticResource 标记 扩展 将 Background 属性 赋予 MyGradientBrush 资源 (代码 文件 StylesAndResources/Resource DemoPage 
.Xaml): 

<StackPanel x:Name="myContalner™"> 

<StackPanel] .Resources> 


<LinearGradientBrush x:Key="MyGradientBrush™" StartPoint="0,0" 
EnNndPoint="0.3,1"> 


<Gradientstop Offset="0.0" Color="LightCyan™ /> 
<Gradientstop Offset="0.14"™ Color="Cyan™ /> 
<Gradientstop Offset="0.7" Color="DarkCyan™ /> 
</LinearGradientBrush> 
</StackPanel .Resources> 
<Button Width="200™ Height="50" Foreground="White™" Margin="5" 
Background="{StaticResource MyGradientBrush}" Content="Click Me!™ /> 
</StackPanel> 


这 里 , 资源 用 StackPanel 定义 ,在 上 面 的 例子 中 , 资源 用 Page 或 Window 元 素 定义 。 基 类 FrameworkElement 
定义 ResourceDictionary 类 型 的 Resources 属性 。 这 就 是 资源 可 以 用 派生 自 FrameworkElement 的 所 有 类 (任意 
XAML 元 素 ) 来 定义 的 原因 。 

资源 按 层 次 结构 来 搜索 。 如 果 用 根 元 素 定义 资源 ， 它 就 会 应 用 于 所 有 子 元 素 。 如 果 根 元 系 包 含 一 个 Grid， 
该 Grid 包含 一 个 StackPanel， 且 资源 是 用 StackPanel 定义 的 ， 该 资源 就 会 应 用 于 StackPanel 中 的 所 有 控件 。 如 
果 StackPanel 包含 一 个 按钮 ， 但 只 用 该 按钮 定义 资源 ， 这 个 样式 就 只 对 该 按钮 有 效 。 


注意 : 

对 于 层次 结构 ， 需 要 注意 是 否 为 样式 使 用 了 没有 Key 的 TargetType。 如 果 用 Canvas 元 素 定义 一 个 资源 ， 
并 把 样式 的 TargetType 设置 为 应 用 于 TextBox 元 素 ， 该 样式 就 会 应 用 于 Canvas 中 的 所 有 TextBox 元 素 。 如 果 
Canvas 中 有 一 个 ListBox， 该 样式 甚至 会 应 用 于 ListBox 包含 的 TextBox 元 素 。 


如 果 需 要 将 同一 个 样式 应 用 于 多 个 窗口 ， 就 可 以 用 应 用 程序 定义 样式 。 在 用 Visual Studio 创建 的 Windows 
应 用 程序 中 , 创建 App.xaml 文件 , 以 定义 应 用 程序 的 全 局 资源 。 应 用 程序 样式 对 其 中 的 每 个 页 面 或 窗口 都 有 效 。 
每 个 元 素 都 可 以 访问 用 应 用 程序 定义 的 资源 。 如 果 通 过 父 窗口 找 不 到 资源 ， 就 可 以 通过 Application 继续 搜索 资 
源 (代码 文件 StylesAndResourcesUWP/App.xaml): 


<Application XxX:Class="StyleshAndResources.App" 
xmlns="http://schemas .microsoft.com/winfx/2006/xaml/presentation™ 
xmlns:x="http://schemas .microsoft.com/winfx/2006/xaml" 
RequestedTheme="Light"»> 
<Application.Resources> 
</Application.Resources> 

</Application> 
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35.6.3 ”从 代码 中 访问 资源 


要 从 代码 隐藏 中 访问 资源 ， 基 类 FrameworkElement 的 Resources 属性 返回 ResourceDictionary。 该 字典 使 用 
索引 器 和 资源 名 称 提供 对 资源 的 访问 。 可 以 使 用 ContainsKey 方法 检查 资源 是 否 可 用 。 

下 面 看 一 个 例子 。 按 钮 控件 buttonl 没有 指定 背景 ， 但 将 Click 事件 动态 赋予 OnApplyResource() 方 法 ， 以 动 
态 修 改 它 (代码 文件 StylesAndResources/ResourceDemoPage.xaml): 


<Button Name="buttonil™ Width="220"™ Height="50"™" Margin="5" 
Click="OnApplyResources" Content="Apply Resource Programmatically™" /> 


使 用 WPF 时 ， 使 用 TryFindResource 方法 来 欠 代 所 有 资源 。 使 用 UWP 时 ， 可 以 使 用 类 似 的 方法 ， 但 是 需 
要 上 自己 实现 它 。OnApplyResources 方法 调用 扩展 方法 TryFindResource 来 查找 名 为 MyGradientBrush 的 资源 ， 并 
将 其 分 配给 控件 的 Background 属性 (代码 文件 StylesAndResources/ResourceDemo.xaml.cs): 


private void OnApplyResources (object sender, RoutedEventArgs e) 
if (sender is Control ctrl) 

Ctrl .Background = etrl.TryFindResource("MyGradientBrush") as Brush; 
ee 


方法 TryFindResource 使 用 ContainsKey 检查 请 求 的 资源 是 否 可 用 ， 它 会 递归 地 调用 方法 ， 以 人 免 资 源 还 没有 
找到 (代码 文件 StylesAndResources/FrameworkElementExtensions.cs);: 


Public static class FrameworkElementExtensions 
{ 
Public static object TryFindResource (this FrameworkElement e, string key) 
{ 
if (ee == null) throw new ArgumentNullException (nameof (e)); 
if (key == null) throw new ArgumentNullException (nameof (key)); 


if (le.Resources.ContainsKRey (Key)) 
{ 
return e.Resources [keyvl]; 
} 
else if (le.Parent is FrameworkElement parent) 
{ 
return TryFindResource (parent, KeYy) ; 
} 
else 
{ 
return null:; 
} 
} 
} 


35.6.4 ”资源 字典 


如 果 相 同 的 资源 可 用 于 不 同 的 页 面 甚至 不 同 的 应 用 程序 ， 把 资源 放 在 一 个 资源 字典 中 就 比较 有 效 。 使 用 资 
源 字典 ， 可 以 在 多 个 应 用 程序 之 间 共 享 文件 ， 也 可 以 把 资源 字典 放 在 一 个 程序 集中 ， 供 应 用 程序 共享 。 

要 共享 程序 集中 的 资源 字典 ， 应 创建 一 个 库 。 可 以 把 资源 字典 文件 (这 里 是 Dictionary1.xXaml) 添 加 到 程序 
集中 。 

Dictionary1l.xaml 定义 了 两 个 资源 : 一 个 是 包含 CyanGradientBrush 键 的 LinearGradientBrush, 男 一 个 是 用 于 
按钮 的 样式 ， 它 可 以 通过 PinkButtonStyle 键 来 引用 (代码 文件 ResourcesLib/Dictionary1.xam)): 


<ResourceDictionary 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml /presentation™ 
xmlns:x="http://schemas .microsoft.com/winfx/2006/xaml"> 
<LinearGradientBrush x:Key="CyanGradientBrush™" StartPoint="0,0" 
EndPoint="0.3,1"> 
<LinearGradientBrush.Gradientstops> 
<Gradientstop Offset="0.0"™ Color="LightCyan™" /> 
<Gradientstop Offset="0.14" Color="Cyan™ /> 
<Gradientstop Offset="0.7"™ Color="DarkCyan"™ /> 
</LinearGradientBrush.Gradientstops> 
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</LinearGradientBrush> 


<Style XxX:Key="PinkButtonstyle™" TargetType="Button"> 
<Setter Property="FontSize™" Value="22"™ /> 
<Setter Property="Foreground"™" Value="White"™ /> 
<Setter Property="Background™"> 
<Setter .Value> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<LinearGradientBrush.GradientSstops> 
<Gradientstop Offset="0.0"™ Color="Pink"™" /> 
<Gradientstop Offset="0.3" Color="DeepPink" /> 
<Gradientstop Offset="0.9" Color="DarkOrchid"™ /> 
</LinearGradientBrush.Gradientstops> 
</LinearGradientBrush> 
</Setter.Value> 
</Setter> 
</Style> 
</ResourceDictionary> 


对 于 目标 项 目 ， 需 要 引用 这 个 库 ， 并 把 资源 字典 添加 到 这 个 字典 中 。 通 过 ResourceDictionary 的 
MergedDictionaries 属性 ， 可 以 使 用 添加 进来 的 多 个 资源 字典 文件 。 可 以 把 一 个 资源 字典 列表 添加 到 合并 的 字典 
中 。 对 于 UWP 应 用 程序 ， 引 用 的 资源 字典 必须 以 ms-appx:// 模 式 作 为 前 组 (代码 文件 StylesAndResources/ 
App.xaml): 


<Application x:Class="StyleshAndResources .App" 
xmlns="http://schemas .microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml™" 
xmlns:local="uUusing:StylesAndResources"™" 
RequestedTheme="L1ight"> 
<ApPplication.Resources> 
<ResourceDictionary> 
<ResourceDictionary.MergedDictionaries> 
<ResourceDictionary 
Source="ms-appx:///ResourcesLibUWP/Dictionaryl .xaml" /> 
</ResourceDictionary.MergedDictionaries> 
</ResourceDictionary> 
</Application.Resources> 
</Application> 


现在 可 以 像 本 地 资源 那样 使 用 引用 程序 集中 的 资源 了 (代码 文件 StylesAndResources/ResourceDemoPage.xam]): 


<Button Width="300™" Height="50™" Style="{StaticResource PinkButtonStyle}" 
Content="Referenced Resource™ /> 


35.6.5 ”主题 资源 


WPF 支持 DynamicResource 标记 扩展 ， 在 应 用 程序 运行 时 ， 如 果 资 源 发 生变 化 ， 它 会 动态 更 新 用 户 界面 。 
尽管 UWP 应 用 程序 不 支持 DynamicResource 标记 扩展 ， 但 这 些 应 用 程序 也 能 动态 改变 样式 。 这 个 功能 是 基于 
主题 的 。 通 过 主题 ， 可 以 允许 用 户 在 光明 与 黑暗 主题 之 间 切 换 (类 似 于 可 以 用 Visual Studio 改变 的 主题 )。 


1. 定义 主题 资源 


主题 资源 可 以 在 ThemeDictionaries 集合 的 资源 字典 中 定义 。 在 ThemeDictionaries 集合 中 定义 的 
ResourceDictionary 对 象 需要 分 配 一 个 包含 主题 名 称 (Light 或 Datk) 的 键 。 示 例 代 码 为 浅 色 背景 和 暗色 前 景 的 
Light 主题 定义 了 一 个 按钮 ， 为 浅 色 前 景 和 暗色 背景 的 dark 主题 定义 了 一 个 按钮 。 用 于 样式 的 键 在 这 两 个 字 — 典 
中 是 一 样 的 ，SampleButtonStyle( 代 码 文 件 StylesAndResources/Styles/SampleThemes .xaml): 


<ResourceDictionary 
xmlns="http://schemas .microsoft.com/winfx/2006/xaml/presentation"™ 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml™" 
xmlns:local="using:StyleshAndResourcesUWP"> 
<ResourceDictionary.ThemeDictionaries> 
<ResourceDictionary XxX:Kevy="Light"» 
<Style TargetType="Button™” XxX:Eey="SampleButtonstyle™"> 
<Setter Property="Background™" Value="LightGray™ /> 
<Setter Property="Foreground™" Value="Black"™" /> 
</Sstyle> 
</ResourceDictionary> 


954 | 第 部 分 应 用 程序 


<ResourceDictionary XxX:Key="Dark"> 
<Style TargetType="Button™” x:KEevy—="SampleButtonstyle™"> 
<Setter Property="Background"™" Value="Black" /> 
<Setter Property="Foreground™" Value="White™ /> 
</Sstyle> 
</ResourceDictionary> 
</ResourceDictionary .ThemeDictionaries> 
</ResourceDictionary> 


使 用 ThemeResource 标记 扩展 可 以 指定 样式 。 除 了 使 用 另 一 个 标记 扩展 之 外 ， 其 他 的 都 与 StaticResource 
标记 扩展 相同 (代码 文件 StylesAndResourcesUWP/ThemeDemoPage.xaml): 


<Button Style="{ThemeResource SampleButtonstyle}™" Click="OnChangeTheme™ 
Content="Change Theme™" /> 


根据 选择 的 主题 ， 使 用 相应 的 样式 。 
2. 选择 主题 


有 不 同 的 方式 选择 主题 。 首 先 ， 应 用 程序 本 映 有 一 个 默认 的 主题 。Application 类 的 RequestedTheme 属 性 定 
义 了 应 用 程序 的 默认 主题 。 这 在 App.xaml 内 定义 ， 在 其 中 还 引用 了 主题 字典 文件 (代码 文件 StylesAndResources/ 
App.xaml): 


<Application 
XX:Class="StyleshndResourcesUWP .App" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml /presentation™ 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml™" 
xmlns:local="using:StylesAndResourcesUWP" 
RequestedTIheme="Light"»> 
<Application.Resources> 
<ResourceDictionary> 
<ResourceDictionary.MergedDictionaries> 
<ResourceDictionary Source="ms-appx:///stylesLib/Dictionaryl.xaml™ /> 
<ResourceDictionary Source="Styles/SampleThemes .xaml" /> 
</ResourceDictionary.MergedDictionaries»> 
</ResourceDictionary> 
</Application.Resources> 
</Application> 


RequestedTheme 属性 在 XAML 元 素 的 层次 结构 中 定义 。 每 个 元 素 可 以 覆盖 用 于 它 本 身 及 其 子 元 素 的 主题 。 
下 面 的 Grid 元 素 改 变 了 Dark 主题 的 默认 主题 。 现 在 它 用 于 Grid 元 素 及 其 所 有 子 元 素 ( 代 码 文件 
StylesAndResources/ThemeDemoPage.xaml): 

<GIrid KX:Name="gridl"™" 

Background="{ThemeResource ApplicationPageBackgroundThemeBrush}" 
RedquestedIheme="Dark"> 
<Button Style="{ThemeResource SampleButtonStyle}™" Click="OnChangeTheme"™ 


Content="Change Theme™" /> 
</Grid> 


也 可 以 在 代码 中 通过 设置 RequestedTheme 属性 来 动态 更 改 主题 (代码 文件 StylesAndResources/ 
ThemeDemoPage.xaml.cs): 


private void OnChangeTheme (object sender, RoutedEventArgs e) 

{ 
gridl .RecqmuestedTheme = gridl .RequestedTheme == ElementTheme .Dark ? 
ElementIheme .Light: ElementTiheme .Dark.:; 

} 


注意 : 
只 有 资源 看 起 来 与 主题 不 同 ， 使 用 ThemeResource 标记 扩展 才 有 用 。 如 果 资 源 应 该 与 主题 相同 ， 就 应 继续 
使 用 StaticResource 标记 扩展 。 


35.7 ”模板 


XAMI Button 控件 可 以 包含 任何 内 容 ， 如 简单 的 文本 ， 还 可 以 给 按钮 添加 Canvas 元 素 ，Canvas 元 素 可 以 


第 35 章 样式 化 Windows 应 用 程序 | 955 


包含 形状 ， 也 可 以 给 按钮 添加 Grid 或 视频 。 然 而 ， 按 钮 还 可 以 完成 更 多 的 操作 。 使 用 基于 模板 的 XAML 控件 ， 
控件 的 外 观 及 其 功能 在 WPF 中 是 完全 分 离 的 。 虽 然 按钮 有 默认 的 外 观 ， 但 可 以 用 模板 完全 定制 其 外 观 。 
如 表 35-2 所 示 ，Windows 应 用 程序 提供 了 几 个 模板 类 型 ， 它 们 派生 目 基 类 FrameworkTemplate。 


表 35-2 
模板 类 型 说 有明 
ControlTemplate 使 用 ControlTemplate 可 以 指定 控件 的 可 视 化 结构 ， 重 新 设计 其 外 观 
ItemsPanelTemplate 对 于 ItemsControl， 可 以 赋予 一 个 IemsPanelTemplate， 以 指定 其 项 的 布局 。 每 个 ItemsControl 都 有 一 
个 默认 的 ItemsPanelTemplate。MenuItem 使 用 WrapPanel，StatusBar 使 用 DockPanel，ListBox 使 用 
VirtuallzineStackPanel 
DataTemplate DataTemplate 非 常 适用 于 对 象 的 图 形 表示 。 给 列表 框 指定 样式 时 ， 默 认 情 况 下 ， 列 表 框 中 的 项 根据 


ToString0 方 法 的 输出 来 显示 。 应 用 DataTemplate， 可 以 重 写 其 操作 ， 定 义 项 的 自 定义 表示 


35.7.1 控件 模板 


本 章 前 面 介 绍 了 如 何 给 控件 的 属性 定义 样式 。 如 果 设 置 控件 的 简单 属性 得 不 到 需要 的 外 观 ， 就 可 以 修改 
Template 属性 。 使 用 Template 属性 可 以 定制 控件 的 整体 外 观 。 下 面 的 例子 说 明了 定制 按钮 的 过 程 ， 后 面 逐 步 地 
说 明了 列表 框 的 定制 ， 以 便 显 示 出 改变 的 中 间 结 果 。 

Button 类 型 的 定制 在 一 个 单独 的 资源 字典 文件 ControlTemplates.xaml 中 进行 。 这 里 定义 了 键 名 为 
RoundedGelButton 的 样式 。RoundedGelButton 样式 设置 Backeround、Height、Foreeround、Marein 和 Template 
属性 。Template 属性 是 这 个 样式 中 最 有 趣 的 部 分 ， 它 指定 一 个 仅 包 含 一 行 一 列 的 网 格 。 

在 这 个 单元 格 中 ， 有 一 个 名 为 GelBackground 的 椭圆 。 这 个 椭圆 给 笔触 设置 了 一 个 线性 渐变 画笔 。 包 围 矩 
形 的 笔触 非常 细 ， 因 为 把 SttokeThickness 设置 为 0.5。 

因为 第 二 个 椭圆 GelShine 比较 小 ， 其 尺寸 由 Margin 属性 定义 ， 所 以 在 第 一 个 椭圆 内 部 是 可 见 的 。 因 为 其 
笔触 是 透明 的 ， 所 以 该 椭圆 没有 边框 。 这 个 椭圆 使 用 一 个 线性 渐变 填充 画笔 从 部 分 透明 的 浅 色 变 为 完全 透明 ， 
这 使 椭圆 具有 “ 亦 真 亦 幻 ”的 效果 (代码 文件 Templates/Styles/ControlTemplates.xaml): 


<ResourceDictionary 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"™ 
xmlns:x="http://schemas .microsoft.com/winfx/2006/xaml"> 


<Style X:KEey="RoundedcelButton™" TargetType="Button"> 
<Setter Property="Width" Value="100" /> 
<Setter Property="Height" Value="100" /> 
<Setter Property="Foreground™ Value="White"™ /> 
<Setter Property="Template™> 
<Setter .Value> 
<ControlTemplate TargetlIype="Button"> 
<GIrid> 
<Ellipse Name="GelBackground™" StrokeThickness="0.5" Fil1l="Black"> 
<Ellipse.Stroke> 
<LinearGradientBrush StartPoint="0,0" EndPoint="0,1"»> 
<Gradientstop Offset="0" Color="#ff7eTeTe™ /> 
<Gradientstop Offset="1" Color="Black"™" /> 
</LinearGradientBrush> 
</Ellipse.Stroke> 
</Ellipse> 
<Ellipse Margin="15,5,15,50"> 
<Ellipse.F1il1]l1> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0" Color="#aaffffff" /> 
<Gradientstop Offset="1" Color="Transparent"™" /> 
</LinearGradientBrush> 
</Ellipse.Fil]l> 
</Ellipse> 
</Grid> 
</ControlTemplate> 
</Setter.Value> 
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</Setter> 
</Style> 
</ResourceDictionary> 


从 app.xaml 文件 中 ， 引用 资源 字典 ， 如 下 所 示 ( 代 码 文 件 Template/App.xaml): 


<Application x:Class="TemplateDemo .App" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml /presentation™ 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml™" 
startupUri="MalinWindow. xaml™> 
<Application.Resources> 

<ResourceDictionary Source="Styles/ControlTemplates.xaml" /> 

</Application.Resources 

</Application> 


现在 可 以 把 Button 控件 关联 到 样式 上 。 按 钮 的 新 外 观 如 图 35-13 所 示 ， 并 使 用 代码 文 

件 Templates /StyledButtons.xaml。 
<Button Style="{StaticResource RoundedGelButton}™" Content="Click Me!™ /> 3513 

按钮 现在 的 外 观 完全 不 同 ， 但 按钮 的 内 容 未 在 图 35-13 中 显示 出 来 。 必 须 扩展 前 面 创建 
的 模板 ， 以 把 按钮 的 内 容 显示 在 新 外 观 上 。 为 此 需要 添加 一 个 ContentPresenter 。 
ContentPresenter 是 控件 内 容 的 占 位 从 ,并 定义 了 放置 这 些 内 容 的 位 置 。 这 里 把 内 容 放 在 网 格 ~ 
的 第 一 行 上 , 即 Ellipse 元 素 所 在 的 位 置 。 ContentPresenter 的 Content 属性 定义 了 内 容 的 外 观 。 Click Mel 
把 内 容 设 置 为 TemplateBinding 标记 表达 式 。TemplateBinding 绑 定 父 模板 ， 这 里 是 Button 元 
素 。{TemplateBinding Content} 指定 ，Button 控件 的 Content 属性 值 应 作为 内 容 放 在 占 位 符 内 。 图 35-14 
图 35-14 显示 了 和 融 内 容 的 按钮 (代码 文件 Templates/Styles/ControlTemplates.xaml): 


<Setter Property="Template™> 
<Setter.Value> 
<ControlTemplate TargetType="Button™"> 
<GIlid> 
<Ellipse Name="GelBackground™" strokeThickness="0.5" Fill="Black"> 
<Ellipse.Stroke> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0" Color="#ff7ie7TeTe™" /> 
<Gradientstop Offset="1" Color="Black"™" /> 
</LinearGradientBrush> 
</Ellipse.SsStroke> 
</Ellipse> 
<Ellipse Margin~="15,5,15,50"> 
<Ellipse.Fil]1l> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0" Color="#aaffffff" /> 
<Gradientstop Offset="1" Color="Transparent™ /> 
</LinearGradientBrush> 
</Ellipse.Fill> 
</Ellipse> 
<ContentPresenter Mame="GelButtonContent"™" 
VerticalAlignment="Center" 
HorizontalAlignment="Center" 
Content=" {TemplateBinding Content}" /> 
</Grid> 
</ControlTemplate> 
</Setter.Value> 


注意 ， 
TemplateBinding 允许 与 模板 交流 控件 定义 的 值 。 这 不 仅 可 以 用 于 内 容 ， 还 可 以 用 于 颜色 和 笔触 样式 等 。 


现在 这 样 一 个 样式 化 的 按钮 在 屏幕 上 看 起 来 很 漂亮 。 但 仍 有 一 个 问题 : 如 果 用 鼠标 单 击 该 按钮 ， 或 使 鼠标 
请 过 该 按钮 ， 则 它 不 会 有 任何 动作 。 这 个 是 用 户 操作 按钮 时 的 一 般 情 况 。 解 决 方法 如 下 : 对 于 模板 样式 的 按钮， 
必须 给 它 指定 可 视 化 状态 或 触 上 用 器 ， 使 按钮 在 啊 应 鼠标 移动 和 鼠标 单 击 时 有 不 同 的 外 观 。 可 视 化 状态 也 利用 动 
画 ， 因 此 本 章 后 面 讨论 这 个 变更 。 

然而 ， 为 了 提前 了 解 这 一 点 ， 可 以 使 用 Visual Studio 创建 一 个 按钮 模板 。 不 是 完全 从 头 开始 建立 这 样 一 个 
模板 , 而 可 以 在 XAML 设计 器 或 文档 浏览 器 中 选择 一 个 按钮 控件 , 从 上 下 文 菜 单 中 选择 Edit Template。 在 这 里 ， 
可 以 创建 一 个 空 的 模板 ， 或 复制 预定 义 的 模板 。 使 用 模板 的 一 个 副本 来 查看 预定 义 的 模板 。 创 建 一 个 样式 资源 
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的 对 话 框 参见 图 35-15。 在 这 里 可 以 定义 包含 模板 的 资源 是 在 文档 、 应 用 程序 (用 于 多 个 页 面 和 窗口 ) 还 是 资源 字 
典 中 创建 。 对 于 之 前 样式 化 的 按钮 ， 资 源 字典 ControlTemplates.xaml 已 经 存在 ， 示 例 代码 在 该 字典 中 创建 资源 。 


Create ControlTemplate Resource 


Name (Key) 


La Buttonstyle1 | 


) Apply to all 


Define in 
) Application 
This docurment 


®@) Resource dictionary ControlTemplates.xaml 


图 35-15 


以 下 代码 片段 显示 了 Windows 应 用 程序 中 默认 按钮 模板 的 一 些 特殊 之 处 。 几 个 按钮 设置 取 目 主题 资源 ， 如 
Background 、Foreground 和 BorderBrmush。 它 们 在 光明 和 黑暗 主题 中 是 不 同 的 。 一 些 值 ， 如 Padding 和 
HorizontalAlignment 是 固定 的 。 创 建 一 个 目 定 义 样 式 ， 就 可 以 改变 这 些 ( 代 码 文件 Templates/Styles/ 
ControlIemplates.Xaml): 


<Style x:Eey="Buttonstylel™”" TargetType="Button™> 
<Setter Property="Background" Value="{ThemeResource ButtonBackground}"/> 
<Setter Property="Foreground"™" Value="{ThemeResource ButtonForeground}"/> 
<Setter Property="BorderBrush" Value="{ThemeResource ButtonBorderBrush}"/> 
<Setter Property="BorderThickness"™" 
Value="{ThemeResource ButtonBorderThemeThickness}"/> 
<Setter Property="Padding™" Value="8,4,8,4"/> 
<Setter Property="HorizontalAligqgnment™" Value="Left"/> 
<Setter Property="VerticalAlignment" Value="Center"/> 
<Setter Property="FontFamily" 
Value="{ThemeResource ContentControlThemeFontFamily}"/> 
<Setter Property="FontWeight" Value="Normal"/> 
<Setter Property="FontS1ize" 
Value="{ThemeResource ControlContentThemeFontSsize}"/> 
<Setter Property="UseSystemFocusVisuals" Value="True"/> 
<Setter Property="FocusVisualMargin™" Value="—3"/> 


控件 模板 由 一 个 Grid 网 格 和 一 个 ContentPresenter 组 成 ， 男 笔 和 边界 值 使 用 TemplateBinding 限定 。 这 样 就 
可 以 用 按钮 控件 直接 定义 这 些 值 ， 来 影响 外 观 。 


<Setter Property="Template"™> 
<3Setter .Value> 
<ControlTemplate TargetType="Button™> 
<Grid x:Name="RootGrid™" Background="{TemplateBinding Background}"> 
<I—Visual State Manager settings removed-—> 
<ContentPresenter xk:Name="ContentPresenter™ 
AutomationProperties.AccessibilityView="Raw" 
BorderBrush="{TemplateBinding BorderBrush}" 
BorderThickness="{TIemplateBinding BorderIhickness}" 
ContentTemplate=" {ITemplateBinding ContentTemplate}™" 
ContentTransitions=" {TemplateBinding ContentTransitions}" 
Content=" {TemplateBinding Content}" 
HorizontalContentAlignment= 
"{TemplateBinding HorizontalContentAlignment}" 
Padding=" {TemplateBinding Padding}" 
VerticalContentAlignment= 
"{TemplateBinding VerticalContentAlignment}"/> 
</Grid> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 


对 于 动态 更 改 按 钮 ， 如 果 鼠 标 划 过 按钮 ， 或 按钮 被 按 下 ， 应 用 程序 的 按钮 模板 就 会 利用 VisualStateManager。 
在 这 里 ， 按 钮 的 状态 改 为 PointerOver、Pressed 和 Disabled 时 ， 就 定义 关键 帧 动画 。 


<VisualStateManacger .VisualSstateGroups> 
<VlisualSstateGroup x:Name="Commonstates"> 
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<VisualSstate x:Name="Normal"> 
<Storyboard> 
<PointerUpThemeAnimation Storyboard.TargetName="RootGrid"/> 
</Sstoryboard> 
</Visualstate> 
<VisualSstate x:Name="PointerOver"> 
<Storyboard> 
<ObjectAnimationUsingKeyFrames 
Storyboard.TargetProperty="BorderBrush™ 
storyboard.TargetName="ContentPresenter™"> 
<DiscreteObjectKeyFrame KeyTime="0" 
Value="{ThemeResource SystemCcontrolHighlightBaseMediumLowBrush}"/> 
</ObpjectAnimationUsingKeyFrames> 
<ObjectAnimationUsingRKeyFrames 
storyboard.TargetProperty="Foreground™ 
storyboard.TargetName="ContentPresenter™> 
<DliscreteobjectKeyFrame KeyTime="0" 
Value="{ThemeResource SystemControlHighlightBaseHighBrush}"/> 
</ObjectAnimationUsingKeyFrames> 
</Storyboard> 
</Visualstate> 
<VisualSstate Xx:Name="Pressed"> 
<Storyboard> 
<!Il-animations removed—> 
</storyboard> 
</Visualstate> 
<VisualSstate x:Name="Disabled"> 
<Storyboard> 
<!I-animations removed-—> 
</Storyboard> 
</Visualstate> 
</VisualSstateGroup> 
</VisualSstateManager.VisualstateGroups> 


35.7.2 ”数据 模板 


ContentControl 元 素 的 内 容 可 以 是 任意 内 容 一 一 不 仅 可 以 是 XAML 元 素 ， 还 可 以 是 NET 对 象 。 例 如 ， 可 以 
把 Country 类 型 的 对 象 赋 予 Button 类 的 内 容 。 下 面 的 示例 创建 Country 类 ， 以 表示 国家 名 称 和 国旗 (用 一 幅 图 像 
的 路 径 表 示 )。 这 个 类 定义 Name 和 ImagePath 属性 ， 并 重 写 ToString0 方 法 ， 用 于 默认 的 字符 串 表示 (代码 文件 
Models/Country.cs): 


Public class Country 

{ 
Public string Name { get; set; } 
Public string ImagePath 1{ get; set; } 
public override string ToString{(} => Name; 


} 

这 些 内 容 在 按钮 或 任何 其 他 ContentControl 中 会 如 何 显示 ?默认 情况 下 会 调用 ToString0 方 法 ， 显 示 对 象 的 
字符 串 表 示 。 

要 获得 自 定 义 外 观 ， 还 可 以 为 Country 类 型 创建 一 个 DataTemplate。 示 例 代 码 定义 了 CountryDataTemplate 
键 ， 这 个 键 可 以 用 于 引用 模板 。 在 DataTemplate 内 部 ， 主 元 素 是 一 个 文本 框 ， 其 Text 属性 绑 定 到 Country 的 
Name 属性 上 ，Source 属性 的 Image 绑 定 到 Country 的 ImagePath 属性 上 。Grid 和 Border 元 素 定 义 了 布局 和 可 见 
外 观 (代码 文件 Templates/Styles/DataTemplates.xaml): 


<DataTemplate x:Eey="CountryDataTemplate"™> 
<Border Margin="4" BorderThickness="2™ CornerRadius="6"> 
<Border.BorderBrush> 
<LinearGradientBrush StartPoint="0,0" EndPoint="0,1"»> 
<Gradientstop Offset="0"™ Color="#aaa™ /> 
<GradientStop Offset="1" Color="#222"™ /> 
</LinearGradientBrush> 
</Border.BorderBrush> 
<Border.Background> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0" Color="#444" /> 
<Gradientstop Offset="1" Color="#fff" /> 
</LinearGradientBrush> 
</Border .Background> 
<Grid Margin="4"> 


二 人 


<Grid.RowDefinitions> 
<RowDefinition Height="auto™ /> 
<RowDefinition Height="auto"™ /> 
</Grid.RowDefinitions> 
<Image Width="120" Source="{Binding ImagePath}"™" /> 
<TextBlock Grid.Row="1" Opacity="0.6" FontSize="16" 
VerticalAlignment="Bottom" HorizontalAlignment="Right"™”" Margin="15" 
FontWeight="Bold™" Text="{Binding Name}"™ /> 
</Grid> 
</Border> 
</DataTemplate> 


在 Page 的 XAML 代码 中 ， 定 义 一 个 简单 的 Button 元 素 button1: 


<Button xXx:Name="countryButton™ Grid.Row="2"™ Margin="20" 
ContentTemplate="{StaticResource CountryDataTemplate}" /> 


在 代码 隐藏 文件 中 ， 实 例 化 一 个 新 的 Country 对 象 ， 并 把 它 赋 给 button1 
的 Content 属性 (代码 文件 Templates/StyledButtons.xaml.cs): 


this.countryButton.Content = new Country 
{ 
Name = "Austria", 
ImagePath = "images/Austria .bmp" 
}i 
运行 这 个 应 用 程序 , 可 以 看 出 , DataTemplate 应 用 于 Button, 因为 Country Austria 
数据 类 型 有 默认 的 模板 ， 如 图 35-16 所 示 。 


当然 ， 也 可 以 创建 一 个 控件 模板 ， 并 从 中 使 用 数据 模板 。 


35-16 


35.7.3” 榜 式 化 ListView 


更 改 按钮 或 标签 的 样式 是 一 个 简单 的 任务 ， 例 如 改变 包含 一 个 元 紊 列表 的 父 元 素 的 样式 。 如 何 更 改 
ListView? 这 个 列表 控件 也 有 操作 方式 和 外 观 。 它 可 以 显示 一 个 元 素 列 表 ， 用 户 可 以 从 列表 中 选择 一 个 或 多 个 
元 素 。 人 至 于 操作 方式 ，ListView 类 定义 了 方法 、 属 性 和 事件 。ListView 的 外 观 与 其 操作 是 分 开 的 。ListView 元 
素 有 一 个 默认 的 外 观 ， 但 可 以 通过 创建 模板 ， 改 变 这 个 外 观 。 

为 了 给 ListView 填充 一 些 项 ， 类 CountryRepository 返回 几 个 要 显示 出 来 的 国家 (代码 文件 
Models/CountryRepository.cs): 

public sealed class CountryRepository 

private static IEnumerable<Country> s countries; 

public IEnumerable<Country> GetCountries() => 
Pe 22 {(s countries = new List<Country> 


new Country { Name="Austria", Imagerath 
new Country 1{ Name="Germany", ImagePath 


"Imges/Austria.bmp" }, 
"Images/Germany .bmp" }, 


new Country { Name="Norway", ImagePath = "Images/Norway.bmp" }, 
new Country { Name="USA", ImagePath = "Images/USA.bmp" } 
}) 5; 


} 
在 代码 隐藏 文件 中 ， 在 StyledList 类 的 构造 函数 中 ， 使 用 CountryRepository 的 GetCountries 方法 创建 并 填 
充 只 读 属性 Countries( 代 码 文件 Templates/StyledListxaml.cs): 


Public ObservableCollection<Country> Countries { get; } = 
new ObservableCollection<Country> () ， 


public StyledListBox() 
{ 
this.InitializeComonent (}); 
this.Datacontext = this; 
Var countries = new CountryRepository{() .Getcountries (); 
foreach (var country in countries) 
{ 
Countries.Add (country); 
} 
} 


在 XAML 代码 中 ， 定 义 了 countryListl 列表 视图 。countryListl 只 使 用 元 素 的 默认 外 观 。 把 ItemsSource 属 
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性 设置 为 Binding 标记 扩展 ， 它 由 数据 绑 定 使 用 。 从 代码 隐藏 文件 中 ， 可 以 看 到 
数据 绑 定 用 于 一 个 Country 对 象 数 组 。 Austria 
35-17 显示 了 ListView 的 默认 外 观 。 在 默认 情况 下 ， 只 在 一 个 简单 的 列表 


wermany 
中 显示 ToString0 方 法 返回 的 国家 名 称 (代码 文件 Templates/StyledList.xaml)。 
、 Norway 
<GIl1d> 
<ListView ItemsSource="{Binding Countries}™" Margin="10" 
x:Name="countryListl"™" /> USA 
</Grid> 


图 35-17 


35.7.4 ListView 项 的 数据 模板 


接 下 来 ， 使 用 之 前 为 ListView 控件 创建 的 DataTemplate。DataTemplate 可 以 
直接 分 配给 ItemTemplate 属性 (代码 文件 Templates/StyledListxaml): 


<ListView ItemsSource="{Binding Countries}" Margin="10" 
ItemTemplate="{StaticResource CountryDataTemplate}™" /> 


有 了 这 些 XAML， 项 就 如 图 35-18 所 示 。 
当然 也 可 以 定义 一 个 引用 数据 模板 的 样式 (代码 文件 Templates/Styles/ | 


LlstIemplates. Xaml): 
Germany 
<Style x:Key="LlistViewSstylel™" TargetType="L1istView"> 


2 : | 
<Setter Property="ItemTemplate 
Value="{StaticResource CountryDataTemplate}™ /> 
</Style> 


在 ListView 控件 中 使 用 这 个 样式 (代码 文件 Templates/StyledList.xaml ): 


<ListView ItemsSource="{Binding Countries}" Margin="10" 
Style="{StaticResource ListViewStylel}" /> 


呈 量 
用 


Austria 


| 


Norway 


35.7.5 ”项 容器 的 样式 


数据 模板 定义 了 每 一 项 的 外 观 ， 每 项 还 有 一 个 容器 。ItemContainerstyle 可 以 
定义 每 项 的 容器 的 外 观 ， 例 如 ， 选 择 、 按 下 每 个 项 时 ， 应 给 画笔 使 用 什么 前 景 和 
背景 等 。 对 于 容器 边界 的 简单 视图 ， 设 置 Margin 和 Background 属性 (代码 文件 
Templates/Styles/ListTemplates.xam!l): 


<Style x:Key="ListViewItemSstylel" TargetType="ListViewlItem"> 
<Setter Property="Background™" Value="Orange"/> 
<Setter Property="Margin™" Value="5" /> 
<Setter Property="Template"™> 
<Setter.Value> 
<ControlTemplate TargetType="ListViewItem™"> 
<ListViewItemPresenter ContentMargin="{TemplateBinding Padding}™" 
FOCcUSBorderBrush= 
"{ThemeResource SysStemControlForegroundAltHighBrush}" 
HorizontalContentAlignment= 
"{TemplateBinding HorizontalContentAlignment}™" 
PlaceholderBackground= 
"{ThemeResource ListViewlItemPlaceholderBackgroundThemeBrush}" 
SelectedPressedBackground= 
"{ThemeResource SystemControlHighlightListAccentHighBrush}" 
SelectedForeground= 
"{ThemeResource SystemControlHighlightAltBaseHighBrush}" 
SelectedBackground= 
"{ThemeResource SystemControlHighlightListAccentLowBrush}" 
VerticalContentAlignment= 
"{TemplateBinding VerticalCcontentAlignment}"/> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Sstyle> 


样式 与 ListView 的 ItemContainerStyle 属性 相关 联 。 这 种 样式 的 结果 如 图 3S-19 


图 35-18 


所 示 。 这 个 图 很 好 地 显示 了 项 容器 的 边界 (代码 文件 Templates/StyledListxaml): 


<ListView ItemsSource="{Binding CountIrlIesl"” Margin="10" 
ItemContainerStyle="{StaticResource ListViewItemStylel}" 
Style="{StaticResource ListViewStylel}"™" MaxWidth="180" /> 


35.7.6 项 面板 


默认 情况 下 ， ListView 的 项 垂直 放置 。 这 不 是 在 这 个 视图 中 安排 项 的 唯一 方法 ， 还 可 以 用 其 他 方式 安排 它 
们 ， 如 水 平 放置 。 在 项 控件 中 安排 项 由 项 面板 负责 。 

下 面 的 代码 片段 为 ItemsPanelTemplate 定义 了 资源 ， 水 平 布置 ItemsStackPanel， 而 不 是 垂直 布置 (代码 文件 
Templates/Styles/listTemplates.xam!l): 


<ItemsPanelTemplate Xx:Eey="ItemsPanelTemplatel]l™"»> 
<ItemsSstackPanel Orientation="Horizontal™" Background="Yellow" /> 
</ItemsPanelTemplate> 


下 面 的 ListView 声明 使 用 与 之 前 相同 的 Style 和 ItemContainerStyle， 但 添加 了 ItemsPanel 的 资源 。 图 35-20 
显示 ， 项 现在 水 平 布置 (代码 文件 Templates/StyledListxaml): 


<ItemsPanelTemplate x:Eey="ItemsPanelTemplatel™"»> 

<VirtualizingSstackPanel IsItemsHost="True™" Orientation="Horizontal™" 
Background="Yellow"/> 

</ItemsPanelTemplate> 

<LlstView ItemsSource="{Binding Countries}™" Margin="10" 
ItemCcontainerSstyle="{StaticResource ListViewItemSstylel}" 
Style="{StaticResource ListViewStylel}" 
ItemsPanel="{StaticResource ItemsPanelTemplatel}"™" /> 


图 35- 20 


35.7.7 ”列表 视图 的 控件 模板 


该 控件 还 没有 介绍 的 是 滚动 功能 , 以 防 项 不 适合 放 在 屏幕 上 。 定义 ListView 控件 的 模板 可 以 改变 这 个 行为 。 

样式 ListViewStyle2 将 根据 需要 定义 水 平和 垂直 滚动 条 的 行为 ， 且 项 水 平 布 置 。 这 个 样式 还 包括 对 日 期 模 
板 的 资源 引用 和 前 面 定 义 的 容器 项 模板 。 设 置 Template 属性 ， 现 在 还 可 以 更 改 整个 ListView 控件 的 UI (代码 文 
件 Templates/Styles/ListTemplates.xaml): 


<Style Xx:FKey="ListViewStyle2" TargetType="ListView"> 

<Setter Property="ScrollViewer.HorizontalSscrollBarVisibility" Value="Auto"/> 
<Setter Property="ScrollViewer.VerticalScrollBarVisibility" 

Value="Disabled"/> 
<Setter Property="ScrollViewer.HorizontalScrollMode™" Value="Auto"/> 
<Setter Property="ScrollViewer.IsHorizontalRailEnabled"™" Value="False"/> 
<Setter Property="ScrollViewer.VerticalScrollMode"™" Value="Disabled"/> 
<Setter Property="ScrollViewer.IsVerticalRailEnabled™" Value="False"/> 
<Setter Property="ScrollViewer.ZoomMode" Value="Disabled"/> 
<Setter Property="ScrollViewer.IsDeferredscrollingEnabled™" Value="False"/> 
<Setter Property="ScrollViewer.BringIntoViewOnFocusChange™" Value="True"™/> 
<Setter Property="ItemTemplate™ 

Value="{StaticResource CountryDataTemplate}™ /> 
<Setter Property="ItemContainerSstyle"™ 

Value="{StaticResource ListViewItemStylel}™ /> 
<Setter Property="ItemsPanel™" > 

<Setter.Value> 

<ItemsPanelTemplate> 
<ItemsstackPanel Orientation="Horizontal™" Background="Yellow"/> 
</ItemsPanelTemplate> 

</Setter.Value> 

</Setter> 
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<Setter Property="Template"™"> 
<Setter.Value> 
<ControlTemplate TargetType="L1istView"> 
<Border BorderBrush="{TemplateBinding BorderBrush}" 
BorderThickness="{TemplateBinding BorderThickness}" 
Background="{TemplateBinding Background} "> 
<SCIollViewer KX:Name="ScrollViewer"> 
<1l—-SCrollViewer definitions removed for clarity-—> 
<ItemsPresenter FooterTransitions= 
"{TemplateBinding FooterTransitions}" 
FooterTemplate="{TemplateBinding FooterTemplate}™" 
Footer="{TemplateBinding Footer}" 
HeaderTemplate="{TemplateBinding HeaderTemplate}™" 
Header="{TemplateBinding Header}" 
HeaderTransitions="{TemplateBinding HeaderTransitions}" 
Padding="{TemplateBinding Padding}"/> 
</ScrollvVviewer> 
</Border> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 


有 了 这 个 资源 ，ListView 的 定义 就 很 简单 了 ， 因 为 
只 需要 引用 ListViewStyle2 和 ItemsSource 来 检索 数据 em 
(代码 文件 Templates/StyledListxaml): 


| | | | 

| | 

| ; , | | | 

<ListView ItemsSource="{Binding Countries}" | / | | 


Margin="10" Germany 
Style="{StaticResource ListViewStyle2}" /> 


新 视图 如 图 35-21 所 示 。 现 在 滚动 条 可 用 了 。 


图 35-21 


35.8 动画 


在 动画 中 ， 可 以 使 用 移动 的 元 素 、 颜 色 变化 、 变 换 等 制作 平滑 的 变换 效果 。XAML 使 动画 的 制作 非常 简单 。 
还 可 以 连续 改变 任意 依赖 属性 的 值 。 不 同 的 动画 类 可 以 根据 其 类 型 ， 连 续 改 变 不 同属 性 的 值 。 

动画 最 重要 的 元 紊 是 时 间 轴 ， 它 定义 了 值 随时 间 的 变化 方式 。 有 不 同类 型 的 时 间 轴 ， 可 用 于 改变 不 同类 型 
的 值 。 所 有 时 间 轴 的 基 类 都 是 Timeline。 为 了 连续 改变 double 值 , 可 以 使 用 DoubleAnimation 类 。Int32Animation 
类 是 int 值 的 动画 类 。PointAnimation 类 用 于 连续 改变 点 ，ColorAnimation 类 用 于 连续 改变 颜色 。 

Storyboard 类 可 以 用 于 合并 时 间 轴 。Storyboard 类 派生 目 基 类 TimelineGroup，TimelineGroup 又 派生 上 自 基 类 
Timeline。 


35.8.1 时 间 轴 


Timeline 定义 了 值 随时 间 的 变化 方式 。 下 面 的 示例 连续 改变 桶 圆 的 大 小 。 在 接 下 来 的 代码 中 ， 
DoubleAnimation 时 间 轴 缩放 和 平移 椭圆 ，ColorAnimation 改变 填充 画笔 的 颜色 。Ellipse 类 的 Triggers 属性 设置 
为 EventITlgger 。 加 载 椭圆 时 触发 事件 。 BeginStoryboard 是 启动 故事 板 的 触发 器 动作 。 在 故事 板 中 ， 
DoubleAnimation 元 素 用 于 连续 改变 CompositeTransform 类 的 ScaleX、ScaleY、TranslateX、TranslateY 属性 。 
动画 在 10 秒 内 把 水 平 比例 改 为 5S， 垂 直 比 例 改 为 3( 代 码 文件 Animation/SimpleAnimation.xam]): 


<Ellipse x:Name="ellipsel™" Width="100" Height="40" 
HorizontalAlignment="Left"™" VerticalAlignment="Top"> 
<Ellipse.F111> 
<SolidColorBrush Color="Green" /> 
</Ellipse.Fill> 
<Ellipse.RenderTransform> 
<CompositeTransform ScaleX="]1" ScaleY="1" TranslateX="0" TranslateY="0" /> 
</Ellipse.RenderTransform> 
<Ellipse.Triggers> 
<EventTrigger> 
<Beginstoryboard> 
<Storyboard x:Name="MoveResizeStoryboard"™"> 
<DoubleAnimation Duration="0:0:10" To="5" 
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Storyboard.TargetName="ellipsel" 
storvyboard.TargetProperty= 
"(UIElement.RenderTransform) . (CompositeTransform.ScaleX)" /> 
<DoubleAnimation Duration="0:0:10" To="3" 
Storvyboard.TargetName="ellipsel" 
storvyboard.TargetProperty= 
"(UIElement.RenderTransform) . (CompositeTransform.ScaleY)" /> 
<DoubleAnimation Duration="0:0:10" To="400" 
Storvyboard.TargetName="ellipsel" 
storvyboard.TargetProperty= 
"(UIElement .RenderTransform) . (CompositeTransform.TranslateX)" /> 
<DoubleAnimation Duration="0:0:10" To="200" 
Storvyboard.TargetName="ellipsel" 
Storvyboard.TargetProperty= 
"(UIElement .RenderTransform) . (CompositeTransform.TranslateY)" /> 
<ColorAnimation Duration="0:0:10" To="Red" 
Storvyboard.TargetName="ellipsel" 
Storvyboard.TargetProperty= 
"(Ellipse.Fill). (SolidColorBrush.Color)" /> 
</Storyboard> 
</Beginstoryboard> 
</EventTrigger> 
</Ellipse.Triggers> 
</Ellipse> 


使 用 ScaleTransform 和 TranslateTransform, 动画 就 会 访问 TransformGroup 的 集合 , 使 用 一 个 索引 器 可 以 访 
问 ScaleX、ScaleY、X 和 了 属性: 
<DoubleAnimation Duration="0:0:10™ To="5" Storyboard.TargetName="ellipsel™ 
Storyboard.TargetProperty= 
"(UIElement.RenderTransform) .Children[0]. (ScaleTransform.scaleXx)™ /> 
<DoubleAnimation Duration="0:0:10™ To="3" Storyboard.TargetName="ellipsel™ 
Storyboard.TargetProperty= 
"(UIElement.RenderTransform) .Children[0]. (ScaleTransform.scaleY)™ /> 
<DoubleAnimation Duration="0:0:10"™ To="400™ Storyboard.TargetName="ellipsel"™" 
Storyboard.TargetProperty= 
"(UIFElement .RenderTransform) .Children[1]. (TranslateTransform.X})"™" /> 
<DoubleAnimation Duration="0:0:10"™ To="200™ Storyboard.TargetName="ellipsel™" 


Storyboard.TargetProperty= 
"(UIFElement .RenderTransform) .Children[1]. (TranslateTransform.Y}"™" /> 


除了 在 组 合 变 换 中 使 用 索引 器 之 外 ， 也 可 以 通过 名 称 访问 ScaleTransform 元 素 。 下 面 的 代码 简化 了 该 属性 
的 名 称 : 


<DoubleAnimation DuratIon="0:0:10"” To="5" Storyboard.TargetName="scalel™" 
Storyboard.TargetProperty=" (ScaleXx)" /> 


图 35-22 和 图 35-23 显示 了 具有 动画 效果 的 椭圆 的 两 个 状态 。 


图 35-22 图 35-23 
动画 并 不 仅仅 是 一 直 和 立刻 显示 在 屏幕 上 的 一 般 窗口 动画 ， 还 可 以 给 业务 应 用 程序 添加 动画 ， 使 用 户 界 面 
的 啊 应 性 更 好 。 光 标 划 过 按钮 或 单 击 按钮 时 的 外 观 由 动画 定义 。 
Timeline 可 以 完成 的 任务 如 表 35-3 所 示 。 


表 35-3 
Timeline 属性 说 明 
AutoReverse 使 用 AutoReverse 属性 ， 可 以 指定 连续 改变 的 值 在 动画 结束 后 是 否 返 回 初 始 值 
SpeedRatio 使 用 SpeedRatio， 可 以 改变 动画 的 移动 速度 。 在 这 个 属性 中 ， 可 以 定义 父子 元 素 的 相对 关系 。 默 认 值 
为 1; 将 速率 设置 为 较 小 的 值 ， 会 使 动画 移动 较 慢 ;将 速率 设置 为 高 于 1 的 值 ， 会 使 动画 移动 较 快 
BeginTime 使 用 BeginTime， 可 以 指定 从 触发 器 事件 开始 到 动画 开始 移动 之 间 的 时 间 长 度 。 其 单位 可 以 是 天 、 小 


时 、 分 钟 、 秒 和 几 分 之 秒 。 根 据 SpeedRatio， 这 可 以 不 是 真实 的 时 间 。 例 如 ， 如 果 把 SpeedRatio 设置 
为 2， 把 开始 时 间 设 置 为 6 秒 ， 动 画 就 在 3 秒 后 开始 
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( 续 表 ) 
Timeline 属性 说 明 
Duration 使 用 Duration 属性 ， 可 以 指定 动画 重复 一 次 的 时 间 长 度 
RepeatBehavior 给 RepeatBehavior 属性 指定 一 个 RepeatBehavior 结构 ， 可 以 定义 动画 的 重复 次 数 或 重复 时 间 
FillBehavior 如 果 父 元 素 的 时 间 轴 有 不 同 的 持续 时 间 ，FillBehavior 属性 就 很 重要 。 例如 ， 如 果 父 元 素 的 时 间 轴 比 实 


际 动 画 的 持续 时 间 短 ， 则 将 FillBehavior 设置 为 Stop 就 表示 实际 动画 停止 。 如 果 父 元 素 的 时 间 轴 比 实 
际 动 画 的 持续 时 间 长 ，HoldEnd 就 会 一 直 执行 动画 ， 直 到 把 它 重 置 为 初始 值 为 止 (假定 将 AutoReverse 
设置 为 true) 


根据 Timeline 类 的 类 型 ， 还 可 以 使 用 其 他 一 些 属性 。 例 如 ， 使 用 DoubleAnimation， 可 以 为 动画 的 开始 和 
结束 设置 From 和 To 属性 。 还 可 以 指定 By 属性 ， 用 Bound 属性 的 当前 值 启动 动画 ， 该 属性 值 会 递增 由 By 属 
性 指定 的 值 。 


35.8.2 ”组 动 函数 


在 前 面 的 动画 中 , 值 以 线性 的 方式 变化 。 但 在 现实 生活 中 ， 移动 不 会 呈 线 性 的 方式 。 移 动 可 能 开始 时 较 慢 ， 
逐步 加 快 ， 达 到 最 高 速度 ， 然 后 减缓 ， 最 后 停止 。 一 个 球 掉 到 地 上 ， 会 反弹 几 次 ， 最 后 停 在 地 上 。 这 种 非 线性 
行为 可 以 使 用 非 线性 动画 创建 。 

动画 类 有 EasineFunction 属性 。 这 个 属性 接受 一 个 派生 目 基 类 EasineFunctionBase 的 对 象 。 通 过 这 个 类 型 ， 
缓 动 函数 对 象 可 以 定义 值 随 着 时 间 如 何 变 化 。 有 几 个 缓 动 函数 可 用 于 创建 非 线 性 动画 ， 如 ExponentialEase， 它 
给 动画 使 用 指数 公式 ; QuadraticEase、CubicEase、QuarticEase 和 QuinticEase 的 指数 分 别 是 2、3、4、5, PowerEase 
的 指数 是 可 以 配置 的 。 特 别 有 趣 的 是 SineEase， 它 使 用 正弦 曲线 ，BounceEase 创建 弹跳 效果 ，ElasticEase 用 弹 


鞭 的 来 回 震 荡 模 拟 动 画 值 。 
下 面 的 代码 把 BounceEase 函数 添加 到 DoubleAnimation 中 。 添 加 不 同 的 缓 动 函 数 ， 就 会 看 到 动画 的 有 趣 
效果 : 


<DoubleAnimation Storyboard.TargetProperty=" (Ellipse .Width)" 
Duration="0:0:3" AutoReverse="True" 
FillBehavior=" RepeatBehavior="Forever™. 
FIrom="100™ To=™"300"™"> 
<Doublehnimation.EasingFunction> 
<BounceEase EasingMode="EaseInOQut" /> 
</DoubleAnimation .EasingFunction> 
</DoubleAnimation> 


为 了 看 到 不 同 的 绥 动 动 田 ， 下 一 个 示例 让 椭圆 在 两 个 小 矩形 之 间 移 动 。Rectanegle 和 Ellipse 元 素 在 Canvas 
辆 布 上 定义 ， 椭 加 定义 了 TranslateTransform 变换 ， 来 移动 椭圆 (代码 文件 Animation/EasingFunctions.xaml): 


<Canvas Grid.Row="1"> 
<Rectangle Fill="Blue"™" Width="10"™ Height="200™ Canvas.Left="50" 
Canvas.Top="100" /> 
<Rectangle Fill="Blue"™" Width="10"™ Height="200™ Canvas.Left="550" 
Canvas .Top="100" /> 
<El1lipse Fi1ll="Red™" Width="30" Height="30™" Canvas.Left="60™ Canvas.Top="185"> 
<Ellipse.RenderTransform> 
<TranslateTransform x:Name="translatel™ X="0O" Y="0"™" /> 
</Ellipse.RenderTransform> 
</Ellipse> 
</Canvas> 


图 35-24 显示 了 和 抑 形 和 椭圆 。 


第 35 章 样式 化 Windows 应 用 程序 | 965 


图 35-24 


用 户 单 击 一 个 按钮 ， 局 动 动画 。 单 击 此 按钮 之 前 ， 用 户 可 以 从 ComboBox comboEasingFunctions 中 选择 组 
动 函 数 ， 使 用 单 选 按钮 选择 一 个 EasingMode 枚 举 值 。 


<StackPanel Orientation="Horizontal™"> 
<ComboBox xX:Name="comboEasingFunctions"™" Margin="10" /> 
<Button Click="OnstartAnimation™ Margin="10">start</Button> 
<Border BorderThickness="1"™" BorderBrush="Black" Margin="3"> 
<StackPanel Orientation="Horizontal™"> 
<RadioButton x:Name="easingModeIn™" GroupName="EasingMode™ Content="In™" /> 
<RadioButton XxX:Name="easingModeOut™ GroupName="EasingMode" 
Content="Out" IsChecked="True™ /> 
<RadioButton XxX:Name="easingModeInOut™ GroupName="EasingMode™ 
Content="InOut"™ /> 
</StackPanel> 
</Border> 
</StackPanel> 


ComboBox 中 显示 的 \ 动 田 激 活 的 缓 动 函数 列表 从 EasingFunctionManager 的 EasingFunctionModels 属性 中 返回 。 
这 个 管理 器 把 缓 动 函 数 转换 为 EasingFunctionModel, 以 显示 出 来 (代码 文件 Animation /EasingFunctionsManager.cs): 


public class EasingFunctionsManager 
{ 
private static IEnumerable<EasingFunctionBase> s easingFunctions = 
new List<EasingFunctionBase> () 
{ 
new BackEase(), 
new SineEase(), 
new BounceEaser(), 
new CircleEase(), 
new CubicEase(), 
new ElasticEase(), 
new ExponentialEase(), 
new PowerEasel(), 
new QuadraticEase (1) ， 
new QuinticEase() 


1s 


Public IEnumerable<EasingFunctionModel> EasingFunctionModels => 
s easingFunctions.SsSelect(f => new EasingFunctionModel (f)); 


} 
EasingFunctionModel 类 定义 了 ToString 方法 ， 返 回 定义 了 缓 动 函数 的 类 的 名 称 。 这 个 名 字 显 示 在 组 合 框 中 
(代码 文件 Animation/EasingFunctionModelcs): 


public class EasingFunctionModel 
{ 
Public EasingFunctionModel (EasingFunctionBase easingFunction) => 
EasingFunction = easingFunction; 


Public EasingFunctionBase EasingFunction { get; } 


public override string ToString{() => EasingFunction.GetType() .Name; 


} 
ComboBox 在 代码 隐藏 文件 的 构造 函数 中 填充 (代码 文件 Animation/EasingFunctions. xaml.cs): 


private EasingFunctionsManager easingFunctions = new EasingFunctionsManager (); 
private const int AnimationTimeSeconds = 6; 
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Publlc EasingFunctions () 


{ 


} 


this.InitializeComponent () ; 
foreach (var easingFunctionModel in easingFunctions .EasingFunctionModels) 
{ 
comboEasingFunctions.1lItems .Add(leasingFunctionModel).; 
} 


在 用 户 界 面 中 ， 不 仅 可 以 选择 应 该 用 于 动画 的 缓 动 函数 的 类 型 ， 也 可 以 选择 绥 动 模式 。 所 有 绥 动 函数 的 基 
类 (EasineFunctionBase) 定 义 了 EasineMode 属性 ， 它 可 以 是 EasingMode 枚 举 的 值 。 

单 击 此 按钮 ， 局 动 动画 ， 会 调用 OnStartAnimation 方法 。 该 方法 又 调用 StartAnimation 方法 。 在 这 个 方法 
中 ， 通 过 编程 方式 创建 一 个 包含 DoubleAnimation 的 故事 板 。 之 前 列 出 了 使 用 XAML 的 类 似 人 代码。 动画 连 续 改 
变 translatel 元 素 的 X 属性 (代码 文件 Animation/EasineFunctionsPage.xaml.cs): 


private void OnstartAnimation (object sender, RoutedEventArgs e) 


{ 


} 


Var easingFunctionModel = 
comboEasingFunctions.SelectedItem as EasingFunctionModel; 
if (easingFunctionModel != null) 
| 
EasingFunctionBase easingFunction = easlngEunct1IonMoade1 .EasingFunction; 
easingFunction.EasingMode = GetEasingMode () ; 
StartAnimation (easingFunction); 


} 


private void startAnimation (EasingFunctionBase easingFunction) 


{ 


} 


var storyboard = new Storyboard()}); 
Var ellipseMove = new DoubleAnimation(); 
ellipseMove.EasingFunction = easingFunction; 


ellipseMove.Duration = new 
Duration({TimeSpan.FromSeconds (AnimationTimeSeconds)); 

ellipseMove.From = 0; 

ellipseMove.To = 460; 

Storyboard.SetTarget (ellipseMove, translatel).; 

storyboard.SetTargetProperty (ellipseMove, "xX"); 


/:/ start the animation in 0.5 seconds 
ellipseMove.BeginTime = TimeSpan.FromSeconds (0 .5) ; 


i:/ keep the position after the animation 
ellipseMove.FillBehavior = FillBehavior.HoldEnd; 
storyboard.children.Add (ellipseMove); 
storyBoard.Begin(}); 


现在 ， 可 以 运行 应 用 程序 ， 看 看 椭圆 使 用 不 同 的 缓 动 函数 ， 以 不 同 的 方式 从 左 窍 形 移动 到 右 窍 形 。 使 用 一 
些 缓 动 函 数 ， 比 如 BackEase、BounceEase 或 ElasticEase， 区 别 是 显而易见 的 。 其 他 的 一 些 缓 动 函数 没有 明显 的 


区 别 。 


为 了 更 好 地 理解 缓 动 值 如 何 变化 ， 可 以 创建 一 个 折线 图 ， 其 中 显示 了 一 条 线 ， 其 上 的 值 由 基于 时 间 的 组 


动 函数 返回 。 
为 了 显示 折线 图 ， 可 以 创建 一 个 用 户 控件 ， 它 定义 了 一 个 Canvas 元 素 。 默 认 情 况 下 ，x 方 同 从 左 到 右 ，y 
方 同 从 上 到 下 。 为 了 把 y 方 同 改 为 从 下 到 上 ， 可 以 定义 一 个 变换 (代码 文件 Animation/EasingChartControl.xaml): 


<Canvas XxX:Name="canvasl™" Width="500"™ Height="500™ Background="Yellow"> 


<Canvas.RenderTransform> 
TransftormGroup> 
<ScaleTransform ScaleX="]1" ScaleY="-1" /> 
<TranslateTransform X="0" Y="500" /> 
</TransformGroup> 
</Canvas.RenderTransform> 


</Canvas> 
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在 代码 隐藏 文件 中 ， 使 用 线段 绘制 折线 图 。 线 段 在 本 章 的 35.3.1 节 “ 使 用 段 的 几何 图 形 ” 中 用 XAML 代码 
讨论 过 。 这 里 ， 它 们 可 以 在 代码 中 使 用 。 通 过 传递 x 轴 上 显示 的 时 间 值 的 规范 化 值 ， 缓 动 图 数 的 Ease 方法 就 返 
回 一 个 值 ， 显 示 在 y 轴 上 (代码 文件 Animation/EasingChartControl.xamlcs ): 


private const double SamplingInterval = 0.01; 


Public void Draw (EasingFunctionBase easingFunction) 


| 


} 


canvasl.children.Clear (}); 

Var PathSegments = new PathSegmentcCcollection ();} 

for (double 1 = 0; 1 < 1; 1 += samplinglnterval) 

{ 
double x = 1 * canvasl .Width; 
double Y = easingFunction.Ease(i) * canvasl.Height; 
Var Segment = new LineSegment () ; 
segment.Point = new Point (x, vy); 
Pathsegments .Add (segment)}).; 

} 


Var p = new Patht({); 

DP-.Stroke = new SOolidColorBrush (Colors.Black); 
p.StrokeThickness = 3; 

var figures = new PathFigureCollection(); 
fiogures.Add (new PathFigure { Segments = pathSegments ]}) ， 
p.Data = new PathGeometry { Figures = figures }; 
canvasl.children.AMdd (p}); 


EasingChartControl 的 Draw 方法 在 动画 开始 时 调用 (代码 文件 Animation/EasingFunctions.xaml.cs): 


private void StartAnimation (EasingFunctionBase easingFunction) 


{ 


// show the chart 
chartControl .Draw (easingFunction).; 
7。 


运行 应 用 程序 时 ， 可 以 看 到 使 用 CubicEase 和 EaseOut 的 结果 ， 如 图 35-25 所 示 。 选 择 EaseIn 时 ， 值 在 动 
男 的 开始 变化 得 较 慢 ， 在 动画 的 后 面 变化 得 较 快 ， 如 图 35-26 所 示 。 图 35-27 显示 使 用 CubicEase 和 EaseInOut 
的 效果 。BounceEase、BackEase 和 ElasticEase 的 图 表 如 图 35-28、 图 35-29 和 图 35-30 所 示 。 


图 35-25 图 35-26 
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图 35-27 图 35-28 


图 35-29 图 35-30 


35.8.3 ”关键 帧 动画 
如 前 所 述 ， 使 用 组 动 函 数 ， 就 可 以 用 非 线 性 的 方式 制作 动画 。 如 果 需 要 为 动画 指定 几 个 值 ， 就 可 以 使 用 关 
键 帧 动画 。 与 正常 的 动画 一 样 ， 关 键 帧 动画 也 有 不 同 的 动画 类 型 ， 它 们 可 以 改变 不 同类 型 的 属性 。 
DoubleAnimationUsingKeyFrames 是 双 精 度 类 型 的 关键 帧 动画 。 其 他 关键 帧 动画 类 型 有 


Int32AnimationUsineKeyFrames 、 PointAnimationUsingeKeyFrames 、 ColorAnimationUsinekeyFrames、 
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SizeAnimationUsingKEeyFrames 以 及 ObjectAnimationUsingKEeyFrames。 

示例 XAML 代码 连续 地 改变 TranslateTransform 元 素 的 入 值 和 Y 值 ， 从 而 改变 椭圆 的 位 置 。 把 EventTrigger 
定义 为 RountedEvent Ellipse.Loaded， 动 画 就 会 在 加 载 椭圆 时 启动 。 事 件 触 有 器 用 BeginStoryboard 元 素 局 动 一 
个 Storyboard。 该 Storyboard 包含 两 个 DoubleAnimationUsinsKeyFrame 类 型 的 关键 帧 动画 。 关 键 帧 动画 由 帧 
元 素 组 成 。 第 一 幅 关 键 帧 动画 使 用 一 个 LinearKeyFrame 、 一 个 DiscreteDoubleKeyFrame 和 一 个 
SplineDoubleKeyFrame; 第 二 帆 关 键 帧 动 男 是 一 个 EasingDoubleKeyFrame。LinearDoubleKeyFrame 使 对 应 值 线 
性 变化 。KeyTime 属性 定义 了 动画 应 何 时 达到 Value 属性 的 值 。 

这 里 LinearDoubleKeyFrame 用 3 秒 的 时 间 使 X 属性 到 达 值 30。DiscreteDoubleKeyFrame 在 4 秒 后 立即 改 
变 为 新 值 。 SplineDoubleKeyFrame 使 用 贝 塞 尔 曲线 ， 其 中 的 两 个 控制 点 由 KeySpline 属性 指定 。 
EasingDoubleKeyFrame 是 一 个 帧 类 ， 它 支持 设置 缓 动 图 数 ( 如 BounceEase) 来 控制 动画 值 ( 代 码 文件 
AnimationKeyFrameAnimationPage.Xaml]): 


<CAaNVas” 
<Ellipse Fill="Red™" Canvas.Left="20"™" Canvas.Top="20" Width="25™" Height="25"> 
<Ellipse.RenderTransform> 
<TranslateTransform X="50" Y="50" x:Name="ellipseMove™" /> 
</Ellipse.RenderTransform> 
<Ellipse.Triggers> 
<EventTrigger> 
<Beglinstoryboard> 
<Storyboard> 
<DoubleAnimationUsingKeyFrames Storyboard.TargetProperty="X" 
storyboard.TargetName="ellipseMove"> 
<LinearDoubleReyFrame KeyTime="0:0:2" Value="30" /> 
<DiscreteDoubleKeyFrame KeyTime="0:0:4" Value="80" /> 
<SplineDoubleKeyFrame KeySpline="0.5,0.0 0.9,0.0" 
KeyTime="0:0:10" Value="300" /> 
<LinearDoubleReyFrame KeyTime="0:0:20"™ Value="150" /> 
</DoubleAnimationUsingKeyFrames> 
<DoubleAnimationUsingKeyFrames Storyboard.TargetProperty="Y" 
Storyboard.TargetName="ellipseMove"> 
<SplineDoubleReyFrame KeySpline="0.5,0.0 0.9,0.0" 
KeyTime="0:0:2" Value="50" /> 
<EasingDoubleKeyFrame KeyTime="0:0:20™ Value="300"> 
<pEasingDoubleKeyFrame .EasingFunction> 
<BounceEase /> 
</EasingDoubleKeyFrame .EasingFunction> 
</EasingDoubleKeyFrame> 
</DoubleAnimationUsingKeyFrames> 
</sStoryboard> 
</Beginstoryboard> 
</EventTrigger> 
</Ellipse.Triggers> 
</Ellipse> 
</Canvas> 


35.8.4 过渡 


为 方便 创建 带动 画 的 用 户 界 面 ,UWP 应 用 程序 定义 了 过 渡 效 果 。 过 渡 效 果 更 容易 创建 引 人 注 目的 应 用 程序 ， 
而 不 需要 考虑 如 何 制作 很 酷 的 动画 。 过 渡 效 果 预 定义 了 如 下 动画 ; 添加 、 移 除 和 重新 排列 列表 上 的 项 ， 打 开 面 
板 ， 改 变 内 容 控件 的 内 容 等 。 

下 面 的 示例 演示 了 几 个 过 渡 效 果 ， 在 用 户 控 件 的 左边 和 右边 展示 它们 ， 再 显示 没有 过 渡 效 果 的 相似 元 素 ， 
这 有 助 于 看 到 它们 之 间 的 差异 。 当 然 ， 需 要 启动 应 用 程序 才能 看 到 区 别 ， 很 难 在 印刷 出 来 的 书 上 证 明 这 一 点 。 

1. 复位 过 渡 效 果 

第 一 个 例子 在 按钮 元 素 的 Transitions 属性 中 使 用 了 RepositionThemeTransition。 过 渡 效 果 总 是 需要 在 
TransitionCollection 内 定义 ， 因 为 这 样 的 集合 是 不 会 目 动 创建 的 ， 如 果 没 有 使 用 TransitionCollection， 就 会 显示 
一 个 有 误导 作用 的 运行 时 错误 。 第 二 个 按钮 不 使 用 过 渡 效 果 ( 代 码 文 件 Transitions/RepositionUserControlLxam]): 


<Button Grid.Row="1"™" Click="OnReposition™" Content="Reposition" 
xX: Name="buttonReposition™" Margin="10"> 
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Button. Transitions> 
<TransitioconCollection» 
<RepositionThemeTransition /> 
</TransitionCollection> 
</Button.Transitions> 
</Button> 
<Button Grid.Row="l1"™ Grid.cCcolumn="1" Click="OnReset™ Content="Reset"™" 
x:Name="button2" Margin="10" /> 


RepositionThemeTransition 是 控件 改变 其 位 置 时 的 过 渡 效 果 。 在 代码 隐藏 文件 中 ， 用 户 单 击 按钮 时 ，Margin 
属性 会 改变 ， 按 钮 的 位 置 也 会 改变 。 

private void OnReposition (object sender, RoutedEventArgs e) 

buttonReposition.Margin = new Thickness (100); 


button2.Margin = new Thickness (100).; 
} 


private void OnReset (object sender, RoutedEventArgs e) 
{ 
buttonReposition.Margin = new Thickness (10).; 
button2.Margin = new Thickness (10); 
} 


2. 窗 格 过 渡 效 果 
PopupThemeTransition 和 PaneThemeTransition 显示 在 下 一 个 用 户 控件 中 。 在 这 里 ， 过 渡 效 果 用 Popup 控件 
的 ChildTransitions 属性 定义 (代码 文件 Transitions /PaneTransitionUserControl.xaml): 


<StackPanel Orientation="Horizontal"™" Grid.Row="2"> 
<POoPuUP XxX:Name="popupl"™" Width="200"™" Helght="90™ Margin="60"> 
<Border Background="Red™ Width="100"™" Height="60"> 
</Border> 
<Popup.ChildlTransitions» 
<TransiticnCollection> 
<PopupThemeTransition /> 
</TransitionCollection> 
</Popup .ChildTransitions> 
</ Popup> 
<PoPuUP X:Name="popup2" Width="200™ Helght="90™ Margin="60"> 
<Border Background="Red™ Width="100"™" Height="60"> 
</Border> 
<Popup.Childlransitions> 
<TransitionCollection> 
<PaneThemeTransition /> 
</TransitionCollection> 
</Popup.ChildTransitions> 
</Popup> 
<PoPuUP X:Name="popup3" Margin="60"™ Width="200™ Height="90"> 
<Border Background="Green™. Width="100" Height="60"> 
</Border> 
</ Popup> 
</sStackPanel> 


代码 隐藏 文件 通过 设置 IOpen 属性 ， 打 开 和 关闭 Popup 控件 。 这 会 启动 过 渡 效 果 ( 代 码 文 件 Transitions\ 
PanelTransitionUserControl.xaml): 


private void Onshow (object sender, RoutedEventArgs ee) 


{ 


POPUPl1 .Isopen = 七 TUE 
PoPpPupz .ISOPeDRn = true; 
Popup3.Isopen = truer 


} 


private void OnHide (object sender, RoutedEventArgs e) 


{ 


Popupl.Isopen = falses 
popupPpz2.Isopen = falser 
POPUP3.IsOpen = falsers 


运行 应 用 程序 时 可 以 看 到 ， 打 开 Popup 和 Flyout 控件 的 PopupThemeTransition 看 起 来 不 错 。 
PaneThemeTransition 慢 慢 从 右 侧 打开 Popup。 这 个 过 渡 效 果 也 可 以 通过 设置 属性 ， 配 置 为 从 其 他 侧 边 打开 ， 


第 35 章 样式 化 Windows 应 用 程序 | 971 


此 最 适合 面板 ， 例 如 设置 栏 ， 它 从 一 个 侧 边 移入 。 
3. 项 的 过 渡 效 果 


从 项 控件 中 添加 和 删除 项 也 定义 了 过 渡 效 果 。 以 下 的 ItemsControl 利用 了 EntranceThemeTransition 和 
RepositionThemeTransition。 项 添加 到 集合 中 时 使 用 EntranceThemeTransition， 重 新 安排 项 时 ， 例 如 从 列表 中 删 
除 项 时 ， 使 用 RepositionThemeTransition (代码 文件 Transitions/ListItemsUserControl.xam]): 

<ItemsControl Grid.Row="1"™ 和 Name 一 "LS 七 > 

ItemsControl. ItemContainerTransitions> 
TransitionCollection> 
<EntranceThemeTransition /> 
<RepositionThemeTransition /> 
</TransitionCollection> 
/ItemsControl .ItemContainerTransitions> 
</ItemsControl> 
<ItemsControl Grid.Row="1" Grid.Column="1" x:Name="list2" /> 


在 代码 隐藏 文件 中 , Rectangle 对 象 在 列表 控件 中 添加 和 删除 。 一 个 ItemsControl 对 象 没有 关联 的 过 渡 效 果 ， 
所 以 运行 应 用 程序 时 ， 很 容易 看 出 差异 (代码 文件 Transitions/ListItemsUserControl. xaml.cs): 
private void OnAdd (object sender, RoutedEventArgs e) 


listl.Items.Add (CreateRectangle ()); 
list2.Items.Add (CreateRectangle()); 
} 


private Rectangle CreateRectangle() 三 > 
new Rectangle 
{ 
Width = 90, 
Height = 40， 
Margin = new Thickness (5), 
Fill = new SolidCcolorBrush { Color = Colors.Blue } 
上 
private void OnRemove (object sender, RoutedEventArgs e) 
{ 
if (listl.Items.cCcount > 0) 
| 
list].Items.RemoveAt TD) : 
list2.Items.RemoveAt 《DO) : 
} 
} 


注意 : 
通过 这 些 过 渡 效 果 ， 了 解 了 如 何 减少 使 用 户 界 面 连续 动 起 来 所 需 的 工作 量 。 一 定 要 查看 可 用 于 UWP 应 用 
程序 的 更 多 过 渡 效 果 。 查 看 MSDN 文档 的 Transition 中 的 派生 类 ， 可 以 看 到 所 有 的 过 渡 效 果 。 


35.9 ”可视化 状态 管理 器 


本 章 前 面 的 “控件 模板 ”中 ， 介 绍 了 如 何 创建 控件 模板 ， 目 定义 控件 的 外 观 。 其 中 还 缺 了 些 什 么 。 使 用 按 
钮 的 默认 模板 ， 按 钮 会 啊 应 鼠标 的 移动 和 单 击 ， 当 鼠标 移动 到 按钮 或 单 击 按钮 时 ， 按 钮 的 外 观 是 不 同 的 。 这 种 
外 观 变 化 通过 可 视 化 状态 和 动画 来 处 理 ， 由 可 视 化 状态 管理 器 控制 。 

本 节 介 绍 如 何 改变 按钮 样式 ， 来 啊 应 鼠标 的 移动 和 单 击 ， 还 描述 了 如 何 创建 目 定义 状态 ， 当 几 个 控件 应 该 
切换 到 禁用 状态 时 ， 例 如 进行 一 些 后 台 处 理 时 ， 这 些 目 定义 状态 用 于 处 理 完整 页 面 的 变化 。 

对 于 XAML 元 素 ， 可 以 定义 可 视 化 状态 、 状 态 组 和 状态 ， 指 定 状态 的 特定 动画 。 状 态 组 允许 同时 有 多 个 状 
态 。 对 于 一 组 ， 一 次 只 能 有 一 个 状态 。 然 而 ， 另 一 组 的 另 一 个 状态 可 以 在 同一 时 间 诉 活 。 人 例如， 按钮 的 状态 和 
状态 组 。 按钮 控件 定义 了 状态 组 CommonStates 和 FocusStates。 用 FocusStates 定义 的 状态 是 Focused、Unfocused 
和 PointerFocused， Commonstates 组 定义 了 状态 Normal、PointerOver、Pressed 和 Disabled。 有 了 这 些 选 项 ， 
多 个 状态 可 以 同时 激活 ， 但 一 个 状态 组 内 总 是 只 有 一 个 状态 是 激活 的 。 例 如 ， 按 钮 可 以 是 Focused 和 Normal 
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状态 。 它 也 可 以 是 Focused 和 Pressed 状态 ， 还 可 以 定义 定制 的 状态 和 状态 组 。 
下 面 看 看 具体 的 例子 。 


35.9.1 用 控件 模板 预定 义 状 态 


下 面 利 用 先前 创建 的 自 定义 控件 模板 ， 样 式 化 按钮 控件 ， 使 用 可 视 化 状态 改进 它 。 为 此 ， 一 个 简单 的 方法 
是 使 用 Microsoft Blend for Visual Studio。 图 35-31 显示 了 状态 窗口 ， 选 择 控件 模板 时 就 会 显示 该 窗口 。 在 这 里 
可 以 看 到 控件 的 可 用 状态 ， 并 基于 这 些 状 态 记 录 变 化 。 
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图 35-31 


之 前 的 按钮 模板 改 为 定义 可 视 化 状态 : Pressed、Disabled 和 PointerOver。 在 状态 中 ，Storyboard 定义 了 一 
个 ColorAnimation 来 改变 椭圆 的 FL 属性 的 颜色 (代码 文件 VisualStates/MainPage.xam)): 


<Style KX:Key="RoundedGelButton™" TargetType="Button"™> 
<Setter Property="Width" Value="100"™ /> 
<Setter Property="Height"™ Value="100" /> 
<Setter Property="Foreground”" Value="White"™" /> 
<Setter Property="Template"™"> 
<Setter.Value> 
<ControlTemplate TargetType="Button™. > 
<Grid> 
<VisualSstateManager .VisualSstateGroups> 
<VisualSstateGroup x:Name="Commonstates"> 
<VisualState x:Name="Normal"/> 
<VisualSstate x:Name="Pressed"> 
<Storvyboard> 
<ColorAnimation Duration="0" To="#FFC8CEl11" 
Storyboard.TargetProperty= 
"(Shape.Fill) . (So0lidColorBrush.Color)" 
storvyboard.TargetName= 
"GelBackground" /> 
</Storyboard> 
</VisualState> 
<VisualSstate x:Name="Disabled"> 
Storvboard> 
<ColorAnimation Duration="0"™" To="#FF606066" 
storvyboard. TargetProperty= 
"(Shape.Fill) . (So0lidColorBrush.Color)" 
Storvyboard.TargetName="GelBackground" /> 
</Storyboard> 
</VisualState> 
<VisualSstate x:Name="PointerOQver"> 
<Storvyboard> 
<ColorAnimation Duration="0"™" To="#FFOFS9D3A" 
storvyboard.TargetProperty= 
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"(Shape.Fill) . (SolidColorBrush.Color)" 
Storvyboard.TargetName="GelBackground" /> 
</Storyboard> 
</VisualState> 
</VisualStateGroup> 
</VisualStateManager .VisualStateGroups> 
<Ellipse XxX:Name="GelBackground™" StrokeThickness="0.5" Fil1l="Black"> 
<Ellijpse.SsStroke> 
<LinearGradientBrush StartPoint="0,0"™ EndPoint="0,1"> 
<Gradientstop Offset="0"™ Color="#ff7eT7TeTe™ /> 
<Gradientstop Cffset="1" Color="Black"™ /> 
</LinearGradientBrush> 
</Ellipse.SsStroke> 
</Ellipse> 
<Ellipse Margin="15,5,15,50"> 
<Ellipse.Fill> 
<LinearGradientBrush StartPoInt="0 0" EndPoint="0,1"> 
<Gradientstop Offset="0"™ Color="#aaffffff"™" /> 
<Gradientstop CGffset="1" Color="Transparent" /> 
</LinearGradientBrush> 
</Ellipse.Fill> 
</Ellipse> 
<ContentPresenter XxX:Name="GelButtonContent™ 
VerticalAlignment="Center™ 
HorizontalAlignment="Center™ 
Content="{TemplateBinding Content}™ /> 
</Grid> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 


现在 运行 应 用 程序 ， 可 以 看 到 颜色 随 着 鼠标 的 移动 和 单 击 而 变化 。 


35.9.2 定义 目 定 义 状态 


使 用 VisualStateManager 可 以 定义 定制 的 状态 , 使 用 VisualStateGroup 和 VisualState 的 状态 可 以 定义 定制 的 
状态 组 。 下 面 的 代码 片段 在 CustomsStates 组 内 创建 了 Enabled 和 Disabled 状态 。 可 视 化 状态 在 主 窗口 的 网 格 中 
定义 。 改 变 状态 时 ，Button 元 素 的 IsEnabled 属性 使 用 DiscreteObjectKeyFrame 动画 立即 改变 (代码 文件 


VisualStates/MainPage.xaml): 


<VisualstateManager .VisualSstateGroups> 
<VisualstateGroup XxX:Name="CustomSstates"> 
<Visualstate x:Name="Enabled"/> 
<Visualstate x:Name="Disabled"> 
<Storyboard> 
<ObjectAnimationUsingKeyFrames 
Storyboard.TargetProperty=" (Control.IsEnabled)}™ 
Storyboard.TargetName="buttonl™> 
<DiscreteObjectKeyFrame KeyTime="0"> 
<DiscreteObjectKeyFrame .Value> 
<X:Boolean>False</x:Boolean> 
</DiscreteobjectKeyFrame .Value> 
</DiscreteObjectKeyFrame> 
</ObjectAnimationUsingKeyFrames> 
<ObjectAnimationUsingKeyFrames 
Storyboard.TargetProperty=" (Control.IsEnabled}™ 
Storyboard.TargetName="button2"> 
<DiscreteObjectKeyFrame KeyTime="0"> 
<DiscreteObjectKeyFrame .Value> 
<X:Boolean>False</x:Boolean> 
</DiscreteobjectKeyFrame .Value> 
</DiscreteObjectKeyFrame> 
</ObjectAnimationUsingKeyFrames> 
</Storyboard> 
</Visualstate> 
</VisualstateGroup> 
</VisualstateManager.VisualSstateGroups> 


35.9.3 设置 自 定义 的 状态 


现在 需要 设置 状态 。 为 此 , 可 以 调用 V1isualStateManager 类 的 GoToState 方法 ,在 代码 隐藏 文件 中 , OnEnable 
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和 OnDisable 方法 是 页 面 上 两 个 按钮 的 Click 事件 处 理 程序 (代码 文件 VisualStates/MainPage.xaml.cs): 
private void OnEnable (object sender, RoutedEventArgs ee) 


VisualstateManager.GoToState (this, "Enabled"™", useTransitions: true); 


private void OnDisable (object sender, RoutedEventArgs e) 


VisualstateManager.GoToState (this, "Disabled™", useTransitions: true); 


} 
在 真实 的 应 用 程序 中 ， 可 以 以 类 似 的 方式 更 改 状态 ， 例 如 执行 网 络 调用 时 ， 用 户 不 应 该 处 理 页 面 内 的 一 些 
控件 。 用 户 仍 应 被 允许 单 击 取消 按钮 。 通 过 改变 状态 ， 还 可 以 显示 进度 信息 。 


35.10 “小 结 


本 章 介 绍 了 样式 化 Windows 应 用 程序 的 许多 功能 。XAML 便于 分 开 开 发 人 员 和 设计 人 员 的 工作 。 所 有 UI 
功能 都 可 以 使 用 XAML 创建 ， 其 功能 用 代码 隐藏 文件 创建 。 

我 们 还 探讨 了 许多 形状 和 几何 图 形 元 素 ， 它 们 是 后 面 几 章 学 习 的 所 有 其 他 控件 的 基础 。 基 于 矢量 的 图 形 允 
许 XAML 元 素 缩放 、 剪 切 和 旋转 。 

可 以 使 用 不 同类 型 的 画笔 绘制 背景 和 前 景 元 素 ， 不 仅 可 以 使 用 纯色 画笔 、 线 性 渐变 或 放射 性 渐变 画笔 ， 而 
且 可 以 使 用 可 视 化 画笔 完成 反射 功能 或 显示 视频 。 

样式 和 模板 可 以 定制 控件 的 外 观 。 可 视 化 状态 管理 器 可 以 动态 更 改 XAML 元 素 的 属性 。 连 续 改 变 WPF 控 
件 的 属性 值 ， 就 可 以 轻松 地 制作 出 动画 。 第 36 章 将 继续 介绍 Windows 应 用 程序 ， 深 入 论述 UWP 的 高 级 功能 。 


.30. 


高 级 Windows 应 用 程序 


本 章 要 点 
。 共享 数据 


e 使 用 应 用 程序 服务 
e 编译 的 绑 定 功能 
e 定 文 本 显示 

e 使 用 墨水 

@ AlUtowtggpest 


本 章 源 代码 下 载 地 址 (wrox.com): 
打开 Www.Wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 AdvancedWindows 目录 
的 https://github.comyProfessionalCSharp/ProfessionalCSharp7 中 找到 。 本 章 的 代码 只 包含 一 个 大 示例 ， 它 展示 了 
本 章 的 各 个 方面 : 
® AppLifetime 
Sharmg Samples 
AppServices 
CompiledBmdmeLiftetime 
ComplledBmdmeMethods 
PhasedBindine 
TextSample 
Text Overflow 
InkSample 
AutoSsuegestSample 


36.1 概述 


前 一 章 介绍 了 Windows 应 用 程序 的 用 户 界 面 (UD 元 素 、 共享 代 人 码 的 模式 和 用 XAML 样式 化 应 用 程序 。 本章 
继续 讨论 Windows 应 用 程序 特定 的 几 个 方面 ，Windows 应 用 程序 的 生命 周期 管理 不 同 于 传统 的 桌面 应 用 程序 ， 
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用 共享 协定 创建 共享 源 和 目标 应 用 程序 ， 在 应 用 程序 之 间 共 享 数 据 。 使 用 名 有 编译 绑 定 的 高 级 绑 定 特性 ， 创 建 
文本 流 ， 并 使 用 AutoSuggestBox 目 动 完成 用 户 输入 。 
下 面 先 讨论 Windows 应 用 程序 的 生命 周期 ， 它 不 同 于 传统 的 提 面 应 用 程序 的 生命 周期 。 


36.2 ”应 用 程序 的 生命 周期 


Windows 8 为 应 用 程序 引入 了 一 个 新 的 生命 周期 , 完全 不 同 于 传统 的 桌面 应 用 程序 的 生命 周期 ,在 Windows 
8.1 中 有 些 变 化 ， 在 Windows 10 中 又 有 一 些 变化 。 如 果 使 用 Windows10 和 平板 电脑 模式 ， 应 用 程序 的 生命 周期 
与 桌面 模式 是 不 同 的 。 在 平板 电脑 模式 中 ， 应 用 程序 通常 全 屏 显 示 。 分 离 键盘 (对 于 平板 电脑 设备 ， 如 Microsoft 
Surface)， 或 在 Action Center 中 使 用 Tablet Mode 按钮 ， 可 以 自动 切换 到 平板 模式 。 在 平板 模式 下 运行 应 用 程序 
时 ， 如 果 应 用 程序 进入 后 台 ( 用 户 切换 到 男 一 个 应 用 程序 )， 就 会 暂停 ， 它 不 会 得 到 任何 更 多 的 CPU 利用 率 。 这 
样 ， 应 用 程序 不 消耗 任何 电力 。 应 用 程序 在 后 台 时 ， 只 使 用 内 存 ， 一 旦 用 户 切 换 到 这 个 应 用 程序 ， 应 用 程序 就 
再 次 激活 。 

当 内 存 资源 短缺 时 ，Windows 可 以 终止 暂停 应 用 程序 的 进程 ， 从 而 终止 该 应 用 程序 。 应 用 程序 不 会 收 到 任 
何 消息 ， 所 以 不 能 对 此 事件 做 出 反应 。 因 此 ， 应 用 程序 应 该 在 进入 暂停 模式 前 做 一 些 处 理工 作 ， 保 存 其 状态 。 
等 到 应 用 程序 终止 时 进行 处 理 就 晚 了 。 

当 收 到 暂停 事件 时 ， 应 用 程序 应 该 将 其 状态 存储 在 磁盘 上 。 如 果 再 次 启动 应 用 程序 ， 应 用 程序 可 以 显示 给 
用 户 ， 好 像 它 从 未 终止 。 只 需要 把 页 面 堆 栈 的 信息 存储 到 用 户 退 出 的 页 面 上 ， 恢 复 页 面 堆栈 ， 并 把 字段 初始 化 
为 用 户 输入 的 数据 ， 就 允许 用 户 返 回 。 

本 节 的 示例 应 用 程序 ApplicationLifetime 就 完成 这 个 任务 。 在 这 个 程序 中 ， 人 允许 在 多 个 页 面 之 间 的 导航 ， 
可 以 输入 状态 。 应 用 程序 暂停 时 ， 存 储 页 面 堆栈 和 状态 ， 在 启动 应 用 程序 时 恢复 它们 。 


36.2.1 应 用 程序 的 执行 状态 


应 用 程序 的 状态 使 用 ApplicationExecutionState 枚 举 定 义 。 该 枚 举 定 义 了 NotRunning、Running、Suspended、 
Terminated 和 ClosedByUser 状态 。 应 用 程序 需要 知道 并 存储 目 己 的 状态 ， 因 为 用 户 在 返回 应 用 程序 时 希望 继续 
原来 的 操作 。 

在 App 类 的 OnLaunched 方法 中 , 可 以 使 用 LauchActivatedEventArgs 参数 的 PreviousExecutionState 属性 获取 应 
用 程序 的 前 一 个 执行 状态 。 如 果 应 用 程序 是 在 安装 后 第 一 次 月 动 ， 在 重 局 计算 机 后 启动， 或 者 用 户 上 一 次 在 任 
务 管 理 器 中 终止 了 其 进程 ， 那 么 该 应 用 程序 的 前 一 个 状态 是 NotRunning。 如 果 用 户 单 击 应 用 程序 的 图 标 时 应 用 
程序 已 经 激活 ， 或 者 应 用 程序 通过 茶 个 激活 协定 激活 ， 则 其 前 一 个 执行 状态 为 Running。 如 果 应 用 程序 被 暂停 ， 
那么 激活 它 时 PreviousExecutionState 属性 会 返回 Suspended。 一 般 来 说 ， 在 这 种 情况 中 不 需要 执行 什么 特殊 操 
作 。 因 为 状态 仍 在 内 存 中 可 用 。 在 暂停 状态 下 ， 应 用 程序 不 使 用 CPU 循环 ， 也 没有 磁盘 访问 。 


注意 : 

应 用 程序 可 以 实现 一 个 或 多 个 协定 ， 然 后 用 其 中 一 个 协定 激活 应 用 程序 。 这 类 协定 的 一 个 例子 是 共享 。 使 
用 这 个 协定 ， 用 尸 可 以 共享 另 一 个 应 用 程序 中 的 一 些 数 据 ， 并 使 用 它 作 为 共享 目标 ， 局 动 一 个 Windows 应 用 程 
序 。 实 现 共 享 协定 参见 本 章 的 “共享 数据 ”一 节 。 


36.22 在 页 面 之 间 导 航 


展示 Windows 应 用 程序 生命 周期 的 示例 应 用 程序 (ApplicationLifetime) 从 Blank App 模板 开始 。 创建 项 目 后 ， 
添加 页 面 Pagel 和 Page2， 实 现 页 面 之 间 的 导航 。 

在 MainPage 中 , 添加 两 个 按钮 控件 来 导航 Page2 和 Pagel1， 再 添加 两 个 文本 框 控件 , 在 导航 时 传递 数据 ( 代 
码 文 件 ApplicationLifetime/MainPage.xaml): 
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<Button Content="Page 1"” Click="{x:Bind GotoPagel, Mode=OneTime}" 
Grid.Row="1" /> 

<TextBox Header="Parameter 1™" Text="{x:Bind ParameterPagel, Mode=TwoWay}™" 
Grid.Row="1" Grid.Ccolumn="1" /> 

<Button Content="Page 2" Click="{x:Bind GotoPage?, Mode~=~OneTime}™" 
Grid.Row="2" /> 

<TextBox Header="Parameter 2"” Text="{xX:Bind Parameter?2, Mode=TwoWay}" 
Grid.Row="2" Grid.Column="1" /> 


代码 隐藏 文件 包含 事件 处 理 程 序 、 Pagel 和 Page2 的 导航 代码 , 以 及 参数 的 属性 (代码 文件 ApplicationLifetime/ 
MainPage.xaml.cs): 


Public void GotoPagel () => 
Frame .Navigate (tvypeof (Pagel), ParameterPagel).; 


public string ParameterPagel { get; set; } 


Public void GotoPage2 () => 
Frame.Navigate (tvypeof (Page2), ParameterPage2).; 


Public string ParameterPage2?2 { get; set; } 

Pagel 的 民 元 素 显 示 在 导航 到 这 个 页 面 时 接收 到 的 数据 、 允 许 用 户 导 航 到 Page2 的 按钮 ,以 及 允许 用 户 输 
入 一 些 状 态 信 息 的 一 个 文本 框 ， 应 用 程序 终止 时 会 保存 这 些 状态 信息 (代码 文件 ApplicationLifetime/ 
Pagel.xaml): 


<TextBlock Text="Page 1" Style="{StaticResource HeaderTextBlockstyle}™ /> 
<TextBlock Grid.Row="1" Text="{xX:Bind RecelvedContent, Mode=OneTime}" 
style="{StaticResource BodyTextBlockstyle}" Margin=12 /> 
<TextBox Grid.Row="2" Text="{Xx:Bind Parameterl, Mode=TwoWay}™" /> 
<Button Grid.Row="3" Content="Navigate to Page 2" 
Click="{x:Bind GotoPage?2, Mode=OneTime}™ /> 
<TextBox Header="Session State 1™ Grid.Row="4" 
Text="{xX:Bind Data.Sessionl, Mode=TwoWay}" /> 
<TextBox Header="Session State 2"™ Grid.Row="5" 
Text="{Xx:Bind Data.Session?2, Mode=TwoWay}" /> 


类 似 于 MainPage, Pagel 的 导航 代码 为 导航 时 传递 的 数据 定义 了 一 个 目 动 实现 的 属性 , 和 实现 导航 到 Page2 
的 一 个 事件 处 理 程序 (代码 文件 ApplicationLifetime/Pagel.xaml.cs): 

public void GotoPage2 () => Frame.Navigate (typeof(Page2)，Parameter1) ; 

public string Parameterl { get; set; } 

在 代码 隐藏 文件 中 ， 导 航 参 数 在 OnNavigatedTo 方法 的 重 写 版 本 中 接收 。 接 收 到 的 参数 分 配给 目 动 实现 的 
属性 ReceivedContent( 代 码 文 件 ApplicationLifetimeSample/Page1.xamlcs): 


protected override void OnNavigatedTo (NavigationEventArgs e) 
{ 
base .OnNavigatedTo (e}).; 
1 。 
RecelvedContent = e.Parameter?.ToString{() ?2? string.Empty; 
Bindings.Update (}); 
} 


public string Receivedcontent { get; private set; } 

在 导航 的 实现 代码 中 ，Page2 非常 类 似 于 Pagel， 所 以 这 里 不 重复 它 的 实现 。 

使 用 第 33 章 介绍 的 系统 后 退 按钮 ， 这 里 ， 后 退 按钮 的 可 见 性 和 处 理 程序 在 类 BackButtonManager 中 定义 。 
如 果 框 架 实例 的 CanGoBack 属性 返回 tme， 那 么 构造 函数 的 实现 代码 使 后 退 按 钮 可 见 。 如 果 堆 栈 可 用 ， 就 实现 
OnBackRequested 方法 ， 返 回 页面 堆 栈 (代码 文件 ApplicationLifetime/Utilities/BackButtonManager.cs): 

ee class BackButtonManager: IDisposable 


private SystemNavigationManager navigationManager; 
private Frame Eramer 


Public BackButtonManager (Frame frame) 
{ 
frame = frame ?3 throw new ArgumentNullException (nameof (frame) ); 
navigationManager = SystemNavigationManager.GetForCurrentView():; 
navigatlionManager.AppViewBackButtonVisibility = frame.CanGoBack ?2 
ApPViewBackButtonVisibility.Visible: 
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AppViewBackButtonVisibility.Collapsed; 
navigationManager.BackRequested += OnBackRequested; 
} 


private void OnBackRequested (object sender, BackRequestedEventArgs e) 
{ 

i 王 ( frame.CcanGoBack) frame.GoBack(),; 

e.Handled = true; 


} 


public void Dispose({) 
{ 
navigationManager.BackRequested -= OnBackRequested; 
} 
} 


在 所 有 页 面 中 ， 通 过 在 OnNavigatedTo 方法 中 传递 Frame 来 实例 化 BackButtonManager， 它 在 
OnNavigatedFrom 方法 中 销毁 (代码 文件 ApplicationLifetime/MainPage.xaml.cs): 


private BackButtonManager backButtonManager; 
protected override void OnNavigatedTo (NavigationEventArgs e) 
{ 
base.OnNavigatedTo (e);} 
backButtonManager = new BackButtonManager (Frame}; 
} 


protected override void OnNavigatingFrom(NavigatingCancelEventArgs e) 
{ 

base.OnNavigatingFrom(e).; 

backButtonManager.Dispose(); 
} 


有 了 所 有 这 些 代 码 ， 用 户 可 以 在 3 个 不 同 的 页 面 之 间 后 退 和 前 进 。 下 一 步 需 要 记 住 页 面 和 页 面 堆栈 ， 把 应 
用 程序 导航 到 用 户 最 近 一 次 访问 的 页 面 上 。 


36.3 “导航 状态 


为 了 存储 和 加 载 导 航 状 态 ， 类 NavigationSuspensionManager 定义 了 方法 SetNavigationStateAsync 和 
GetNavigationStateAsync。 导 航 的 页 面 堆 栈 可 以 在 单个 字符 串 中 表示 。 这 个 字符 串 写 入 本 地 缓存 文件 中 ， 用 一 个 
弟 数 给 它 命 名 。 如 果 应 用 程序 以 前 运行 时 文件 已 经 存在 ， 就 覆 兹 它 。 不 需要 记 住 应 用 程序 多 次 运行 之 间 的 页 面 
导航 (代码 文件 ApplicationLifetime/Utilities/NavigationSuspensionManager.cs): 


Public class NavigationSsuspensionManager 
{ 
private const string NavigationstateFlile = "Navigationstate.txt"; 
public async Task SetNavigationstateAsync (string navigationstate) 
{ 
StorageFile file = await 
ApplicationData.Current.LocalCacheFolder.CreateFileAsync! 
NavigationstateFile, CreationCollisionOoption.ReplaceExisting).; 
Stream stream = await fjle.openSstreamForWriteAsync (); 
US1Ing (Var writer = new StreamHriter (stream)) 
{ 
awalit writer.WriteLineAsync (navigationstate).,; 
} 
} 


public async Task<string> GetNavigationstateAsync() 
{ 
stream stream = await 
ApplicationData.Current.LocalCacheFolder.OpenstreamForReadAsyncl 
NavigationstateFile); 
UslIno (var reader = new StreamReader (stream)) 
{ 
return await reader.ReadLineAsync(}); 


} 
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注意 : 
NavigationSuspensionManager 类 利用 Windows 运行 库 API 和 .NET 的 Stream 类 读 写 文件 的 内 容 。 这 两 个 功 
能 详 见 第 22 章 。 


36.3.1 暂停 应 用 程序 


为 了 在 暂停 应 用 程序 时 保存 状态 ， 在 OnSuspending 事件 处 理 程序 中 设置 App 类 的 Suspending 事件 。 当 应 
用 程序 进入 暂停 模式 时 触发 事件 (代码 文件 ApplicationLifetime/App.xamlcs): 

public App() 

this.InitializeComponent (); 


this.Suspending += OnSsuspending; 
} 


OnSuspending 是 一 个 事件 处 理 程 序 方法 ， 因 此 声明 为 返回 void。 这 有 一 个 问题 。 只 要 方法 完成 ， 应 用 程序 
就 可 以 终止 。 然而 ， 因 为 方法 声明 为 void， 所 以 不 可 能 等 待 方法 完成 。 因 此 ， 收 到 的 SuspendingEventArgs 参数 
定义 了 一 个 SuspendingDeferral， 通 过 调用 GetDeferral 方法 可 以 检索 它 。 一 旦 完成 代码 的 异步 功能 ， 需 要 调用 
Complete 方法 来 延迟 。 这 样 ， 调 用 者 知道 方法 已 完成 ， 应 用 程序 可 以 终止 (代码 文件 ApplicationLifetime/ 
App.xaml.cs): 

private async void Onsuspending (object sender, SuspendingEventArgs e) 


Var deferral = e.SuspendingOperation.GetDeferral(); 
ffs 
deferral.Completel().; 

} 


注意 : 
异步 方法 参见 第 15 章 。 


在 OnSuspendimg 方法 的 实现 中 ， 页 面 堆栈 写 入 临时 缓存 。 使 用 Frame 的 BackStack 属性 可 以 在 页 面 堆栈 上 
检索 页 面 。 这 个 属性 返回 PageStackEntry 对 象 的 列表 ， 其 中 每 个 实例 代表 类 型 、 导 航 参 数 和 导航 过 渡 信 息 。 为 
了 用 SetNavigationStateAsync 方法 存储 页 面 跟踪 ， 只 需要 一 个 字符 串 ， 其 中 包 合 完整 的 页 面 堆栈 信息 。 这 个 字 
符 串 可 以 通过 调用 Frame 的 GetNavigationState 方法 来 检索 (代码 文件 ApplicationLifetime/App.xaml.cs ): 


private async void OnSsuspending (object sender, SuspendingEventArgs e) 
{ 
var deferral = e.Suspendingoperation.GetDeferral (); 
var frame = Window.Current.Content as Frame.; 
IE (frame? .BackStackDepth >= 1) 
{ 
Var SuspensionManager = new MavigationSuspensionManager (); 
string navigationSstate = frame .GetNavigationSstate().; 
if (navigationSstate 1= null) 
{ 
await suspensionManager.SetNavigationSstateAsvync (navigationstate).; 
} 


} 

FE 

deferral .complete (); 
} 


默认 情况 下 ， 在 应 用 程序 终止 前 ， 只 暂停 几 秒 钟 。 但 是 ， 可 以 延长 这 个 时 间 ， 以 进行 网 络 调用 ， 从 服务 中 
检索 数据 ， 给 服务 上 传 数 据 ， 或 跟踪 位 置 。 为 此 ， 只 需要 在 OnSuspending 方法 内 创建 一 个 
ExtendedExecutionSession， 设 置 理 由 ， 比 如 ExtendedExecutionReason .SavingData。 调 用 RequestExecutionAsync 
来 请 求 扩 展 。 只 要 没有 拒绝 延长 应 用 程序 的 执行 ， 就 可 以 继续 扩展 的 任务 。 


36.3.2 ”激活 暂停 的 应 用 程序 


GetNavigationState 退回 的 字符 串 用 逗号 分 隔 ， 列 出 了 页 面 堆栈 的 完整 信息 ， 包 括 类 型 信息 和 参数 。 不 应 该 
解析 字符 串 ， 获 得 其 中 的 不 同 部 分 ， 因 为 在 Windows 运行 库 的 更 新 实现 中 ， 这 可 能 会 改变 。 仅 仅 使 用 这 个 字符 
串 恢 复 状 态 ， 用 SetNavigationState 恢复 页 面 堆栈 是 可 行 的 。 如 果 字 符 串 格式 在 未 来 的 版 本 中 有 变化 ， 这 两 个 方 
法 也 会 改变 。 

在 启动 应 用 程序 时 ， 为 了 设置 页 面 堆栈 ， 需 要 更 改 OnLaunched 方法 。 这 个 方法 在 Application 基 类 中 重 写 ， 
在 启动 应 用 程序 时 调用 。 参 数 LaunchActivatedEventArgs 给 出 了 应 用 程序 启动 方式 的 信息 。Kind 属性 返回 一 个 
ActivationKind 枚 举 值 ， 通 过 它 可 以 读 取 应 用 程序 的 局 动 方 式 : 由 用 户 单 击 磁 贴 ， 局 动 一 个 语音 命令 ， 或 在 
Windows 中 启动 ， 例 如 把 它 局 动 为 一 个 共享 目标 。 这 个 场景 需要 PreviousExecutionState， 它 返回 一 个 
ApplicationExecutionState 枚 举 值 , 来 提供 之 前 应 用 程序 结束 方式 的 信息 。 如 果 应 用 程序 用 ClosedByUser 值 结束 ， 
就 不 需要 特殊 操作 ， 应 用 程序 应 重新 开始 。 然 而 ， 如 果 应 用 程序 之 前 是 被 终止 的 ，PreviousExecutionState 就 包 
售 Terminated 值 。 这 个 状态 可 用 于 将 应 用 程序 返回 到 之 前 用 己 退 出 时 的 状态 。 这 里 ， 页 面 堆栈 从 
NavigationSuspensionManager 中 检索 ， 给 方法 SetNavigationState 传递 以 前 保存 的 字符 串 ， 来 设置 根 框架 (代码 文 
件 ApplicationLifetime/App.xamlcs): 

protected override async void OnLaunched (LaunchActivatedEventArgs e) 


Frame rootFrame = Window.Current.Content as Frame; 


if (rootFrame == null) 
{ 
rootFrame = new Frame (); 
rootFrame .NavigationFailed += OnNavigationFailed; 
if (le.PreviousExecutionSstate 一 ApplicationExecutionSstate.Terminated) 
{ 


Var suspensionManager = new NavigationSuspensionManager (); 
string navigationstate = 
await suspensionManager .GetNavigationSstatehsynct(); 
rootFrame .SetNavigationSstate (navigationstate); 
FE 
} 


1 Place the frame in the current Window 
Window.Current.cContent = rootFrame; 
} 
if (rootFrame.Content == null) 
{ 
rootFrame .Navigate (typeof (MainPage), e.Arguments);} 
} 
Window.Current .Bctivate({).; 


} 


36.3.3 ”测试 暂停 


现在 局 动 该 应 用 程序 (参见 图 36-1D)， 导 航 到 另 一 个 页 面 ， 然 后 打开 另 一 个 应 用 程序 ， 并 等 待 前 一 个 应 用 程 
序 终 止 。 如 果 将 Status Values 选项 设置 为 “Show Suspended Status”， 则 可 以 在 任务 管理 器 的 Details 视图 中 看 到 
暂停 的 应 用 程序 。 但 是 ， 在 测试 暂停 时 ， 这 不 是 一 个 简单 的 方法 (因为 应 用 程序 可 能 在 很 人 之 后 才 暂 停 )， 但 可 
以 调试 不 同 的 状态 。 

使 用 调试 器 则 不 同 。 如 果 应 用 程序 一 旦 失去 焦点 就 会 暂停 ， 那 么 每 到 达 一 个 断 点 就 会 暂停 ， 因 此 在 调试 器 
中 运行 时 ， 暂 停 是 被 禁用 的 ， 正 常 的 暂停 机 制 不 会 起 作用 。 但 是 ， 模 拟 暂 停 很 容易 。 打 开 Debug Location 工具 
栏 , 可 以 看 到 3 个 按钮 : Suspend、Resume 和 Suspend and shutdown( 参 见 图 36-2)。 如 果 选 择 Suspend and shutdown， 
然后 再 次 月 动 应 用 程序 ， 那 么 应 用 程序 将 从 前 一 个 状态 ApplicationExecutionState.Terminated 继续 运行 ， 因 此 会 
打开 用 户 之 前 打开 的 页 面 。 
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36.3.4 ”页 面 状态 


用 户 输 入 的 任何 数据 也 应 该 恢复 。 为 了 进行 演示 ， 在 Pagel 上 创建 两 个 输入 字段 (代码 文件 
ApplicationLifetime/Pagel.xaml): 


<TextBox Header="Session State 1™ Grid.Row="4" 
Text="{XxX:Bind Data.Sessionl, Mode=TwoWay}™" /> 
<TextBox Header="Session State 2™ Grid.Row="5" 
Text="{XxX:Bind Data.Session2, Mode=TwoWay}" /> 


这 个 输入 字段 的 数据 表示 由 DataManager 类 定义 ， 从 Data 属性 中 返回 ， 如 下 面 的 代码 片段 所 示 ( 代 码 文件 
ApplicationLifetime/Pagel.xaml.cs): 

public DataManager Data => DataManager.Instance; 

DataManager 类 定义 了 属性 Session1 和 Session2， 其 值 存储 在 Dictionary 中 (代码 文件 ApplicationLifetime/ 
Services/DataManager.cs): 


public class DataManager: INotifyPropertyChanged 
{ 
private const string SessionStateFile = "TempSessionSstate.json™y 
private Dictionary<string, string> state = new Dictionary<string, string>() 
{ 
[nameof (Sessionl})}] = string.Empty, 
[nameof (Session2)] = string.Empty 
上 


private DataManager () 

{ 

} 

PUublic event PropertyChangedEventHandler PropertyChanged; 

protected void OnPropertyCchanged'!l 
[callerMemberName] string propertyName = null) => 
PropertyCchanged? .Invoke (this, new PropertyCchangedEventArgs (propertyName)); 

Public static DataManager Instance 1{ get; } = new DataManager (); 


public string Sessionl 


{ 
get => state[nameof (Session]1)]; 
SS 忆 七 
{ 
state[nameof (Session1)] = value; 
OnPropertycCchanged(}); 
} 
} 


Public string Session2 


{ 
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get => state[nameof (Session2)]; 
Set 
{ 
_state[nameof (Session2)] = Value; 
OnPropertyChanged (}); 
} 


ep 
} 


为 了 加 载 和 存储 会 话 状态 ， 定 义 了 SaveTempSessionAsync 和 LoadTempSessionAsync 方法 。 其 实现 代码 使 
用 Json Net 将 字典 序列 化 为 JSON 格式 。 但 是 ， 可 以 使 用 任何 序列 化 (代码 文件 ApplicationLifetime/Services/ 
DataManager.cs): 


public async Task SaveTempSessionAsynct() 
{ 
storageFile file = 
awalt ApplicationData.Current.LocalCacheFolder.CreaterFileAsyncl 
SessionstateFile, CreationCollisionOption.ReplaceExisting),; 
stream stream = await file.OpenstreamForWriteAsync(); 
var Serializer = new JsonSerializer (); 
USing (Var writer = new StreamWriter (stream)) 
{ 
serlializer.Seriliallze (writer, state)}); 
} 
} 


public async Task LoadTempSessionAsynct() 
{ 
stream stream = awalit 
ApplicationData.Current.LocalCacheFolder.OpenSstreamForReadAsvync( 
SesslonstateFile).; 
var Serializer = new JSsonSerializer(); 
USing (Var reader = new StreamReader (stream)) 
{ 
string json = await reader.ReadLineAsync () ; 
Dictionary<string, string> state = 
JsonConvert.DeserializeObject<Dictionary<string, string>> (json); 
_ state = state,; 
foreach (var item in state) 
{ 
onPropertyChanged (item. Key),; 
} 
} 
} 


注意 : 
XML 和 JSON 的 序列 化 参见 网 上 附加 第 2 章 。 


剩 下 的 就 是 调用 SaveTempSessionAsync 和 LoadTempSessionAsync 方法 ， 暂 停 、 激 活 应 用 程序 。 这 些 方 法 
添加 到 OnSuspending 和 OnLaunched 方法 中 读 写 页 面 堆栈 的 地 方 (代码 文件 Application Lifetime/App.xamlcs): 


private async void Onsuspending (object sender, SuspendingEventArgs e) 
{ 
Var deferral = e.SuspendingOperation.GetDeferral (1) ; 
Pf 
await DataManager. Instance .SaveTempSessionhsvync().; 
deferral.complete(); 
} 


protected override async void OnLaunched (LaunchActivatedEventArgs e) 
{ 


Frame rootFrame = Window.Current.Content as FIrame; 


if (rootFrame == null) 
{ 
rootFrame = new Frame (}).， 
rootFrame .NavigationFailed += OnNavigationFailed; 
if (e.PreviousExecutionSstate == ApplicationExecutionSstate.Terminated) 
{ 
fi/... 


await DataManager. Instance.LoadTlempSessionhsync().; 
} 


/Place the frame in the current Window 
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Window.Current.Content = rootFrame; 
if (rootFrame.Content == null)} 
rootFrame.Navigate (typeof (MainPage), e.Arguments); 
} 


Window.Current.Activate(y):; 


I 
现在 ， 可 以 运行 应 用 程序 ， 在 Page2 中 输入 状态 ， 暂 停 和 终止 程序 ， 再 次 局 动 它 ， 表 次 显示 状态 。 
在 应 用 程序 的 生命 周期 中 ， 需 要 为 Windows 应 用 程序 进行 特殊 的 编程 ， 以 考虑 电池 的 耗费 。 下 一 节 讨 论 在 
应 用 程序 间 共 享 数据 ， 这 也 可 以 用 于 手机 平台 。 


36.4 共享 数据 


如 果 应 用 程序 提供 与 其 他 应 用 程序 的 交互 ， 就 会 更 有 用 。 在 Windows 10 中 ， 应 用 程序 可 以 使 用 拖 放 操作 
共享 数据 ， 甚 至 桌面 应 用 程序 也 这 样 做 。 在 Windows 应 用 程序 之 间 ， 也 可 以 使 用 共享 协定 分 享 数 据 。 

使 用 共享 协定 时 ， 一 个 应 用 程序 (共享 源 ) 可 以 用 许多 不 同 的 格式 共享 数据 ， 例 如 文本 、HIML、 图 片 或 目 
定义 数据 , 用 户 可 以 选择 接收 数据 格式 的 应 用 程序 ,作为 共享 目标 。Windows 使 用 安装 时 应 用 程序 注册 的 协定 ， 
找到 支持 相应 数据 格式 的 应 用 程序 。 


36.4.1 共享 源 


关于 共享 ， 首 先 要 考虑 的 是 确定 哪些 数据 以 何 种 格式 共享 。 可 以 共享 简单 文本 、 富 文本 、HIML 和 图 像 ， 
也 可 以 共享 自 定义 类 型 。 当 然 ， 其 他 应 用 程序 ( 即 共享 目标 ) 必 须知 道 日 能 使 用 所 有 这 些 类 型 。 对 于 自 定义 类 型 ， 
只 有 知道 该 类 型 晶 是 该 类 型 的 共享 目标 的 应 用 程序 才能 共享 它 。 示 例 应 用 程序 提供 了 文本 格式 的 数据 和 HTML 
格式 的 图 书 列表 。 

为 了 用 HTML 格式 提供 图 书信 息 ， 定 义 了 一 个 简单 的 Book 类 (代码 文件 SharingSource/Models/Book .cs): 


public class Book 
{ 
Public string Title { get; set; } 
Public string Publisher { get; set; } 
} 


Book 对 象 列表 从 BooksRepository 类 的 GetSampleBooks 方法 中 返回 (代码 文件 SharingDate/SharingSourcey 
Models/BooksRepository.cs): 
Public class BooksRepository 


public IEnumerable<Book> GetSampleBooks'() => 
new List<Book> (1) 


new Book 
{ 
Title = "Professional C# 7 and -NET Core 2"， 
Fublisher = "Wrox Press"™ 
}, 
new Book 
{ 
Title = "Professional C# 6 and -NET Core 1.0", 
Eublisher = "Wrox Press" 
} 
}s 
} 


要 把 Book 对 象 列表 转换 为 HTML， 扩 展 ToHtml 方法 通过 LINQ to XML 返回 一 个 HTML 表 ( 代 码 文件 
SharineData/SharineSource/Utiities/BooksExtenslions.cs): 
Public static class BookExtensions 
Public static string ToHtml (this IEnumerable<Book> books) => 


new KElement ("table™., 
new XElement ("thead™, 
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new XElement ("tr™, 
new XElement ("td", "Title™), 
new XElement ("td", "Publisher™))}), 
books.Select (bb => 
new XElement ("tr™, 
new XElement ("td", b.Title), 
new XElement ("td", b.Publisher)})}) .Tostring(); 


注意 : 
LINQ to XML 参见 网 上 附加 第 2 章 。 


在 Mainpage 中 定义 了 一 个 按钮 ， 用 户 可 以 通过 它 启动 共享 ， 再 定义 一 个 文本 框 控件 ， 供 用 户 输入 要 共享 
的 文本 数据 (代码 文件 SharingData/Share Source/MainPage.xaml): 
<RelativePanel Margin="24"> 
<Button x:Name="shareDataButton™”" Content="Share Data™ 
Click="{x:Bind DataSsharing.ShowShareUI, Mode=OneTime}" Margin="12" /> 
<TextBox RelativePanel .Rightof="shareDataButton"™ 
Text="{XxX:Bind Datasharing.SimpleText, Mode=TwoWay}" Margin="12" /> 
</RelativePanel> 


在 代码 隐藏 文件 中 ，DataSharing 属性 返回 ShareDataViewModel， 其 中 实现 了 所 有 重要 的 分 享 功能 (代码 文 
件 SharingData/Share Source/MainPage.xaml.cs): 

public ShareDataViewModel DataSharing { get; set; } = new ShareDataViewModel (); 

ShareDataViewModel 定义 了 XAML 文件 绑 定 的 属性 SimpleText， 用 于 输入 要 共享 的 简单 文本 。 对 于 分 享 ， 
把 事件 处 理 程序 方法 ShareDataRequested 分 配给 DataTransferManager 的 事件 DataRequested。 用 户 请 求 共享 数据 
时 ， 触 发 这 个 事件 (代码 文件 SharingData/Share Source/ViewModels/ShareDataViewModel.cs): 


Public class ShareDataVviewModel 


{ 
Public ShareDataViewModel () 
{ 
DataTransferManager.GetForCurrentView!() .DataRequested 十 = 
shareDataRequested; 
} 
public string SimpleText { get; Set } = string.Empty; 
| 
} 


当 触 发 事件 时 ， 调 用 OnShareDataRequested 方法 。 这 个 方法 接收 DataTransferManager 作为 第 一 个 参数 ， 
DataRequestedEventArgs 作为 第 二 个 参数 。 在 共享 数据 时 ， 需 要 填充 args.Request.Data 引用 的 DataPackage。 可 
以 使 用 Titte、Description 和 Thumbnail 属性 给 用 户 界 面 提供 信息 。 应 共享 的 数据 必须 用 一 个 SetXXX 方法 传递 。 
示例 代码 分 享 一 个 简单 的 文本 和 HTML 代码 ,因此 使 用 方法 SetText 和 SetHtmlFormat。HtmlFormatHelper 类 帮 
助 创建 需要 共享 的 HTML 代码 .图 书 的 HIML 代码 用 前 面 的 扩展 方法 ToHtml 创建 (代码 文件 SharingData/Share 
Source/ViewModels/ShareDataViewModel.cs): 


private void ShareDataRequested (DataTransferManager sender, 
DataRequestedEventArgs args) 
{ 
Var books = new BooksRepository!() .GetsampleBooks (); 
Uri baseUri = new Uri("ms-appx:///"):; 
DataPackage package = args .Request.Data; 
Package .Properties.Title = "Sharing Sample™; 
package .Properties .Description = "Sample for sharing data".; 
Package .Properties.Thumbnail = RandomAccessSstreamReference.CreateFromUril 
new Uri(baseUri, "Assets/Squared4x44Logo .png")); 
Package .SetTlText (SimpleText) ; 
package .SetHtmlFormat (HtmlFormatHelper.CreateHtmlFormat (books.ToHtml ())).; 
} 


如 果 需 要 共享 操作 何 时 完成 的 信息 ， 例 如 从 源 应 用 程序 中 删除 数据 ，DataPackage 类 就 触发 
OperationCompleted 和 Destroyed 事 件 。 
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注意 : 
除了 提供 文本 或 HIML 代码 之 外 , 其 他 方法 , 比如 SetBitmap、SetRtf 和 SetUri, 也 可 以 提供 其 他 数据 格式 。 


注意 : 

如 果 需 要 在 ShareDataRequested 方法 中 使 用 异步 方法 构建 要 共享 的 数据 ， 需 要 使 用 一 个 延期 ， 在 数据 可 用 
时 提供 信息 。 这 类 似 于 本 章 前 面 介 绍 的 页 面 暂 停机 制 。 使 用 DataRequestedEventArgs 类 型 的 Request 属性 ， 可 
以 调用 GetDeferral 方法 。 这 个 方法 返回 一 个 DataRequestedDeferral 类 型 的 延期 。 使 用 这 个 对 象 ， 可 以 在 数据 可 
用 时 调用 Complete 方法 。 


最 后 ， 需要 显示 分 享 的 用 户 界 面 。 这 人 允许 用 户 选 择 目 标 应 用 程序 : 
Public void ShowShareUI ()} 

DataTransferManager .ShowShareUI(); 
} 


图 36-3 展示 了 调用 DataTransferManager 的 ShowShareUI 方法 后 的 用 户 界 面 。 根 据 所 提供 的 数据 格式 和 安 
装 的 应 用 程序 ， 显 示 相 应 的 应 用 程序 ， 作 为 选项 。 从 Windows 10 的 Fall Creators Update (构建 号 16299) 版 本 开 
始 ， 不 仅 可 以 看 到 应 用 程序 ， 还 可 以 看 到 一 些 联 系 人 。 选 择 联系 人 时 ， 可 以 使 用 应 用 程序 与 联系 人 通信 ， 直 接 
与 联系 人 共享 数据 。 

如 果 选 择 Mail 应 用 ， 就 传递 HIML 信息 。 图 36-4 显示 在 这 个 应 用 程序 中 接收 的 数据 。 


Format Insert Dptions 四 Discard ”各 Send 


From: chnstiannagel®@LNYVECOM = 


chare To: chnstian@chnstiannagel.com; 内 Ce & Bec 
Shanng ampe sharing $ample 


sample for shanng da 二 


Title Publisher 


Professiaonal C# 7 and ,NET Caore 2 Wrox Press 
professional C# 6 and .NET Core 1.0 Wrox press 


he Angela Charlotte Be Professianal C# 5.0 and .ET 4.5.1 Wrox Press 


Nagel Nagel Kughen Schrnidt 
sent from Mail for Windows 10 


OneMote skype 


向 Get apps in Store 
图 36-3 图 36-4 
注意 : 


共享 数据 最 初 是 在 Windows 8 中 使 用 功能 区 设计 的 。 用 户 必 须 从 右边 滑动 来 访问 共享 特性 。 许 多 用 户 无 法 
找到 这 个 功能 。 对 于 Windows 10， 需 要 显 式 地 提供 一 个 可 见 控 件 (例如 ， 按 钮 )， 用 户 可 以 在 其 中 开始 共享 。 
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36.4.2 共享 目标 


现在 看 看 共享 内 容 的 接收 者 。 如 果 应 用 程序 应 从 共享 源 中 接收 信息 ， 就 需要 将 其 声明 为 共享 目标 。 图 36-5 
显示 了 清单 设计 器 在 Visual Studio 中 的 Declarations 页 面 ， 在 其 中 可 以 定义 共享 目标 。 在 这 里 添加 Share Target 
声明 ， 它 至 少 要 包含 一 种 数据 格式 。 可 能 的 数据 格式 是 Text、URI、Bitmap、HTML、Storageltems 或 RIF。 还 
可 以 添加 文件 扩展 名 ， 以 指定 应 支持 哪些 文件 类 型 。 

在 注册 应 用 程序 时 ， 要 使 用 软件 包 清 单 中 的 信息 。 这 告诉 Windows， 哪 些 应 用 程序 可 用 作 共 享 目标 。 示 例 
应 用 程序 SharingTarget 为 Text 和 HTML 定义 了 共享 目标 。 

用 户 把 应 用 程序 局 动 为 共享 目标 时 ， 就 在 App 类 中 调用 OnShareTargetActivated 方法 ， 而 不 是 OnLaunched 
方法 。 这 里 创建 另 一 个 页 面 (ShareTargetPage)， 显 示 用 户 选择 这 款 应 用 程序 作为 共享 目标 时 的 屏幕 (代码 文件 
SharineData/ShareTarget/App.xaml.cs): 


protected override void OnshareTargethActivated ! 
ShareTargetActivatedEventArgs args) 

{ 
Frame IOQOtFIrame = CreateRootrFrame (). 
rootFrame.Navigate (typeof (ShareTargetPage), args.ShareOperation); 
Window.Current.Activate (); 


Application Visual Assets Capabilities Declarations Content URIs Packaging 


IT Dioperntes 


hvuallable Declarations: 
| select Ng,. ; 
Only ene instance 

Mere inferrmatiorn 

Properties: 

Share description: |A list of books 


Data forrmats 


Data format 


Dats format |Text 


Dats format 


Data format | HTRIL 


FT 


Supported file types 
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为 了 不 在 两 个 不 同 的 地 方 创建 根 框 架 ， 应 该 重 构 OnLaunched 方法 ， 把 框架 创建 代码 放 在 一 个 单独 的 方法 
CreateRootFrame 中 。 这 个 方法 在 OnShareTargetActivated 和 OnLaunched 中 调用 : 


private Frame CreateRootFrame () 
{ 
Frame rootFrame = Window.Current.Content as Frame; 
if (rootFrame == null) 
{ 
rootFrame = new Frame'(}).: 
rootFrame .NavigationFailed += OnNavigationFailed; 
Window.Current.Content = rootFrame; 
} 


return rootFrame; 


第 36 章 高 级 Windows 应 用 程序 | 987 


OnLaunched 方法 的 变化 如 下 所 示 。 与 OnShareTargetActivated 相反 ， 这 个 方法 导航 到 MainPage: 


protected override void OnLaunched (LaunchActivatedEventArgs e) 
{ 
Frame rootFrame = CreateRootFrame (}; 
1if (Ile.PreLaunchActivated) 
{ 
if (rootFrame.Content == null) 
{ 
rootFrame.Navigate (typeof (MainPage)}, e.Arguments); 
} 
Window.Current.Activate(}).: 
} 
} 


ShareTargetPage 包含 控件 ， 用 户 可 以 在 其 中 看 到 共享 数据 的 信息 ， 如 标题 和 插 述 ， 还 包括 一 个 组 合 框 ， 显 
示 了 用 户 可 以 选择 的 可 用 数据 格式 (代码 文件 SharineData/SharingTarget/ShareTargetPage.xaml): 


<StackPanel Orlientation="Vertical™> 
<TextBlock Text="Share Target Page™ /> 
<TextBox Header="Title" IsReadonly="True" 
Text="{Xx:Bind ViewModel .Title, Mode~=~OneWay}" Margin="12" /> 
<TextBox Header="Description™" IsReadonly="True™ 
Text="{x:Bind ViewModel .Description, Mode=OneWay}" Margin="12"™" /> 
<ComboBox ItemsSource="{x:Bind ViewModel .ShareFormats, Mode=OQneTime}" 
SelectedItem="{XxX:Bind ViewModel .SelectedFormat, Mode=TwoWay}" 
Margin="12" /> 
<Button Content="Retrieve Data™ 
Click="{x:Bind ViewModel.RetrieveData, Mode=OneTime}" Margin="12"™ /> 
<Button Content="Report Complete™ 
Click="{x:Bind ViewModel .ReportCcompleted, Mode~OneTime}" Margin="12"™" /> 
<TeExtBox Header="Text™" IsReadonly="True™ 
Text="{Xx:Bind ViewModel .Text, Mode=OneWay}" Margin="12"™ /> 
<TextBox AcceptsReturn="TIrue™”" IsReadonly="TIrue™ 
Text="{x:Bind ViewModel .Html, Mode~OneWay}" Margin="12" /> 
</StackPanel> 


在 代码 隐藏 文件 中 ， 把 ShareTargetPageViewModel 分 配给 ViewModel 属性 。 在 前 面 的 XAML 代码 中 ， 这 
个 属性 使 用 了 编译 绑 定 。 另 外 在 OnNavigatedTo 方法 中 ， 把 ShareOperation 对 象 传递 给 Activate 方法 ， 激活 
SharedTargetPageViewModel (代码 文件 SharineTarget/ShareTargetPage.xaml.cs): 


Public sealed partial class ShareTargetPage: PEage 
{ 
Public ShareTargetPage () => InitializeComponent(); 


public ShareTargetPageViewModel ViewModel { get; } = 
new ShareTargetPageViewModel (); 


protected override void OnNavigatedTo (NavigationEventArgs e) 
{ 
ViewModel .nctivate(e.Parameter as ShareOperation); 
base .OnNavigatedTo (e),;} 
} 
} 


类 ShareTargetPageViewModel 为 应 该 显示 在 页 面 中 的 值 定 义 了 属性 , 还 实现 INotifyProperty Changed 接口 ， 
为 更 改 通 知 定 义 了 属性 (代码 文件 SharingTarget/ViewModels/ShareTargetViewModel.cs): 


Public class ShareTargetPageViewModel: INotifyPropertyChanged 
{ 


Public event PropertyChangedEventHandler PropertyChanged; 


Public void OnPropertyChanged'l 
[CcallerMemberName] string propertyName = null) => 
PropertyCchanged? .Invoke (this, new PropertyCchangedEventArgs (propertyName)); 


PUublic Vvoid Set<T> (ref T item, T Value， 
[CallerMemberName] string propertyName = null) 
{ 
if (!EqualityComparer<T>.Default.Equals (item, value)) 
{ 
item = value; 
OnPropertyChanged (propertyName); 
} 
} 


988 | 第 部 分 应 用 程序 


了 


private string text; 
public string Text 
1 
get => text; 
set => Set (Te text, value); 


} 


private string html; 
public string Html 


get =»> html; 
set => Setl(ref html, value); 


private string titles 
public string Title 


get => Es 
set => Setl(ref title, value); 


private string description; 
public string Description 


get => description; 
set => Setl(ref description, value); 


Activate 方法 是 ShareTargetPageViewModel 的 一 个 重要 部 分 。 这 里 ，ShareOperation 对 象 用 于 访问 共享 数据 
的 信息 ， 得 到 一 些 可 用 于 显示 给 用 户 的 元 数据 ， 如 Title、Description 和 可 用 数据 格式 的 列表 。 如 果 出 错 ， 就 调 
用 ShareOperation 的 ReportError 方法 , 把 错误 信息 显示 给 用 户 (代码 文件 SharingTarget/ViewModels/ShareTarget- 
ViewModel.cs): 


public class ShareTargetPageViewModel: INotifyPropertyChanged 
{ 
i 
private ShareOperation shareOperation; 
private readonly ObservableCollection<string> shareFormats = 
new ObservableCollection<string> (); 
public string SelectedFormat { get; set; } 
Public IEnumerable<string> ShareFormats => shareFormats; 


public void Activate (ShareOperation shareOQOperation) 
{ 
if (shareOperation == null) 
throw new ArgumentNullException (nameof (shareOperation)); 


string title = null; 
string description = null; 
try 
{ 
_shareOperation = shareQperation,; 
title = shareQOperation.Data.Properties.Title, 
description = shareOperation.Data.Properties .Description; 
foreach (Var format in shareQOperation.Data.AvailableFormats) 
{ 
_shareFormats .Add (format); 
} 
Title = title; 
Description = description; 
} 
catch (Exception ex) 


{ 
shareOperation.ReportError (ex .Message).; 
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一 旦 用 户 选 择 数 据 格式 ， 可 以 单 击 按钮 ， 检索 数据 。 这 会 调用 RetrieveData 方法 。 根 据 用 户 的 选择 ， 在 
Data 属性 返回 的 DataPackageView 实例 上 调用 GetTextAsync 或 GetHtmlFormatAsync。 在 检索 数据 前 ， 调 用 
方法 ReportSstarted; 检索 到 数据 后 ， 调 用 方法 ReportDataRetrieved( 代 码 文 件 SharingTarget/ViewModels/ 
ShareTareetViewModel.cs): 


Public class ShareTargetPageViewModel: INotifyPropertyCchanged 
{ 
FF 
private bool dataRetrieved = false; 
Public async void RetrieveData() 
{ 
try 
{ 
if (dataRetrieved) 
{ 
await new MessageDialog("data already retrieved") .ShowasyYynec () ; 
} 
shareOperation.Reportstarted (}); 
switch (SelectedFormat) 
{ 
CaSe "Text™: 
Text = awalt shareOperation.Data.GetTextAsync (}; 
break; 
Case "HTML Format™: 
Html = await shareOperation.Data.GetHtmlFormatAsync(); 
break; 
default: 
break; 
} 
shareOperation.ReportDataRetrieved()}; 
dataRetrieved = true; 
} 
catch (Exception ex) 
{ 
shareOperation.ReportError (ex.Message); 
} 
} 
2 
} 


在 示例 应 用 程序 中 ， 检 索 到 的 数据 显示 在 用 户 界 面 中 。 在 真正 的 应 用 程序 中 ， 可 以 使 用 任何 形式 的 数据 ， 
例如 ， 把 它 本 地 存储 在 客户 端 上 ， 或 者 调用 目 己 的 Web 服务 并 给 它 传递 数据 。 

最 后 ， 用 户 可 以 在 UI 中 单 击 Report Completed 按钮 。 通 过 Click 处 理 程 序 ， 会 在 视图 模型 中 调用 
ReportCompleted 方法 ， 进 而 在 ShareOperation 实例 上 调用 ReportCompleted 方法 。 这 个 方法 关闭 对 话 框 (代码 文 
件 SharingTarget/ViewModels/ShareTareetViewModel.cs): 


Public class ShareTargetPageViewModel: INotifyPropertyCchanged 
{ 

ff - 

Public void ReportCcompleted() 

{ 

shareOperation.ReportCompleted (); 

} 

FF 
} 


在 应 用 程序 中 ， 可 以 在 检索 数据 之 后 调用 前 面 的 ReportCompleted 方法 。 只 要 记 住 ， 应 用 程序 的 对 话 框 关 
闭 时 ， 调 用 此 方法 。 

要 激活 ShareTarget 应 用 程序 ， 需 要 运行 ShareTarget 应 用 程序 一 次 ， 将 其 注册 为 一 个 共享 源 。 然 后 ， 再 次 
启动 ShareSource 应 用 程序 。 现 在 ， 共 享 数据 时 ，ShareTarget 被 列 为 一 个 可 供 选 择 的 应 用 程序 。 选 择 此 应 用 程 
序 ， 就 会 看 到 正在 运行 的 ShareTarget 应 用 程序 ， 如 图 36-6 所 示 。 
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Share Target 


Share Target Page 


Title 
Description 
| sample for sharing data 
| Text > 
Retriewe Data 
Report Complete 


Text 
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注意 : 

测试 分 享 所 有 支持 格式 的 最 佳 方法 是 使 用 示例 应 用 程序 的 Sharing Content Source 示例 和 Sharing Content 
Target 示例 。 两 个 示例 应 用 程序 都 在 https://github.com/Microsoft/ Windows-universal-samples 上 。 如 果 把 其 中 一 
个 应 用 程序 作为 共享 源 ， 就 使 用 另 一 个 示例 应 用 程序 作为 目标 ， 反 之 亦 然 。 


注意 : 

调试 共享 目标 的 一 个 简单 方法 是 把 Debug 选项 设置 为 Do not launch, but debug my code when it starts。 这 个 
设置 在 Project Properties 的 Debug 选项 卡 ( 参 见 图 36-7) 中 。 使 用 此 设置 ， 可 以 局 动 调试 器 ,一 旦 与 这 款 应 用 程序 
共享 数据 源 应 用 程序 中 的 数据 ， 应 用 程序 就 启动 。 将 共享 和 目标 应 用 程序 都 设置 为 使 用 调试 器 局 动 ， 目 标 应 用 
程序 在 作为 共享 目标 激活 后 立即 启动 。 


Application Configuration: Active (Debug) = Platiorm Active (x86) 
Build 
Build Events 
Debue start actian 
Reference Paths De naot launeh, but debug my code when lt starts 
slgnin 
3 "9 Allow local network loopback 
Code Analysis 
Start options 

Target devlce: Lacal hlachine 

Remaote machine: 

Authentication Mode: Wimdaws 


Command line 
arguments: 


L] Uninstall and then re-install my package. All informatian about the application state is deleted 
口 Deploy optional packages 
Debugger type 


Applicatian process: Managed Only 


Background task process: Managed Only 
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36.5 ”应 用 程序 服务 


在 应 用 程序 之 间 共 享 数 据 的 另 一 种 方法 是 使 用 应 用 程序 服务 。 应 用 程序 服务 可 以 与 调用 Web 服务 相 媲美 ， 
但 对 用 户 的 系统 而 言 ， 服 务 是 本 地 的 。 多 个 应 用 程序 可 以 访问 相同 的 服务 ， 这 是 在 应 用 程序 之 间 共 享 信息 的 
方式 。 应 用 服务 和 Web 服务 之 间 的 一 个 重要 区 别 是 ， 用 户 不 需要 使 用 这 个 特性 进行 交互 ， 而 可 以 在 应 用 程序 
中 完成 。 

样 例 应 用 程序 AppServices 使 用 服务 缓存 Book 对 象 。 调 用 服务 ， 可 以 检索 Book 对 象 的 列表 ， 
对 象 添加 到 服务 中 。 

应 用 程序 包含 多 个 项 目 : 

e 一 个 NET 标准 库 (BooksCacheModel 定 义 了 这 个 应 用 程序 的 模型 : Book 类 。 为 了 便于 传输 数据 ， 提 供 

一 个 扩展 方法 , 把 Book 对 象 转换 为 JSON, 把 JSON 转换 为 Book 对 象 。 这 个 库 在 所 有 其 他 项 目 中 使 用 。 

e 第 二 个 项 目 (BooksCacheService) 是 一 个 Windows 运行 库 组 件 ， 定 义 了 book 服务 本 身 。 这 种 服务 需要 在 

后 台 运 行 ， 因 此 实现 一 个 后 台 任 务 。 

e 后 台 任 务 需要 注册 到 系统 中 。 这 个 项 目 是 一 个 Windows 应 用 程序 BooksCacheProvider。 

se ”调用 应 用 程序 服务 的 客户 机 应 用 程序 是 一 个 Windows 应 用 程序 BooksCacheClient。 

下 面 看 看 这 些 部 分 。 


也 新 Book 


36.5.1 创建 模型 


移动 库 BooksCacheModel 包含 Book 类 .利用 NuGet 包 Newtonsoft Json 转换 到 JSON 的 转换 器 以 及 存储 库 。 
Book 类 定义 了 Title 和 Publisher 属性 (代码 文件 AppServices/BooksCacheModel/Book.cs): 


Public class Book 
{ 
Public string Title { get; set; ]} 
Public string Publisher { get; set; } 
} 


BooksRepository 类 包含 Book 对 象 的 内 存 缓存 ， 人 允许 用 户 通过 AddBook 方法 添加 book 对 象 ， 使 用 Books 
属性 返回 所 有 缓存 的 书 。 为 了 查看 一 本 书 ， 不 需要 添加 新 书 ， 初 始 化 时 把 一 本 书 添加 到 列表 中 (代码 文件 
AppServices /BooksCacheModel/BooksRepository.cs): 

Public class BooksRepository 

{ 


private readonly List<Book> books = new List<Book> () 


new Book 
{ 
Title = "Professional C# 7 and .NET Core 2"™, 
Publisher = "Wrox Press"™ 
} 
}s 


Public IEnumerable<Book> Books => books; 
private BooksRepository() { } 
Public static BooksRepository Instance = new BooksRepository(); 


Public void AddBook (Book book) => books.Add (book); 


因为 通过 应 用 程序 服务 发 送 的 数据 需要 序列 化 ， 所 以 扩展 类 BookExtensions 定义 了 一 些 扩展 方法 ， 把 Book 对 
象 和 Book 对 象 列表 转换 为 JSON 字符 串 ， 反 之 亦 然 。 给 应 用 程序 服务 传递 一 个 字符 串 是 很 简单 的 。 扩展 方法 利用 了 
NuGet 包 Newtonsoft Json 中 可 用 的 类 JsonConvert (代码 文件 AppServices/BooksCacheModel (BookExtensions.cs): 

Public static class BookExtensions 


{ 
PUublic static string ToJson(this BOOK book) => 
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JsonConvert.SerializeObject (book); 


Public static string ToJson (this IEnumerable<Book> books) 三 > 
JSonConvert.SerializeObject (books).; 


public static Book ToBook (this string Json) => 
JSsonConvert.DeseriallizeObject<Book> (json)}); 


public static IEnumerable<Book> ToBooks (this string json) 三 > 
JsonConvert .DeserializeOQObject<IEnumerable<Book>> (json); 


36.5.2 ”为 应 用 程序 服务 连接 创建 后 台 任 务 


现在 进入 这 个 示例 应 用 程序 的 核心 : 应 用 程序 服务 。 需 要 把 应 用 服务 实现 为 Windows Runtime 组 件 库 ， 通 
过 实现 接口 BackgroundTask 把 它 实 现 为 一 个 后 台 任 务 。Windows 后 台 任 务 可 以 在 后 台 运 行 ， 不 需要 用 户 交 互 。 

有 不 同 种 类 的 后 台 任 务 可 用 。 后 台 任 务 的 局 动 可 以 基于 定时 器 的 间隔 、Windows 推送 通知 、 位 置信 息 、 蓝 
牙 设备 连接 或 其 他 事件 。 

类 BooksCacheTask 是 一 个 应 用 程序 服务 的 后 台 任 务 。 接 口 [BackeroundTask 定义 了 需要 实现 的 Run 方法 。 
在 实现 代码 中 ， 定 义 了 请 求 处 理 程序 ， 来 接收 应 用 程序 服务 的 连接 (代码 文件 AppServices/BooksCacheService/ 
BooksCacheTask.cs): 


Public sealed class BooksCacheTask: IBackgroundTask 
{ 
private BackgroundTaskDeferral taskDeferral; 
public void Run(IBackgroundTaskInstance taskInstance) 
{ 
taskDeferral = taskIinstance.GetDeferral () ， 
taskInstance.Ccanceled += OnTaskCanceled; 


var trigger = taskInstance.TriggerDetails as BppServicelTriggerDetails.; 
AppServiceConnection connection = trigger .AppServiceConnection.; 
Connection.RequestReceived += OnRequestReceived,; 

} 


private volid OnTaskCanceled (IBackgroundTasklInstance sender., 
BackgroundTaskCancellationReason reason) 
{ 
taskDeferral?.Complete (); 
} 
sa 
} 


在 OnRequestReceived 处 理 程序 的 实现 代码 中 ， 服 务 可 以 读 取 请 求 ， 且 需要 提供 回应 。 接 收 到 的 请 求 都 包 
会 在 AppServiceRequestReceivedEventArgs 的 Request.Message 属性 中 。Message 属性 返回 一 个 ValueSet 对 象 。 
ValueSet 是 一 个 字典 ， 其 中 包含 键 及 其 相应 的 值 。 这 里 的 服务 需要 一 个 command 键 ， 其 值 是 GET 或 POST。 
GET 命令 返回 一 个 包含 所 有 书籍 的 列表 , 而 POST 命令 要 求 把 额外 的 键 book 和 一 个 JSON 字符 串 作 为 Book 对 
象 表示 的 值 。 根 据 收 到 的 消息 ， 调 用 GetBooks 或 AddBook 辅助 方法 。 通 过 调用 SendResponseAsync 把 从 这 些 
消息 返回 的 结果 返回 给 调用 者 ; 


private async vold OnRequestReceived (BAppServiceConnection SenaeI， 
AppServiceRequestReceivedEventArgs args) 
{ 
AppServiceDeferral deferral = args.GetDeferral (); 
try 
{ 
ValueSet message = args.Request.Message; 
Valueset result = null; 
switch (message["command"™] .ToSstring(})) 
{ 
CasSe "GET™: 
result = GetBooks (}); 
break; 
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Case "POST™": 
result = AddBook (message["book"™.] .ToString (})); 
break:; 
default: 
break; 
} 
awalt args.Request.SendResponseAsync (result); 
} 
finally 
{ 
deferral .Complete(}; 
} 
} 


GetBooks 方法 使 用 BooksRepository 获得 JSON 格式 的 所 有 书籍 ， 它 创建 了 一 个 ValueSet， 其 键 为 result: 


private ValueSet GetBooKks () 

{ 
Var TESUIt = new ValueSset(}; 
result.Add ("result", BooksRepository.Instance.Books.ToJson(})); 
return result.; 


} 
AddBook 方法 使 用 存储 库 添 加 一 本 书 ， 并 返回 一 个 ValueSet， 其 中 的 键 是 result， 值 是 ok: 


private ValueSet AddBook (string book) 
{ 
BooksRepository.Instance.AddBook (book ToBook () ); 
var Iesult = new ValueSsSetl(}).; 
result.Add ("result™, "ok™}; 
return result; 


36.5.3 注册 应 用 程序 服务 


现在 需要 通过 操作 系统 注册 应 用 程序 服务 。 为 此 ， 创 建 一 个 正常 UWP 应 用 程序 ， 它 引用 了 
BooksCacheService。 在 此 应 用 程序 中 ， 必 须 在 package.appxmanifest 中 定义 一 个 声明 ( 见 图 36-8)。 在 应 用 程序 声 
明 列 表 中 添加 一 个 应 用 程序 服务 ， 并 指定 名 字 。 需 要 设置 到 后 台 任 务 的 入 口 各 ， 包 插 名 称 空间 和 类 名 。 

对 于 客户 端 应 用 程序 ， 需 要 package.appxmanifest 定义 的 应 用 程序 名 和 包 名 。 为 了 得 看 包 名 ， 可 以 查看 
PackageManifestEditor 的 Package 选项 卡 ， 也 可 以 以 编程 方式 调用 Package.Current.Id.FamilyName。 为 了 便于 在 
局 动 应 用 程序 时 查看 这 个 名 字 ， 把 它 写 入 属性 PackageFamilyName， 该 属性 绑 定 到 用 户 界 面 的 一 个 控件 上 (代码 
文件 AppServices/BooksCacheProvider/MainPage.xaml.cs): 

public sealed partial class Mainpage: Page 

| public MainPage () 

this.InitializeComponent (); 


FackagerFamilyName = Package.Current.Id.FamilyName.; 
} 


Public string PackageFamilyName 


get => (string)GetValue (PackageFamilyNameProperty); 
set => SetValue (PackageFamilyNameProperty, value); 


public static readonly DependencyProperty PackageFamlilyNameProperty = 
DependencyProperty.Reglster("PackageFamilyName", typeof (string), 
typeof (MainPage), new PropertyMetadata (string.Empty)); 
} 


当 运 行 这 个 应 用 程序 时 ， 它 会 注册 后 台 任 务 ， 并 显示 客户 端 应 用 程序 需要 的 包 名 。 
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Application Visual Assets Capabilities Declarations Content URIs Packaging 


Ruallable Declarations: 
Select one. 


Supported Declarations: 


Peore nFerrriatiiary 
Propertios: 
Narme: cam CMinmnevaton BooksCache 


pT i Fn 


lw| ExecutableOrstarPagelshequired 

App settings 

Exwecutable 

Enmtry point: BooksCacheService. BooksCacheTask 
Start page: 


Resource group: 
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36.5.4 调用 应 用 程序 服务 


在 客户 喘 应 用 程序 中 ， 现 在 可 以 调用 应 用 程序 服务 。 客 户 端 应 用 程序 BooksCacheClient 的 主要 部 分 用 视图 
模型 实现 。Books 属性 绑 定 在 UI 中 ， 显 示 从 服务 返回 的 所 有 书籍 。 这 个 集合 用 GetBooksAsync 方法 填充 。 
GetBooksAsync 使 用 GET 命令 创建 一 个 ValueSet， 使 用 SendMessageAsync 辅助 方法 发 送 给 应 用 程序 服务 。 这 
个 辅助 方法 返回 一 个 JSON 字符 串 ， 该 字符 串 再 转换 为 一 个 Book 集合 ， 用 于 填充 Books 属性 的 
ObservableCollection (代码 文件 AppServices/BooksCacheClient/ViewModels/BooksViewModel.cs ): 


Public class BooksViewModel 
{ 
private const string BookServiceName = "com.CNinnovation.BooksCache"™s; 
private const string BooksPackageName = 
"085f6zed-ei12b-4c07-9910-b4d01c066dd6 P2wxVUTYOmV8G 


public CbservableCollection<Book> Books { get; } = 
new ObservableCollection<Book> (}); 


public async void GetBooksAsyncl() 
{ 
Var message = new Valueset (}); 
message.Add ("command™", GET"); 
string json = await SendMessageAsync (message)}); 
IEnumerable<Book> books = json.ToBooks (}); 
foreach (var book in books) 
{ 
Books .Add (book) ; 
} 


fhes: 
} 


PostBookAsync 方法 创建 了 一 个 Book 对 象 , 序列 化 为 JSON, 通过 ValueSet 把 它 发 送 给 SendMessageAsync 
Public string NewBookKTitle { get; set; ]} 
Public string NewBookPuUublisher { get; set; } 
Public async void PostBookAsync() 
{ 
Var message = new Valueset(}).; 
message.BAdd ("command™”, "POST™):; 
string json = new Book 


{ 
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Title = NewBookTitle, 
PUublisher = NewBookPublisher 
} .ToJson():; 
message.Add ("book™, Json); 
string result = await SendMessageAsvync (message); 


} 

与 应 用 程序 服务 相关 的 客户 代码 包含 在 SendMessageAsync 方法 中 。 其 中 创建 了 一 个 AppServiceConnection。 
连接 使 用 完 后 ， 通 过 using 语句 销毁 ， 以 关闭 它 。 为 了 把 连接 映射 到 正确 的 服务 上 ， 需 要 提供 AppServiceName 
和 PackageFamilyName 属性 。 设 置 这 些 属性 后 ， 通 过 调用 方法 OpenAsync 来 打开 连接 。 只 有 成 功 地 打开 连接 ， 
才能 在 调用 方法 中 发 送 请 求 和 接收 到 的 ValueSet。AppServiceConnection 方法 SendMessageAsync 把 请 求 发 送 给 
服务 ， 返 回 一 个 AppServiceResponse 对 象 。 啊 应 包含 来 目 服务 的 结果 ， 相 应 的 处 理 如 下 : 


private async Task<string> SendMessageAsync (ValueSet message) 
{ 
Using (Var connection = new AppServiceConnection()) 
{ 
connection .AppServiceName = BookServiceName : 
connection.PackageFamilyName = BooksPackageName.; 
AppServiceConnectionSstatus status = await connection.OpenAsvync().; 
if (status == AppServiceConnectionStatus.Success) 
{ 
LAppServiceResponse response = 
await connection.SendMessagehsync (message); 


1if (response.Status == AppServiceResponseSstatus.Success && 
response.Message .ContainsKey ("result")) 
{ 
string result = response.Message["result"] .ToString'(); 
return result; 
} 
全 二 号 忌 
{ 
await ShowServiceErrorAsync (response.status); 
} 
} 
= 
{ 
await ShowConnectionErrorAsync (status); 
} 
return string.Empty; 
} 
} 


在 构建 解决 方案 ， 部 署 提供 程序 和 客 尸 机 应 用 程序 后 ， 就 可 以 局 动 客户 机 应 用 程序 来 调用 服务 。 还 可 以 创 
建 多 个 客户 机 应 用 程序 ， 来 调用 相同 的 服务 。 
运行 提供 程序 , 注册 后 台 任 务 后 ,可 以 运行 客 尸 问 应 用 程序 ,获取 图 书 ， 并 添加 新 的 图 书 ， 如 图 36-9 所 示 。 


Bookst achet lvent 


Get Books Professional C# 7 and .NET Core 2 


Wrox Press 
Ttle 


| Professional 人 并 吕 


Publisher 


Add Book 


图 36-9 
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36.6 ”高 级 的 编译 绑 定 


第 33 章 涵盖 了 与 Windows 应 用 程序 的 编译 绑 定 ， 但 编译 绑 定 还 有 一 些 其 他 有 趣 的 特性 。 本 节 介绍 绑 定 生 
命 周期 、 绑 定 到 方法 和 阶段 绑 定 。 


36.6.1 已 编译 数据 绑 定 的 生命 周期 


通过 已 编译 的 数据 绑 定 ，C# 代 码 从 XAML 文件 的 绑 定 中 生成 。 还 可 以 通过 编程 方式 影 啊 绑 定 的 生命 周期 。 
下 面 从 一 个 在 用 户 界 面 中 绑 定 的 简单 Book 类 型 开始 (代码 文件 CompiledBindingLifetime/Models/Book.cs): 
public class Book : BindableBase 
| public int BookId { get; set; } 

private string title; 

public string Title 

get => title; 

, set 一 > Set (Te title, value}: 

public string Publisher { get; set; } 


public override string ToString() => Title; 
} 
使 用 page 类 ， 创 建 一 个 只 读 属 性 Book， 返 回 一 个 Book 实例 。 可 以 更 改 Book 实例 的 值 ， 而 Book 实例 本 
身 仅 用 于 读 取 (代码 文件 CompiledBindineLifetime/MainPage.xaml.cs): 
Public Book Book { get; } = new Book 
{ 
Title = "Professional C# 7", 


Publisher = "Wrox Press™ 
上 
在 XAML 代码 中 ，Title 属性 处 于 TextBlock 的 Text 属性 的 OneWay 模式 ，Publisher 被 绑 定 而 不 指定 模式 ， 
这 意味 着 它 被 绑 定 OneTime( 代 码 文件 CompiledBindingLifetime/MainPage.xaml): 
<StackPanel> 
<TextBlock Text="{x:Bind Book.Title, Mode=OneWay}™ /> 


<TextBlock Text="{x:Bind Book.Publisher}™ /> 
</StackPanel> 


接 下 来 ， 绑 定 几 个 AppBarButton 控件 ， 来 更 改 己 编译 绑 定 的 生命 周期 。 一 个 按钮 的 Click 事件 绑 定 到 
OnChangeBook 方法 。 这 个 方法 使 用 调用 的 方式 来 更 改 图 书 的 标题 。 如 果 符 试 这 样 做 ,标题 会 因为 进行 OneTime 
绑 定 而 立即 更 新 (代码 文件 CompiledBindingLifetime/MainPage.xaml.cs): 


private int csharpversion = 7; 
Public void OnchangqeBooK () => 
Book.Title = $"Professional C# {++csharpversion}™; 


但 是 ， 可 以 停止 对 绑 定 的 跟踪 。 使 用 页 面 的 Bindings 属性 调用 StopTracking 方法 (如 果 使 用 已 编译 绑 定 ， 则 
创建 此 属性 )， 将 删除 所 有 绑 定 侦 听 器 。 在 调用 OnChangeBook 方法 之 前 调用 此 方法 时 ， 该 书 的 更 新 没有 反映 在 
用 户 界 面 中 (代码 文件 CompiledBindineLifetime/MainPage.xaml.cs): 


private void OnstopTracking{() => 
Bindings.stopTracking (}); 


要 从 绑 定 源 上 显 式 更 新 用 户 界 面 ， 可 以 调用 update 方法 。 调 用 此 方法 不 仅 反 映 了 OneWay 绑 定 或 TwoWay 
绑 定 的 更 改 ， 还 反映 了 OneTime 绑 定 (代码 文件 CompiledBindingLifetime/MainPage.xaml.cs): 


private void OnUpdateBinding() 三 > 
Bindings.Update () ; 


在 加 载 窗 口 时 ， 将 调用 Initialize 方法 。 这 个 方法 调用 一 次 Update 方法 。 当 再 次 调用 Initialize 时 ， 不 会 再 次 
调用 Update。 需 要 直接 调用 方法 Update 进行 显 式 更 新 。Update 和 StopTracking 是 在 初始 化 后 用 已 编译 绑 定 控 
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制 生命 周期 的 两 个 重要 方法 。 还 可 以 使 用 Update 方法 来 更 新 那些 没有 实现 INotifyPropertyChanged 的 属性 。 
运行 应 用 程序 时 ( 见 图 36-10)， 可 以 单 击 下 方 区 域 的 Stop 按钮 ， 然 后 单 击 Edit 按钮 更 改 图 书 。 只 有 在 显 式 
单 击 Refresh 按钮 时 才 会 发 生 更 新 。 如 果 没 有 单 击 Stop 按钮 ， 则 在 单 击 Edit 按钮 时 立即 更 新 UI。 


CompiledBindingLrtetirne 


2rofessional C# 12 


Wrox Press 
Instructions: 


1. Click the Edit button to update the book from code behind. This 
Updates the book In the UI. 


.Click the Stop button, change tracking will be stopped. Click the Edit 
button to update the book this change will not reflect In the UI. 


3. Click the Refresh button to update bindings 
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36.6.2 ” 绑 定 到 方法 上 


使 用 已 编译 绑 定 ， 就 已 经 使 用 了 事件 绑 定 一 一 把 事件 绑 定 到 方法 上 。 已 编译 绑 定 也 文 持 把 属性 绑 定 到 方法 
上 。 例 如 ， 可 以 使 用 它 蔡 换 WPF 文 持 的 多 绑 定 特性 ， 将 模型 的 多 个 属性 绑 定 到 XAML 元 素 的 一 个 属性 。 通 过 
绑 定 到 方法 ， 还 可 以 蔡 换 值 转换 器 。 

下 一 个 示例 应 用 程序 使 用 绑 定 到 方法 。 示 例 应 用 程序 中 使 用 的 模型 是 Person 类 。 这 个 类 没有 实现 通知 更 改 ， 所 
以 需要 在 绑 定 中 调用 Update 方法 ， 来 查看 UI 中 更 新 的 更 改 (代码 文件 CompiledBindingMethods/Models/Person.cs): 

Public class Person 

| Public string GivenName { get; set; } 

| public string Surname !{ get; set; } 

在 MainPage 中 实例 化 两 个 Person 对 象 ， 并 分 配给 属性 Personl1 和 Person2( 代 码 文 件 
CompiledBindmeMethods/MainPage.xaml.cs): 


Public MainPage() 
{ 


Personl = new Person { GivenName = "Katharina™", Surname = "Nagel™ }; 
Person2 = new Person { GivenName = "Stephanie", Surname = "Nagel™ }; 
this.InitializeComonent (); 

} 


Public Person Personl { get; } 
public Person Person? { get; set; } 


在 代码 隐藏 文件 中 , 方法 ToName 将 Person 对 象 转换 为 字符 串 。 实 现 两 个 将 Person 对 象 转换 为 字符 串 的 不 
同 变 体 ， 第 一 个 变 体 返 回 姓 之 前 给 定 的 名 称 ， 第 二 个 变 体 返 回 给 定名 称 前 的 姓 ， 中 间 有 逗号 。 为 了 在 变 体 之 间 
进行 选择 ，ToName 方法 的 第 二 个 参数 接受 一 个 布尔 输入 值 ， 来 选择 其 中 一 个 选项 (代码 文件 
CompiledBindmeMethods/MainPage.xaml.cs): 

public string ToName (Person p, bool firstLast) 


{ 
if {p == null) throw new ArgumentNullException (nameof (p)})); 


998 | 第 IV 部 分 应 用 程序 


if (firstLast) 
| 
return $"{p.FirstName} {p.LastName}"; 
} 
else 
{ 


return $"{p.LastName}, {p.FirstName}"; 
} 
要 调用 ToName 方法 ， 方 法 名 与 x:Bind 标记 扩展 名 一 起 使 用 。 把 两 个 值 传递 给 ToName 方法 : 在 代码 隐藏 
文件 中 定义 的 Personl 属性 值 和 一 个 布尔 参数 。x:True 和 x:False 在 http://schemas.microsoft.com/winfx/2006/xaml 
名 称 空间 中 定义 为 XAML (代码 文件 CompiledBindingMethods/MainPage.xaml): 


<TextBlock Text="{x:Bind ToName (Personl, x:False)}" /> 
<TextBlock Text="{x:Bind ToName (Personl, x:True)}" /> 


使 用 这 些 绑 定 ，Personl 对 象 显 示 为 以 下 两 种 变 体 : 
® FirstName LastName 
® LastName, FirstName 
把 值 改 回来 怎么 样 ? 还 可 以 定义 使 用 一 个 方法 , 该 方法 用 XAML 代码 中 的 双 回 绑 定 来 调用 。 属 性 的 值 传递 
给 方法 ， 需 要 定义 一 个 方法 来 接收 这 个 参数 。 绑 定 TextBlock 的 Text 属性 时 ， 会 收 到 一 个 字符 串 。ToPerson2 
方法 声明 类 型 为 string 的 参数 ,将 此 值 拆 分 ,将 其 值 赋 给 Person2 的 GivenName 和 Sumame 属性 .因为 GivenName 
和 Sumame 属性 没有 实现 更 改 通 知 ， 所 以 显 式 调用 Update 方法 ， 来 更 新 用 户 界 面 ( 代 码 文 件 
CompiledBindineMethods/MainPage.xaml.cs): 
public void ToPerson2 (string name) 
string[] names = name.Split(" '); 
和 (names.Length != 2) return, // don't do anything with wrong inputs 
Person2.GivenName = names[0]; 


Person2.Surname = names[ll]:; 
Bindings.Update () ; 


调用 方法 来 接收 Text 属性 值 的 方法 使 用 了 xBind 标记 扩展 的 BindBack 属性 。BindBack 需要 方法 的 名 称 。 
另外 ， 已 编译 的 绑 定 需要 声明 为 TwoWay( 代 码 文 件 CompiledBindingMethods/MainPage. xam)): 


Text="{x:Bind ToName (Person2, x:True), BindBack=ToPerson2, Mode=TwoWay}" /> 
<TextBlock Text="{x:Bind ToName (Person?2, Xx:True}}™" /> 


运行 应 用 程序 时 ， 可 以 看 到 绑 定 值 ， 并 使 用 绑 定 到 方法 来 更 改 TextBox 中 的 值 。 
36.63 用 x:Bind 分 阶段 


用 户 不 想 等 待 。 有 时 候 获 取信 息 需 要 一 些 时 间 。 使 用 阶段 化 可 以 改善 用 户 体验 ， 因 为 可 以 更 早 地 提供 一 些 
数据 ， 并 随 独 更 多 数据 可 用 而 更 新 用 户 界面 。 


注意 ; 
如 果 熟 悉 来 自 WPF 的 优先 级 绑 定 ， 那 么 使 用 阶段 编译 绑 定 可 以 提供 与 不 同 实 现 类 似 的 功能 。 


通过 分 阶段 ， 可 以 通过 使 用 ListView 和 GridView 控件 来 定义 不 同 的 阶段 。 只 有 这 些 控件 支持 分 阶段 。 

示例 应 用 程序 实现 了 一 个 典型 的 场景 从 API 服务 中 检索 数据 ， 这 可 能 需要 一 些 时 间 。 同 时 ， 还 应 显示 其 
他 信息 。 数 据 是 逐 阶 段 检 索 的 。 对 于 每 个 阶段 ， 返 回 的 数据 类 型 可 能 不 同 。 示 例 应 用 程序 最 初 只 显示 静态 信息 ， 
但 是 类 似 的 本 地 缓存 信息 可 以 用 于 显示 。 

从 服务 中 获取 的 信息 由 LunchMenu 类 定义 (代码 文件 PhasedBinding/Models/LunchMenu.cs): 

i class LunchMenu 


public int MenuId { get; set; } 
Public string Text { get; set; } 
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Public string ImageUrl { getr set; } 
} 


LunchMenuService 类 模拟 从 一 个 服务 中 获取 衣 单 列表 。 这 里 只 是 一 个 内 存 列 表 。 从 网 络 返 回 一 个 简单 的 列 
表 取 诀 于 网 络 速 度 和 到 服务 器 的 距离 ， 且 可 能 看 不 到 这 两 个 阶段 之 间 的 巨大 差异 。 但 是 ， 需 要 的 服务 器 端 处 理 
越 多 ， 效 果 就 越 容 易 看 到 。 为 了 模拟 更 长 的 过 程 ， 从 GetLunchMenusAsynec 方法 中 返回 的 菜单 数据 之 前 ， 需 要 
延迟 10 秒 (代码 文件 PhasedBinding/Services/LunchMenuService.cs.cs): 
public class LunchMenuService 
private IEnumerable<LunchMenu> menusList = new List<LunchMenu> () 
{ 


new LunchMenu { MenulId = 1, Text = "Chicken Salad", ImageUrl = 
"nttps://kantineml01.blob.core.windows.net/menuimages/Backhendelsalat"™}, 


new LunchMenuy { MenulId = 2, Text = "Cordon Bleu", ImageUrl1 = 
"nttps://kantinem101.blob.core.windows.net/menuimages/CordonBleu 250"™}, 
new LunchMenu { MenulId = 3, Text = "Wiener Schnitzel", ImageUrl = 


"nttps://kantinem101.blob.core.windows.net/menuimages/™ + 
"Wienerschnitzel 250"), 
new LunchMenu { MenuIQ = 4, Text = "Lasagne", ImageUrl = 
"nttps://kantinem101 .blob.core.windows.net/menuimages/Lasagne 250"}, 
new LunchMenu { MenulId = 5, Text = "Lentils with bacon and dumplings"™, 


ImadgeUrl = 
"https://kantinem101 .blob.core.windows.net/menuimages/Linsen 250"}, 
new LunchMenu { MenulId = 6, Text = "Schweinslungenbraten™", ImageUrl = 


"nttps://kantineml01.blob.core.windows.net/menuimages/™ + 
"Schweinslungenbraten 250"}), 

new LunchMenu { MenulId = 7, Text = "Spatzle", ImageUrl1 = 
"nttps://kantinem101.blob.core.windows.net/menuimages/™ + 
"Spinatspaetzle 250"™}, 

new LunchMenuy { MenulId = 8, Text = "Topfennockerl™", ImageUrl1 = 
"nttps://kantineml101.blob.core.windows.net/menuimages/™ + 
"Topfennockerl 2230"}, 

new LunchMenu { MenulId = 3, Text = "Fried trout with potatoes", ImageUrl = 
"nttps://kantinem101.blob.core.windows.net/menuimages/forelle 250"}, 


Fs 


Public async Task<IEnumerable<LunchMenu>> GetLunchMenusAsync() 
{ 
await Task.Delay (10000}; // simlate a delay 
return menusList; 
} 
} 


用 户 界 面 中 的 列表 绑 定 到 LunchMenuViewModel 上 。 这 个 视图 模型 类 定义 了 LunchMenu 属性 ， 它 返回 与 
其 名 称 相 同类 型 的 对 象 。 此 外 ， 还 提供 了 IntroText 属性 。 这 个 只 读 属 性 只 返回 静态 文本 。 在 LunchMenu 的 结 
果 出 来 之 前 ， 将 首先 显示 介绍 文本 (代码 文件 PhasedBinding/ViewModels/LunchMenuViewModel.cs): 


Public class LunchMenuViewModel : BindableBase 
{ 


private LunchMenuService service = new LunchMenuService()}; 


public LunchMenuViewModel () 
{ 
} 


Public string IntroText { get; } = "A Lunch",; 


Private LunchMenu lunchMenu; 
Public LunchMenu LunchMenu 
{ 

可 et => lunchMenu,; 

set => Set(ref lunchMenu, value)}); 


在 代码 隐藏 文件 中 ， 创 建 了 一 个 LunchViewModel 对 象 列表 ， 并 分 配给 LunchViewModels 属性 。 在 页 面 的 
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开头 ， 这 个 视图 模型 的 属性 IntroText 已 经 初始 化 并 可 以 显示 出 来 。 加 载 页 面 之 后 ， 将 调用 OnLoaded 方法 。 在 
此 方法 中 , 从 服务 中 检索 午餐 菜单 ,并 使 用 返回 的 结果 更 新 ObservableCollection 中 现 有 的 LunchMenuViewModel 
对 象 (代码 文件 PhasedBinding/MainPage.xaml cs): 

Public sealed partial class MainPage : Page 


{ 


private ObservableCollection<LunchMenuVviewModel> lJunchVviewModels = 
new ObservableCcollection<LunchMenuVviewModel>( 


Enumerable.Range (0, 8) .Select (x => new LunchMenuViewModel] (}))).; 


private LunchMenuService service = new LunchMenuService(); 
public ObservableCollection<LunchMenuVviewModel> LunchViewModels => 
lunchviewModels; 


public MainPage () 

{ 
this.InitializeComponent (); 
this.Loaded 二 = OnLoaded.; 

} 


private async void OnLoaded (object sender, RoutedEventArgs e) 
{ 
try 
{ 
List<LunchMenu> lunchMenus = 
{awalit service.GetLunchMenusAsync{()) -TOL1ILS 七 () 7 
for (Int 1 = 0; 1 < 8; I++) 
{ 
lunchvVvjewModels[1i] .LunchMenu = LUChMenus [ 工 ] ; 
} 
} 
catch (Exception ex) 
{ 
// TODO: log the exception 
throw; 
} 
} 
} 


接 下 来 重要 的 代码 是 XAML 语法 ，ListView 控件 绑 定 到 在 代码 隐藏 文件 中 定义 的 LunchViewModels。 要 和 定 
义 视 图 模型 应 该 显示 什么 ， 使 用 一 个 DataTemplate。 在 这 个 数据 模板 中 ， 除 了 x:Bind 标记 表达 式 之 外 ， 还 可 以 
看 到 x:Phase 属性 。 用 x:Phase 属性 定义 的 数字 指定 了 阶段 排序 。 绑 定 是 按照 绑 定 阶段 的 顺序 进行 的 。 在 示例 代 
码 的 第 一 个 阶段 中 ， 只 显示 了 IntroText 属性 的 值 。 还 可 以 添加 本 地 映像 。 第 2 阶段 从 视图 模型 的 LunchMenu 
属性 中 显示 文本 信息 ,第 3 阶段 显示 图 像 。 在 XAML 代码 中 验证 阶段 2 和 阶段 3 之 间 的 不 同 订单 。 要 在 图 像 上 
显示 文本 ,首先 声明 图 像 。 第 一 行 中 的 文本 框 只 是 为 了 演示 在 加 载 数据 时 ，UI 是 有 啊 应 的 。 可 以 输入 一 些 文本 ， 
并 在 处 理 不 同 阶段 时 使 用 UI (代码 文件 PhasedBinding/MainPage.xam]): 


<TextBox Header="Enter Some Text™" PlaceholderText= 
"UI is responsive 一 enter some text while the actual data is retrieved"™ 
Grid.Row="1" /> 
<LlistView HorizontalAlignment="Center™" x:Name="Menultems™" 
ItemsSource="{XxX:Bind LunchViewModels, Mode~OneWay}™" 
SelectionMode="None™ Grid.Row="2"> 
<ListView.ItemTemplate> 
<DataTemplate Xx:DataType="vm:LunchMenuViewModel"> 
<Grid Margin="12"> 
<TextBlock Text="{x:Bind IntroText}" x:Phase="1" /> 
<Image Width="300" Source="{x:Bind LunchMenu.ImageUrl1l, Mode=OneWay}" 
x:Phase="3" /> 
<TextBlock Margin="8" VerticalAlignment="Bottom" 
HorizontalTextAlignment="Center" 
Text=" {Xx:Bind LunchMenu.Text, Mode=OneWay}" 
stvyle=" {StaticResource SubtitleTextBlockStyle}" FontWeight="Bold" 
x:Phase="2" /> 
</Grid> 
</DataTemplate> 
</ListView.ItemTemplate> 
</ListView> 


运行 该 应 用 程序 时 ， 首 先 会 看 到 图 36-11 中 的 初始 数据 ， 然 后 会 看 到 使 用 菜单 信息 更 新 的 数据 和 图 36-12 
中 的 图 像 。 
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PhasedBinding 


Phasing Sample 


Enter Some Text 
AB Lunch 
Luneh 


BLunch 


A Luneh 


A Lunch 


A Lunch 


36-11 


PhasedBinding 


Phasing Sample 


Enter Some Text 


第 33 章 说 明了 如 何 使 用 CalendarView 控件 实现 各 个 阶段 。 
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36.7 ”使 用 文本 


Windows 应 用 程序 对 文本 有 丰富 的 支持 。TextBlock 控件 不 仅 支 持 简 单字 符 串 的 显示 ， 还 支持 更 复杂 的 文 
本 元 素 ， 比 如 使 用 不 同 的 样式 、 权 重 、 内 联 元 素 和 块 元 素 。RichTextBlock 控件 扩展 了 这 个 功能 ， 人 允许 文本 洲 出 。 
如 果 一 列 不 够 ， 可 以 很 容易 地 将 信息 流 到 洲 出 区 域 。 使 用 RichTextBox 控件 ， 支 持 RIF( 富 文本 文件 ) 的 使 用 。 


36.7.1 使 用 字体 


文本 的 一 个 重要 方面 是 它 的 外 观 和 字体 的 重要 性 。 通 过 TextBlock 控件 ， 可 以 使 用 属性 FontWeight、 
FontStyle、FontStretch、FontSize 和 FontFamily 指定 字体 : 
e FontWeight 一 一 FontWeights 类 指定 的 预定 义 值 , 它 提 供 了 如 ExtraLight、 Light、 Medium、 Normal、 Bold 
和 ExtraBold 等 值 。 
FontStyle 一 一 FontStyles 类 定义 的 值 ， 它 提供 了 Normal、TItalic 和 Oblique。 
Fontstretch 一 一 使 用 它 指定 伸展 字体 的 度 (与 正常 长 宽 比 相 比 )。FontStretch 定义 了 预定 义 的 伸展 度 ， 范 围 
是 从 50%(UltraCondensed) 到 200%(UltraExpanded)。 在 该 范围 内 的 预定 义 值 和 有 ExtraCondensed(62.5%)、 
Condensed(75%)、 SemiCondensed(87.5%)、Normal(100%)、 SemiExpanded(112.5%)、Expanded(125%) 和 
ExtraExpanded(150%)。 
FontSize 一 一 这 是 double 类 型 ， 允 许 用 与 设备 无 关 的 单位 指定 字体 的 大 小 。 
FontFamily 一 一 用 于 指定 首选 的 字体 系列 名 ， 例 如 Arial 或 Times New Roman。 使 用 此 属性 ， 可 以 指定 
一 个 字体 系列 名 称 的 列表 ， 因 此 ， 如 果 一 个 字体 不 可 用 ， 则 使 用 列表 中 的 下 一 个 字体 。 
为 了 了 解 不 同 字体 的 外 观 ， 下 面 的 示例 应 用 程序 包括 一 个 ListView。ListView 显示 在 该 字体 列表 中 的 字体 
名 称 。 选 择 字体 时 ， 会 显示 更 多 的 字体 信息 ， 如 粗 体 字 体 的 权重 、 字 体 样 式 的 斜体 、 字 体 的 展开 和 压缩 ， 以 及 
一 些 使 用 字体 的 文本 (代码 文件 FontsSample/MainPage.xaml): 


<ListView xXx:Name="listFonts" ItemsSource="{xXx:Bind FontNames, Mode=OneTime}" 
SelectedItem="{Xx:Bind SelectedFont, Mode=TwoWay}"™ Margin="12"> 
<ListView.ItemTemplate> 
<DataTemplate x:DataType="x: String"> 
<StackPanel Orientation="Horizontal™"> 
<TextBlock Text="{x:Bind Mode=~OneTime}" FontFamily="{x:Bind }" /> 
</StackPanel> 
</DataTemplate> 
</ListView.ItemTemplate> 
</ListView> 
<StackPanel Grid.Column="1" Margin="12™ Padding="8"> 
<TextBlock Text="{X:Bind SelectedFont, Mode~OneWay}" 
FontFamily="{x:Bind SelectedFont, Mode=OneWay}"™ /> 
<TextBlock Text="Bold"™" FontFamily="{Xx:Bind SelectedFont, Mode=OneWay}" 
FontWeight="Bold™" /> 
<TextBlock Text="Italic™" FontFamilly="{Xx:Bind SelectedFont, Mode~OneWay}™" 
Fontstyle="Italic"™ /> 
<TextBlock Text="Expanded™" FontFamily="{xXx:Bind SelectedFont, Mode=OneWay}" 
Fontstretch="Expanded™" /> 
<TextBlock Text="Condensed" FontrFamily="{x:Bind SelectedFont, Mode=~OneWay}" 
Fontstretch="Condensed™ /> 
<TextBlock Text="The quick brown fox jumped over the lazy dogs" 
FontFamily="{x:Bind SelectedFont, Mode=~OneWay}" /> 
<TextBlock Text="g&g#§xET700; &#xE701:; &#xE7T02:" 
FontFamily="{x:Bind SelectedFont, Mode=OneWay}" /> 
<TextBlock Text="&#x2467;&#x2460; &#2469:" 
FontFamily="{x:Bind SelectedFont, Mode=OneWay}" /> 
</StackPanel> 


在 代码 隐藏 文件 中 ， 在 Windows 10 系统 中 保证 可 用 的 字体 组 合 在 一 个 集合 中 一 一 其 中 的 字体 有 的 适合 于 
标题 和 UI 元 素 ， 如 Calibri、Consolas 和 Segoe UI; 有 的 适合 于 大 量 的 文本 ， 如 Cambria 和 Courier New; 有 的 适 
合 于 符号 和 图 标 ， 如 Segoe UI Emoji 和 Segoe MDL2 Assets; 以 及 非 拉 丁字 体 。 合 并 的 字体 分 配给 FontNames 属 
性 。 此 属性 在 UI 中 绑 定 。 依 赖 属 性 用 于 选择 字体 (代码 文件 FontsSample/MainPage.xaml.cs): 


Public sealed partial class MainPage : Page 
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public MainPage() 
{ 
this.InitializeComponent (); 
SelectedFont = FontNames.F1irst({):; 
} 
// good for headings and UI elements 
private readonly string[] sansSerifFontNames = { "Arial™, "Calibri™, 


"Consolas™", "Segoe UI", "Segoe UI Historic", "Selawik", "verdana™ }; 


// good for large amounts of text 


private readonly string[] serifFontNames = { "Cambria™", "Courier New", 


"Georgia", "Times New Roman™ }; 


/symbols and icons 


private readonly string[] symbolsAndIiconFontNames = { "Segoe MDL2 Assets", 


"Segoe UI Emoj1i", "Segoe UI Symbol™ }; 


/i non-latin 

private readonly string[] nonLatinFontNames = { "Ebrima™", "Gadug1i", 
"Javanese", "Leelawadee UI", "Malgun Gothic", "Microsoft Himalava", 
"Microsoft JhengHei UI", "Microsoft PhagsPa™", "Microsoft Tal Le™, 


"Microsoft YaHei UI", "Microsoft YI Baiti™", "Mongolian Baiti"™", "MV Boli"™, 


"Myanmar Text™", "Nirmala UI"™, "SimSun™", "Yu Gothic™"™, "Yu Gothic UI"™ 


private string[] allFonts; 
Public string[] FontNames => allFonts ?2? (allFonts = 
sansSserifFontNames.Concat( serifFontNames) 


-Concat ( symbolsAndIiconFontNames) -Concat ( nonLatinFontNames) .ToArray()}); 


Public string SelectedFont 


get => (string)GetValue (SelectedFontProperty); 
Set => SetValue (SelectedFontProperty, value),; 


Public static readonly DependencyProperty SelectedFontProperty = 
DependencyProperty.Reglster("SelectedFont", typeof (string), 
typeof (MainPage), new PropertyMetadata (string.Empty)); 
} 


在 运行 应 用 程序 时 ， 会 得 到 具有 不 同 特征 的 字体 列表 ， 如 图 36-13 所 示 。 


FontsSample 


Mm Segoe UI 


Calibri Bold 
Consdlas ltalic 
Expanded 


Condensed 
Segqoe Ul Historic 


The quick brown fox jumped over the lazy dogs 
000 
Verdana Ion 


Lambria 


Selawik 


Courier Ney 
36-13 


注意 : 


并 非 所 有 字体 都 定义 了 所 有 字符 。 有 些 文本 可 能 不 会 使 用 Segoe MDL2 Assets 显示 ， 而 这 个 字体 在 Unicode 
字符 中 显示 图 标 ， 而 其 他 字体 没有 定义 元 素 。 显 示 或 未 显示 的 特殊 字符 可 以 根据 系统 上 安装 的 字体 扩展 名 而 有 


所 不 同 。 
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36.7.2 ”内 联 和 块 元 素 


在 定义 文本 元 素 时 ， 需 要 区 分 从 Inline 类 中 派生 的 元 素 和 从 Block 类 中 派生 的 元 素 。Inline 派生 目 基 类 
TextElement:， 所 有 Inline 元 素 都 是 TextElement， 并 表示 一 个 文本 。Block 元 素 允 许 定义 段落 。Paragraph 类 派 
生 目 Block。 顽 可 以 包含 mline 元 素 。 

看 看 下 面包 含 Bold、LineBreak、Hyperlink、Italic、Underline、Run 和 Span 元 素 的 TextBlock 元 素 (代码 文 
件 TextSample/MainPage.xaml): 


<TextBlock Margin="]12" x:Name="textl" IsTextSelectionEnabled="True™" 
SelectionHighlightColor="Green™. FontFamily="Segoe UI" Foreground="Black"> 
<Bold>This is bold.</Bold><LineBreak /> 
<Hyperlink NavigateUri="https://csharp.christiannagel .com"> 
C# Blog</Hyperlink><LineBreak /> 
<Italic>This is italic.</Italic><LineBreak /> 
<Underline>This is underlined.</Underline><LineBreak /> 
<Run>Run element</Run><LineBreak /> 
<Span>span element</sSpan><LineBreak /> 
<Span FontFamily="Calibri"> 
<Run FontSize="24">A span can contain inlines</Run> 
<Italic>Italic is a span<LineBreak /> 
and thus <Underline>underlines</Underline> can contain inlines as well 
</Span> 
</TextBlock> 


所 有 定义 为 TextBlock 子 元 素 的 元 素 都 添加 到 Inlines 属性 中 。 类 TextBlock 将 属性 Inlines 定义 为 
ContentProperty， 就 像 ButtonBase 类 将 属性 Content 定义 为 ContentProperty 一 样 。 

类 LineBreak、Run 和 Span 派生 目 Inline, 可 用 于 Inline 集合 。 
Run 类 定义 了 Text 属性 ， 可 以 用 文本 内 容 填充 该 属性 ， 并 使 用 et 


C# Blog 
Run 元 素 的 属性 设置 字体 信息 。Span 元 率 本 壬 可 以 作为 进一步 内 plea 
联 元 素 的 容器 。Bold、Italic 和 Hyperlink 派生 目 Span， 因 此 ， 它 ei 
们 也 可 以 用 作 Inline 元 素 ， 它 们 还 可 以 包含 其 他 Inline 元 率 。 Aspan can contain inlines itoiciscspon 


图 36-14 显示 了 包含 所 有 这 些 Inline 元 素 的 TextBlock 元 素 。 ang thus underlines can contain inlines os well 
RichTextBlock 给 其 内 容 使 用 Blocks 属性 。Block 类 定义 文本 图 36-14 
格式 属性 LineHeight 、LineStackingStrategy 、 Marein 和 
TextAlignment。Paragraph 是 派生 目 Block 的 唯一 具体 类 ， 可 以 与 Blocks 属性 一 起 使 用 。Block 类 不 是 抽象 的 ， 
但 是 构造 函数 是 用 protected 访问 修饰 符 声明 的 。 
下 面 的 代码 片段 在 RichTextBlock 中 使 用 了 多 个 Paragraph 元 素 .Paragraph 本 身 包 含 一 个 mline 元 素 列 表 ( 代 
码 文 件 TextSample/MainPage.xaml): 


<RichTextBlock> 
<Paragraph FontSize="18">Paragraph 1l</Paragraph> 
<Paragraph LineSstackingstrategy="BaselineToBaseline" LineHeight="16" 
TextAlignment="Justify"> 
<Run Fontstretch="ExtraExpanded" FontWeight="Black" Text="Paragraph 2" /> 
<LineBreak /> 
<RUNn> 
The quick brown fox jumped over the lazy dogs down 1234567890 times. 
</Run> 
<RUNn> 
The quick brown fox Jumped over the lazy dogs down 1234567890 times. 
</Run> 
</Paragraph> 
<Paragraph> 
<Bold>Paragraph 3</Bold> 
<LineBreak /> 
<InlineUIContainer> 
<Ellipse Width="30" Height="20" Fill="Red"™" /> 
</InlineUIContainer> 
<LineBreak /> 
<RUun>More Text</Run> 
</Paragraph> 
<Paragraph Linestackingstrategy="BaselineToBaseline™" LineHeight="]16" 
TextAlignment="Left"»> 


<Run FontWeight="Bold™" Text="Paragraph 4" /> 
<LineBreak /> 
<RUNn> 


第 36 章 高 级 Windows 应 用 程序 | 1005 


The aquick brown fox jumped over the lazy dogs down 1234567890 times. 


</RUuny> 
<Run> 


The quick brown fox jumped over the lazy dogs down 1234567890 times. 


</Run> 
</Paragraph> 
</RichTextBlock> 


运行 该 应 用 程序 时 , 可 以 看 到 图 36-15 中 的 RichTextBlock。 
如 果 比 较 第 2 和 第 4 段 ， 就 可 以 看 到 文本 对 齐 方式 的 区 别 。 第 
2 段 是 居中 对 齐 ， 第 4 段 是 左 对 齐 。 第 3 段 包 含 一 个 
InlineUIContainer。InlineUIContainer 是 男 一 个 Inline 元 素 ， 注 
意 ， 这 个 Inline 元 素 不 能 与 TextBlock 一 起 使 用 。 它 在 
RichTextBlock 中 成 功 显 示 。InlineUIContainer 元 素 可 以 显示 其 
他 XAML 元 素 。 示 例 代 码 在 RichTextBlock 中 显示 Ellipse 一 一 
这 是 一 个 Shape 类 。 


36.7.3 ”使 用 溢出 区 域 


Paragraph 1 


Paragraph 2 

The quick brown fox jumped over the lazy dogs down 
1234567890 times. The quick brown fox jumped owver the 
lazy dogs down 1234567890 times. 


Paragraph 3 


More Text 


Paragraph 4 

The quick brown fox Jumped over the lazy dogs down 
1234567890 times. The quick brown fox jumped over the 
lazy dogs down 1234567890 times. 


图 36-15 


与 TextBlock 相 比 , RichTextBlock 可 以 显示 多 个 段落 , 男 一 种 可 能 是 如 果 文 本 放 不 下 ,就 多 许 RichTextBlock 
将 文本 溢出 到 另 一 个 区 域 。 这 一 次 ， 文 本 是 通过 编程 创建 的 。GetmlineElements 方法 返回 一 个 内 联 元 素 列 表 ( 代 


码 文 件 TextOverflow/MainPage.xaml.cs): 


public IEnumerable<Inline> GetInlIneElLements ()} 


{ 
var inlines = new List<Inline>({(); 
var header = new Bold().; 
header.Inlines.Add(new Run 1{ Text = "Lorem ipsum" }); 


inlines.Add (header}); 
inlines.Add(new LineBreak(}).: 


inlines.Add (new Run { Text = "Lorem ipsum dolor sit amet, 


inlines.Add(new LineBreak(}}):; 
return inlines; 


} 


Con-... “}) :> 


GetBlock 方法 返回 包含 内 联 元 素 的 段落 (代码 文件 TextOverflow/MainPage.xaml.cs): 


public Block GetBlock() 
| 


var paragraph = new Paragraph 1{ TextAlignment = TextAlignment.Justify }; 


foreach (war inline in GetInlineElements(})) 
{ 
paragraph.Inlines.Add(inline); 
} 
return paragraph; 


} 


当 加 载 页 面 了 时， 从 GetBlock 方法 获取 的 Block 被 反复 添加 到 RichTextBlock( 代 码 文 件 TextOverflow/ 


MainPage.xaml.cs): 


public MainPage() 
{ 
InitializeComponent (); 
Loaded ++= OnLoadData; 
} 


private void OnLoadData (object sender, RoutedEventArgs 已) 


{ 
for (int i = 0; i < 8; i++) 
{ 
textBlock.Blocks.Add GetBLOCKXI) 7 
} 
} 


在 用 户 界 面 中 ， 两 个 RichTextBlockOverflow 控件 靠近 RichTextBlock。 在 RichTextBlock 中 ， 江 出 的 内 容 进 
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入 第 一 个 RichTextBlockOverflow。 这 是 由 OverflowContentTarget 属性 定义 的 。 该 属性 用 于 将 内 容 从 第 一 个 
RichContentBlockOverflow 控件 洲 出 到 第 二 个 控件 (代码 文件 TextOverflow/MainPage.xaml): 


<RichTextBlock x:Name="textBlock" TextWrapping="Wrap" Margin="20,0" 
OverflowContentTarget="{x:Bind overflowContainerl}" 
TextLineBounds="FUl1l]"></RichTextBlock> 

<RichTextBlockOverflow Visibility="Collapsed" x:Name="overflowContainerl1" 
Grid.Ccolumn="1" Margin="20,0" 
COverflowContentTarget="{x:Bind overflowContainer2}"></RichTextBlockOverflow> 

<RichTextBlockOverflow Visibility="Collapsed™" x:Name="overflowContainer2" 
Grid.column="2"™ Margin="20,0"></RichTextBlockOverflow> 


如 果 页 面 太 小 ， 为 了 自动 隐藏 溢出 控件 ，RichTextBlockOverflow 控件 位 于 网 格 的 列 中 (代码 文件 
TextOverflow/MainPage.Xam]): 


<GIl1d> 
<Grid.columnDefinitions> 
<ColumnDefinition /> 
<ColumnDefinition x:Name="Column2" /> 
<ColumnDpefinition x:Name="Column3" /> 
</Grid.CcolumnDefinitions> 


<!1—— RichTextBlock and overflow controls 一 一 > 
</Grid> 
在 AdaptiveTrigger 的 帮助 下 ， 滥 出 容器 被 设置 为 可 见 或 压缩 。AdaptiveTrigger 还 定义 了 网 格 列 的 大 小 
其 范围 是 0 到 星 型 大 小 。 对 于 星 型 大 小 ，RichTextBlock 和 RichTextBlockOverflow 具有 相同 的 宽度 (代码 文件 
TextOverflow/MainPage.xam!l): 
<VisualSstateManager.VisualStateGroups> 
<VisualstateGroup> 
<Visualstate x:Name="Widestate"> 
<VisualSstate.SsStateTriggers> 


<AdaptiveTrigger MinWindowWidth="1024"™ /> 
</Visualstate.stateTriggers> 


<Visualstate.Setters> 
<Setter Target="overflowContainerl .Visibility" Value="Visible" /> 
<Setter Target="overflowContainer2 .Visibility" Value="Visible" /> 
<Setter Target="Column3.Width" Value="*" /> 
<Setter Target="Column2 .Width" Value="*" /> 
</Visualstate.Setters> 
</Visualstate> 


<Visualstate x:Name="MedijumSstate"™"> 
<VisualSstate.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="720"™" /> 
</Visualstate.stateTriggers> 


<VisualSstate.Setters> 
<Setter Target="overflowContainerl .Visibility" Value="Visible" /> 
<Setter Target="overflowContainer2 .Visibility" Value="Collapsed" /> 
<Setter Target="Column3.Width" Value="0" /> 
<Setter Target="Column2 .Width" Value="*" /> 
</Visualstate.Setters> 
</Visualstate> 


<Vijsualstate x:Name="NarrowSstate"™> 
<VisualSstate.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="320"™ /> 
</Visualstate.stateTriggers> 


<Visualstate.Setters> 
<Setter Target="overflowContainerl .Visibility" Value="Collapsed" /> 
<Setter Target="overflowContainer2 .Visibility" Value="Collapsed" /> 
<Setter Target="Column3.Width" Value="0" /> 
<Setter Target="Column2 .Width" Value="0" /> 

</Visualstate.Setters> 

</Visualstate> 
</VisualSstateGroup> 
</VisualstateManager.VisualstateGroups> 


Ee 
自 适 应 触发 器 参见 第 33 章 。 
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运行 应 用 程序 时 ， 可 以 看 到 ， 宽 屏幕 有 两 个 洲 出 控件 的 洲 出 (参见 图 36-16)， 中 等 屏幕 有 一 个 溢出 控件 ( 参 
见 图 36-17)， 军 屏幕 没有 洲 出 控件 (参见 图 36-18)。 


TENHDwEEflow 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing 
elit, sed do elusmod tempoar incididunt ut labore et 
dolore magna aliqgua. Ut enim ad minim veniam, quis 
nostrud ewercitation ullameo labons misi wt aliqguip ex 
ea COMmmodo consequat, Duis aute irure dolor in 
reprehenderit in voluptate velit esse cillum dolore eu 
fugiat nulla pariatur. Exwcepteur sint occaecat 
cupidatat non proident sunt in culpa hi officia 
deserunt mollit anim id est laborum. 


Laorer ipsurm 

Lorem ipsum dolor sit amet, consectetur adipiscing 
elit, sed do ensmad tempoar incididunt ut labore et 
dolore magna aligua. Ut enim ad minim veniam, quis 
nostrud ewercrtation ullameo labons nrsi wt aliguip ex 
Pa Fnmmadn rnnsequat. Tns aute nre dalnr in 


reprehenderit in voluptate velit esse cillum dolore eu 
fugiat nulla pariatur, EXCepteur sint oucaecat 
cupidatat non Proident sunt im llpa qui officia 
deserunt mallit anim id est laborurm. 


Lorem ipsum 

Larem ipsum dolor sit amet, consectetur adipiscing 
eltt, sed do elusmod tempoar incididunt ut labore et 
dolore magna aliqgua. UM enim ad minim weniam, quis 
nostrud exwercitation ullameos laboris misi wt aliquip ex 
ea CMModo consegquat Cuis aute irure dolor in 
reprehenderit in voluptate velit esse cillum dolore eu 
tugiat nulla panatur. Excepteur sint occaecat 
cupidatat men proident, sunt im cylpa qu officia 
deserunt mollit anim id est laborum. 


Lorem ipsum 
Lorem ipsum dolor sit amaet, consectetur adipiscing 


elit, sed do elusmaod tempor ineididunt ut labore et 
dolore magna aligua. Ut enim ad minim veniam, quits 
nostrud ewercitation ullameo laboris nisl ut aliguip ex 
ea Commodo consequat, Duis aute irure doler in 
reprehendenit im voluptate welit esse cillum dolore eu 
fugiat nulla pariatur. Excepteur sint occaecat 
cupidatat monm proident, sunt in culpa qui officia 
deserunt mollit anim id est labonim. 


Larem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing 
eI, sed do eiusmod tempor incididunt ut labore et 
dolore magna aligua. Ut enim ad minirm weniam, ouis 
nastrud exercitation ullames laboris nisi ut aliguip ex 
ea Comimodo consequat, Duls aute irure dolor in 
reprehendernt in voluptate veltt esse cilurm dolore eu 
fmmat mlla panatur Fwrepteur sint ncraerat 
cupidatat non proident, sunt in culpa quyui officia 
deserunt moallit anim id est labonsm, 


Laerem lpsurm 

Lorem ipsum dolor sit amet, consectetur adipiscing 
elit, sed do eiusmod tempor incididunt ut labore et 
dolore magna aligua. Ut enim ad minmim veniam, quis 
nostrud exwercmtation ullamco labons nisl ut aliguip ex 
ea Commodo consequat, Duis aute irure dolor in 
reprehenderit in voluptate welit esse cillum dolore eu 
fugiat nulla pariatur Excepteur sint occaecat 
cupidatat non proident, sunt im culpa qui officia 
deserunt mollit anim Id est labonim, 


Larem Ipsurm 

Lorem ipsum dolor sit amet consectetur adipiscing 
elit, sed do eiusimod tempor incididunt ut labore et 
dolore magna aliqua. Ut enim ad minim veniam, quis 
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FS eweramtation ullames laboris nisi ut aliquip ex 
Ba Commods consequat, Duls aute irure doler in 
reprehenderit in voluptate welit esse cillum dolore eu 
fugiat nulla pariatur, Excepteur sint occaecat 
cupidatat non proident, sunt in culpa qul offica 
deserunt mallit anim id est labonym,. 


Laorerm lpsurm 

Lorerm ipsurm dolor sit ameat, consectetur adipiseing 
Et sed do eusmad tempear neididunt ut labore et 
dolore magna aliqua. Ut enim ad minim veniam, quis 
nostrud exerctation ullameo laboris nisi ut aliqyip ex 
ea COMIMmModo consegquat. Duis aute irure dalor in 
repreheraerit in voluptate welit esse cillum dolore eu 
Tugiat nulla pariatur. Excepteur sint occaecat 
cupidatat nan prowdent, sunt m culpa 可 Ui officia 
全 EST mnllit anim i eat lahanum. 


TextOerf how 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit sed do 
elusmod tempar inecididunt ut labore et dolore magna aliqua, Ut 
enim ad minim veniam, quis nostrud exercitation ullameco labons 
nisi ut aliguip ex ea commMmodo consequat. Duis aute irure dolor im 
reprehendert Im volupiate velit esse clllum dolore ey fugiat nulla 
pariatur. Excepteur sint occaecat cupidatat non proidenit, sunt in 
culpa qui officia deserunt mollit anim id est laborum,. 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do 
elusmod tempor incididunt ut labore et dolore magna aliqua, Ut 
enim ad minim wveniam, dquis nostrud exercitation ullameo laboris 
nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in 
reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla 
pariatur. Excepteur sint occaecat cupidatat non proideni, sunt in 
culpa qui officia deserunt mollit anim id est laborum. 


Lerem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do 
elusmod tempor incdidunt ut labore et dolore magna aliqgua. Ut 
enim ad minim veniam, quis nostrud exercitation ullamco labornis 
nisi ut aliqyip ex ea commodo consequat. Dus aute Irure dolor 站 
reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla 
pariatur. Excepteur sint occaecat cupidatat non proident, sunt in 
culpa qui officia deserunt mollit anim id est laboryum,. 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit sed do 
elusmod tempor ingirdidunt ut labore et dolore magna aliqua, Wt 
enim ad minim veniam, quis nostrud exercitation ullameo laboris 
nisi ut aliguip ex ea commodo consequat. Duis aute irure dolor in 
reprehendert in volupiate velit esse cillum dolore ey fugiat nulla 
pariatur, Excepteur sint Occaecat cupidatat non proident, sunt in 
culpa gui officia deserunt moallit anim id est laborum. 


Lorem ipsum 

Lerem ipsum doler sit amet, consectetur adipiscing elit, sed de 
elusmod tempoer incididunt ut labore et dolere magna aliqgua. Ut 
enim ad minim veniam, quis nostrud ewercitation ullamco labors 
Nisi ut aliguip ex ea ComModo consequat. Duls aute Irure dolor Im 
reprehenderit in voluptate velit esse cillum dolore ey fugiat nulla 
pariatur., Excepteur sint occaecat cupidatat non Proident sunt in 
culpa qui officia deseryunt mollit anim id est laboryum,. 


Lorem ipsum 

Lorem ipsum deler sit amet, consectetur adipiscing elit, sed de 
eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut 
enim ad minim weniam, quis nostrud exercitation ullameo laboris 
nisi ut aliquip ex ea comMmodo consequat. Duis aute irure dolor in 
reprehenderit in Voluptate velit esse cillum dolore eu fugiat nulla 
panatur, Excepteur sint occaecat cupidatat non proident, sunt in 
culpa gui officia deserunt mollit anim id est laborum, 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do 
elusmod tempor incididunt ut labore et dolore magna aliqgua. Ut 
enim ad minim veniam, quis nostrud exwercitation ullamco labons 
nisi Ut aligquip ex ea commodo consequat. Duis aute irure dolor in 
reprehenderit in voluptate velit esse cillum dolore ey fugiat nulla 
pariatur, Excepteur sint occaecat cupidatat non proident, sunt in 
culpa qui officia deseryunt molltt anim Id est laborym, 


Lorem ipsum 

Lorem ipsum dolor st amet, consectetyr adipiscing elt, sed do 
elusimod tempor inecididunt ut labore et dolore magna aliqua. Ut 
enim ad minim veniam, quis nostrud ewercitation ullameo labons 
nisi ut aliqguip ex ea ComModo consequat. Duis aute irure dolor im 
reprehenderit im voluptate velit esse cillum dolore ey fugiat nulla 
pariatur, Excepteuyr sint occaecat cupidatat non proident, sunt im 
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Test Overflow 


Lorem ipsum 

Lorem ipsum dolor st amet, consectetur adipiscing elit, sed do eilusmod tempor incididunt ut 
labore et dolore magna aligua. Lt enim ad minim veniam, gyis nostrud exercitation ullamco laborns 
nisi ut aliguip ex ea commMmodo consedquat. Duis aute irure dolor im reprehenderit im voluptate velit 
esse cillyum dolore eu fugiat nulla panatuyr. Excepteur sint occaecat cuplidatat non proident, sunt In 
culpa quil officia deserunt moallit anim id est laboerum. 


Laorem ipsum 

Lorem ipsum dolor st amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqua, Ut enim ad minim veniam, gyis nostrud ewercitation ullamco laboris 
nisi ut aliqgyuip ex ea commodo consegquat. Dyuts aute Irure dolor In reprehendertt In woluptate weltt 
esse clllum dolore eu fugiat nyulla panatuyur. Excepteur sint occaecat cupidatat non proident, sunt In 
culpa qui officia deserunt moallit anim id est laborum. 


Lorem ipsum 
Lorem ipsum dalor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqgua. Ut enim ad minim veniam, gyis nostrud exercitation ullamco laboris 


nisi ut aligquip ex ea commodo consegcuat Duis aute irure dolor in reprehenderit in voluptate velit 
esse cillum dolore eu fugiat nulla pariatur Excepteur sint occaecat cupidatat non proident, sunt in 
culpa qul officia deserunt mollt anim Id est laborum, 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullameo laborns 
nisi ut aliguip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate welit 
esse cillum dolore eu fugiat nulla Paniatur Excepteur sint occaecat cupidatat non proident, sunt in 
culpa qui officia deserunt mollit anim id est laborum. 


Lorem ipsum 

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut enim ad minim veniam, quis Nostrud exercitation ullameco laboris 
nisi ut aliqguip ex ea comMmodo consequat. Duis aute irure doloar in reprehenderit im voluptate welit 
esse cillum dolore ey fugiat nulla Pariatur Excepteur sint occaecat cupidatat non proident, sunt in 
culpa qui officia deserunt mollit anim id est laborum. 
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36.8 ”上演 


越 来 越 多 的 Windows 10 设备 在 使 用 钢笔 。 对 于 钢笔 来 说 ， 上 墨 是 一 个 重要 的 概念 ，Windows 应 用 程序 很 
容易 文 持 它 。 用 户 只 需要 使 用 InkCanvas 控件 来 进行 一 些 绘图 。 该 控件 支持 使 用 钢笔 、 和 触摸屏 和 鼠标 来 上 墨 ， 
还 支持 检索 所 有 已 创建 的 笔触 ， 从 而 可 以 保存 该 信息 (代码 文件 mkSample/MainPage.xam): 


<Grid Background="{ThemeResource ApplicationPrageBackgroundThemeBrush}"> 
<InkCanvas Xx:Name="inkCanvas" Margin="8,32,8,8" /> 
<1—— ... 一 -> 


默认 情况 下 ，InkCanvas 控件 配置 为 文 持 钢笔 。 还 可 以 通过 设置 InkPresenter 的 InputDevicesType 属性 ， 来 
定义 它 来 支持 鼠标 和 人 触摸屏 (代码 文件 mkSample/MainPage.xamlcs): 


public MainPage () 
{ 
this.InitializeComponent(); 
inkCanvas. TInkPresenter. InputDevicelypes = CorelnpeutDeviceTypes.Mouse | 
CoreInputDeviceTypes.Touch | CorelInputDeviceTypes.Pen; 
Colorselectiocon = new Colorselection (inkCanvas); 
} 


有 了 InkCanvas, 就 可 以 使 用 输入 设备 , 使 用 黑 笔 创 建 相同 的 绘图 。 要 更 改 钢笔 配置 , 还 有 一 个 mkToolBar。 
这 个 工具 栏 需要 使 用 TargetInkCanvas 属性 与 mkCanvas 关联 。 在 示例 应 用 程序 中 ， 男 一 个 位 于 InkToolbar 右 侧 
的 工具 栏 使 用 墨水 笔触 打开 并 保存 文件 (代码 文件 InkSample/MainPage.xam)): 


<RelativePanel VerticalAliagnment="Top"> 

<InkToolbar x:Name="inkToolbar" RelativePanel.AlijoqgnLeftWithPFanel="True"™ 
RelativePanel.AlignTopWithPanel="True"™ 
TargetInkCanvas="{x:Bind inkCanvas}" /> 

<CommandBar RelativePanel .Rightof="inkToolbar™ 
Template="{StaticResource CommandBarControlTemplatel}"> 
<AppBarButton Icon="OpenFile™" IsCompact="True™" Click="{x:Bind OnLoad}" 

ToolTipService.ToolTip="Open File™ /> 

<AppBarButton Icon="Save™" IsCompact="True™" Click="{xXx:Bind Onsave}™" 
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ToolTipService.ToolTip="Save™" /> 
<AppBarButton Icon="Clear™" IsCompact="True" Click="{x:Bind OnClear}" 
ToolTipService.ToolTip="Clear™ /> 
</CommandBar> 
</RelativePanel> 


InkToolBar 提供 自 定义 钢笔 的 颜色 和 大 小 的 按钮 ， 如 图 36-19 所 示 。 还 可 以 选择 标尺 (参见 图 36-20) 和 量 角 
器 (参见 图 36-21)。 
Tm x 


Colors 


size 


InkSample 


VY YY FF 


36-20 


1010 | 第 部 分 应 用 程序 


InkSample 
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图 36-21 


如 前 所 述 ，InkCanvas 控件 还 支持 访问 已 创建 的 笔触 。 下 面 的 示例 使 用 这 些 笔触 将 其 存储 在 一 个 文件 中 。 
使 用 FileSavePicker 选择 文件 。 当 用 户 单 击 先前 创建 的 Save AppBarButton 时 ， 将 调用 OnSave 方法 。 首 先 ， 通 
过 分 配 月 动 位 置 、 文 件 类 型 扩展 名 和 文件 名 来 配置 FileSavePicker。 译 少 需 要 添加 一 个 文件 类 型 选项 ， 以 允许 用 
户 选 择 文件 类 型 。 调 用 PickSaveFileAsync0 方 法 时 ， 将 要 求 用 户 选 择 一 个 文件 。 该 文件 通过 调用 
OpenTransactedWriteAsync0 方 法 来 打开 事务 写 入 访问 。InkCanvas 的 笔触 保存 在 InkPresenter 的 StrokeContainer 
下 。 笔 触 可 以 通过 SaveAsync 方法 直接 保存 到 流 中 (代码 文件 InkSample/MainPage.xaml.cs): 


private const string FileTypeExtension = ".strokes"™; 
Public async void OnsSave () 
{ 
Var Picker = new FileSavePicker 
{ 
SuggestedStartLocaticon = PickerLocationId.PicturesLibrary, 
DefaultFileExtension = FilelTypeExtension, 
SuggestedFileName = "sample" 
上 


Picker .FileTypeChoices.hAdd("Stroke File", new List<string>() 
{ FileTypeExtension }).; 


StorageFile file = await picker.PickSaveFilehsync().; 
1if {file != null) 
{ 
using (StorageSstreamTransaction tx = await file.OpenTransactedWriteAsync()) 
{ 
await inkCanvas.InkPresenter.StrokeContainer.SaveAsync (tx.Stream); 
awalt tx.CommitAsync (); 
} 
} 
} 


注意 ; 
使 用 FileOpenPicker 和 FileSavePicker 来 读 写 流 详 见 第 22 章 。 


要 加 载 文 件 ， 可 以 通过 LoadAsync 方法 使 用 FileOpenPicker 和 StrokeContainer( 代 码 文件 InkSample/ 
MainPage.xaml.cs): 
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public async volid OnLoad{() 

PICKeI = new FileOpenPicker 

SuggestedSstartLocation = PickerLocationId.PicturesLibrary 
上 

picker.FileTypeFilter.Add (FileTypeExtension); 


StorageFile file = await plicker.PickSinglerFrileAsync(); 
IE (file != null) 
{ 


using (var stream = await file.OpenReadAsync()) 
{ 
await inkCanvas. InkPresenter.StrokeContainer.LoadAMsync (stream); 
} 
} 
} 


运行 应 用 程序 时 ， 如 图 36-22 所 示 ， 很 容易 使 用 钢笔 创建 给 图。 如 果 没 有 笔 ， 也 可 以 用 手指 触摸 设备 或 使 
用 鼠标 ， 因 为 InputDeviceTypes 属性 已 经 做 了 相应 的 配置 。 


InkSample 


图 36-22 


36.9 ”自动 建议 


Windows 的 搜索 功能 有 一 段 时 间 的 历史 了 。 在 Windows 8 中 ， 搜 索 功 能 位 于 用 户 需要 滑动 才能 打开 的 功能 
区 上 。 在 Windows 10 中 ， 它 被 SearchBox 控件 所 取代 。 现 在 ，SearchBox 被 AutoSuggestBox 控件 所 取代 。 该 控 
件 允 许 用 户 在 控件 中 输入 内 容 时 ， 回 用 户 提供 建议 。 

这 个 控件 有 三 个 重要 事件 。 一 旦 用 户 在 控件 中 输入 内 容 ，TextChanged 事件 就 会 被 触发 。 在 示例 代码 中 ， 
调用 OnTextChanged 处 理 程序 方法 。 如 果 同 用 户 提 供 了 建议 , 而 用 户 选 择 了 该 建议 , 就 会 触发 SuggestionChosen 
事件 。 在 用 户 输 入 文本 (可 能 是 建议 或 键入 的 其 他 单词 ) 之 后 ， 就 触发 QuerySubmitted 事件 (代码 文件 
AutoSuggestSample/MainPage.xaml): 


<AuUutoSuggestBox Header="Formula 1 Champion™" 
TextChanged="{Xx:Bind OnTextChanged}™" 
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Suggest1iIonchosen=" {X:BIna OnSsuggestionChosen}™" 
QuerySubmitted="{x:Bind OnQuerySubmitted}™ /> 


为 了 用 一 些 示例 代码 创建 建议 ， 请 使 用 HttpClient 类 从 http://www.cninnovation.com/downloads/Racers.xml 
中 加 载 包含 方程 式 1 冠军 的 XML 文件 。 导 航 到 页 面 ， 检 索 XML 文件 ， 将 内 容 转 换 为 Racer 对 象 列 表 ( 代 码 文 
件 AutoSuggestSample/MainPage.xaml.cs): 


private const string RacersUri = 
"http://waw.cninnovation.com/downloads/Racers .xml"; 
private IEnumerable<Racer> racers; 


protected async override void OnNavigatedTo (NavigationEventArgs e) 
{ 

base.onNavigatedTo (e); 

RElement xmlRacers = null; 

USing (Var client = new HttpClient ()) 

usSing (Stream stream = await client.GetSstreamAsync (RacersUri)) 


{ 


XmlRacers = KElement.Loadlstream); 
} 
racers = xmlRacers.Elements ("Racer") .Select (rr => new Racer 
{ 

FirstName = Ir.Element ("Firstname™") .Value, 


LastName = Ir.Element ("Lastname") .Value, 
Country = Ir.Element ("Country") .Value 
}) .ToList().: 
} 


Racer 类 包含 FirstName、LastName、County 属性 和 ToString 方法 的 重 载 (代码 文件 AutoSuggestSample/ 
Models/Racer.cs): 


Public class Racer 
{ 

public string FirstName { get; sets; } 

public string LastName { get; set; } 

public string Country { get; set; } 

Public override string ToSsString() => $"{FirstName} {LastName}, {Country}"} 
} 


只 要 AutoSuggestBox 的 文本 发 生变 化 ， 就 会 调用 OnTextChanged 事件 。 接 收 的 参数 是 AutoSuggestBox 本 
身 ( 发 送 者 ) 和 AutoSuggestBoxTextChangedEventArgs。 使 用 AutoSuggestBoxTextChangedEventArgs， 发 生变 化 的 
原因 显示 在 Reason 属性 中 。 可 能 的 原因 包括 UserInput、ProgrammaticChange 和 SuggestionChosen。 只 有 原因 是 
UserInput， 才 需要 回 用 户 提 供 建议 。 这 里 还 进行 了 检查 ， 以 查看 用 户 是 否 输 入 了 至少 两 个 字符 。 通 过 访问 
AutoSuggestBox 的 Text 属性 来 检索 用 户 输入 。 此 文本 基于 输入 字符 串 查 询 名 字 、 姓 氏 和 国家 。 得 询 的 结果 分 配 
给 AutoSuggestBox 的 ItemsSource 属性 (代码 文件 AutoSuggestSample/MainPage.xaml.cs): 


private void OnTextChanged (ButoSuggestBox sender., 
AutoSuggestBoxTextChangedEventArgs args) 
{ 
if (args.Reason == AutoSuggestionBoxTextChangeReason.UserInput && 
sender.Text .Length > 一 Zz) 
{ 
string input = sender .Text.; 
var ITacers = racers.Where! 

r => Ir.FirstName.startsWith (input, 
StringCcomparison.CurrentCultureIgnoreCase)) 
.OrderByl(r => Ir.FirstName) .ThenBy(r => Ir.LastName) 
-ThenBy(r => Ir.Ccountry) .ToBrravl(}s 


if (racers.Length == 0) 
{ 
racers = racers.Wherel(r => r.LastName.SsStartsWith (Input， 
StringComparison.CurrentCulturelgnoreCase)) 
-OrderByl(r => Ir.LastName) .ThenByl(r => Ir.FirstName) 
.ThenBy{(r 一 > Ir.Ccountry) .ToBrrav(}; 


if (racers.Length == 0) 
{ 


racers = racers.Wherel(r => r.Country.startsWith (input, 
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stringComparison.CurrentCultureIgnoreCase)) 
-OrderByl{r => Ir.Country) .ThenByl(r 一 > Ir.LastName) 
-ThenBy (rr => 工 -FITStName) .ToArray (};} 
} 
} 


sender.ItemsSource = racers,; 
} 
} 


运行 应 用 程序 , 在 AutoSuggestBox 中 输入 Aus 时 , 该 查询 无 法 从 该 文本 中 找到 名 字 或 姓氏 , 但 找到 了 国家 。 
建议 列表 中 显示 了 来 目 以 Aus 开头 的 国家 的 一 级 方程 式 冠 和 车， 如 图 36-23 所 示 。 


Autosuggestsample 


AutoSuggest 


Start writing a name of a Formula 1 champion by firstname, lastname, or country, e.g. Jack, Vettel, Lewis, Austria, ltaly 
Formula 1 Champion 


Aus 


Jack Brabham, Australia 


Alan Jones, Australia 


NI Lauda, Austria 


Jochen Rindt, Austria 


图 36-23 


如 果 用 户 选 择 了 其 中 一 个 建议 ， 将 调用 OnSuggestionChosen 处 理 程序 。 建 议 可 以 从 AutoSuggestBox- 
SuggestionChosenEventArgs 的 SelectedItem 属性 中 检索 : 


private async void OnSuggestionCchosen (AutoSuggestBox sender, 
AutoSuggestBoxSuggestionChosenEventArgs args) 

{ 
Var dlg = new MessageDialog($"suggestion: {args.SelectedItem}"); 
await dlg.SsShowAsync(}); 

} 


无 论 用 户 是 否 选 择 了 建议 ， 都 会 调用 onQuerySubmit 方法 来 显示 结果 。 结 果 显 示 在 AutoSuggest Box Query 
SubmittedEventArgs 参数 的 QueryText 属性 中 。 如 果 选 择 了 建议 ， 结 果 可 以 在 ChosenSuggestion 属性 中 找到 ; 


private async void OnQuerySubmitted (AutoSuggestBox sender, 
AutoSuggestBoxQuerySubmittedEventArgs args) 
{ 

string message = $"query: {args.QueryText}".; 

if (largs.ChosenSuggestion != null) 

{ 

message += $" suggestion: {args.CchosenSuggestion}"; 

} 

Var dlg = new MessageDialog (message); 

await dlg.SsShowAsync().; 


36.10 ”小结 


本 章 介 绍 了 编写 Windows 应 用 程序 的 更 多 内 容 ， 讨 论 了 生命 周期 与 Windows 桌面 应 用 程序 的 区 别 ， 以 及 
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如 何 啊 应 Suspending 事件 。 

与 其 他 应 用 程序 的 交互 是 使 用 共享 协定 实现 的 。DataTransferManager 用 于 给 其 他 应 用 程序 提供 HTML 数 
据 。 实 现 “ 共 享 目标 ”协定 ， 就 可 以 接收 其 他 应 用 程序 的 数据 。 

本 章 展 示 了 已 编译 绑 定 的 一 些 特 性 ， 比 如 将 属性 绑 定 到 方法 和 分 阶段 。 

下 一 章 继续 讨论 XAML 在 使 用 Xamarin 的 iPhone 和 Android 移动 设备 上 的 应 用 。 


二 


Xamarin.Forms 


本 章 要 点 

Xamarin 开发 工具 

Android 和 iOS 的 应 用 程序 架构 
使 用 Xamarin .Forms 

页 面 

导航 

布局 

视图 

数据 绑 定 和 命令 


本 章 源 代码 下 载 : 

打开 www.wrox.com 的 Download Code 选项 卡 可 下 载 本 章 源 代码 。 源 代码 也 可 以 在 Xamarin 和 
PatternsXamarinShared 目录 的 https://github.conyProfessionalCSharp/ProfessionalCSharp7 中 找到 。 

本 章 代 码 分 为 以 下 几 个 主要 的 示例 文件 : 

® AndroldSsample 

® liPhoneSsample 

® BooksAppX (Xamarin.Forms) 


37.1 Xamarin 开发 入 门 


移动 应 用 开发 主要 在 两 个 产品 之 间 共 享 : 苹果 的 iOS 和 谷歌 的 Android。iOS 的 本 机 开发 是 使 用 编程 语言 
Objective-C 或 SWi 人 ft、Cocoa 和 Cocoa Touch 框架 完成 的 。Cocoa 是 苹果 API 的 名 称 。 在 为 Android 开发 时 ， 可 
以 使 用 谷歌 的 Android 软件 开发 工具 包 ， 而 Java 是 主要 的 编程 语言 。 

可 以 使 用 C# 和 XAML， 而 不 是 使 用 不 同 的 编程 语言 重 写 代 码 。Xamarin 提供 蜂 平 台 开 发 ， 但 仍然 可 以 使 用 
本 机 API。 

由 于 Xamarin 被 微软 收购 ， 并 且 Visual Studio 中 的 Xamarin 工具 集成 越 来 越 好 ， 因 此 许多 使 用 路 平台 技术 
的 应 用 程序 可 以 提高 生产 率 。 
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本 章 介绍 如 何 开始 创建 Xamarin 应 用 程序 。 使 用 从 其 他 章节 学 到 的 有 关 C#、.NET Core 和 XAML 的 基础 ， 
在 阅读 本 章 后 , 就 可 以 使 用 Xamarin 开始 应 用 程序 开发 了 。 其 他 专门 讨论 Xamarin 的 书 中 还 有 很 多 这 方面 的 内 
容 ， 这 是 一 个 好 的 开始 。 


注意 : 

要 创建 和 编译 本 章 中 的 示例 ， 需 要 在 Windows 系统 上 安装 Mobile Development with NET 工作 负载 。 另 一 
个 选项 是 ， 可 以 使 用 Visual Studio for Mac。 拥有 Android 手机 有 助 于 运行 Android 应 用 程序 。 要 创建 和 编译 
iOS 示例 ， 需 要 使 用 Mac 进行 编译 ， 而 iPhone 也 很 有 用 。 


37.1.1 用 Android 架构 Xamarin 


为 Android 手机 创建 Xamarin 应 用 程序 时 ， 知 道 幕 ow 
后 发 生 了 什么 是 很 不 错 的 。 图 37-1 给 出 了 一 个 架构 概 .NET APls 了: Android SDK 
括 。Android 在 Linux 内 核 上 运行 。 在 Google 中 可 以 看 Acw 


到 , Android SDK 在 Android 运行 库 (ART) 之 上 运行 。 该 
图 的 左 侧 显示 了 .NET 部 分 一 一 使 用 .NET Mono 运行 库 pe ART 


的 .NET API。 Mono 运行 库 和 ART 在 应 用 程序 进程 中 


并 行 运 行 。 Mono Callable Wrapper(MCW) 用 于 从 .NET a 
中 调用 Android SDK。 反 过 来 也 是 可 能 的 : 为 了 从 


Android 进入 .NET， 可 使 用 Android Callable 图 37-1 

Wrapper(ACW)。 用 户 过 去 可 能 使 用 过 .NET 与 COM( 来 

目 Microsof 的 组 件 对 象 模型 )。 在 这 里 ， 该 体系 结构 与 Runtime Callable Wrappers(RCW) 和 COM Callable 
Wrappers(CCW) 非 常 相似 。 为 了 便于 从 .NET 进入 Android SDK，Xamarin 创建 了 Android 绑 定 。 

如 果 想 使 用 的 现 有 Java 库 不 属于 从 .NET 中 调用 的 Android SDK， 则 可 以 创建 MCW。 

Xamarin.Android 使 Android 中 的 Java API 可 用 于 .NET， 而 且 它 非常 庞大 。 这 些 API 可 以 在 
https:/Wdeveloperxamarin.comyapirootMonoAndroid-lib/ 上 找到 。 这 里 只 提 及 几 个 重要 的 名 称 空间 : Android.App 
名 称 空间 带 有 Activity 类 和 用 于 长 时 间 运 行 的 后 台 操 作 的 Service 类 ， 以 及 带 UI 元 素 的 Android.Widget 名 称 空间 。 

Xamarin 网 站 上 的 文档 遗漏 了 很 多 可 以 直接 在 https:/Wdeveloperandroid.comyreference/packages. html 上 阅读 的 
信息 。 在 映射 类 型 时 ， 来 自 https://developer.android.com 的 信息 比较 适用 。 


37.1.2 用 iOS 架构 Xamarin 


iOS 上 Xamarin 应 用 程序 的 体系 结构 是 不 同 的 。 由 于 iOS 上 的 安全 限制 ， 不 允许 在 设备 上 执行 动态 生成 的 
代码 。 这 就 是 为 什么 Xamarin 使 用 提前 (AOT) 编 译 器 将 从 C# 编 译 器 创建 的 开 代码 编译 为 本 机 代码 的 原因 。 这 
提供 了 很 好 的 运行 性 能 和 更 好 的 启动 时 间 ， 但 它 也 有 一 些 限制 。 C# 将 泛 型 编译 为 泛 型 工 类 型 。 使 用 泛 型 类 型 
和 即时 (JIT) 编 译 器 ， 当 二 代码 在 运行 期 间 被 编译 时 ， 会 解析 泛 型 。 使 用 AOT 编译 器 ，I 代码 需要 在 部 署 到 设 
备 上 之 前 进行 编译 。 所 以 泛 型 不 能 用 于 某 些 场景 。 例 如， 不 能 在 派生 自 NSObject 的 类 中 创建 泛 型 方法 。 泛 型 也 
不 能 用 于 P/ Invoke。 对 于 Android.iOS，P / Invoke 用 于 使 用 C# 定 义 方法 ， 但 它 使 用 Objective-C 中 的 实现 。 而 
且 , 反射 是 有 限 的 。 不 能 用 反射 发 射 代 码 , 动态 生成 代码 是 不 允许 的 。 由 于 工 代码 已 经 预 编译 , Mono iOS Runtime 
中 的 更 多 功能 被 禁用 ， 例 如 元 数据 验证 程序 和 JIT 引擎 。 

图 37-2 给 出 了 Xamarin 的 iOS 体系 结构 的 概览 图 。 iOS 使 用 类 似 于 UNIX 的 内 核 ，Objective-C 运行 库 
和 iOS API 在 其 顶部 。.NET API 绑 定 到 iOS API， 以 提供 相同 的 功能 ， 并 使 用 AOT 编译 器 和 删 减 版 的 Mono 
运行 库 。 
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= 


.NET APls 


i iOS APIs 


Fuyll AOT Objective-C 
Mono Runtime Runtime 


UNIX-like 


图 37-2 


在 https://developer.xamarin.com/apiroot/ ios-unified /上 可 以 找到 Xamarin.iOs 的 文档 。Xamarin for iOS 提供 
了 许多 SDK。 用 户 界 和 面 的 主要 部 分 是 UIKit 名 称 空 间 。 Apple 的 信息 可 以 在 https://developer.apple.cony 
documentation/uikit 中 找到 。 

幸运 的 是 ， 可 以 使 用 C# 和 XAML 为 这 些 平台 开发 。 Xamarin 提供 跨 平 台 的 开发 ， 但 它 仍然 使 用 平台 的 所 


注意 : 

为 什么 用 户 界 面 的 iOS 类 具有 UI 前 级 。 原因 是 Objective-C( 用 于 实现 本 机 iOS 应 用 程序 的 编程 语言 ) 不 支 
持 名 称 空间 。 为 了 避免 与 其 他 类 的 冲突 ， 用 户 界面 的 类 具有 UI 前 缓 ， 而 来 自 其 他 区 域 的 类 具有 其 他 前 缓 。 
义 amarin.iOS.Contacts 名 称 空间 中 的 类 有 具有 前 级 CN， 例 如 CNContact。 


注意 : 

Xamarin.iOS( 经 典 ) 与 Xamarin.iOS 不 同 ， 它 也 标记 为 “统一 ”。Xamarin.iOS( 经 典 ) 仅 适用 于 iPhone， 而 更 
新 版 本 的 Xamarin.iOS 为 Phone、 iPad 和 Mac 使 用 统一 的 API. 经 典 的 API 也 仅 限于 32 位 , 不 再 能 在 App Store 
中 使 用 。 


37 .1.3 Xamarin.Forms 


有 了 Xamarin， 可 以 使 用 Xamarin.Android 创建 Android 应 用 程序 ， 使 用 Xamarin.iOs 创建 iOS 应 用 程序 ， 
或 者 使 用 Xamarin.Forms 创建 适用 于 Android、iOS、Windows 和 更 多 平台 的 应 用 程序 。 

有 了 Xamarin. Android， 就 可 以 使 用 完整 的 API 和 Android SDK 的 所 有 控件 。 借助 XamariniOS， 可 以 看 
到 可 从 C# 中 访问 的 所 有 iOS SDK。 使 用 Xamarin Android 或 Xamarin.iOs 时 ， 可 以 创建 单独 的 用 户 界 面 并 使 
用 平台 特定 的 代码 ， 但 可 以 共享 业务 逻辑 和 服务 。 

使 用 XamarinForms， 可 以 共享 用 户 界面 代码 ， 还 可 以 使 用 XAML 代码 创建 用 户 界面 。 但 是 ， 与 使 用 矢 
量 图 形 绘制 元 素 的 通用 Windows 平台 相反 ，Xamarin.Forms 使 用 每 个 平台 的 本 机 控件 呈现 用 户 界面 。 

使 用 本 机 控件 具有 很 大 的 优势 ， 因 为 可 以 获得 每 个 平台 上 本 机 控件 的 外 观 和 性 能 。 不 过 ， 本 机 控件 也 有 
一 个 缺点 。 使 用 Xamarin.Forms， 只 能 获得 可 映射 到 每 个 平台 的 控件 ， 得 不 到 仅 在 Android 上 可 用 的 控件 。 可 
以 实现 一 个 自 定义 的 特定 于 平台 的 泻 染 器 ， 以 使 用 不 能 直接 从 Xamarin.Forms 上 访问 的 、 平 台 特 有 的 控件 或 


注意 : 
还 记得 Windows 窗 体 吗 ? Windows 窗 体 是 本 机 Windows 控件 的 一 个 包装 器 。 也 许 选 择 Xamarin Forms 
这 个 名 字 是 因为 它 也 是 本 机 控件 的 包装 器 。Xamarin Forms 包装 了 iOS、Android 和 Windows 上 的 本 地 控件 。 
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37.2 Xamarin 开 友 工具 
为 Android 和 iOS 创建 应 用 程序 时 ， 需 要 了 解 支持 所 需 工 具 的 平台 版 本 。 
37.2.1 Android 


在 Windows 上 开发 时 ， 我 们 学 习 了 如 何 指定 开发 应 用 程序 的 最 低 版 本 和 目标 版 本 。 这 与 Android 非常 相 
似 。 对 于 Android， 用 户 有 Android 的 一 个 版 本 以 及 与 编号 的 API 级 别 相对 应 的 代码 名 称 。 

用 户 需 要 决定 想 文 持平 台 的 哪个 版 本 。 文 持 的 原因 可 能 是 市 场 上 的 分 销 。 表 37-1 列 出 了 Android 的 最 新 版 
本 及 其 代码 名 、API 级 别 ， 以 及 Android 手机 访问 Google Playground 的 百分比 。 在 2018 年 1 月 , Lollipop(5.0)、 
API 21 级 是 谷歌 支持 的 最 早 版 本 ， 但 KitKat 4.4 仍 占有 12.8% 的 市 场 份 额 。Marshmallow 的 市 场 份额 最 大 ， 达 
到 28.6% 。 可 以 使 用 这 些 信 息 来 决定 需要 支持 的 Android 版 本 。Oreo 于 2017 年 8 月 发 布 ， 但 其 市 场 份 额 仍 然 
落后 。 许 多 新 出 售 的 设备 没有 安装 最 新 的 Android 版 本 ， 并 不 是 所 有 的 手机 都 可 以 更 新 到 最 新 版 本 。 有 关 实 际 
发 行 版 ， 请 参阅 https: / developer.android.com/about/dashboards/index.html。 


表 37-1 


有 不 | 代 而 名 | MM | 改行- 同人 


4.4 KitKat 19 12.8% 使 用 云 服 务 打印 ， 新 的 存储 访问 框架 ， 基 于 NFC 的 事 
务 ， 人 硬件 传 感 器 批 处 理 ， 步 进 检测 器 和 步 进 计数 器 

5.0 Lollipop 21 25.1% 材料 设计 ， 新 部 件 

5.1 22 作业 调度 器 

了 了. 25 应 用 快捷 方式 (辅助 磁 贴 ) 

8.0 Oreo 26 0.79%6 自 适应 图 标 ， 可 下 载 的 字体 ， 

8.] 27 WebView API 


注意 : 

Android 代码 名 称 按 其 发 布 时 间 、 按 字母 顺序 排列 。 Cupcake(1.5) 之 后 是 Donut(1.6)、 Eclair(2.0)、 Froyo(2.2)、 
Gingerbread(2.3)、Honeycomb (3.0)、Ice Cream Sandwich (4.0)、Jelly Bean (4.1)、Kitkat (4.4)、Lollipop($.0), 
Marshmallow (6.0)、Nougat (7.0) 和 和 Oreo (8.0)。 


为 Android 开发 时 ， 需 要 为 支持 的 版 本 安装 Android SDK 以 及 模拟 器 。 微软 最 近 创建 了 自己 的 Android 和 
SDK 工具 扩展 , 以 便于 安装 Android 平台 和 工具 ( 见 图 37-3)。 可 以 从 Visual Studio Tools | Android | Android SDK 
Manager 上 访问 它 。 

还 可 以 使 用 通过 Android Emulator Manager 配置 的 模拟 器 。 如 果 可 以 使 用 真实 设备 ， 它 就 是 有 益 的 ， 它 们 
通常 比 模拟 器 更 快 。 应 该 在 多 个 设备 上 测试 。 来自 同一 硬件 供应 商 的 不 同 设备 可 能 会 有 不 同 的 表现 。 我 们 可 能 
会 从 不 同 的 供应 商 那 里 购买 使 用 不 同 平台 版 本 的 数 百 台 设 备 ， 因 此 有 一 个 选择 。 借 助 Visual Studio App Center， 
可 以 使 用 Test Cloud 在 数 千 个 物理 设备 上 测试 应 用 程序 。 只 需要 创建 一 个 民 测 试 ， 并 在 30 天 的 免费 期 后 支付 
每 月 费用 ， 这 可 能 比 购买 所 有 类 型 的 手机 便宜 。 
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(® Androd SDks and Tools 


Android SOK Locatiomn: tC"\Program Files (we N\Androld\androwd-sdk 


Platftorms | Tooils 


Check or uncheck items to install or ren 


到 [| Andraid SDK Platform 27 
DL] Android SCGK Platform 27 
3 国 | Android 8.0 - Oreo 60 ME 
| Android SDK Platform 26 2 60 MEB 


[] Sources tor Android 26 | 33 MB 


| Android Wear Intel xB6 Atom System Image 340 MB 
L_] China version of Android Wear Intel x86 Atom System Image : 308 MB 
DD Bndrod TV Intel wde Atom System lImage | 369 MiB 
图 oogle APls Intel xd6 Atom System Image tab ME 
画 Google APls Intel x Atom 64 System lImage 911 MB 
[] Gocogle Play lntel xB6 Atom System lmage 733 MB 
到 [|] Android 7.1 - Nougai 995 MB 
看 [| Android 7.0 - Nouwgat 78 MB 
四 [| Android 6.0 - Marshmallow 2 B67 MB 
到 [| Andraid 5.1 - Lallipep 
四 [ ] Android 5.0 Lallipep 
四 [| Android 4.4.87 - Kit Kat + Wear support 
四 [| Android 4.4 — Kit Kat 


3 Updates Avallable Apply Changes 


图 37-3 


要 使 用 Android 设备 ,需要 启用 它 以 进行 调试 。 然 后 将 其 连接 到 电脑 的 USB 器 口 。 尽 管 可 以 通过 在 Update 
设置 中 选择 Developer Mode， 为 开发 人 员 局 用 Windows 设备 ， 但 使 用 Android 需要 打开 Settings 页 面 ， 并 单 击 
构建 号 七 次 。 

37.2.2 iOS 


为 了 开发 iOS 应 用 程序 ， 需 要 一 台 Mac 来 构建 XCode。 如 果 使 用 的 是 Visual Studio 2016 版 本 15.6， 则 配 
对 变 得 非常 简单 。 从 Visual Studio Tools | 1OS | Pair to Mac, 可 以 与 Mac 配对 , 并 远程 安装 所 需 的 Android SDK。 
在 此 过 程 中 ， 还 可 以 获得 注册 Apple 门户 的 信息 ， 并 配置 物理 设备 ， 以 便 用 于 调试 。 

为 iOS 创建 应 用 程序 时 ， 还 需要 决定 文 持 哪个 10S 版 本 。 iOS 的 版 本 有 编号 ， 且 没有 太 多 需要 支持 的 设备 
类 型 。 要 查看 iPhone 和 iPad 设备 文 持 哪些 iOS 版 本 ， 请 访问 http:Wiossupportmatrix.comy。 

与 Android 用 户 相 比 ,iOS 用 户 在 更 新 iOS 版 本 时 速度 更 快 。 在 https://developer.apple.com/support/app-store/ 
中 可 以 查看 使 用 App Store 的 设备 数量 。 截至 2017 年 12 月 ， 使 用 iOS 11 的 用 户 占 59%， 使 用 iOS 10 的 用 户 
占 33% ， 使 用 早期 版 本 的 用 户 仅 占 8%%。 


3/.2.3 Visual studlo 2017 


除了 编译 XCode( 受 Apple 许 可 限制 ) 之 外 , Visual Studio 2017 还 具备 为 Android\iOS 和 Windows 创建 Xamarin 
应 用 程序 所 需 的 全 部 功能 。 如 果 安 装 了 Mobile Development with .NET 工作 负载 ， 就 将 获得 Android 应 用 程序 、 
iOS 应 用 程序 和 跨 平 台 应 用 程序 的 项 目 模 板 。Visual Studio 提供 了 Android SDK 的 安装 ， 可 以 使 用 Android 和 
iPhone 模拟 器 ， 并 且 可 以 为 Android XML(AXML) 文 件 和 iOS 故事 板 提供 设计 人 员 ，。 


3/.2.4 Visual Studlo forMac 


Visual Studiofor Mac 起 源 于 Mac 上 用 来 创建 Xamarin 应 用 程序 的 Xamarin Studio。 现 在 Visual Studio for Mac 
不 仅 名 称 改变 了 , 还 有 更 多 功能 。Visual Studio 的 编辑 器 现在 已 集成 , 还 可 以 创建 ASPNET Core Web 应 用 程序 。 

Visual Studio for Mac 包含 用 于 创建 iOS 和 Android 应 用 程序 的 项 目 模 板 。 无 法 使 用 Visual Studio for Mac 创 
建 Windows 应 用 程序 。 在 这 里 ，Visual Studio 需要 Windows 10 系统 。 

Visual Studio for Mac 与 Visual Studio 一 样 管 理 Android SDK 版 本 , 并 为 设计 人 员 提 供 AXML 文件 以 及 iOS 
故事 板 。 
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3/.2.9 Visual Studio App Center 


Visual Studio App Center(https://appcenter.ms) 已 经 在 Test Cloud for Android 设 备 中 提 及 。 测试 云 还 支持 iPhone 
和 iPad 设 备 。 使 用 UI 测 试 ， 可 以 自动 在 数 和 干 个 设备 上 测试 应 用 程序 。 

测试 不 是 Visual Studio App Center 的 唯一 功能 。 可 以 创建 目 动 构建 程序 ， 并 运行 单元 测试 ， 因 为 源 代码 已 
等 入 到 Visual Studio Team Services、GitHub 或 其 他 几 个 代码 存储 库 中 。 

可 以 使 用 Visual Studio App Center 作为 分 发 工具 ， 将 应 用 分 发 给 beta 测试 人 员 ， 并 获取 有 关 应 用 问题 的 信息 。 

最 后 ， 可 以 通过 应 用 分 析 获 取 生 产 中 的 应 用 的 良好 报告 ， 了 解 用 户 在 做 什么 ， 发 现 应 用 毅 误 的 位 置 ， 目 动 
将 问题 记录 到 源 代 码 库 中 。 


注意 : 
第 29 章 介 绍 了 Analytics 和 Visual Studio App Center。 


37.3 Android 基础 


在 进入 Xamarin.Forms 之 前 ， 最 好 了 解 一 些 平台 的 基础 信息 。 第 一 个 应 用 程序 是 Hello Android! App; 它 
是 使 用 Blank App (Android) 模板 创建 的 。 

应 该 检查 的 第 一 个 设置 是 Android Manifest, 可 以 从 Android Manifest 选 项 卡 的 Project Properties 上 访问 它 ( 请 
参见 图 37-4)。 在 这 里 ， 需 要 定义 Android 的 最 低 版 本 和 目标 版 本 ， 这 与 第 33 章 中 的 Windows 运行 库 配 置 类 
似 。 这 里 需要 选择 应 用 程序 支持 的 API 级 别 。 根 据 想 要 支持 的 设备 ， 可 以 使 用 可 用 的 功能 。 


大 | farnold 


[I 


Application name: 
时 iin pp nen 


Package name: 
HelloAndroid HelloAnadraid 


hpplication car 
Application therme 


Wersion number 
| 


Version Marme: 
10 


Inatall |ocatiare 


Prefer External 


Minmimiurs Arndrobd versiore 
Androiwd &0 (AP Level 23 - Barshrmallow) 


Targat hrndroid version 
Use Compile using SOK version 


DD AccESS COMRSE LOCATIGN 
DACEESS FINE_ LOCATION 
OAccESS LOCATION_ EXTRA COMMANDS 
口 AEcESS_NMOCK LOCATION 
LACCESS NETWORK STATE 

器 aceEss_ NOTIFICATION_POLIEY 
回 ] ACCESS SURFACE_ FUNGER 

品 ACCESS_ WIFI STATE 

DD ACEOUNT MANAGER 

口 ADD_WGHGEMALL 

器 ] 总 ITHENTICATE _ACCOUNTS 


各 


图 37-4 
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37.3.1 活动 


使 用 Android 时 ， 用 户 界面 屏幕 会 映射 到 一 个 活动 上 。 为 每 个 视图 创建 一 个 活动 。 Android 开发 利用 了 
MVC( 模 型 -视图 -控制 器 ) 模 式 。 活 动 类 是 控制 器 。 代 码 示例 显示 了 MainActivity 一 一 即 主 视图 的 活动 。 每 个 活动 
都 来 自 Activity 类 或 从 Activity 派生 的 类 。 通过 这 个 类 ， 可 以 重 写 由 Activity 基 类 提供 的 生命 周期 方法 。 在 创 
建 活动 时 ， 调 用 OnCreate 方法 。 

调用 方法 SetContentView， 会 定义 为 此 活动 定义 的 用 户 界 面 。 UI 在 资源 中 定义 ， 如 下 一 节 所 述 (代码 文件 
HelloAndroid / MainActivity.cs): 


[Activity (Label = "HelloAndroid™", MainLauncher = true})] 
public class MainActivity : Activity 


LIrotec ted override vold OnCreate (Bundle savedInstancestate) 
: base.oncreate (savedInstancestate). 

0 
SetContentVYVliew (Resource. Layout. Malin) 

} 

该 活动 定义 了 Android 应 用 程序 的 生命 周期 。 表 37-2 列 出 了 活动 的 生命 周期 方法 。 

表 37-2 
方 法 描 述 


OnCreate 在 创建 活动 时 调用 此 方法 ， 并 在 用 户 启动 应 用 程序 时 执行 主要 活动 。 视图 在 这 个 阶段 创建 。 
活动 的 生命 周期 在 OnCreate 和 OnDestroy 之 间 定 义 。 
这 个 方法 接收 一 个 带 参 数 的 Bundle。 捆绑 可 用 于 在 活动 之 间 传 递 数据 ， 并 在 重新 启动 后 恢复 数据 。 方法 
OnSaveInstanceState 在 活动 处 于 后 台 状 态 之 前 调用 ， 因 此 可 以 在 使 用 OnCreate 恢复 之 前 使 用 此 方法 写 入 数据 。 
在 此 阶段 创建 视图 、 初 始 化 变量 并 将 数据 绑 定 到 列表 

OnSstart 在 OnCreate 之 后 调用 Onstart。 当 活动 在 停止 后 重新 启动 时 ， 也 会 调用 此 方法 。 在 重新 局 动 时 ， 在 Onstart 之 前 
先 调 用 OnRestart。 
活动 的 可 见 生 命 周期 是 在 OnStart 和 OnStop 之 间 定 义 的 。 
在 活动 可 见 之 前 ， 设 置 需要 的 数据 

OnResume Onstart 之 后 的 下 一 个 方法 是 OnResume。 在 OnResume 之 后 ， 活 动 处 于 运行 状态 。 
活动 的 前 台 生 命 周 期 在 OnResume 和 OnPause 之 间 定 义 。 
在 这 里 ， 可 以 启动 动画 、 显 示警 报 、 侦 听 GPS 更 新 、 向 外 部 事件 添加 事件 处 理 程序 ， 这 是 活动 进入 前 台 之 前 所 


OnPause 当 另 一 个 活动 进入 前 台 时 ， 将 调用 OnPause。 如 果 用 户 返 回 到 活动 ， 并 且 再 次 出 现在 前 台 ， 那 么 下 一 个 方法 是 
OnResume. 
释放 在 OnResume 中 分 配 的 资源 。 该 方法 的 实现 应 该 是 快速 的 ,因为 只 有 当 OnPause 方法 完成 时 ， 用 户 的 下 一 个 
活动 才 会 启动 

Onstop 如 果 活 动 完全 隐藏 ， 则 调用 Onstop。 如 果 用 户 再 次 导航 到 该 活动 ， 则 调用 的 下 一 个 方法 是 OnRestart 和 OnStart。 
释放 在 Onstart 中 分 配 的 资源 

OnDestroy 活动 被 系统 破 十， 不 再 可 以 使 用 资源 。 许 多 应 用 程序 不 会 重 写 此 方法 ， 因 为 清理 资源 已 经 在 Onstop 和 OnPause 
中 完成 了 。 


如 果 有 一 个 长 时 间 运 行 的 资源 ， 比 如 在 OnCreate 中 启动 的 后 合 线程 ， 就 应 该 在 这 里 重新 设置 状态 。 
这 个 方法 不 能 保证 被 调用 。 活 动 可 以 被 用 户 或 操作 系统 停止 ， 而 不 调用 OnDestroy 
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37.3.2 资源 


在 Solution Explorer 中 ， 可 以 看 到 Resources 文件 夹 市 有 多 个 子 文件 夹 。drawable 文件 严 用 于 存储 图 像 。 视 
图 在 layout 文件 夹 中 定义 ，values 文件 夹 包含 简单 的 字符 串 。 

在 示例 代码 中 ， 字 符 串 资源 被 更 新 ， 以 包含 用 于 按钮 文本 、 应 用 程序 名 称 和 由 hello 标识 的 字符 串 ( 代 码 文 
件 HelloAndroid/Resources/values/Strings.xml)。 


<2xml version="1.0" encoding="utf-8"?> 
LILIESOUICeSs> 
<string name="main buttonl text">Click Mel</string> 
string name="app name">Hello Android</string> 
<string name="hello">Hello Android!l</string> 
<string name="somedata clickeditem title">Clicked Item</string> 
</resources> 
视图 是 使 用 AXML 文件 定义 的 ， 它 与 XAML 文件 有 相似 之 处 。LinearLayonut 是 一 种 安排 子 元 素 的 布局 控 
件 。 可 以 将 LinearLayout 与 StackPanel 类 进行 比较 ， 它 具有 相同 的 功能 。 在 示例 应 用 程序 中 ， 在 布局 内 部 添加 
一 个 按钮 控件 。 可 以 将 按钮 控件 从 工具 箱 拖 动 到 设计 器 。 带 有 属性 的 android 前 级 是 名 称 空间 
http://schemas.android.com/apK/res/android 的 别名 。 对 于 按钮 ，text 设置 为 字符 串 资 源 中 的 资源 字符 串 
main button text， 宽 度 设置 为 与 父 节 点 的 宽度 相 匹 配 ， 高 度 设置 为 换行 ， 以 免 一 行 放 不 下 。 将 id 分 配给 
@+idbutton1， 会 创建 一 个 新 的 卫 ， 名称 button1.@+id 是 在 设计 器 生成 的 文件 Resource.Designer.cs 中 创建 新 人 DD 
来 访问 按钮 的 快捷 方式 (代码 文件 HelloAndroid/ Resources/layout/Main.axml): 
<2xml] version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical™ 
android:1layout width="match parent"™" 
android:1layout height="match parent™" 
android:minWidth="25pXx" 
android:minHeight="25px"> 
<Button 
android:text="@string/main button text" 
android: layout width="match parent" 
android: layout height="wrap content" 
android:id="@+id/buttonl"™" /> 
</LinearLayout> 


在 活动 中 , 可 以 使 用 基 类 Activity 中 的 FindFyById 方法 访问 按钮 控件 , 通过 Resource.Id.button1 引用 传递 的 
ID。 在 代码 片段 中 ， 检 索 按钮 ， 以 添加 单 击 事件 处 理 程序 。 处 理 程序 的 实 
现代 码 回 用 户 显 示 一 个 通知 (代码 文件 HelloAndroid / MainActivity.cs): 


protected override void Oncreate (Bundle savedInstancestate) 
CLICK MEI 
{ 


信和 业 和 立 回 蓝 果 遇 和 来 替 下 上 自 910 


HelloAndroid 


base.oOncCcreate (savedInstanceSstate),; ee 


SetCcontentView (Resource.Layout.Main); 
Button buttonl = FindViewById<Button> (Resource.Id.button]l). 
buttonl .Click += (sender, e) => 
Toast.MakeText (ApplicationContext, "Helloe Android!"™", 
ToastLength.Long) .Show()..; 
} 


在 模拟 器 或 物理 设备 上 运行 应 用 程序 时 ， 按 钮 会 显示 ， 可 以 单 击 它 ， 
会 看 到 一 个 toast， 如 图 37-5 所 示 。 


Hello Anmdroid! 


37.3.3 显示 列表 


一 个 常见 的 场景 是 导航 到 页 面 ， 并 显示 列表 。 这 是 通过 应 用 程序 的 下 
一 个 增强 来 显示 的 。 为 此 ， 先 创建 一 个 模型 。 
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1. 定义 模型 
该 模型 是 一 个 简单 的 类 , 定义 了 一 些 属性 并 重 写 了 ToString 方法 (代码 文件 HelloAndroid/Models/SomeData.cs)。 


public class SomeData 
{ 

public int Number { get; set; } 

PUublic string Text { get; set } 

Public override string ToString{() => $"{Number} {Text}"™; 
} 


2. 使 用 ListActivity 

接 下 来 ， 创 建 一 个 活动 。 现 在 使 用 ListActivity 基 类 ， 而 不 是 从 Activity 基 类 中 派生 活动 。ListActivity 定义 
了 用 于 在 列表 中 选择 项 的 虚拟 属性 和 方法 。 在 创建 SomeDataListActivity 时 ， 将 创建 一 个 包含 示例 数据 的 集合 ， 
并 将 其 存储 在 items 字段 中 。 在 OnCreate 方法 中 ， 基 类 的 ListAdapter 属性 也 分 配给 SomeDataListAdapter 的 一 
个 新 实例 。 在 MainActivity 中 ， 活 动 的 用 户 界面 由 使 用 SetContentView 的 资源 定义 。 这 里 ， 使 用 适配器 来 提供 
用 户 界 面 。 该 活动 还 定义 了 重 写 方法 OnListItemClick， 以 显示 所 选项 (代码 文件 HelloAndroid/ SomeData 
ListActivity.cs): 


[Activity (Label = "SomeDataListActivity")] 

Public class SomeDataListActivity : ListActivity 

{ 
private IList<SomeData> 1ltems; 
protected override void Oncreate (Bundle savedInstancestate) 
{ 


base.oncreate (savedInstancestate). 


_items = Enumerable.Range (0, 100) 
.Select(i => new SomeData { Number = i, Text = S$"sample {i}" }) 
.ToList().; 
ListAdapter = new SomeDataListAdapter (this, items).,; 
} 


protected override void OnListItemClick (ListView 1, View Vv, int position, 
long 1id) 
{ 
//... implementation of the OnListItemClick event handler 
} 
} 


3. 实现 一 个 适配器 

SomeDataListAdapter 用 于 为 SomeDataListActivity 定义 UI。 这 个 类 的 核心 是 重 写 方法 GetView， 它 需要 返 
列表 中 每 一 项 的 视图 。 该 方法 接收 父 ViewGroup， 其 中 将 显示 该 项 的 视图 。LayoutInflater 将 AXML 文件 放大 
到 一 个 视图 中 。 可 以 为 资源 中 的 项 创建 视图 。 代 码 示例 为 Android 使 用 一 个 预定 义 的 AXML 文件 。 
Android.Resource.Layout.SimpleListIteml 返回 预定 义 AXML 文件 的 ID。 这 个 布局 使 用 TextView 元 素 定 义 一 个 
简单 的 项 。TextView 元 素 使 用 FindViewById 来 访问 ， 其 中 Text 属性 分 配给 项 中 的 信息 (代码 文件 
HelloAndroid/SomeDatalListA dapter.cs): 


Public class SomeDataListAdapter : BaseAdapter 
{ 

private readonly Activity activity; 

private readonly IList<SomeData> ltems; 


Public SomeDataListAdapter (Bctivity activity, IList<SomeData> items) 
{ 

activity = activity; 

items = items; 


} 

Public override Java.Lang.Object GetItem(int position) => position; 
PUublic override long GetItemIQG (Int position) => position; 

Public cwverride View GetView(int position, View convertView, 


ViewGroup parent) 
{ 
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Var View = ConvertView:; 
i£f£ (view == null) 
{ 
View = activity.LayoutInflater 
.Inflate (Android.Resource.Layout.SimpleListIteml, null); 
} 
view.FindViewById<TextView> (Android.Resource.Id.Textl1) .Text = 
$"{ items[position] .Number}: { items[lposition] .Text}",; 
return view,; 
} 
下 
Public override int Count => items.Count; 


} 


. 3: sample 3 

注意 : 
要 了 解 SimpleListIteml1 和 其 他 预定 义 布局 是 如 何 定义 的 ， 请 参阅 a 
https://github.com/aosp-muror/platform frameworks base/tree/ 0 
mastercoreTes/Tes/]ayonunt。 6: sample 6 


SomeDataListActivity 


4. 用 Android 导航 7: sample 7 


要 导航 到 SomeDataList 活动 ， 对 于 Android， 需 要 启动 活动 ， 并 传递 Ee 
活动 类 型 。 这 是 在 MainActivity 的 showlistButton 中 完成 的 (代码 文件 a 
HelloAndrold MamActivity.cs): 10: sample 10 


showlistButton.cClick += (sender, 8) => 11: sample 17 
StartActivity (typeof (SomeDataListActivity)}).; 


运行 该 应 用 程序 时 ， 可 以 看 到 从 SomeDataListAdapter 返回 的 条 目 列 
表 ， 其 中 包含 预定 义 的 SimpleListIteml 和 如 图 37-6 所 示 。 <| 


12: sample 12 


37.3.4 ”显示 消息 7 

在 Android 应 用 程序 的 第 一 个 按钮 上 ， 在 单 击 该 按钮 之 后 ， 就 会 显示 Toast。 如 何 从 UWP 中 显示 像 
MessageDialog 这 样 的 东西 ? 对 于 Android， 可 以 使 用 AlertDialog。 单 击 列表 中 的 项 时 ， 会 使 用 这 个 对 话 框 。 

在 使 用 对 话 框 之 前 , 需要 创建 它 。 要 创建 AlertDialog, 需要 实例 化 内 部 Builder 类 。 使 用 AlertDialog.Builder， 
可 以 使 用 SetMessage 定义 要 显示 的 消息 , 并 使 用 SetTitle 来 定义 要 显示 的 标题 ,。 为 了 定义 应 显示 的 按钮 , Builder 
类 定义 了 一 些 方法 ， 例 如 SetNeutralButton、SetPositiveButton 和 SetNegativeButton。 甚 至 可 以 创建 多 选项 
SetMultiChoiceItems。 在 代码 片段 中 ，SetNeutralButton 是 使 用 预定 义 的 资源 TRNACEIIGDECT 
字符 串 Android.Resource.String.OK 来 设置 的 。 在 配置 构建 器 之 后 , AlertDialog 
将 从 Builder 的 Create 方法 中 创建 。 最 后 ， 需 要 调用 Show 方法 来 显示 对 话 框 
(代码 文件 HelloAndroid/SomeDataListActivity.cs): 

protected override void OnListItemClick(ListView 1, View v, int 
position, 
long id) 
AlertDialog.Builder builder = new AlertDialog.Builder (this); Clicked ltem 


builder.SetMessage ($"clicked { items[position]}") 


。 clicked 12 sample 12 
-SetTitle (Resource.String.somedata clickeditem title)},; - 


builder.SetNeutralButton (Android.Resource.3tring.ok, (sender, e) => 
{ 
// user clicked the ok button 
}); 
AlertDialog dialog = builder.Create (); 


dialog.show(); 
} 


运行 该 应 用 程序 ，AlertDialog 如 图 37-7 所 示 。 
用 Android 构建 应 用 程序 提供 了 一 些 有 趣 的 方面 ， 但 其 开发 与 创建 
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Windows 应 用 程序 非常 不 同 。 与 iPhone 相似 的 场景 是 怎样 的 呢 ? 
37.4 iOS 基础 


使 用 Android.iOS， 创 建 Helloios 应 用 程序 。 要 创建 和 构建 这 个 应 用 程序 ， 需 要 一 个 安装 了 Xcode 的 Mac， 
这 样 构建 过 程 就 可 以 使 用 Xcode 引擎 了 。 所 创建 的 应 用 程序 是 从 使 用 Single View App (iPhone) 项 目 模板 开始 的 。 

所 生成 的 文件 Info.plist 包含 的 信息 与 Windows 应 用 程序 中 的 package.manifest 文件 类 似 (参见 图 37-8)。 在 
这 里 ， 可 以 配置 部 署 目标 ， 以 支持 在 应 用 程序 中 支持 的 iOS 版 本 ， 为 图 标 添 加 可 视 资 产 ， 配 置 功能 (例如 ， 当 需 
要 后 台 功 能 时 )， 并 配置 用 于 启动 应 用 程序 的 文档 类 型 。 


Application Wisual Assets Capablilities hcvanced 
Application Name: HelloiOs 


Bundle ldemtifier: eem.companyname.Helloils 


中 0 


|_| Upside Down [| Landscape Right 


status Bar Style: Default 
Hide status bar 


|_ | Requires full screen 


图 37-8 


37.4.1 iOS 应 用 程序 结构 


在 生成 的 代码 中 ， 有 一 个 Main0 方 法 作为 应 用 程序 的 入 口 点 。 调 用 UIApplication 类 的 静态 Main0 方 法 ， 消 
居 就 开始 对 事件 做 出 反应 。 这 需要 处 理事 件 的 应 用 程序 委托 的 名 称 (代码 文件 HelloiOS/Main.cs): 


public class Application 
{ 


static void Main(string[] args) 
{ 

UIApPlication.Main(largs, null, "AppDelegate").; 
} 


} 

AppDelegate 类 定义 了 应 用 程序 的 生命 周期 。 它 实现 的 功能 可 以 在 应 用 程序 局 动 时 用 于 初始 化 
(FinishedLaunching), 在 如 下 情况 下 通知 应 用 程序 : 使 用 OnResignActivation 从 活动 状态 转换 到 不 活动 状态 时 ( 例 
如 ， 打 一 个 电话 ); 当 用 户 将 另 一 个 应 用 程序 移动 到 前 台 (DidEnterBackground) 来 保存 用 户 数据 时 ; 当 应 用 程序 
回 到 前 台 (CWillEnterForeground) 时 ; 当 应 用 程序 被 激活 (OnActivated)， 以 重 局 暂停 任务 并 刷新 用 户 界 面 时 ; 当 应 
用 程序 被 终止 (WillTerminate)， 以 保存 数据 时 (代码 文件 HelloiOS/AppDelegate.cs): 

[Register ("AppDelegate") ] | 
public class AppDelegate : UIApplicationDelegate 
public override UIWindow Window 


{ 
get; 
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写 忆 七 > 


} 


public override bool FinishedLaunching (UIApplication application, 
NSDictionary launchoptions) 


{ 
return trues 


} 


public override void OnResignActivation (UIApplication application) 


public override void DidEnterBackground (UIApplication application) 


public override void WillEnterForeground (UIApplication application) 


Public override void OnActivated (UIAppPplication application) 


public override void WillTerminate (UIApplication application) 


37.4.2 故事 板 


iOS 应 用 程序 也 基于 MVC 模式 。 然 而 ， 在 ios 中 ， 用 户 界面 是 围绕 故事 板 来 组 织 的 。 故 事 板 定义 了 用 户 
与 视图 交互 的 流程 。 通 过 故事 板 设计 器 (参见 图 37-9)， 可 以 使 用 工具 箱 将 控制 器 和 控件 添加 到 故事 板 中 (参见 图 
37-10)。 


Eareh Toolbes PP": 
4 Controllers & Objects 
| kh Pointer 
AyPlayer View Controller 
Coallection View Controller 
Navigation Controller 
Object 
OpenGl ES View Controller 
Page View Controller 


Split View Controller 


Storyboard Reference 
Tab Bar Contraller 
Table View Controller 


(leh had 


ODOO0OO0@00O0OO0 


View Controller 


本 
而 


ontrols 
二 Pointer 
Actrvity Indicator View 
加 Button 
my [Label 
园 Page Control 
— Progress View 


Segmented Contral 

slider 

Slepper 

Switch 

Text Fiald 

Visual Effect View with Blur 


So08 上 oa 


Wisual Effect Views with Blur ard Vibraney 
Data Views 


RE Pointer 

国 ARRKit Scene View 

| ARKIt Sprite Wiew 

四 Viewing: iFhone 8 Plus 一 Portrait 一 wChR 起 回 callection Reusable View 


图 37-9 图 37-10 
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在 视图 中 添加 控件 (如 按钮 ) 时 ， 可 以 指定 属性 (参见 图 37-11)、 布 局 和 事件 (参见 图 37-12)。 可 以 使 用 Touch 
Down 或 Touch Up Inside, 而 不 是 将 Click 事件 赋予 按钮 。 当 按钮 内 的 触摸 事件 结束 时 , 会 触发 Touch Up Inside。 
当 按钮 外 的 触摸 事件 (例如 ， 用 户 将 手指 移 到 按钮 的 外 部 ) 时 ， 会 触发 Touch Up Outside。Touch Down 在 Touch In 
事件 发 生前 触发 ， 并 且 总 是 在 触摸 时 被 触发 。 对 于 典型 的 单 击 事件 ， 请 使 用 Touch Up Inside。 


EE a 


a Identity 二 Control Events 
Touch 


Name 
[ 员 .上 Down 
Module Down Repeat 


Restoration ID 


Up Inside 
Localization IC 
CrnBeuttoncllek 
二 Button 
Up Outside 
Type System 
LT 


Touch Drag 


|rside 


State Config Default 

Tithe Plain 
Cliek hhel 

Helvetica Neue ”| |17 Cutside 


Regular . Enter 


shadow Coler No Cola Changed 


Default Editing 
Did Begin 


37-11 37-12 
在 故事 板 设计 器 中 ， 可 以 通过 单 击 视图 左下 角 的 图 标 来 访问 与 视图 关联 的 控制 器 ， 这 会 显示 关联 控制 器 的 
属性 (参见 图 37-13)。 选 择 ViewController 时 ， 可 以 看 到 局 用 了 Is Initial View Controller 设置 。 该 设置 使 这 个 视图 
成 为 初始 UI。 


-ee em 

4a ldentity 
Cass Viewt entiraoller 
edule 
Storyboard ID 


Restoratidr ‖ 
L | Use Storyboard ID 


a Simulated Metrics 
Size Inferred 
Status Bar Inferred 
Tap Bar Inferred 


Bottom Bar Inferred 


a View Controller 
Title 


[i] is Initial View Controller 


Layeut 


WW) Adjust Scroll View Insets 

L | Hide Bottem Bar on Push 

网 Resize View From NIB 

| Use Full Screen (Deprecated) 


37-13 
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故事 板 设计 器 创建 了 一 个 XML 文件 , 其 中 Button 由 按钮 元 取 定义 , 单 击 事件 用 一 个 连接 和 一 个 操作 定义 。 
使 用 该 操作 定义 的 选择 器 在 关联 控制 器 的 设计 器 生成 的 代码 文件 中 定义 了 一 个 部 分 方法 : 
> destination~="BYZ—38-—t0Or™" 1id="1110" 


eventType="touchUpInside"/> 
</connections> 


37.4.3 ”控制 器 


与 故事 板 视图 相关 的 控制 器 类 派生 自 基 类 UIViewController。 控 制 器 管理 着 应 用 程序 模型 与 视图 之 间 的 交互 。 

基 类 UIViewController 管理 视图 的 布局 ， 包 括 大 小 调整 和 对 方向 变化 的 响应 。 在 这 个 文件 中 ， 还 实现 了 处 
理 程序 ， 以 响应 来 自 UI 元 素 的 事件 ， 如 下 所 示 ( 代 码 文 件 HelloiOS/ViewController.cs): 

public partial class ViewController : UIViewController 

0 handle})} : base (handle) 


{ 
} 


public override void ViewDidLoad{) 
{ 

base .ViewDidLoaqd(}; 
} 


public override void DidReceiveMemoryWarningl() 
{ 
base.DidReceliveMemoryWarning(); 
} 
ii-.--. 
} 


37.4.4 显示 消息 


通过 故事 板 中 的 按钮 声明 ， 为 touchUpInside 事件 定义 OnButtonClick。 这 在 控制 器 的 设计 器 生成 的 文件 中 
定义 了 一 个 名 为 OnButtonClick 的 局 部 方法 的 声明 。 Action ie id 
HellolOS/VliewController.desiener.cs): me 8 i051 


[Action ("OnButtonClick:")] 
[GeneratedCode ("103 Designer™, "1.0")] 
partial void OnButtonClick (UIKit.UIBuUutton sender});) 


在 目 定义 控制 器 实现 类 中 ， 现 在 可 以 实现 OnButtonClick 方法 了 。 
在 样 例 应 用 程序 中 ， 创 建 了 一 个 新 的 UIAlertView， 其 中 设置 了 Title 
和 Message 属性 。 使 用 AddButton 方法 添加 了 一 个 Close 按钮 。 最 后 ， 
要 显示 对 话 框 , 应 调用 Show 方法 (代码 文件 HelloiOS/ViewController.cs): 

public partial class ViewController : UIViewController 


{ 
6 


Hello 
partial void OnButtonClick (UIButton sender) Hello iosi 
{ 

alert = new UIAlertVliew Close 
Title = "Hello", 
Message = "Hello i0S!", 


上 
alert.AddButton ("Close™)s 
alert.clicked += (senderl, e) => 
{ 

/i dialog closed 


ee 
} 
} 


在 模拟 器 中 运行 应 用 程序 时 ， 可 以 看 到 带 有 UIAltertView 的 按 
钮 ， 如 图 37-14 所 示 。 
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37.5 Xamarin. Forms 应 用 程序 


现在 了 解 了 关于 Android 和 iOS 的 一 些 原 则 ， 下 面 从 Xamarin.Forms 开始 。 这 个 项 目 命 名 为 BooksAppX， 
并 使 用 第 34 章 中 用 于 视图 模型 和 核心 功能 的 库 。 这 些 库 的 项 目 位 于 文件 来 PatternsXamarinShared 中 。 

第 34 章 中 的 Windows 应 用 程序 项 目 展示 了 书籍 列表 和 一 本 书 的 详细 信息 。 同 样 的 功能 现在 将 使 用 
Xamarin.Forms 来 实现 一 一 使 用 相同 的 库 。 

要 创建 Xamarin Forms 项 目 ， 模 板 Cross-Platform App (Xamarin.Forms) 是 一 个 很 好 的 开端 。 使 用 这 个 项 目 
模板 ， 在 Windows 上 可 以 选择 三 个 平台 、UI 技术 和 代码 共享 策略 ， 如 图 37-15 所 示 。 


Select a template: 


A cross-platform template for building cross- 
:=| =| platform, native mobile apps for iOS, 
= i Android, and Universal Windows Platform, 
Blank App Master Detail 
Use the native user interface approach to 
create Uls for each platform, or Use 
Xamarin,Forms to create cross-platfonm, 
native Uls im MAML 


Platform UI Techneleoy Code Sharing Strategy ? 


I) Andraid [二 | Mamarin.Formes 二 | Shared Project 
| iD5 (Matiwe i NET Standard 
A) Windows (UWP) 


图 37-15 


使 用 Xamarin.Forms 可 以 为 Android、iOS 和 Windows 平台 创建 跨 平 台 的 应 用 程序 。 在 撰写 本 文 时 ， 
Xamarin.Forms for WPF 的 预览 已 经 是 可 用 的 ， 所 以 Xamarin.Forms 不 会 在 这 三 个 平台 上 停止 。 要 选择 的 UI 技 
术 是 Xamarin.Forms 或 Native。 选 择 Native 时 ， 就 会 创建 本 地 应 用 程序 。 用 户 界 面 在 此 场景 中 不 共享 。 但 是 ， 
可 以 使 用 公共 的 视图 -模型 和 公共 服务 。 通 过 Xamarin Forms， 使 用 XAML 为 所 有 这 些 平台 创建 用 户 界 面 。 这 是 
本 章 从 现在 开始 使 用 的 选项 。 使 用 代码 共享 策略 ， 可 以 在 共享 项 目 和 .NET 标准 之 间 选 择 。 使 用 NET 标准 ， 创 
建 一 个 包含 UI 代码 的 库 ， 在 所 选 的 平台 之 间 共 享 。 选 择 共享 项 目 时 ， 源 代码 会 构建 到 所 选 的 每 个 平台 应 用 程 
序 中 。 库 不 共享 , 但 是 源 代码 是 共享 的 。 在 示例 项 目 中 , 在 模式 和 Xamarin 章节 共享 的 两 个 项 目 将 共享 一 个 NET 
标准 库 ， 但 是 XAML 代码 与 共享 项 目 共享 。 


有 关 共 享 项 目 和 .NET 标准 的 更 多 信息 ， 请 阅读 第 19 章 。 


使 用 新 的 跨 平 台 应 用 程序 时 ， 可 以 选择 的 模板 是 Blank App 和 Master Detail 应 用 程序 ， 虽 然 这 款 应 用 程序 
会 有 一 些 主 从 功能 ， 但 我 们 还 是 先 从 空白 开始 ， 并 在 前 面 创建 的 库 的 帮助 下 实现 主 从 功能 。 

创建 项 目 BooksAppX 时 ， 创 建 了 四 个 项 目 : 用 于 通用 Windows 平台 、iOS 和 Android 的 三 个 托管 项 目 ， 以 
及 一 个 包含 XAML 文件 的 共享 项 目 。 由 于 前 面 已 经 使 用 这 三 个 平台 创建 了 项 目 ， 因 此 托管 代码 将 非常 熟悉 。 下 
面 通 过 这 三 种 技术 来 完成 后 动 。 


37.5.1 托管 Xamarin 的 Windows 应 用 程序 


生成 的 App 类 非常 类 似 于 第 33 章 中 用 来 创建 Windows 应 用 程序 的 App 类 。 不 同 的 是 Xamarin.Forms 现在 
在 重 写 方法 OnLaunched 中 初始 化 (代码 文件 BooksAppX/BooksAppX/UWP/App.xaml.cs): 


protected override Vvoid OnLaunched (LaunchActivatedEventArgs e) 
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Frame rootFrame = Window.Current.cCcontent as Frame; 
if (rootFrame 一 = null) 
{ 

rootFrame = new Frame(}).; 

rootFrame .NavigationFailed += OnNavigationFailed; 


Ramarin.Forms.Forms. Initle).; 


if (le.PreviousExecutionSstate == ApplicationExecutionSstate.Terminated) 
{ 

/TODO: Load state from previously suspended application 
} 


Window.Current.cContent = rootFrame.; 


} 


1if (rootFrame.Content == null) 
{ 

rootFrame .Navigate (typeof (MainPage), ee.Arguments).,; 
} 


Window.Current .Bctivate().; 


} 

现在 ， 从 OnLaunched 方法 中 创建 的 MainPage 是 一 个 派生 自 Xamarin.Forms.Platform.UWPWindowsPage 的 
类 。 这 个 类 驻 留 XamarinForms 页 面 。 公 共 代 码 在 MainPage 类 的 构造 函数 中 加 载 。LoadApplication 是 
Xamarin.Forms 的 开始 ， 它 从 共享 项 目 中 创建 一 个 新 的 App 类 ， 并 将 实例 传递 给 LoadApplication 方法 (代码 文件 
BooksAppX/BooksAppX/UWP/MaimnPage.xaml.cs): 

public Mainpage() 


{ 


this.InitializeComponent (); 


LoadApplication (new BooksAppX .App ()); 
} 


注意 : 

不 要 被 UWP 场景 中 的 两 个 MainPage 和 两 个 App 类 迷惑 。 一 个 App 和 MainPage 类 在 UWP 项 目 中 。 这些 
类 仅 由 Windows 应 用 程序 使 用 ， 其 他 App 和 MainPage 类 都 在 共享 项 目 中 。 这 些 类 由 UWP、Android 和 iOS 应 
用 程序 使 用 。 这 些 类 的 名 称 空间 是 不 同 的 。 


37.52 托管 Xamarin 的 Android 


在 Android 项 目 中 , 会 发 现 MainActivity。 这 个 活动 现在 派生 自 基 类 Xamarin.Forms.Platform.Android.Forms- 
AppCompatActivity。Xamarin.Forms 的 初始 化 和 公共 App 类 的 实例 化 在 OnCreate 方法 中 (代码 文件 BooksAppX/ 
BooksAppX. android /MainActivity.cs): 


[Activity (Label = "BooksAppX", Icon = "@drawable/icon™, 
Theme = "@style/MainTheme", MainLauncher = true., 
ConfigurationChanges = ConfigChanges.ScreenSsSize | ConfigChanges.Orientation)})] 


Public class MainActivity : 
global: :Xamarin.Forms.Platform.Android.FormsAppCompatActivity 
{ 
protected override void DOnCreate (Bundle bundle) 
{ 
TabLayoutResource = Resource.Layout.Tabbar; 
ToolbarResource = Resource.Layout.Toolbar; 


base.OncCcreate (bundle}). 


global: :Xamarin.Forms.Forms.TInit(this, bundle). 
LoadApplication (new App(}))}).: 
} 
} 
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37.5.3 ”托管 Xamarin 的 iOS 


托管 Xamarin.Forms 的 iOS 项 目 包 含 了 Main0 方 法 ， 其 中 调用 UIApplication， 传 递 AppDelegate 字符 串 ， 
类 似 于 之 前 的 iOS。AppDelegate 类 的 实现 是 不 同 的 。 这 个 类 现在 派生 自 基 类 Xamarin.Forms.Platform.iOS. 
FormsApplicationDelegate，FinishedLaunching 方法 的 实现 初始 化 了 Xamarin Forms， 并 加 载 应 用 程序 (代码 文件 
BooksAppX/BooksAppX. 10S /AppDelegate.cs): 


[Register ("AppDelegate"™)] 
Public partial class AppDelegate : 
global: :Xamarin.Forms.Platform.i0s.FormshpplicationDelegate 
{ 
PUublic override bool FinishedLaunching (UIApplication app， 
NSDictionary options)} 


global: :Xamarin.Forms.Forms.TInit().; 
LoadApplication (new App ()); 


return base.FinishedLaunching(app, options).; 
} 
} 


从 这 里 开始 ，UI 的 通用 代码 编写 就 可 以 开始 了 。 


37.5.4 共享 的 项 目 
这 个 共享 的 项 目 包 含 了 一 个 公共 的 App 类 ， 带 有 可 重 写 的 方法 OnStart、OnSleep 和 OnResume。 这 将 映射 
到 Android\iOS 和 Windows 系统 的 生命 周期 .在 构造 函数 中 ,创建 了 MainPage( 代 码 文 件 BooksAppX /BooksAppX 


/App.xaml.cs): 


Public partial class App : Application 
{ 
Public App() 
{ 
InitializeComponent () ，; 
MainPage = new BookSsapDX .MainPage ();} 
} 


protected override void Onstart!() 
{ 

} 

protected override void Onsleep() 
{ 

} 

protected override void OnResume {() 
{ 

】 

} 


MainPage 的 XAML 内 容 类 似 于 Windows 应 用 程序 ， 但 它 也 有 区 别 ， 其 中 使 用 了 不 同 的 XAML 元 素 ， 如 
ContentPage 和 Label。 这 些 是 用 XamarinForms 定义 的 ， 在 所 有 的 Xamarin.Forms 平台 上 都 可 以 使 用 : 


< ?Xml version="1.0" encoding="utf-8"™" ?> 
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" 
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml™" 
xmlns:local="clr-namespace:BooEsAppX" 
X:Class="BooksAppX.MainPage"> 
<Label Text="Welcome to Xamarin.Forms!" 
VerticalOoptions="Center" 
HorizontalOptions="Center™ /> 
</ContentPage> 


注意 : 
这 里 显示 的 MainPage.xaml 包含 创建 新 Xamarin.Forms 时 创建 的 ContentPage。 在 可 下 载 的 源 代码 中 ， 


MainPage.xaml 包含 一 个 TabbedPage， 参 见 37.8 节 “ 页 面 ”。 
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37.6 ”使 用 公共 库 


要 使 用 第 34 章 创 建 的 .NET 标准 库 BooksLib 和 Framework， 可 以 在 Xamarin Forms 解决 方案 中 添加 来 自 文 
件 夹 PatternsXamarinShared 的 项 目 。 这 些 项 目 需要 从 每 个 Xamarin 项 目 中 引用 。 

还 需要 添加 NuGet 包 Microsoft.Extensions.DependencyInjection 和 Microsoft.Extensions. Configuration。ILogger 
接口 由 服务 和 视图 模型 使 用 。 

Xamarin 还 包括 一 个 依赖 注入 容器 ， 它 可 以 从 DependencyService 类 中 访问 。DependencyService.Register 注 
册 一 个 服务 ， 而 DependencyService.Get 从 容器 中 返回 服务 。 但 是 ， 因 为 UWP 项 目 以 及 其 他 许多 章节 都 在 使 
用 .NETCore DI 容器 Microsoft.Extensions.DependencyInjection， 它 也 与 BooksAppX 一 起 使 用 。 

可 以 实例 化 依赖 注入 容器 ， 并 可 以 在 共享 的 App 类 中 注册 服务 。 对 于 具有 特定 于 UWP 实现 的 服务 ， 现 在 
需要 完成 特定 于 Xamarin 的 实现 。 需 要 Xamarin 实现 、 特 定 于 平台 的 服务 是 显示 消息 对 话 框 的 IMessageService， 
和 在 页 面 之 间 导 航 的 INavigationService (代码 文件 BooksAppX/ BooksAppX/App.xaml.cs): 

public partial class App : Application 

| public App () 

InitializeCcomponent (); 
RegisterServices (); 
Mainpage = new BooksAppX.Views.Mainpage () ; 


} 
Pe 


Private void RegisterServices'() 

{ 
Var Services = New ServiceCollection'().:; 
services.AddSingleton<IBooksRepository, BooksSampleRepositorvy>().; 
services.hddSsingleton<IlItemsService<Book>, BooksService>(); 
Services.hddTransient<BooksViewModel»>().: 
services.hddTransient<BookDetailViewModel»>().; 
Services.AddSingleton<IMessageService, XamarinMessageService>():; 
Services.hddSsingleton<INavigationService, XamarinNavigationService>(); 
Services.LddSingleton<XamarinlnitializeNavigationService2>(); 
Services.AddLogging(); 
AppServices = services.BuildServiceProvider():; 


} 


Public IServiceProvider AppServices { get; private set,; } 
} 


IMessageService 和 INavigationService 的 实现 将 在 “导航 ”一 节 中 讨论 。 


37.7 ”控件 层次 结构 


第 33 章 介 绍 了 Windows 应 用 程序 控件 的 主要 层次 。Xamarin.Forms 有 类 似 的 层次 结构 ,但 它 有 很 大 的 区 别 ， 

需要 在 这 里 讨论 。 此 外 ， 这 些 控件 的 名 称 也 不 同 。 

下 面 介 绍 Xamarin.Forms 层次 结构 中 最 重要 的 类 。 

e BindableObject: 这 是 Xamarin.Forms 控件 的 基 类 。 这 个 类 实现 了 INotifyPropertyChanged 接口 。 在 UWP 
中 没有 此 类 ， 但 是 BindableBase 类 有 一 个 定制 的 实现 。BindableObject 还 实现 了 接口 
IDynamicResourceHandler。 访 接口 由 平台 演 染 器 使 用 。 

e Element: Element 类 作为 Forms 层次 结构 中 所 有 元 素 的 基 类 。 这 个 类 定义 阴历 树 的 方法 和 属性 ， 并 
实现 了 平台 演 染 器 的 功能 。 

se Cell: Cell 类 派生 自 Element。 可 以 将 Cell 添加 到 ListView 和 TableView 类 中 。 与 可 以 使 用 UWTP 进行 
的 操作 不 同 ， 不 能 将 任何 XAML 元 素 添 加 到 ListView 中 。 在 Xamarin Forms 中 ， 只 能 添加 从 Cell 中 派 
生 的 类 。 
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VisualElement: VisualElement 派生 自 Element, 是 所 有 有 可 视 化 外 观 的 元 素 的 基 类 , 在 UWP 中 , Height 


和 Width 属性 可 以 定义 所 需 的 斥 寸 , 并 根据 容器 的 大 小 来 安排 。 而 在 Xamarin.Forms 中 , Height 和 Width 
属性 都 是 只 读 的 , 像 UWP 中 的 ActualHeight 和 ActualWidth 一 样 使 用 .Xamarin Forms 中 的 HeightRequest 
和 WidthRequest 是 UWP 中 Height 和 Width 属性 的 变 体 。VisualElement 类 也 有 一 个 Style 属性 , 可 以 定 
义 缩 放 、 旋 转 和 不 透明 度 ， 可 以 通过 IsEnabled 设置 要 启用 的 元 素 ， 通 过 IsVisible 设置 元 素 是 否 显示 。 

Page: Page 类 派生 自 VisualElement， 是 所 有 页 面 的 基 类 。 这 个 类 定义 了 标题 (title 属性 )、 工 具 栏 
(ToolbarItems)、 图 标 (Icon)。 使 用 方法 DisplayAlert， 可 以 显示 一 个 带 有 accept 和 cancel 按钮 的 对 话 框 。 


View: View 类 派生 日 VisualElement， 是 几乎 所 有 控件 的 基 类 。 这 个 类 定义 了 指定 在 布局 中 如 何 使 用 元 


素 的 水 平和 垂直 选项 、 定 义 了 视图 页 边 距 的 Margin 属性 ， 以 及 手势 识别 器 。 

ltemsView: ItemsView 派生 自 View， 可 以 与 UWP 的 ItemsControl 类 进行 比较 。ItemsView 是 ListView 
的 基 类 ， 定 义 了 ItemsSource 和 ItemTemplate 属性 。 

InputView: InputView 派生 目 View， 是 允许 键盘 输入 的 基 类 。 这 个 类 有 一 个 Keyboard 属性 。 

Layout: Layout 类 派生 自 View， 人 允许 派生 自 Layout 的 类 定位 它 的 子 元 素 。 在 UWP 中 ， 这 是 Panel 类 。 


接 下 来 讨论 这 些 控件 和 类 别 。 


37.8 贝 向 


要 创建 用 户 界面 ， 应 从 MainPage 开始 。Windows 应 用 程序 为 主页 使 用 NavigationView。 此 控件 不 可 用 于 
Xamarin.Forms。 记 住 ，Xamarin.Forms 只 提供 了 可 映射 到 所 有 平台 的 控件 。 

可 用 的 一 个 页 面 类 型 是 TabbedPage。 在 UWP 中 ，TabbedPage 就 是 Pivot 控件 ， 在 iOS 中 和 它 是 
UiTabBarController。TabbedPage 包含 AboutPage， 它 本 刁 就 是 ContentPage 和 NavigationPage。NavigationPage 
相当 于 Windows 应 用 程序 的 Frame 。 NavigationPage 的 内 容 在 导航 时 替换 (代码 文件 
BooksAppX/BooksAppX/Views/ MainPage.xam!l): 


< ?Xml Version="1.0" encoding="utf-8"™" ?> 
<TabbedPage xmlns="http://xamarin.com/schemas/2014/forms" 


xmlns:x="http://schemas .microsoft.com/winfx/2009/xaml" 
xX:Class="BookKsAppX.Views.MainPage"> 
<TabbedPage .Children> 


<NavigationPage Title="Books"> 
<NavigationPage.Icon> 
<OnPlatform x:TypeArguments="FileImageSource"> 
<On Platform="i0OS" Value="tab feed.png"/> 
</Onplatform> 
</NavigationPage.Icon> 
<X:Arguments> 
<ViewSs:BooksPage xX:Name="booksPage™" /> 
</x:Arguments> 
</NavigationPage> 
<views:AboutPage Title="About™ /> 


</TabbedPage .Children> 


</TabbedPage> 

该 应 用 程序 的 其 他 页 面 一 一 BooksPage 和 BooksDetailPage 一 使 用 简单 的 ContentPage 页 面 。ContentPage 可 
以 包含 一 个 内 容 。 

可 用 于 Xamarin.Forms 的 页 面 如 表 37-3 所 示 。 


表 37-3 
Xamarin.Forms 的 页 面 类 说 明 
TabbedPage TabbedPage 提供 多 个 选项 卡 在 页 面 之 间 导 航 。 这 是 一 个 常用 的 用 户 界面 


类 可 以 与 UWP 的 Border 类 相 比 较 


NavigationPage NavigationPage 提供 了 像 UWP 中 Frame 类 的 导航 功能 。Xamarin.Forms 的 Frame 
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( 续 表 ) 
Xamarin.Forms 的 页 面 类 说 明 
ContentPage 无 ContentPage 派生 自 TemplatedPage， 而 TemplatedPage 派生 自 Page。 使 用 模板 页 
面 ， 可 以 分 配 ControlTemplate 属性 来 定义 内 容 。ContentPage 只 能 有 一 个 内 容 
MasterDetailPage 无 MasterDetailPage 显示 了 一 个 列表 和 详细 信息 。 不 同 的 页 面 可 以 用 于 主要 和 细节 
部 分 
CarouselPage CarouselPage 派生 上 自 MultiPage。 这 个 页 面 匈 许 用 户 浏览 多 个 页 面 。 这 种 功能 在 


UWP 中 很 常见 ， 但 Android 和 iOS 却 不 常见 


37.9 “导航 


该 应 用 程序 的 根 页 面包 括 TabbedPage， 其 中 包括 NavigationPage。NavigationPage 定义 的 属性 Navigation 返 
回 初 始 化 INavigation 接口 的 对 象 。 这 样 ， 就 可 以 使 用 PushAsync 方法 导航 到 另 一 个 页 面 ， 并 使 用 PopAsync 方 
法 返回 。 

使 用 .NET 标准 库 Framework， 用 这 些 方法 定义 INavigationService: 


Public interface INavigationService 
{ 
Task NavigateToAsync (string page); 
Task GoBackAsync (}; 
string CurrentPage { get; } 
} 


现在 ， 需 要 XamarinForms 的 具体 实现 。 这 个 初始 化 给 导航 界面 使 用 了 INavigation 接口 (代码 文件 
BooksAppx/Services/XamarinNavieationService.cs): 


Public class XamarinNavigationService : INavigationService 
{ 
private Dictionary<string, Func<Page>> pages = 
new Dictionary<string, Func<Page>> 
{ 
[PageNames.BookDetailPage] = () => new BookDetailPage{() 
} 7 


private INavigation navigation; 
private INavigation Navigation 


{ 


get => navigation ?2 ( navigation = initializeNavigation.Navigation); 


} 
public string CurrentPage => throw new NotImplementedException(}); 
private readonly XamarinIinitializeNavigationservice initializeNavigation; 


public XamarinNavigationServicel 
XamarinIinitializeNavigationService initializeNavigatlion) 


{ 


initializeNavigation = initialijzeNavigation; 


} 
public Task GoBackAsync() => Navigation.PopAsync(); 


public Task NavigateToAsync (string pagename) => 
Navigation.PushAsync( Pages [pagename] ()}); 


} 
现在 需要 为 初始 化 提供 XamarinInitializeNavigationService。 这 个 类 只 定义 了 XamarinNavieationService 类 使 
用 的 SetNavigation 方法 和 Navigation 属性 (代码 文件 BooksAppX/Services/XamarinInitializeNavigationService.cs): 


public class XamarinIinitializeNavigationService 
{ 
Public void SetNavigation (INavigation navigation) 三 > 
navigation = navigation; 
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private INavigation navigation; 
public INavigation Navigation => navigatlion 23 
throw new ArgumentException ("navigation not initialized"™"); 


} 
现在 ， 需 要 从 NavigationPage 可 用 的 页 面 中 设置 Navigation 属性 一 一 MainPage 的 代码 隐藏 文件 (代码 文件 
BooksAppX/Views/ MalnPage.Xaml.cs)。 


[XamlCcompilation (XamlCompilationoOptions.Compile)] 
Public partial class MainPage : TabbedPage 
{ 

Public MainPage () 

{ 


InitializeComponent (}); 


(Application.Current as App) .AppServices 
.GetService<XamarinIinitializeNavigationService>{() 
.SetNavigation (navigationPage.Navigation); 


37.10 ”布局 


About 页 面 使 用 Grid 和 StackLayout 控件 来 安排 其 子 元 素 。Grid 控件 允许 定义 行 和 列 一 一 就 像 使 用 UWP 
中 的 Grid 控件 一 样 一 一 使 用 自动 设置 、. 星 形 设置 和 固定 大 小 设置 (代码 文件 BooksAppX/Views/AboutPage.xaml): 


<2?3Xml Version="1.0" encoding="utf-8"™" ?> 
<Contentpage xmlns="http://xamarin.com/schemas/2014/forms" 
xmlns:x="http://schemas .microsoft.com/winfx/2009/xaml" 
X:Class="BooOksAppX.Vliews .AboutPage"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="Auto" /> 
<RowDefinition Height="*" /> 
</Grid.RowDefinitions> 
<StackLayout BackgroundColor="{StaticResource Accent}" 
VerticalOptions="F1illAndExpand™" HorizontalOptions="F1il]1"> 
<StackLayout Orientation="Horizontal" HorizontalOptions="Center™" 
Verticaloptions="Center™"> 
<ContentView Padding="0,40,0,40™" VerticalOptions="F1l1lAndExpand"™> 
<Image Source="xamarin logo.png" Verticaloptions="Center" 
HeightRequest="64"> 
<IMage .SoOurce> 
<OnPlatform xX: TYPpeArguments="ImageSource"> 
<On Platform="UWP" Value="Assets/xamarin logo.png" /> 
</onPlatform> 
</Image.Source> 
</Image> 
</ContentView> 
</StackLayout> 
</StackLayout> 
<SCIOllView Grid.Row="1"> 
<StackLayout Orientation="Vertical" Padding="16,40,16,40"™" Spacing="10"> 
<Label FontSize="22"> 
<Label .FormattedText> 
<Formattedstring> 
<FormattedSstring.Spans> 
<SPan Text="AppName™" FontAttributes="Bold"™ FontSsize="22"™ /> 
<Span Text=" nm /> 
<Span Text="1.0" 
FoOregroundColor="{StaticResource LightTextColor}"™" /> 
</Formattedstring.spans> 
</Formattedstring> 
</Label .FormattedText> 
</Label> 
<Label> 
<Label.FormattedText> 
<FoOrmattedSstring> 
<FormattedSsString .Spans> 
<Span Text="This is a sample app for ™ /> 
<Span Text="Professional C# 7 and -NET Core 2.0" 
FontAttributes="Bold"™" /> 
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<Span Text="." /> 
</Formattedstring .Spans> 
</Formattedstring> 
</Label.FormattedText> 
</Label> 
<Label> 
<Label .FormattedText>» 
<Formattedstring> 
<FormattedSstring.sSspans> 
<Span Text="It shares code with"™ /> 
<Span Text=" ”和 /> 
<Span Text="i0S, Android, and Windows" FontAttributes="Bold™" /> 
<Span Text="." /> 
</Formattedstring .Spans> 
</Formattedstring> 
</Label.FormattedText> 
</Label> 
<Button Margin="0,10,0,0™ Text="Learn more™ Command="{Binding 
ViewModel .OpenWebCommand, Mode=OneWay}" 
BackgroundColor="{StaticResource Primary}"™" TextColor="White™" /> 


</stackLayout> 
</ScrollView> 
</Grid> 
</ContentPage> 
表 37-4 列 出 了 Xamarin.Forms 的 布局 控件 ， 以 及 它们 与 Windows 面板 控件 的 比较 。 
表 37-4 
Xamarin.Forms 控件 说 明 

Grid 使 用 星 型 、 自 动 和 固定 大 小 来 组 织 行 和 列 中 的 内 容 
StackLayout StackPanel 把 子 控件 一 个 接 一 个 地 水 平 或 垂直 排列 起 来 
AbsoluteLayonut Canvas 使 用 附加 属性 AbsoluteLayoutLayoutBounds 和 AbsoluteLayout.LayoutFlags， 通 
RelativeLayout RelativePanel 相对 于 其 他 控件 安排 控件 


About 页 面 还 有 其 他 一 些 有 趣 的 方面 .使 用 OnPlatform 元 素 , 可 以 根据 平台 定义 不 同 的 XAML 元 素 和 属性 。 
使 用 Image 元 素 , 将 Source 属性 设置 为 一 个 PNG 文件 。 该 文件 对 Android 和 iOS 是 有 效 的 , 但 是 对 于 Windows， 
该 文件 存储 在 Assets 文件 夹 中 。 只 有 UWP 中 Source 属性 的 设置 是 不 同 的 ， 它 由 OnPlatform 元 素 定 义 : 


<Image Source="xamarin logo.png" VerticalOptions="Center" 
HeightRequest="64"> 
<Image.Source> 
<OnPlatform x:TypeArguments=" ImageSource"> 
<On Platform=" Value="Assets/xamarin logo .png" /> 
/OnPlatform> 
</Image.Source> 
</Image> 


男 一 个 有 趣 的 部 分 是 Label 元 素 。 与 UWP 中 的 TextBlock 一 样 ，Label 不 仅 可 以 包含 简单 的 文本 ， 还 可 以 
包含 用 不 同 字体 和 颜色 格式 化 的 文本 。 参 见 第 36 章 ， 以 获得 更 多 关于 TextBlock 的 文本 格式 信息 。 使 用 带 有 
Label 的 不 同文 本 格式 ， 需 要 将 FormattedText 属性 设置 为 FormattedString: 


<Label> 
<Label .FormattedText»> 
<FormattedSstring> 
<FormattedSstring.Spans> 
<Span Text="This is a sample app for ™ /> 
<Span Text="Professional C# 7 and .NET Core 2.0" 
FontAttributes="Bold™ /> 
<SPan Text="." /> 
</Formattedstring.spans> 
</Formattedstring> 
</Label .FormattedText> 
</Label> 
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37.11 视图 


下 面 讨论 一 些 视图 类 型 ， 并 将 它们 与 已 知 的 控件 进行 比较 ， 如 表 37-5 所 示 。 


表 37-5 
Xamarin.Forms 控件 UWP 控件 说 了 明 

Button 按钮 会 对 触摸 事件 做 出 反应 ， 就 像 UWP 中 的 按钮 一 样 。 但 是 ， 按 钮 不 能 包 
会 任何 内 容 一 一 只 能 包含 文本 

Label TextBlock 标签 不 仅 可 以 包含 文本 ， 像 TextBlock 一 样 ， 还 可 以 包含 格式 化 的 文本 ， 如 
前 一 节 所 述 

Editor Entry 与 UWP 不 同 ，Xamarin Forms 对 多 行 编辑 和 单行 编辑 有 不 同 的 控制 。 要 只 纺 
辑 一 行 ， 可 以 使 用 Entry 类 。Editor 支持 多 行 编辑 

SearchBar UWP 使 用 AutoSuggestBox 演 染 SearchBar 

Stepper UWP 中 没有 与 Stepper 等 效 的 控件 。 在 Xamarin Forms 中 ， 这 是 通过 用 户 控 
件 和 两 个 按钮 实现 的 

ListView ListView XXamarin.Forms 定义 了 一 个 具有 与 UWP 中 的 ListView 类 似 功 能 的 ListView， 
来 使 用 ItemTemplate 显示 项 列表 

ProgressBar ProgressBar Xamarin Forms 定义 ProgressBar 来 显示 进度 信息 ， 类 似 于 UWP 

Switch ToggleSwitch Switch 类 类 似 于 UWP 中 的 ToggleSwitch 

注意 : 


Xamarin Forms 和 UWP 有 许多 相似 之 处 ， 但 类 名 、 属 性 名 和 方法 名 有 许多 不 同 之 处 。 因 为 有 .NET 标准 ， 
所 以 现在 ，XAML 标准 正在 使 用 中 : 参见 https://github.com/ Microsoft/ xaml-standard。 我 们 需要 检查 问题 ， 以 查 
看 实际 进展 。 在 写 这 篇 文章 的 时 候 ， 对 Xamarin Forms 来 说 ， 可 以 使 用 一 个 预览 包 ， 该 包 人 允许 使 用 XAML 标准 
和 XAML 文件 .这 样 ,XAML 代码 就 从 XAML 标准 转换 到 Xamarin Forms 控件 .Xamarin 控件 本 身 不 会 随 XAML 
标准 而 改变 ， 但 XAML 语法 相同 。 


37.12 ”数据 绑 定 


Xamarin.Forms 的 数据 绑 定 是 使 用 标记 扩展 完成 的 。x: Bind 标记 扩展 不 可 用 , 但 是 可 以 使 用 Binding 标记 扩 
展 ， 它 也 可 以 与 UWP 一 起 使 用 。 请 注意 ， 默 认 模 式 是 不 同 的 ， 可 以 使 用 的 模式 也 是 不 同 的 。Xamarin.Forms 不 
支持 OneTime， 但 OneWay、TwoWay 和 OneWayToSource 都 不 能 用 于 UWP。 此 模式 将 来 自 源 的 数据 绑 定 到 目 
标 (UI 元 紊 )， 但 反之 无 效 。 下 面 的 代码 片段 绑 定 了 Entry 控件 的 Text 和 IsEnabled 属性 (代码 文件 
BooksAppX/VIiews/ BookDetallPage.xaml): 


<ContentPage.Content> 
<StackLayout Spacing="20™" Padding="15"> 


<Label Text="Id:" FontSize="Medium"™ /> 

<Entry IsEnabled="False"™ 
Text=" {Binding ViewModel .EditItem.BookId, Mode=OneWay}" /> 

<Label Text="Title:" FontSize="Medium™" /> 

<Entry lsEnabled=" {Binding ViewModel .TIsEditMode, Mode=OneWay}" 
Text=" {Binding ViewModel .EditItem.Title, Mode=TwoWay}" 
FontSize="Ssmall™ /> 

<Label Text="Publisher:" Fontsize="Medium" /> 

<Entry lsEnabled=" {Binding ViewModel .TIsEditMode, Mode=OneWay}" 
Text=" {Binding ViewModel .EditItem.Publisher, Mode=TwoWHay}" 
FontSsSize="Small™ /> 


</SstackLayout> 
</ContentPage.Content> 
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该 属性 没有 指定 DataContext 来 激活 绑 定 ， 而 是 具有 名 称 BindingContext( 代 码 文 件 BooksAppX /视图 / 
BookDetallPage.Xaml.cs): 


[XamlCompilation (XamlCompilationOptions.Compile)})] 
Public partial class BookDetailPage : ContentPage 
{ 
Public BookDetailPage() 
{ 
InitializeComponent (); 
BindingContext = this; 
} 


public BookDetailViewModel ViewModel { get; } = 
(Application.Current as App) .AppServices.GetService<BookDetaillViewMode]l> (); 


37.13 命令 


与 UWP 一 样 ，Xamarin.Forms 中 的 命令 实现 了 ICommand 接口 。Xamarin.Forms 已 经 通过 Command 类 包 
会 了 一 个 实现 。Command 类 的 实现 类 似 于 Framework 库 中 实现 的 RelayCommand 。 Command 用 于 
AboutViewModel( 代 码 文件 BooksAppX/ViewModels /AboutViewModel.cs): 


Public class AboutViewModel 
{ 
public AboutViewModel () 
{ 
OpenWebcCcommand = new Command(() => 
Device.OpenUri (new Uri("https://csharp.christiannagel .com"™))); 


} 


Public ICommand OpenWebCommand { get; } 
} 


Button 类 的 Command 属性 是 通过 数据 绑 定 来 分 配 的 (代码 文件 BooksAppX/Views/ AboutPage.xaml): 


<Button Margin="0,10,0,0" Text="Learn more"™ 
Command=" {Binding ViewModel .OpenWebCommand, Mode=OneWay}" 
BackgroundColor="{StaticResource Primary}”" TextColor="White”" /> 


Xamarin.Forms 还 支持 ToolBarItem 控件 ， 该 控件 可 分 配给 ContentPage 的 ToolBarItems 属性 。 这 些 命 令 绑 
定 到 在 BooksLib 库 的 视图 模型 中 定义 的 命令 (代码 文件 BooksAppX/Views/BooksPage.xaml): 


<ContentPage.ToolbarItems» 
<ToolbarIitem Text="Refresh"™ 
Command="{Binding ViewModel.RefreshCommand, Mode=OneWay}™" /> 
<ToolbarItem Text="Add Book™ 
Command=" {Binding ViewModel .AddCommand, Mode=OneWay}™ /> 
</ContentPage.ToolbarItems> 


37.14 ListView 和 ViewCell 


ListView 控件 用 于 显示 项 列表 。 在 示例 应 用 程序 中 ，ItemsSource 属性 绑 定 到 视图 模型 的 Items 属性 上 。 为 
了 进行 显示 ， 将 DataTemplate 分 配给 ItemTemplate 属性 。 这 看 起 来 非常 类 似 于 UWP， 唯 一 的 区 别 是 ListView 
中 项 的 DataTemplate 只 能 包含 派生 目 Cell 的 类 。 这 里 使 用 了 一 个 ViewCell, 以 允许 使 用 其 他 元 系 , 如 StackLayout 
和 Label 控件 (代码 文件 BooksAppX/Views/ BooksPage.xaml): 


<LisStView Xx:Name="BooOksL1istView"™" 
ItemsSource="{Binding ViewModel.Items}" 
VerticalOptions="FillAndExpand"™" 
HasUnevenRows="true™ 
RefreshCommand="{Binding ViewModel .RefreshCommand}™" 
IsPullToRefreshEnabled="true™ 
IsRefreshing="{Binding IsBusy, Mode=OneWay}" 
Cachingstrategy="RecycleElement™" 
SelectedItem="{Binding VliewModel .selectedItem, Mode=TwoWay} "> 
<ListView.ItemTemplate> 
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<DataTemplate> 
<ViewCell> 
<StackLayout Padding="10"> 
<Label Text="{Binding Title}™" 
LineBreakMode="NoWrap™" 
Style="{DynamicResource ListItemTextStyle}™" 
Fontsize="16" /> 
</sStackLayout> 
</ViewCell> 
</DataTemplate> 
</ListView.ItemTemplate> 
</ListvView> 


其 他 派生 目 Cell 的 类 已 经 包含 了 预定 义 的 功能 ， 所 以 不 需要 添加 Entry Label 控件 。 表 37-6 列 出 了 派生 目 
Cell 的 类 。 


表 37-6 
Cell 说 明 
EntryCell 允许 编辑 一 行 的 单元 格 ， 类 似 于 Entry 控件 
SwitchCell 带 有 标签 和 开关 的 选项 
TextCell 主要 和 次 要 文本 
ImageCell 带 有 图 像 的 单元 格 
ViewCell 开发 人 员 定 义 的 视图 ， 如 BooksPage 示例 所 示 
注意 : 


可 以 在 Windows、iOS 和 Android 设备 的 屏幕 截图 中 看 到 正在 运行 的 应 用 程序 ,这 些 设备 都 在 本 书 的 GitHub 
站 点 上 ， 网 址 是 : 
https:/glithub.comy ProfessionalC Sharp/ProfessionalC Sharp7/blob/master/Xamarin/Readme.md., 


37.15 小结 


本 章 介 绍 了 如 何 使 用 Xamarin 开发 移动 应 用 程序 ， 学 习 了 Android 和 iPhone 的 不 同方 面 ， 以 及 如 何 使 用 
Xamarin.Android 和 Xamarin.iOS 开发 应 用 程序 。 

本 章 的 重点 是 Xamarin.Forms， 它 如 何 提供 与 UWP 相同 的 功能 ， 以 及 它们 的 区 别 。 虽 然 元 素 名 称 和 属性 与 
UWP 不 同 ， 但 功能 上 的 区 别 并 不 大 一 一 可 以 只 实现 一 次 XAML 代码 ， 就 获得 用 于 Windows、iOS 和 Android 
的 应 用 程序 。 

在 视图 模型 和 服务 中 实现 的 应 用 程序 的 完整 功能 是 在 本 地 的 UWP 应 用 程序 和 Xamarin.Forms 之 间 共 享 的 。 
对 于 Xamarin.Forms， 只 需要 为 用 户 界 面 定 义 顶 部 的 小 层 。 


